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 NameWhat It IsWhy Clickpost Needs It
tokenYour Delhivery API authentication tokenUsed to authenticate every API call Clickpost makes to Delhivery on your behalf
nameThe registered client/account name as set up in Delhivery's systemUsed to identify your account when registering pickup warehouses with Delhivery
shipping_modeThe shipping service tier for your shipmentsTells Delhivery which service level to use (e.g. Express, Surface)
is_otp_verifiedWhether OTP-based delivery is enabled by default for all orders on this accountWhen set to True, Delhivery will require an OTP from the customer before completing delivery
ndd_typeNext-Day Delivery product type, if applicableEnables NDD service for eligible shipments; leave blank if not using NDD
is_multi_seller_warehouseWhether 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_formatWhich identifier to use as the order number sent to DelhiveryControls 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
labelWho generates the shipping label for this accountDetermines whether Clickpost or Delhivery is responsible for label generation. Possible values: Clickpost Generated, Delhivery Generated
label_sizeThe size of the shipping label to be generatedSets the label dimensions for printing. Possible values: A4, A6
brand_nameYour brand name to be printed or passed to DelhiverySent to Delhivery as part of shipment extra parameters for branding purposes
otp_based_deliveryWhether Clickpost should auto-generate and manage the OTP for deliveryWhen True, Clickpost generates the OTP internally and passes it to Delhivery as part of the order
include_drop_otpWhether to include the OTP in the drop/delivery instruction sent to DelhiveryWorks in conjunction with otp_based_delivery; when both are True, the OTP is included in the Delhivery shipment payload
transport_speedThe transport speed preference for shipments on this accountControls 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_delivery and include_drop_otp in 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).


Did this page help you?