How to Integrate and Set Up Custom Courier

Custom Courier Setup Guide - Biteship

To use certain business and operational features in Biteship, corporate users need to complete the Custom Courier Setup process.

This feature helps Biteship ensure that your internal delivery fleet or special partner couriers can be well integrated into the system, so that operational processes, automatic tracking, and delivery management can run safely and smoothly.

This article will help you understand:

• What Custom Courier is in Biteship
• Benefits of using Custom Courier
• Required documents and technical data
• How to fill out the Custom Courier setup form
• Estimated activation and testing time
• Reasons for Custom Courier integration rejection

1. What Is the Custom Courier Feature?

Custom Courier is the process of integrating your company’s self-managed delivery fleet or selected third-party courier into the Biteship API ecosystem to ensure tracking, manifest management, and data communication run in sync.

This feature is usually required for:

• Using company-scale internal logistics fleets
• Activating special route features and personalized rates
• Delivery collaboration with local/traditional couriers outside standard partners
• Self-tracking validation based on coordinates or manual status
• Data privacy needs and special operational compliance

2. Benefits of Setting Up Custom Courier

By completing the configuration and setup process of Custom Courier, your company can gain the following benefits:

• Full control to align tracking, manifest management, and data communication of your self-managed fleet
• Easier integration of internal fleets or selected third-party couriers into the Biteship API ecosystem
• Simplified consolidation of special routes and personalized rate monitoring in one dashboard
• Reduced risk of tracking data miscommunication because the system runs in sync
• Easier validation of delivery reports (report settlement) for local/traditional couriers
• Full access to custom delivery API documentation for special operational compliance

3. Documents and Data to Prepare

Before starting the setup process, make sure you have prepared the following documents and technical information:

• NPWP / Company Legal Documents (if representing an official fleet)
• Rate Structure Scheme (based on weight, distance, or area)
• API Tracking / Webhook Documentation (if using an independent external system)
• Bank Account Information for shipping cost reconciliation

Ensure all documents and data:

• Are still valid and represent the latest operational data version
• Rate table format is intact and easy to understand
• Match the business account name registered in Biteship

4. Information Requested During Setup

During the Custom Courier setup process, you will be asked to fill in several important details about your courier’s operations.

Courier Service Details

• Custom courier name (will appear on the dashboard/checkout)
• Courier operational email or contact
• Description of delivery coverage area
• Estimated daily delivery capacity
• External tracking URL (optional)

In the coverage area description, briefly explain:

• Type of fleet used (motorcycle, car, truck)
• Specific coverage area (e.g., Jabodetabek, internal factory area, etc.)
• Target Service Level Agreement (SLA) for delivery
• Preferred pricing method
• Estimated monthly delivery volume

Supporting Documents and Data

You need to upload the following operational data:

• Excel/CSV file containing price matrix based on postal codes or coordinates
• Airwaybill Numbering Format
• SOP for Handling Late / Damaged Goods
• Identity/ID of the Field Operational PIC

Notes:

• If the custom courier is managed by an official third-party vendor, a cooperation MoU may be required under certain conditions.
• If the fleet is personally managed by MSMEs, legal documents can be replaced with a self-operational statement letter according to form instructions.

Signer & Contract Details

You also need to provide information about the person responsible for managing this fleet’s operations:

• Name of the fleet responsible person
• Position or role in the company

Ensure the data matches the party authorized to make logistics decisions in the company.

Reconciliation & Cost System Details

Financial setup information is needed for:

• COD fund disbursement if the custom courier handles cash-on-delivery
• Adjustments if there are shipping cost discrepancies
• Monthly billing needs (if any)

Data to be filled in:

• Operating bank name
• Account holder’s name
• Active account number

It is recommended to use the main company’s operational account to speed up and validate financial verification.

Integration Correspondence Information

To facilitate technical communication during integration, you are asked to provide contacts from your company’s technical division:

• IT / Developer Team (for webhook & API needs)

Information requested:

• PIC Name
• Active phone/WhatsApp number
• Email

Make sure the provided contacts are active and can respond quickly to logistics technical issues.

Hub / Main Warehouse Address

You also need to complete:

• Main warehouse address / fleet pickup point
• Courier operational office address
• Maximum free pickup radius (if any)

Ensure the warehouse address is filled in completely, including:

• Building, warehouse, or complex name
• Lot or unit number
• Street name
• District & City
• Postal code & Maps coordinate points

5. How to Set Up Custom Courier

Step 1: Log in to Biteship Dashboard

Log in to your Biteship account via the official Biteship Dashboard.

Step 2: Open Courier Settings Page

Go to the integration menu, select the "Custom Courier" option, and click "Add New Courier".

Step 3: Fill Operational & Rate Information

Complete all information including service name, coverage area, and upload valid rate matrices.

Step 4: Upload Supporting Technical Data

Upload airwaybill format, tracking webhook configuration, and required driver data as per form instructions.

Step 5: Submit for Review & Sandbox Testing

After all data is correctly filled, submit the form for evaluation by the Biteship technical team before going live.

6. How Long Does Custom Courier Activation Take?

The estimated verification process until ready for use usually takes:

• 2–4 business days for rate scheme checking and tracking webhook testing
• Longer if rate data structure is inconsistent or tracking API integration encounters errors

If needed, the Biteship developer team may contact your company’s IT team for joint integration testing sessions.

7. Reasons for Custom Courier Setup Rejection / Failure

Here are some common reasons why custom courier configuration submissions fail:

• Rate matrix file format is corrupted or unreadable by the system
• Tracking webhook endpoint configuration is unresponsive (Timeout)
• Delivery coverage area is not clearly defined (incorrect postal code format)
• Operational PIC contact information is unreachable
• Airwaybill numbering scheme duplicates another courier’s

8. Tips to Get Setup Approved Quickly

• Use the official rate file template provided by Biteship
• Ensure the tracking endpoint has been internally tested before submission
• Provide complete and accurate postal code data for each pricing tier
• Have your IT/Developer team on standby during technical review
• Provide backup route information if your internal courier is unavailable

9. FAQ About Custom Courier

Can I change the shipping rates after the status is Live?

Yes. You can update the rate matrix anytime via the settings menu, but changes require about 15-30 minutes for system synchronization.

Is automatic status tracking mandatory to fill?

If your fleet does not have an API tracking system, Biteship provides a manual status update feature on the courier dashboard so delivery status can still be monitored by buyers.

Is my company’s rate and delivery route data secure?

Yes. All rate configurations, customer data, and custom courier routes are confidential and protected with encryption according to Biteship’s privacy policy.

What if my internal courier fleet experiences over-capacity?

You can temporarily disable the Custom Courier feature via the toggle button on the dashboard and redirect deliveries to regular Biteship partner couriers.

10. Conclusion

The Custom Courier feature in Biteship gives your company full flexibility to manage an independent supply chain with efficiency comparable to national-scale couriers.

By completing technical and operational configurations accurately, your custom courier integration can run smoothly without obstacles.

If you encounter difficulties or need further API integration guidance, please contact the Biteship logistics support team via support@biteship.com.