There are a few things to consider when creating orders with the ecommerce order API.
- Order status
- Order kinds
- Payment on delivery or pre-paid
- Partner Order ID
- Billing Identifiers
- AWB Documents (Labels)
- Marking an order as
ready for collection
When you creaet a new single order, this order will be created in a
pending state and will only by visible on your Quiqup Portal, but it is not visible for our dispatching system.
1. Order states:
||The order has been created in a draft state and has not been yet confirmed by the client that it can be collected, Quiqup will ignore this order until it is submitted|
||Order created and is known in Quiqup’s system and will be added to the next collection run|
||Quiqup has collected the order from the pickup location and the order is on the way to our depot|
||The order has been received at the depot|
||The order is out for delivery|
||Order has successfully been delivered, this is an end of life cycle state.|
||The delivery of the order has failed. This has several reasons. See table below.|
||The order will be returned to the retailer|
||The order has been returned to the retailer, this is an end of life cycle state.|
||The delivery of the order has been cancelled|
||The delivery of the order has been put on hold|
||The order is at the depot and awaiting to be scheduled with customer or will be delivered during the next delivery day|
||The order has been scheduled for delivery with the customer in the future|
2. Order Kinds (Service Type):
Through this API we offer various services, depending on what service you select, different service levels apply. The current available service kinds are:
|Order Kind Value||Service Description|
||If orders are marked as
||Orders that are marked as
||Orders mark as
||Use this order kind to create return orders for customers to return. Important to consider that the pickup location here should pickup location of the customer and the dropoff location should be the location where order is returned to.|
||Use this for store deliveries to allow your customer to collect from store.|
3. Payment on delivery or pre-paid
There are two fields that pertain to payment on delivery,
payment_mode can either be:
prepaid- This means the customer has already paid you and no money needs to be collected during the delivery
paid_on_delivery- This means the customer has not yet paid for the order and will be collecting this by card or by cash during the delivery.
As for the
payment_amount this is dependent on what
payment_mode is set.
- If the payment mode is prepaid, then the payment amount needs to be 0 or
- In case where the
paid_on_delivery, then the
payment_amountneeds to be greater then
The currency is defaulted to the countries currency, in the case of the UAE this is Dirham AED, ISO: AED 784.
4. Partner Order ID
This field you can use for your own interal order reference. This will also be used for invoicing purposes and allows for easy reconcilation of invoices and COD payments. This field does not enforce uniqueness, however this is certainly recommended.
5. Billing Identifiers
Billing Identifiers allow you to create orders in other accounts. This can be useful for integrations that will be used by several business.
A billing identifier needs to be configured by Quiqup and approved by the business.
A billing Identifier is set by passing the below in the root of the order payload:
- The integrated account
email@example.com API keys to connect to Quiqup’s system and create orders.
- While creating orders it passes the billing identifier
- The order is then owned by
firstname.lastname@example.org the order is authored by
email@example.comMaking the order visible on both their Quiqup Portals.
Items should be regarded as parcel. Each item represents one parcel. So thus if an order consists of only one parcel there is only one item in the order. If there are two parcels as part of the order.
The item object has a few importants fields that you need to be aware of:
- First being the
name, you can put your parcel refernce code or order ID in here. Alternative you can name this: Parcel #1, and Parcel 1 of 2 if there are multiple parcels as part of this order.
Quantifyshould always be set to
- Then last but not least
parcel_barcode, if you leave this empty, we will generate this and use it to generate a label with. However you do provide a
parcel_barcodewe assume that you have your own label that you will use.
7. AWB Documents (Labels)
Ecommerce order require labels to maintain and provide an accurate chain of custody for you records and ours. This is what allows us to keep a clean order history and track the parcels throughout it’s life-cycle.
As an order can have multiple items, an order can also have multiple labels. Each item requires a label with a unique parcel-barcode so each individual parcel can be tracked. For more information on how to download our labels see: More about this see Download the AWB Document.
8. Marking an order as
Once the order has been picked, packed and labelled you can mark the order as ready for collection. Orders that remain in a
pending will be ignored by Quiqup. For full details please see Mark Ready for Collection