Inbound | POST | /usp/bulk/handover

Summary

This API performs bulk manifest creation and handover for multiple shipments in a single request.

Description

This API is used by the External Fulfillment System (EFS) to perform manifest creation and handover for multiple shipments simultaneously. It allows handing over multiple EFS shipment codes to a transporter with associated documentation.

Request Body

{
  "locationCode": "LOC-001",
  "channelName": "USP-Channel",
  "transporter": "BlueDart",
  "efsShipmentCodes": [
    "EFS-SHIP-001",
    "EFS-SHIP-002",
    "EFS-SHIP-003"
  ],
  "ewayBillDocument": "<https://example.com/docs/eway-bill.pdf>",
  "lrNumber": "LR-123456",
  "remarks": "Handle with care",
  "vehicleNumber": "MH12AB1234"
}
Parameter Name Data Type Description Mandatory
locationCode String Identifier of the fulfillment location Yes
channelName String Channel name of the marketplace Yes
transporter String Transporter or courier partner handling the shipments Yes
efsShipmentCodes Array[String] List of EFS shipment codes to handover Yes
ewayBillDocument String URL of the e-way bill document No
lrNumber String Lorry Receipt (LR) number for the shipment No
remarks String Additional remarks or handling notes No
vehicleNumber String Vehicle number for the shipment pickup No

Response Body

{
  "handoverDocumentUrl": "<https://example.com/docs/handover-manifest.pdf>",
  "externalManifestId": "MANIFEST-001"
}

HttpStatus: 200