How to Integrate and Set Up Custom Courier

Custom Courier Setup Guide - Biteship

To use certain business and operational features on 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 are well integrated into the system, so operational processes, automatic tracking, and delivery management can run securely and smoothly.

This article will help you understand:

• What Custom Courier is on Biteship
• The 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 why Custom Courier integration might be rejected

1. What Is the Custom Courier Feature?

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

This feature is typically required for:

• Use of company-scale internal logistics fleets
• Activation of custom routes and personalized rates features
• Delivery cooperation with local/traditional non-standard partner couriers
• 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 for Custom Courier, your company can gain the following benefits:

• Full control to align tracking, manifest management, and data communication for your self-managed fleet
• Simplified integration of internal fleets or selected third-party couriers into the Biteship API ecosystem
• Easier consolidation of custom routes and monitoring of personalized rates within a single dashboard
• Reduced risk of tracking data miscommunication because the system runs in sync
• Simplified 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 You Need to Prepare

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

• Tax ID / Company Legality (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
• Have rate tables that are complete and easy to understand
• Match the business account name registered on 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 operations.

Courier Service Details

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

In the coverage area description section, briefly explain:

• Type of fleet used (motorbike, car, truck)
• Specific coverage area (e.g., Greater Jakarta, internal factory area, etc.)
• Target Service Level Agreement (SLA) for deliveries
• 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 Pattern (AWB) numbering format
• SOP for Handling Late/Damaged Goods
• Identity/ID card of the Operational PIC (Person In Charge) in the field

Note:

• 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 managed personally by MSMEs, legality documents can be replaced with a self-operation statement letter as instructed on the form.

Signatory & Contract Details

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

• Name of the fleet person in charge
• Position or role within the company

Make sure the data corresponds to the party authorized to make logistics decisions in the company.

Reconciliation & Cost System Details

Financial setup information is required for:

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

Data to be filled in:

• Operational bank name
• Account holder name
• Active account number

It is recommended to use the main company’s operational account for faster and more valid financial verification.

Integration Correspondence Information

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

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

Information requested:

• PIC Name
• Active phone number / WhatsApp
• Email

Ensure the provided contacts are active and able to respond quickly to logistics technical issues.

Main Hub / Warehouse Address

You also need to complete:

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

Make sure the warehouse address is fully filled in, including:

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

5. How to Set Up Custom Courier

Step 1: Log in to the Biteship Dashboard

Access your Biteship account through the official Biteship Dashboard.

Step 2: Open the Courier Settings Page

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

Step 3: Fill in Operational & Rate Information

Complete all service name details, coverage areas, and upload a valid rate matrix.

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 webhook tracking testing
• Longer if the rate data structure is inconsistent or tracking API integration encounters errors

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

7. Reasons Why Custom Courier Setup Is Rejected / Fails

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 does not respond (Timeout)
• Delivery coverage area is not clearly defined (incorrect postal code format)
• Operational PIC contact information cannot be reached
• AWB numbering scheme data duplicates another courier’s

8. Tips to Get Your Setup Approved Quickly

• Use the official rate file template provided by Biteship
• Make sure the tracking endpoint is tested internally before submission
• Provide complete and accurate postal code data for each price tier
• Ensure your IT/Developer team is on standby during the technical review period
• 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 through the settings menu, but changes require about 15–30 minutes of system synchronization.

Is automatic status tracking mandatory to fill out?

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 safe?

Yes. All rate configurations, customer data, and custom courier routes are confidential and protected by encryption in accordance with 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 Biteship’s regular partner couriers.

10. Conclusion

The Custom Courier feature on Biteship offers your company full flexibility to manage an independent supply chain with technology 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 Biteship’s logistics support team at support@biteship.com.