Delhivery
Overview
Delhivery is one of India's leading logistics and supply chain companies, providing domestic parcel delivery, express shipping, and fulfillment services across India.
The Delhivery integration enables shipment creation, updates, cancellation, tracking, and freight charge calculation through the Delhivery APIs.
The integration supports both single-piece shipments and multi-piece shipments (MPS), along with automatic or pre-generated waybill numbers.
Supported Operations
The following operations are supported through the Delhivery integration.
| Operation | Endpoint | Description |
|---|---|---|
| Create Shipment | POST /create.json |
Creates a shipment and generates a waybill if not provided |
| Generate Waybills (Bulk) | GET /waybill/api/bulk/json |
Generates waybill numbers for multi-piece shipments |
| Update Shipment | POST /api/p/edit |
Updates shipment details for an existing shipment |
| Cancel Shipment | POST /api/p/edit |
Cancels an existing shipment |
| Track Shipment | GET /api/v1/packages/json/ |
Retrieves shipment tracking information |
| Freight Cost Calculation | GET /api/kinko/v1/invoice/charges/.json |
Calculates shipment charges |
Carrier Services
The following carrier service types are supported.
| Service Type | Description |
|---|---|
| Domestic | Shipments within India |
| Reverse Pickup | Return or pickup shipments |
| Cash on Delivery (COD) | Payment collected at delivery |
| Prepaid | Payment completed before shipment |
Payment Modes
| Payment Mode | Description |
|---|---|
| Prepaid | Forward shipment paid in advance |
| COD | Cash on Delivery |
| Pickup | Reverse shipment pickup |
| REPL | Replacement shipment |
Supported Products
The following Delhivery shipping products are supported.
| Code | Product Name | Service Type |
|---|---|---|
| Surface | Delhivery One (Surface) | Domestic |
| Express | Delhivery Express | Domestic |
The product code determines the shipping mode used for the shipment.
| Integration Field | Delhivery Field |
|---|---|
| productCode | shipping_mode |
Possible values:
Surface
Express
Label Generation
Delhivery automatically generates shipment labels when a shipment is successfully created.
Waybill Generation
For high-value shipments exceeding 50,000 INR, a waybill must be generated before creating the shipment.
Waybill Generation Endpoint
GET /waybill/api/bulk/json
The generated waybill must then be included in the shipment creation request.
Integration Notes
Single Piece Shipments
Shipments can be created without providing a waybill number.
POST /create.json
Delhivery will automatically generate the waybill number.
Multi-Piece Shipments (MPS)
For multi-piece shipments:
- A waybill must be provided for each package
- Waybills should be generated using the bulk waybill API.
Shipment Cancellation
Shipments can be cancelled using the edit order API.
POST /api/p/edit
Required key:
"cancellation": "true"
Allowed Cancellation Status
| Status |
|---|
| Manifested |
| In Transit |
| Pending |
| Open |
| Scheduled |
Cancellation Result
| Shipment Type | Resulting Status |
|---|---|
| Prepaid / COD | Returned |
| Pickup | Cancelled |
Shipment Updates
Shipment details can be updated using:
POST /api/p/edit
Supported update fields include:
- Consignee name
- Consignee address
- Consignee phone
- Shipment weight
- Shipment dimensions
- Payment mode
- Product details
Allowed Update Status
| Status |
|---|
| Manifested |
| In Transit |
| Pending |
| Scheduled |
Update Not Allowed For
| Status |
|---|
| Delivered |
| Dispatched |
| Lost |
| RTO |
| DTO |
| Picked Up |
| Collected |
Tracking Shipments
Tracking information can be retrieved using:
GET /api/v1/packages/json/
Up to 30 waybill numbers can be tracked in a single request.
Freight Cost Calculation
Freight charges can be estimated using the invoice calculation API.
GET /api/kinko/v1/invoice/charges/.json
The API calculates shipping costs based on:
- origin and destination pincodes
- package weight
- shipment dimensions