POST /v3/shipments/selfShip/dispatch¶
Description - Self Ship API to mark items as dispatched from the seller warehouse. In addition to marking items as dispatched from the warehouse, seller must enter invoice details. Flipkart now supports automated shipment status updates from select logistics vendors, with tracking IDs validated to support this feature. Note: The Allowed vendor list
Self Ship API provides a list of allowed logistics vendors for a seller, returning two parameters: name
(used as deliveryPartner
in the the Self Ship Dispatch API) and vendorcode
(used as deliveryPartnerCode
in the the Self Ship Dispatch API)
Request and Response Parameters¶
URL: https://api.flipkart.net/sellers/v3/shipments/selfShip/dispatch
Request Body Parameters: shipments
Parameter/Attribute | Type | Requirement | Description |
---|---|---|---|
shipmentId |
String | Mandatory | Primary identifier for a specific shipment |
tentativeDeliveryDate |
DateTime | Mandatory | The anticipated delivery date .
Tentative Delivery Date should not be before Today’s date |
dispatchDate |
DateTime | Mandatory | Date by which the order items are dispatched by the seller. Dispatch Date should not be after Today’s date |
deliveryPartner |
String | Optional | Name of Logistics Partner |
deliveryPartnerCode |
String | Mandatory | Delivery Partner Code |
trackingId |
String | Optional | Pick up courier tracking id |
locationId |
String | Optional | Id which refers to seller’s dispatch location |
invoice.invoiceNumber |
String | Optional | Invoice Number |
invoice.items |
List | Mandatory | Comma separated list of invoice Items |
invoice.invoiceDate |
DateTime | Mandatory | Invoice Date |
invoice.items.orderItemId |
String | Mandatory | Order Item Id |
invoice.items.quantity |
Number | Mandatory | Order Items quantity |
invoice.items.serialNumbers |
List<List<String>> | Optional | Serial Numbers |
dispatchLocation.locationId |
String | Mandatory | Dispatch Location Id |
dispatchLocation.address.address1 |
String | Mandatory | Dispatch Address 1 |
dispatchLocation.address.address2 |
String | Optional | Dispatch Address 2 |
dispatchLocation.address.landmark |
String | Optional | Dispatch Landmark |
dispatchLocation.address.city |
String | Mandatory | Dispatch City |
dispatchLocation.address.state |
String | Optional | Dispatch State |
dispatchLocation.address.pincode |
String | Optional | Dispatch Pincode |
Validations
shipmentIds: should be valid shipment ids for this seller.
Maximum 100 shipments per request.
Response Body Parameters:
Parameter/Attribute | Type | Description |
---|---|---|
shipments . shipmentId |
String | Primary identifier for a specific shipment. |
shipments . processingStatus |
String | SUCCESS or FAILURE |
shipments . errorCode |
String | Error code for any error |
shipments . errorMessage |
String | Error message |
Possible Error Response Codes
Error Codes | Reason for Error |
---|---|
DEPENDENT_SYSTEM_CALL_FAILED |
Error in marking items as dispatched. |
UNPROCESSABLE_ENTITY |
When invalid request is received i.e, when some mandatory requirement validations are failed. |