🚫 This article is obsolete.
Visit the Understanding COD article for up to date information.
🌏 This content is for Shippit customers located in Singapore, Malaysia, and elsewhere throughout South-East Asia.
Cash on Delivery (COD) orders can be created through various methods, depending on your integration point to Shippit:
Shopify
API
Bulk CSV File
FTP Server
COD Orders from Shopify
Your customers can make purchases at your Shopify store for COD orders as usual.
Once the orders are placed though, it is important that Shippit is configured to accept the orders.
🔄 Auto-Sync Event
Login to Shippit
Go to Settings > Integrations
Go to the Shopify Integration Settings' Orders tab
Under Auto-Sync Event, select When an order is created
COD orders will not auto-sync into Shippit if When an order is marked as paid is set as the Auto-Sync Event for the obvious reason that COD orders do not get marked as paid until they are delivered.
🚚 Shipping Method Mapping
If you would like your COD orders to be assigned to a specific courier in Shippit, you can set-up Shipping Method mapping within the Shopify Integration Settings' Orders tab too.
Shippit will never allocate a COD order to a courier that is not COD compatible. If you are not particular about which courier the COD orders get assigned to, this step may not be necessary.
COD Orders from the API
Please refer to the Shippit Developer Guide and take note of the unique use of the following data fields:
cash_on_delivery_amount | Used by the courier to indicate amount to be collected upon delivery for COD orders |
courier_allocation | this field specifies the courier who will handle the order; valid options for COD compatible couriers: AramexExpress, AramexInternational, DhlExpress, DhlExpressInternational, NinjaVanStandard, and NinjaVanExpress; this field may be skipped if the courier_type (below) is provided |
courier_type | this field specifies your preferred shipping service class for an order; the available service level options are standard and express only; this field may be skipped if the courier_allocation (above) is provided |
authority_to_leave | dictates whether or not an order can be left unattended at the delivery address; even if YES is sent for COD orders, orders will be created with ATL disabled; no error will hinder the order from coming through, only that ATL will be disregarded. |
These data fields are not marked as required for usual order creation but are actually considered in creating a COD order.
COD Orders from a CSV File
Creating orders through a CSV file is considered an integration of sorts. This means you cannot go through this order creation method if you already have a Shopify integration.
Here is a good sample file you can view and then edit to be familiar with the columns required in creating COD orders from a CSV file.
Follow this guide on how to set-up a CSV/FTP integration. Check out the section specific to Upload via Web Interface.
COD Orders from the FTP Server
Creating orders through the FTP server is an actual platform integration. This means you cannot use this order creation method if you already have a Shopify integration.
Here is a good sample file you can use as a basis for the file you will upload to the FTP server.
Follow this guide on how to set-up a CSV/FTP integration. Go to the section specific to Update via the FTP Service.
If you encounter any issues while creating your COD orders, email us at [email protected].