POST /orders/labels¶
Description - The Label Generation API (also known as the Pack API) generates invoice and shipping labels for the order items and marks order items as packed. It takes the invoice details in the request as input. If the orderItemId requires a serial number or IMEI number (also known as serialized product), that input is also required when calling this API.
Request and Response Parameters¶
☰ SHOW | HIDE
URL: https://api.flipkart.net/sellers/v2/orders/labels
Request Body Parameter
| Parameter | Type | Requirement | Description |
|---|---|---|---|
orderItemID |
String | Mandatory | The orderItemId of the
primary item |
serialNumbers |
|
Mandatory if the item needs FSN (IMEI) else, Optional | To specify FSN, ISBN or IMEI, as applicable |
invoiceDate |
ISO String | Mandatory | Date on which the seller invoice was generated |
invoiceNumber |
String | Optional | Invoice number |
taxRate |
Numeric | Mandatory | Tax rate for the item |
subItems |
List | Optional | List of freebies items and details returned by the POST /orders/search |
Validations
orderItemId: should be a valid order item id for this seller.
invoiceDate: should be a valid date in the format YYYY-MM-DD and should be between order date and current date
taxRate: should be a value between 0 and 100.
Maximum 100 order item ids per request.
Response Structure
| Response Code | Description |
|---|---|
| 200 | The label generation request processed succesfully. Response object contains details about validations. |
Possible Error Response Codes
| Error Codes | Reason for Error |
|---|---|
INVALID_REQUEST_ITEM_ID |
Item ID passed in the request does not exist |
INVALID_REQUEST_TAX |
Validation failure for the tax value |
INVALID_ITEM_STATE |
Order item is not ready to be packed |
INVALID_REQUEST_JSON |
JSON parsing failure of the request |
INVALID_REQUEST_DATE_FORMAT |
Parsing failure of the invoice date format (should be YYYY:MM:DD) |
UNPROCESSABLE_ENTITY |
When invalid request is received i.e, when some mandatory requirement validations are failed. |