.. _shipmentPack-label: POST /v3/shipments/labels ------------------------ **Description** - The Label Generation API (also known as the Pack API) generates invoice and shipping labels for the shipment ids and marks shipments 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 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: toggle .. container:: header **☰ SHOW | HIDE** **URL:** ``https://api.flipkart.net/sellers/v3/shipments/labels`` **Request Body Parameter** +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | Parameter/Attribute | Type | Requirement | Description | +===============================================+=========================+======================================+===============================================================================+ | ``shipments`` | List of shipments | Mandatory | List of shipment ids for pack | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``shipmentId`` | String | Mandatory | Unique number that identifies the shipment. | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``locationId`` | String | Mandatory | Id which refers to seller's dispatch location. | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``taxItems`` | List of tax items | Mandatory | List of taxable items | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``taxItems``. ``orderItemId`` | String | Mandatory | The orderItemId of the primary shipment Item. | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``taxItems``. ``purchasePrice`` + Numeric + Optional + Purchase price of the item (only to be passed for refurbished products) + +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``taxItems``. ``taxRate`` | Numeric | Mandatory | Tax Rate for the Item | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``taxItems``. ``quantity`` | Numeric | Mandatory | Quantity of items to be shipped. | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``serialNumbers`` | List of serial numbers | Mandatory only if item is serialized | Serial number array for serialized products | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``serialNumbers``. ``orderItemId`` | String | Mandatory | ``orderItemId`` for which serial number is being input | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``serialNumbers``. ``serialNumbers`` | List> | Mandatory | ``serialNumbers`` for the given order item id | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``subShipments`` | List of sub shipments | Mandatory | List of ``subShipments`` associated with the shipment | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``subShipments``. ``subShipment`` | String | Mandatory | Primary identifier for a specific sub shipment. | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``subShipments``. ``dimensions``. ``length`` | Float | Mandatory | Length of the sub-shipment | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``subShipments``. ``dimensions``. ``breadth`` | Float | Mandatory | Breadth of the sub-shipment | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``subShipments``. ``dimensions``. ``height`` | Float | Mandatory | Height of the sub-shipment | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``subShipments``. ``dimensions``. ``width`` | Float | Mandatory | Width of the sub-shipment | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``invoices`` | List of invoice details | Mandatory | Invoice details for the shipment | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``invoices``. ``orderId`` | String | Mandatory | Order id to which particular order item is associated. | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``invoices``. ``invoiceNumber`` | String | Optional | If the seller has not opted for auto invoicing, then this field is mandatory. | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ | ``invoices``. ``invoiceDate`` | Date | Mandatory | Invoice date | +-----------------------------------------------+-------------------------+--------------------------------------+-------------------------------------------------------------------------------+ **Validations** :: ShipmentId and Sub Shipment Id is mandatory. Order Item id is mandatory. Dimensions are mandatory and should be a positive value. For multiline orders, Pass the LBHW attributes of the the order_item which has the maximum value in the order. GST information must be part of taxItems **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 | +-------------------------------------+--------+---------------------------------------------+ ======================================= ========================= Error Codes Reason for Error ======================================= ========================= ``ITEM_ON_HOLD`` Error if shipment is on hold ``INVALID_PACK_REQUEST`` If all the order items inside shipment are not in approved state ``INCOMPLETE_SHIPMENT_DIMENSIONS`` Invalid dimensions given for particular sub shipment ``SERVICEABILITY_NOT_ALLOWED`` Serviceability not allowed from seller location to buyer location ``SELLER_TIN_NOT_FOUND`` Seller TIN number not found ``INVALID_DISPATCH_AFTER_DATE`` Dispatch After Date is greater than current time of pack ``PACK_OPERATION_NOT_AUTHORISED`` Seller not authorised for packing the shipment ``INVALID_IMEI_NUMBER`` Invalid IMEI number given for any serialised products ``WEIGHT_ANOMALY_ERROR`` Error in dimension details for given shipments ``WEIGHT_ANOMALY_WARNING`` Warning in dimension details for given shipments ``PACK_GSTIN_NOT_FOUND`` Please check and update your GSTIN ``INVALID_PACK_CHANNEL`` When pack channel is not supported for shipment type and service profile ``DUPLICATE_PACK_REQUEST`` When Earlier Pack Request Still in Processing ``INVALID_LOCATION`` When Shipment does not belong to this location, please cross check from Get shipment details api ``INVALID_PURCHASE_PRICE`` When Purchase Price present for non-refurbished verticals or not valid purchase price for order item id’s ``INVALID_PACKAGE_DIMENSION`` Package dimensions too big to be serviceable. Please re-check your packaging under My Listings tab at the time of order placement ======================================= ========================= | `Try it out! `_ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |