DHL WayBill Virtual Sandbox
Virtual API for managing DHL and Blue Dart waybill operations.
This API provides endpoints for performing essential waybill operations, including generating new waybills, cancelling existing ones, updating E-way bills, and importing shipment data. It is designed to facilitate integration with DHL and Blue Dart logistics services.
Use this hosted sandbox to simulate DHL WayBill APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready.
This keeps your integration code consistent across local development, QA, demos, and production.
Use cases:
Use this sandbox to validate shipment creation workflows, test payload structures for waybill generation, simulate cancellation requests, verify E-way bill update logic, and handle data import responses before integrating with production logistics systems.
Generate Waybill
POST
{
"Request": {
"Consignee": {
"AvailableDays": "",
"AvailableTiming": "",
"ConsigneeAddress1": "Test Cngee Addr1",
"ConsigneeAddress2": "Test Cngee Addr2",
"ConsigneeAddress3": "Test Cngee Addr3",
"ConsigneeAddressType": "",
"ConsigneeAddressinfo": "",
"ConsigneeAttention": "ABCD",
"ConsigneeEmailID": "testemail@bluedart.com",
"ConsigneeFullAddress": "",
"ConsigneeGSTNumber": "",
"ConsigneeLatitude": "",
"ConsigneeLongitude": "",
"ConsigneeMaskedContactNumber": "",
"ConsigneeMobile": "9995554441",
"ConsigneeName": "Test Consignee Name",
"ConsigneePincode": "110027",
"ConsigneeTelephone": ""
},
"Returnadds": {
"ManifestNumber": "",
"ReturnAddress1": "Test RTO Addr1",
"ReturnAddress2": "Test RTO Addr2",
"ReturnAddress3": "Test RTO Addr3",
"ReturnAddressinfo": "",
"ReturnContact": "Test RTO",
"ReturnEmailID": "testemail@bluedart.com",
"ReturnLatitude": "",
"ReturnLongitude": "",
"ReturnMaskedContactNumber": "",
"ReturnMobile": "9995554447",
"ReturnPincode": "400057",
"ReturnTelephone": ""
},
"Services": {
"AWBNo": "",
"ActualWeight": "0.50",
"CollectableAmount": 0,
"Commodity": {
"CommodityDetail1": "Test1",
"CommodityDetail2": "Test2",
"CommodityDetail3": "Test3"
},
"CreditReferenceNo": "TestCrR4e3342",
"CreditReferenceNo2": "",
"CreditReferenceNo3": "",
"DeclaredValue": 100,
"DeliveryTimeSlot": "",
"Dimensions": [
{
"Breadth": 32.7,
"Count": 1,
"Height": 3.2,
"Length": 28.9
}
],
"FavouringName": "",
"IsDedicatedDeliveryNetwork": false,
"IsDutyTaxPaidByShipper": false,
"IsForcePickup": false,
"IsPartialPickup": false,
"IsReversePickup": true,
"ItemCount": 1,
"Officecutofftime": "",
"PDFOutputNotRequired": true,
"PackType": "",
"ParcelShopCode": "",
"PayableAt": "",
"PickupDate": "/Date(1683365079000)/",
"PickupMode": "",
"PickupTime": "1600",
"PickupType": "",
"PieceCount": "1",
"PreferredPickupTimeSlot": "",
"ProductCode": "A",
"ProductFeature": "",
"ProductType": 1,
"RegisterPickup": true,
"SpecialInstruction": "",
"SubProductCode": "P",
"TotalCashPaytoCustomer": 0,
"itemdtl": [
{
"CGSTAmount": 0,
"HSCode": "",
"IGSTAmount": 0,
"Instruction": "",
"InvoiceDate": "/Date(1685117940594)/",
"InvoiceNumber": "",
"ItemID": "Test Item ID1",
"ItemName": "Test Item1",
"ItemValue": 100,
"Itemquantity": 1,
"PlaceofSupply": "",
"ProductDesc1": "",
"ProductDesc2": "",
"ReturnReason": "",
"SGSTAmount": 0,
"SKUNumber": "",
"SellerGSTNNumber": "",
"SellerName": "",
"SubProduct1": "Test Sub 1",
"SubProduct2": "Test Sub 2",
"TaxableAmount": 0,
"TotalValue": 100,
"cessAmount": "0.0",
"countryOfOrigin": "",
"docType": "",
"subSupplyType": 0,
"supplyType": ""
}
],
"noOfDCGiven": 0
},
"Shipper": {
"CustomerAddress1": "Test Cust Addr1",
"CustomerAddress2": "Test Cust Addr2",
"CustomerAddress3": "Test Cust Addr3",
"CustomerAddressinfo": "",
"CustomerBusinessPartyTypeCode": "",
"CustomerCode": "246525",
"CustomerEmailID": "TestCustEmail@bd.com",
"CustomerGSTNumber": "",
"CustomerLatitude": "",
"CustomerLongitude": "",
"CustomerMaskedContactNumber": "",
"CustomerMobile": "9996665554",
"CustomerName": "Test Cust Name",
"CustomerPincode": "122002",
"CustomerTelephone": "",
"IsToPayCustomer": true,
"OriginArea": "DEL",
"Sender": "TestRvp",
"VendorCode": ""
}
},
"Profile": {
"LoginID": "APIID",
"LicenceKey": "APIKEY",
"Api_type": "S"
}
}{
"GenerateWayBillResult": {
"AWBNo": "",
"AWBPrintContent": null,
"AvailableAmountForBooking": 0,
"AvailableBalance": 0,
"CCRCRDREF": "TestCrFrR8",
"ClusterCode": null,
"DestinationArea": null,
"DestinationLocation": null,
"IsError": true,
"IsErrorInPU": false,
"Status": [
{
"StatusCode": "InvalidPickupDate",
"StatusInformation": "Invalid Pickup Date. < 08/02/2023"
}
],
"TokenNumber": null,
"TransactionAmount": 0
}
}{
"status": 400,
"title": "Bad Request",
"error-response": "Request validation error.Please check the request payload."
}{
"status": 401,
"title": "Unauthorized",
"error-response": "Access to the resource is not allowed."
}Cancel Waybill
POST
{
"Request": {
"AWBNo": "89186876973"
},
"Profile": {
"Api_type": "S",
"LicenceKey": "APIKEY",
"LoginID": "APIID" }
}{
"CancelWaybillResult": {
"AWBNo": "89186876973",
"CCRCRDREF": null,
"IsError": true,
"Status": [
{
"StatusCode": "CancelFailure",
"StatusInformation": "Waybill Number has been already cancelled."
}
]
}
}{
"status": 400,
"title": "Bad Request",
"error-response": "Request validation error.Please check the request payload."
}{
"status": 401,
"title": "Unauthorized",
"error-response": "Access to the resource is not allowed."
}Update E-wayBill
POST
{
"ERequest": {
"InvoiceDate": "/Date(1684748434000)/",
"InvoiceNumber": "Test Inv1",
"SellerGSTNo": "09565720209C",
"Waybillnumber": "20470326332",
"eWaybillDate": "/Date(1684748434000)/",
"eWaybillNumber": "125478547851"
},
"Profile": {
"Api_type": "S",
"LicenceKey": "APIKEY",
"LoginID": "APIID"
}
}{
"UpdateEwayBillResult": {
"IsError": false,
"Status": [
{
"StatusCode": "Valid",
"StatusInformation": "EWaybill details updated successfully"
}
]
}
}{
"status": 400,
"title": "Bad Request",
"error-response": "Request validation error.Please check the request payload."
}{
"status": 401,
"title": "Unauthorized",
"error-response": "Access to the resource is not allowed."
}Import data
POST
{
"Request": [
{
"Consignee": {
"AvailableDays": "",
"AvailableTiming": "",
"ConsigneeAddress1": "Test Cngee Addr1",
"ConsigneeAddress2": "Test Cngee Addr2",
"ConsigneeAddress3": "Test Cngee Addr3",
"ConsigneeAddressType": "",
"ConsigneeAddressinfo": "",
"ConsigneeAttention": "ABCD",
"ConsigneeEmailID": "testemail@bluedart.com",
"ConsigneeFullAddress": "",
"ConsigneeGSTNumber": "",
"ConsigneeLatitude": "",
"ConsigneeLongitude": "",
"ConsigneeMaskedContactNumber": "",
"ConsigneeMobile": "9995554441",
"ConsigneeName": "Test Consignee Name",
"ConsigneePincode": "110027",
"ConsigneeTelephone": ""
},
"Returnadds": {
"ManifestNumber": "",
"ReturnAddress1": "Test RTO Addr1",
"ReturnAddress2": "Test RTO Addr2",
"ReturnAddress3": "Test RTO Addr3",
"ReturnAddressinfo": "",
"ReturnContact": "Test RTO",
"ReturnEmailID": "testemail@bluedart.com",
"ReturnLatitude": "",
"ReturnLongitude": "",
"ReturnMaskedContactNumber": "",
"ReturnMobile": "9995554447",
"ReturnPincode": "400057",
"ReturnTelephone": ""
},
"Services": {
"AWBNo": "",
"ActualWeight": "0.50",
"CollectableAmount": 0,
"Commodity": {
"CommodityDetail1": "Test1",
"CommodityDetail2": "Test2",
"CommodityDetail3": "Test3"
},
"CreditReferenceNo": "TessstCrR4e32",
"CreditReferenceNo2": "",
"CreditReferenceNo3": "",
"DeclaredValue": 100,
"DeliveryTimeSlot": "",
"Dimensions": [
{
"Breadth": 32.7,
"Count": 1,
"Height": 3.2,
"Length": 28.9
}
],
"FavouringName": "",
"IsDedicatedDeliveryNetwork": false,
"IsDutyTaxPaidByShipper": false,
"IsForcePickup": false,
"IsPartialPickup": false,
"IsReversePickup": true,
"ItemCount": 1,
"Officecutofftime": "",
"OrderURL": "",
"PDFOutputNotRequired": true,
"PackType": "",
"ParcelShopCode": "",
"PayableAt": "",
"PickupDate": "/Date(1683365079000)/",
"PickupMode": "",
"PickupTime": "1600",
"PickupType": "",
"PieceCount": "1",
"PreferredPickupTimeSlot": "",
"ProductCode": "A",
"ProductFeature": "",
"ProductType": 1,
"RegisterPickup": true,
"SpecialInstruction": "",
"SubProductCode": "P",
"TotalCashPaytoCustomer": 0,
"itemdtl": [
{
"CGSTAmount": 0,
"HSCode": "",
"IGSTAmount": 0,
"Instruction": "",
"InvoiceNumber": "212222",
"InvoiceDate": "/Date(1685117940594)/",
"ItemID": "Test Item ID1",
"ItemName": "Test Item1",
"ItemValue": 100,
"Itemquantity": 1,
"PlaceofSupply": "",
"ProductDesc1": "",
"ProductDesc2": "",
"ReturnReason": "",
"SGSTAmount": 0,
"SKUNumber": "",
"SellerGSTNNumber": "",
"SellerName": "",
"SubProduct1": "Test Sub 1",
"SubProduct2": "Test Sub 2",
"TaxableAmount": 0,
"TotalValue": 100,
"cessAmount": "0.0",
"countryOfOrigin": "IN",
"docType": "INV",
"subSupplyType": 7,
"supplyType": "I"
}
],
"noOfDCGiven": 0
},
"Shipper": {
"CustomerAddress1": "Test Cust Addr1",
"CustomerAddress2": "Test Cust Addr2",
"CustomerAddress3": "Test Cust Addr3",
"CustomerAddressinfo": "",
"CustomerBusinessPartyTypeCode": "",
"CustomerCode": "246525",
"CustomerEmailID": "TestCustEmail@bd.com",
"CustomerGSTNumber": "",
"CustomerLatitude": "",
"CustomerLongitude": "",
"CustomerMaskedContactNumber": "",
"CustomerMobile": "9996665554",
"CustomerName": "Test Cust Name",
"CustomerPincode": "122002",
"CustomerTelephone": "",
"IsToPayCustomer": true,
"OriginArea": "DEL",
"Sender": "TestRvp",
"VendorCode": ""
}
}
],
"Profile": {
"LoginID": "APIID",
"LicenceKey": "APIKEY",
"Api_type": "S"
}
}{
"GenerateWayBillResult": {
"AWBNo": "",
"AWBPrintContent": null,
"AvailableAmountForBooking": 0,
"AvailableBalance": 0,
"CCRCRDREF": "TestCrFrR8",
"ClusterCode": null,
"DestinationArea": null,
"DestinationLocation": null,
"IsError": true,
"IsErrorInPU": false,
"Status": [
{
"StatusCode": "InvalidPickupDate",
"StatusInformation": "Invalid Pickup Date. < 08/02/2023"
}
],
"TokenNumber": null,
"TransactionAmount": 0
}
}{
"status": 400,
"title": "Bad Request",
"error-response": "Request validation error.Please check the request payload."
}{
"status": 401,
"title": "Unauthorized",
"error-response": "Access to the resource is not allowed."
}dhllogisticsshippingwaybillbluedart