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

☰ SHOW | HIDE

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.

Try it out!