DELHIVERY
Delhivery
Delhivery is a leading domestic last-mile delivery courier partner offering forward shipping services across India, with support for prepaid, COD, and exchange shipments.
CPID: 4
Services Integrated
- Order Creation
- Order Cancellation
- Tracking
- Vendor Code Lookup
- OTP-based Delivery
Steps to Set Up Delhivery on Clickpost
First, complete the process of setting up a courier partner account by following the steps outlined here: https://docs.clickpost.ai/docs/create-an-courier-partner-accountPartner
Once your account is created, navigate to Carrier Integrations → Delhivery and open your account configuration. You will land on the Credentials screen.
| Field Name | What It Is | Why Clickpost Needs It |
|---|---|---|
| token | Your Delhivery API authentication token | Used to authenticate every API call Clickpost makes to Delhivery on your behalf |
| name | The registered client/account name as set up in Delhivery's system | Used to identify your account when registering pickup warehouses with Delhivery |
| shipping_mode | The shipping service tier for your shipments | Tells Delhivery which service level to use (e.g. Express, Surface) |
| is_otp_verified | Whether OTP-based delivery is enabled by default for all orders on this account | When set to True, Delhivery will require an OTP from the customer before completing delivery |
| ndd_type | Next-Day Delivery product type, if applicable | Enables NDD service for eligible shipments; leave blank if not using NDD |
| is_multi_seller_warehouse | Whether your account operates a multi-seller warehouse model (multiple sellers shipping from the same pickup location) | When True, Clickpost registers a separate warehouse entry in Delhivery's system for each unique seller at the same pickup address |
| order_number_format | Which identifier to use as the order number sent to Delhivery | Controls whether Delhivery receives the Reference Number, Order ID, or a combination of both as the shipment order number. Possible values: Reference Number, Order ID, Order ID + Reference Number |
| label | Who generates the shipping label for this account | Determines whether Clickpost or Delhivery is responsible for label generation. Possible values: Clickpost Generated, Delhivery Generated |
| label_size | The size of the shipping label to be generated | Sets the label dimensions for printing. Possible values: A4, A6 |
| brand_name | Your brand name to be printed or passed to Delhivery | Sent to Delhivery as part of shipment extra parameters for branding purposes |
| otp_based_delivery | Whether Clickpost should auto-generate and manage the OTP for delivery | When True, Clickpost generates the OTP internally and passes it to Delhivery as part of the order |
| include_drop_otp | Whether to include the OTP in the drop/delivery instruction sent to Delhivery | Works in conjunction with otp_based_delivery; when both are True, the OTP is included in the Delhivery shipment payload |
| transport_speed | The transport speed preference for shipments on this account | Controls whether shipments are sent at standard speed or next-day (fast) speed. Possible values: Standard, Next Day |
Sample Clickpost Request — Create a Delhivery Order
{
"drop_info": {
"drop_lat": 0,
"drop_city": "Mumbai",
"drop_long": 0,
"drop_name": "Rahul Sharma",
"drop_email": "[email protected]",
"drop_phone": "9876543210",
"drop_state": "Maharashtra",
"drop_address": "45 Marine Drive, Nariman Point",
"drop_district": "Mumbai City",
"drop_landmark": "Near NCPA",
"drop_pincode": "400021",
"drop_country": "IN",
"drop_address_type": "RESIDENTIAL"
},
"pickup_info": {
"pickup_lat": 19.0760,
"pickup_city": "Mumbai",
"pickup_long": 72.8777,
"pickup_name": "Acme Fashions Warehouse",
"pickup_time": "2024-06-15T10:00:00+05:30",
"pickup_email": "[email protected]",
"pickup_phone": "9123456780",
"pickup_state": "Maharashtra",
"pickup_address": "Plot 12, MIDC Industrial Area, Andheri East",
"pickup_district": "Mumbai Suburban",
"pickup_landmark": "Near MIDC Gate 3",
"pickup_pincode": "400093",
"pickup_country": "IN",
"pickup_address_type": "OFFICE"
},
"shipment_details": {
"items": [
{
"sku": "ACM-SHIRT-001",
"price": 799.00,
"weight": 300,
"hs_code": "6205.20.00",
"quantity": 2,
"description": "Acme Men's Cotton Formal Shirt, Size L, White",
"manufacture_country": "India",
"manufacture_country_code": "IN",
"cat": "Apparel",
"color": "White",
"brand": "Acme",
"size": "L",
"final_amount_paid": "1598.00",
"store_credits_used": "0.00",
"product_id": "PROD123456",
"variant_id": "VAR789012"
}
],
"height": 10,
"length": 30,
"weight": 600,
"breadth": 20,
"order_id": "ACME-ORD-20240615-001",
"cod_value": 0,
"order_type": "PREPAID",
"invoice_date": "2024-06-15",
"delivery_type": "FORWARD",
"invoice_value": 1598.00,
"invoice_number": "INV-ACME-2024-001",
"courier_partner": 4, // CPID for Delhivery; hardcoded value passed to Delhivery
"reference_number": "ACMEREF20240615001",
"account_code": "your_account_code_here"
},
"additional": {
"return_info": {
"city": "Mumbai",
"name": "Acme Fashions Returns",
"email": "[email protected]",
"phone": "9123456780",
"state": "Maharashtra",
"address": "Plot 12, MIDC Industrial Area, Andheri East",
"district": "Mumbai Suburban",
"landmark": "Near MIDC Gate 3",
"pincode": "400093",
"country": "IN"
},
"async": false,
"otp_flag": false,
"order_date": "2024-06-15",
"estimated_delivery_date": "2024-06-18",
"user_defined_field_array": [
{"name": "udf_1", "type": "String", "value": ""},
{"name": "udf_2", "type": "String", "value": ""},
{"name": "udf_3", "type": "String", "value": ""},
{"name": "udf_4", "type": "String", "value": ""}
]
},
"gst_info": {
"seller_gstin": "27AABCU9603R1ZX",
"taxable_value": 1355.93,
"ewaybill_serial_number": null,
"is_seller_registered_under_gst": true,
"sgst_tax_rate": 9,
"place_of_supply": "MAHARASHTRA",
"gst_discount": 0,
"hsn_code": "62052000",
"sgst_amount": 122.03,
"enterprise_gstin": "27AABCU9603R1ZX",
"gst_total_tax": 244.07,
"igst_amount": 0,
"cgst_amount": 122.03,
"gst_tax_base": 1355.93,
"consignee_gstin": "",
"igst_tax_rate": 0,
"cgst_tax_rate": 9
}
}Onboarding Checklist
- Obtain your Delhivery API token from your Delhivery account manager or the Delhivery developer portal
- Confirm your shipping mode (Express or Surface) and transport speed preference with your Delhivery account manager
- Confirm whether your account uses a multi-seller warehouse setup and communicate this to the Clickpost onboarding team
- Enter all credentials (token, name, shipping mode, and other applicable settings) on the Clickpost dashboard under Carrier Integrations → Delhivery
- Confirm the correct order number format with your operations team (Reference Number, Order ID, or combined) and set it in the credentials
- If OTP-based delivery is required, enable
otp_based_deliveryandinclude_drop_otpin the credential settings and confirm the flow with your Delhivery account manager - Place a test shipment end-to-end — verify that the order is created successfully in Delhivery's system, the AWB number is returned, and tracking updates are received on Clickpost before going live
Notes
AWB Generation: Delhivery assigns the AWB number at the time of order creation. No pre-assigned AWB flow is required for CPID 4 (standard forward). If you are using a pre-assigned AWB flow, confirm with the Clickpost team whether your account has this enabled, as it requires a separate setup.
Labels: Delhivery supports both Clickpost-generated and Delhivery-generated labels. The preferred mode is configured in the label credential field on the dashboard.
CSB-4 Support: Not applicable for this integration (domestic forward only).
Updated 3 months ago
