Delhivery India
INTEGRATION DOCUMENT
About Delhivery
Established in 2011, Delhivery is one of India’s leading supply chain services company. The Gurugram based company has 24 automated sort centres, 85+ fulfilment centres, 70 hubs, 3000+ direct delivery centres, 7500+ partner centres, and 15000+ vehicles. Delhivery brings unparalleled cost efficiency and pan-India reach to the businesses of over 10000 customers
Services Integrated
Below are the services of Delhivery which are integrated with e-Retail:
- Shipment Tracking
- Forward Manifest
- Pick up
- Reverse Pick up with Quality Check
Pre-requisites
Before configuring the transporter on Vin e-Retail, the following needs to be obtained from Delhivery:
- Tracking secret key
- Manifest/Serviceability secret key
- Pickup secret key
Configuring the logistics partner
Below are the steps to configure the transporter in eRetail:
- Login on Vin e-Retail. Once logged in, navigate to left hand side of the screen towards the menu.
- Hover over the Master Module and click on Transporter Master under Trading Partners.
- In the Transporter Enquiry screen, click the Add New button that is located on the top right corner of the screen. Alternatively, use Alt+F as shortcut key to add a new transporter. This will bring up Transporter Create/Edit screen.
- On the Transporter Create/Edit screen, select the Transporter Type as Delhivary India from the drop-down list.
Fill the details as required in the below table:
Detail Transporter
S.No. | Section | Field (Free Text/Checkbox/ Dropdown) | Features | Details |
1. | Detail Transporter | Transporter Type | Select the dropdown to choose the transporter. It is a mandatory field. | Select Delhivary India. Once the transporter is selected, “Configure API Details” tab will appear. |
1.a. | Transporter Code* | Unique Code is generated by the user for each Transport. Once the Transporter Code is saved, it cannot be edited. It is a mandatory field. | It helps differentiating two or more records in case these records have same Transporter Name. | |
1.b. | Transporter Name* | Defined by the user. It is a mandatory field. | The user can use this field to give any name for the transporter. | |
1.c. | Company Name | Defined by the user. | This field is used to provide an optional alternative name to the transporter. | |
1.d. | GL Code | General Ledger Code and it is an optional free text field. | It is used for reference to locate the transporter in the books of accounts. | |
1.e. | Validate Service Loc | Checkbox that allows validation of Delivery location/pin code of the transporter | It is used to check whether the delivery location is serviceable or not (i.e., reachable by the transporter.) | |
1.f. | Send Ship Mail ID | Checkbox that allows to send ship mail ID to your customers. | When this option is enabled, the transporter will send order tracking information to the end customer via email. | |
1.g. | Reverse Validate Service Loc | Checkbox will allow validation for the delivery location/pin code in case of returns | It is used to check whether the pickup location is serviceable or not. | |
1.h. | Delivery Mode | Dropdown to select delivery mode as Air or Surface | It is not a mandatory field. The delivery via water bodies will be part of the surface only. | |
1.i. | Upload AWB series | Checkbox that allows to upload AWB series if manifest generation is offline otherwise leave it blank. | Check only if manifest generation is off line. Keep this option unchecked in case of real time manifest generation. Manifest (offline/real-time) can be selected in the Configure API Details tab. | |
1.j. | Is Active | Check this option to mark the transporter active. It is a mandatory field. | The transporter cannot be used if it is not marked active. | |
1.k. | Tracking hour | Free text field used for any number of hours less than 24 hours to check the shipment with the transporter. | 6 hours is the ideal time and is also the default value. | |
1.l | Dimensional Factor | Optional free text field used to calculate the dimensional weight of the shipment. | The volume of the shipment is divided by Dimensional Factor to determine the shipment’s dimensional weight, which is then further used to calculate the shipment rates. It is an optional field. | |
1.m. | Trans Type* | Dropdown to be selected either as “Courier” or “Own Fleet”. It is a mandatory field. | In B2C cases, select “Courier” as the default Trans type. In B2B cases, this field is more relevant. | |
2. (a-d) | Contact Details | Mandatory fields a. Address 1 b. Address 2 c. Country d. State | a & b. Free text field to update the correct address
c. & d. Dropdown boxes to select the correct City & State information | Address1, Address2, Country, and State are mandatory, and must be filled before further configuration. |
2. (e-m) | Other fields like: Address 3, Address 4, Phone, Alternate Phone, Fax, Email, Alternate Email, City & Pin code | Optional fields to update the required information | These are optional fields to provide other contact information. |
User Defined Fields
The user may also add up to 5 custom defined fields for their use in the User Defined Field tab. All these fields are optional.
Configure API Details
Configure the following as needed:
Field | Feature | Details |
AWB Generation Type | It is a drop down list to select the type of AWB number generation. | Enter the following accordingly: 1. Off Line Manifest - The AWB numbers are already acquired beforehand from Delhivery, and saved in Vin e-Retail database. These AWB numbers are then used to track order status of the shipment. 2. Real Time Manifest - The AWB numbers are received from Delhivery when the manifest (booking) details are sent through API. Tracking of the order status of the shipment is done through the AWB number generated by Transporter. |
Multi Box Support | This check box is used to allow Multi-box support for the transporter. | This option allows you to create a master tracking number that ties all included boxes with different child tracking numbers back to the master tracking number. This allows packages that cannot fit in a single box to be shipped and delivered together. |
Create Return on RTO (WMS) | This option is used to create a return order for RTO (Return to Origin) made for any order created via the Warehouse Management System. |
|
Create Return on RTO (SP) | This option is used to create a return order for RTO (Return to Origin) made for any order created via Seller Panel. |
|
External Invoice | This option is used to generate the invoice provided by the B2B shipping partner. | This option is only relevant for B2B transporters. If left unchecked, then the system will generate the eRetail invoice. |
External Shipping Label | This option is used to generate the shipping label provided by the B2B shipping partner. | This option is only relevant for B2B transporters. If left unchecked, then the system will generate the eRetail shipping label. |
Applicable to B2B | This option is used to mark the shipping partner for use in B2B transactions. | This option is mandatory if the transporter must be used for B2B transactions. |
Enable QR Generation | This option is used to allow the QR Code to be printed on the Invoice | Taxpayers having aggregate turnover of more than ₹500 crore require Dynamic QR Code on B2C invoice to avoid penalty. |
Below screen will appear once the AWB generation type is selected with four tabs:
- Tracking API Details
- Manifest API Details
- Pickup API Details
- Reverse Pickup API Details
Tracking API Details
Fill the details as per the information provided in the table.
S.No. | Field | Feature | Details |
3.a.i. | Tracking API Details | It is a check box that enables Tracking API details | Tracking API is used to get the various statuses of an order, e.g. In Transit, Delivered, RTO, etc. Once this checkbox is clicked, the subsequent tabs will be enabled for allowing input. |
3.a.ii. | Tracking Secret Key | It is a mandatory alphanumeric key which is provided by the transporter. | This key is to be obtained from Delhivery. |
3.a.iii. | Tracking Enable Mongo (Y/N) | This text box is used to enable using Mongo Database for the tracking of order status if required. | Enter the following accordingly: “Y” – To enable tracking status from Mongo Database. “N” – To keep using pull tracking status method. |
Manifest API Details
Fill the details as per the information provided in the table.
S.No. | Field | Feature | Details |
3.b.i. | Manifest API Details | It is a check box that enables Manifest API details | Manifest API is mainly used to inform the transporter of the pickup location and the delivery location. Once this checkbox is clicked, the subsequent tabs will be enabled for allowing input. |
3.b.ii. | Order id Replace by Obcode in api request (Y/N) | This field is used to allow replacing the order ID in the API request with Outbound Code, if required.
| Enter the following accordingly: “Y” – To replace the order ID with the outbound code in the API request. “N” – To keep using order ID in the API request. |
3.b.iii. | Replace Wherehouse name from Pickup Name (Y/N) | This field is used to determine where the shipment should be picked from. | Enter the following accordingly: “Y” – To change the name of the warehouse (location name) with a different pickup name. “N” – To keep using warehouse location as the pickup location |
3.b.iv. | Manifest / Serviceability Secret Key | It is a mandatory alphanumeric key which is provided by the transporter. | This key is to be obtained from Delhivery. |
3.b.v. | Pickup Name | This field is used to enter the name of the location that replaces the warehouse for pickup. |
|
Pickup API Details
Fill the details as per the information provided in the table.
S.No. | Field | Feature | Details |
3.c.i. | Pickup API Details | It is a check box that enables Pickup API details. | PickUp API is used to configure for picking up shipment from the warehouse location. Once this checkbox is clicked, the subsequent tabs will be enabled for allowing input. |
3.c.ii. | Pickup Secret Key | It is a mandatory alphanumeric key which is provided by the transporter. | This key is to be obtained from Delhivery. |
3.c.iii. | Pickup Scheduled Time | This is the time at which the transporter may arrive to pick up the shipment. | If the field is blank, then the time will be “12:00:00” PM by default. |
3.c.iv. | CutOff Time | This field is used to enter the cutoff time in hours from the pickup scheduled time, at which the transporter will be notified about the shipment to be picked. | By default, the value is “10”. |
Reverse Pickup API Details
Fill the details as per the information provided in the table.
S.No. | Field | Feature | Details |
3.d.i. | Reverse Pickup API Details | It is a check box that enables Reverse Pickup API details. | Reverse PickUp API is used to send any special instruction for picking up shipment from customers in case of returns. Once this checkbox is clicked, the subsequent tabs will be enabled for allowing input. |
3.d.ii. | Enable QC
| This field is used to allow Quality Check of the shipment by the transporter during returns by customer after sales. | Enter the following accordingly: “Yes” – To enable a quality check by the transporter on the shipment or line item that is to be collected in case of returns by customers. “No” – To bypass the quality check flag. |