Test Environment URL
Production Environment URL
Important Points which needs to be considered while order creation
Waybill: In case of single piece shipment, Waybill can be passed in the payload or can be skipped as well which can have multiple products inside it), but in case of MPS, waybill needs to be passed for each box explicitly in the API.
This line is a must to have in the payload JSON body.
Order ID should be unique for every new order manifested in our system ideally when the waybill is passed and must when the waybill is not passed and randomly assigns from delhivery end. It can only be same when the waybill is passed explicitly in the payload
The uniqueness of order in our network is identified with order+waybill as primary keys. Order ID may not be unique in case the client is providing the waybill as well. In case, a waybill is not passed by the client in the API and Delhivery will be generating the waybills, order ID passed needs to be unique.
4.Payment_mode will be COD or Pre-paid when the order is created for forwarding shipment else Pickup if it is created for reverse flow.
Pickup location to be passed in the API needs to be exactly the same as the name of the warehouse registered The name is also case sensitive. An error is thrown to indicate any differences in the name of the pickup location.
There is a field which identifies the client at our end, its value should be exactly the same with the name the client registered in the delhivery.
In case of fragile content, fragile_shipment: true should be passed in manifestation payload at root level.
Key Name: fragile_shipment
Key Value: true or false
Also, our system does not accept special characters in the payload,
Characters: &, #, %, ; ,\
If '' is present in the payload, it should be escaped as shown '\\'.
Only if the payload is JSON encoded, then there is no issue.
Mandatory Fields: Pin, phone and address are the mandatory keys to be passed in all shipment flows.
For Last-Mile Delivery in Bangladesh:- "country" should be pass as "BD" and valid "pin" for the Bangladesh country while creating order via order creation API. In case you don't pass any "country" then the system will automatically consider the country "India" by default
In any scenario if you are not passing any optional key value, the default value which will be linked to your account will be assigned automatically, it would be safe to pass maximum keys to get an order created successfully.
GST Details :
There are 2 ways client can provide the GST related information as below.
A client can pass the information through API (fields are given below) OR he can share the information one time with our business / Account manager. The client should have received an email from us a link where you have to update the GST related information one time.
- Seller_gst_tin - GST TIN number of the seller--Mandatory in the API
- Client_gst_tin - GST TIN number of the contracting entity with Delhivery
- Consignee_gst_tin - GST tin of the consignee in case of B2B shipments
- Hsn_code - Share the Harmonized System of Nomenclature for each product in the package (Mandatory in the API). You can pass more than one HSN here if the quantity is more than 1.
- invoice_reference - unique invoice reference number
Seller_gst_tin and hsn_code are mandatory in API and these fields need to be added only in Package/Order creation API, not in Vendor/Warehouse creation API
Order Creation Reverse Pickup Shipments
Meaning of RVP- this is a case where shipment needs to be pick from the customer and delivered to the client warehouse else the specified location given by the client.**
Order creation API for RVP- API URL and payload will be the same as forward but you need to make few changes as given below.
- payment_mode= Pickup (whereas it is prepaid and COD for forwarding shipment)
- If you are passing the return keys then shipment will be delivered to return address.
- If you are not passing the return keys then shipment will be delivered to the warehouse address.