The Cargo courier is a delivery service for large or heavy items, generally over 10 kg. If the cargo courier option does not appear on the Website checkout page, this could be due to various factors, including minimum weight limits, shipping zone settings, API integration, or restrictions from the courier itself. This article will explain the main causes and solutions to address them.
1. Order Weight Does Not Meet Minimum for Cargo Shipping
Cause:
Cargo couriers usually have a minimum weight limit, so if the order is too light, the cargo service will not appear in the Shopify checkout.
| Cargo Courier | Minimum Weight |
|---|---|
| JNE Trucking (JTR) | 10 kg |
| SiCepat GOKIL | 10 kg |
| Indah Cargo | 10 kg |
Solution:
- Ensure the total order weight meets the minimum limit of the available cargo service.
- If the items being shipped are lighter, use regular shipping services or add a weight adjustment option in the checkout system.
2. Cargo Courier Option Not Enabled on Website or Biteship
Cause:
If the cargo courier service is not enabled in Shopify settings or Biteship API, this option will not appear at checkout.
Solution:
-
For Biteship API:
- Log in to the Biteship Dashboard → Shipping → Courier Settings.
- Make sure the Cargo service is activated.
-
For Shopify:
- Log in to Shopify Admin → Settings → Shipping and Delivery.
- Ensure Cargo Courier is included among the available shipping methods.
- If using app-based rates, ensure that cargo courier rates have been added to the appropriate shipping zones.
3. Shipping Location Not Supported by Cargo Courier
Cause:
Cargo service is usually only available for shipments between certain cities or provinces. If the destination address is outside the coverage area, the shipping option will not appear.
Solution:
- Use Biteship API Check Coverage to verify if the address can be reached by the cargo courier.
- If the customer is outside the cargo service area, use alternative shipping options such as regular expedition or third-party trucking.
4. Package Dimensions Exceed Maximum Capacity of Cargo Courier
Cause:
Some cargo services have maximum dimension limits for shipments. If the package exceeds these limits, the service will not be available at checkout.
| Cargo Courier | Maximum Dimensions (cm) |
|---|---|
| Deliveree | Varies based on fleet |
| Indah Cargo | Varies |
Solution:
- Make sure product dimensions are correctly calculated in Shopify Admin → Products.
- For full service terms, see here
- If the item dimensions are too large, contact the relevant courier to find alternative solutions, such as shipping via trucking.
5. Biteship API Rate Limit Exceeded
Cause:
If too many API requests are made in a short time, Shopify or Biteship may limit API responses, causing cargo courier options not to appear.
Solution:
- Use caching or webhooks to avoid excessive API polling.
- Wait a moment and try again.
- Make sure you do not exceed the Biteship API rate limit (for example, 1000 requests per minute in production).
6. API Response Error or Synchronization Failure
Cause:
If there is a disruption in communication between Shopify and the Biteship API, the cargo courier service may not appear.
Solution:
- Check the API response logs in the Biteship Dashboard or use Postman to manually test the API response.
- If you receive a 500 (Internal Server Error) or 429 (Too Many Requests) error, try again after a while.
- Contact support@biteship.com if the problem persists.
Conclusion
If the cargo courier service does not appear on the Shopify checkout page, check the following factors:
✅ Check if the item weight meets the cargo courier's minimum limit
✅ Ensure cargo courier service is activated in both API and Shopify
✅ Verify if the shipping address is within cargo service coverage
✅ Make sure package dimensions do not exceed cargo courier limits
✅ Ensure shipping distance does not exceed maximum limits
✅ Ensure API rate limits are not exceeded
✅ Check shipping zones in Shopify
If you still encounter issues, please contact support@biteship.com for further assistance.