.. _update-listings-label: **POST** /listings/v3/update ---------------------------- Summary: Update product listings in Flipkart's Marketplace. Description: This call updates listings against the specified SKUs. If the SKU doesn't exist in the system, then an error will be returned against the SKU. The values that the listing attributes can take can change with time and selling constructs. It is recommended to explicitly handle errors and warnings returned by this API. In addition to the authorization header, which is required for all Flipkart REST API calls, the following table includes additional headers required by this call: +--------------+---------------------------------------------------------+----------+---------------------------------+ | Header | Description | Required | Allowed Values | +==============+=========================================================+==========+=================================+ | Content-Type | The MIME type of the body of the request. Must be JSON. | Yes | application/json; charset=utf-8 | +--------------+---------------------------------------------------------+----------+---------------------------------+ Input: .. container:: toggle .. container:: header ☰ Toggle **Payload Model** .. literalinclude:: v3/payloads/UpdateListingRequest.json :linenos: :language: json **Request field descriptions** The payload is a map of SKU identifiers to their corresponding UpdateListingRequest. Max batch size allowed is "10". The fields of the UpdateListingRequest are described in the table below. +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | Field | Type | Occurrence | Description | +=============================================+=======================+=============+=========================================================================================================================+ | product_id | String | Mandatory | This is the product's identifier in the Flipkart Marketplace. Length Range -> 13 to 16 characters. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | price.mrp | Non-negative Integer | Mandatory | The maximum retail price for the product | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | price.sellingPrice | Positive Integer | Mandatory | Your selling price for the product | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | tax.hsn | String | Mandatory | The Harmonized System Nomenclature for the product used to determine applicable tax rate | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | tax.tax_code | String | Mandatory | Flipkart’s tax code which decides the goods and services tax for the listing. Each tax_code internally maps to a | | | | | Goods Services Tax (GST). Eg, tax_code GST_0 maps to 0% tax and GST_APPAREL maps to GST of apparels according to the | | | | | final cart value. All tax-codes are available below. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | listing_status | Enumeration | Mandatory | Controls the listing's visibility in the marketplace. Values can be ACTIVE, INACTIVE. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | shipping_fees.local | Non-negative Integer | Conditional | Delivery charge you want charge a buyer in the same city for listings which are not Flipkart Assured | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | shipping_fees.zonal | Non-negative Integer | Conditional | Delivery charge you want charge a buyer outside your zone for listings which are not Flipkart Assured | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | shipping_fees.national | Non-negative Integer | Conditional | Delivery charge you want charge a buyer outside your zone for listings which are not Flipkart Assured | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | fulfillment_profile | Enumeration | Mandatory | Fulfillment method for the listing | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | fulfillment.dispatch_sla | None-negative Integer | Conditional | Time required to keep the product ready for dispatch | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | fulfillment.shipping_provider | Enumeration | Mandatory | Information on who will ship the item to the customer | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | fulfillment.procurement_type | Enumeration | Mandatory | Information on how the inventory is procured by the seller to fulfill an order | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages | Array | Conditional | The physical package configuration of the lot. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].id | String | Mandatory | Flipkart system identifier for the package. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].name | String | Mandatory | Your identifier for the package. Max length: 64 | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].dimensions | Dimension | Conditional | The dimension of the package | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].dimensions.length | Non-negative Decimal | Mandatory | The length of the package in centimeters. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].dimensions.breadth | Non-negative Decimal | Mandatory | The breadth of the package in centimeters. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].dimensions.height | Non-negative Decimal | Mandatory | The height of the package in centimeters. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].weight | Non-negative Decimal | Conditional | The weight of the package. It is mandatory to specify it in case dimensions are defined. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].description | String | Conditional | The description of the package. It can be used to display additional information to the customer on the product page. | | | | | Max length: 4000 | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].handling | Handling | Conditional | Handling information to be transmitted to the configured logistics provider. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].handling.fragile | Boolean | Conditional | Signals that the package contains fragile items. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].notional_value | NotionalValue | Conditional | The part-value of the package. It is mandatory to define it if the lot has multiple packages. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].notional_value.amount | Non-negative Integer | Mandatory | The value amount. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | packages[].notional_value.unit | Enumeration | Mandatory | The unit of the amount. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | locations | Array | Mandatory | Your selling locations for this listing. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | locations[].id | String | Mandatory | The location ID obtained via the Onboarding API. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | locations[].status | Enumeration | Mandatory | Controls the fulfillment of the product at this location. If disabled, then orders will not be fulfilled from this | | | | | location. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | locations[].inventory | Non-negative Integer | Mandatory | The available inventory at this location. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | address_label.manufacturer_details | Array | Mandatory | Name and address of the manufacturer | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | address_label.importer_details | Array | Conditional | Name and address of the importer if the product is being imported. Mandatory if country of origin is not (IN)India. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | address_label.packer_details | Array | Mandatory | Where manufacturer is not the packer, name and address of the packer | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | address_label.countries_of_origin | Array | Mandatory | ISO-2 code of the Country of Origin or manufacturing or country of assembly in | | | | | case of imported products (Eg: IN for India, US for United States Of America) | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | dating_label.mfg_date | Positive | Conditional | Date in EPOCH (seconds) on which the product was manufactured or prepacked or imported. | | | Integer | | For products where day is not available, please put the manufacturing date as 1st of the month. | | | | | Eg, 01/01/2018 converted to EPOCH (1514745000) for a product manufactured in Jan 2018. | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | dating_label.shelf_life | Positive Integer | Conditional | Duration (in seconds) from the date of manufacturing beyond which the product shall not have the quality attributes | | | | | normally expected by the consumers and the commodity should not be regarded as marketable. | | | | | Maximum allowed value is 155520000 seconds (60 months) | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ | archived_status | Enumeration | Optional | To Archive listing, value -> ARCHIVED or NONE | +---------------------------------------------+-----------------------+-------------+-------------------------------------------------------------------------------------------------------------------------+ GST Tax Codes: These are the valid GST tax codes that can be used in the ``tax.tax_code`` field: +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New/Old | Tax ID | Description | +=============================+==================+===========================================================================================+ | Existing | GST_0 | 0% GST will be applied for your products | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | Existing | GST_3 | 3% GST will be applied for your products | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | Existing | GST_5 | 5% GST will be applied for your products | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | Existing | GST_12 | 12% GST will be applied for your products | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | Existing | GST_18 | 18% GST will be applied for your products | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | Existing | GST_28 | 28% GST will be applied for your products | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | Existing | GST_APPAREL | The GST rate for apparel depends on the price. The relevant GST rate will be determined | | | | and automatically applied based on the order item value. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Footwear | The GST rate for footwear depends on the price. The relevant GST rate will be determined | | | | and automatically applied based on the order item value. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_40 | 40% GST will be applied for your products | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_5_New_18 | 5% GST will be applied to your product until September 21, 11:59 PM, and 18% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_5_New_0 | 5% GST will be applied to your product until September 21, 11:59 PM, and 0% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_12_New_5 | 12% GST will be applied to your product until September 21, 11:59 PM, and 5% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_12_new_18| 12% GST will be applied to your product until September 21, 11:59 PM, and 18% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_12_New_0 | 12% GST will be applied to your product until September 21, 11:59 PM, and 0% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_18_New_5 | 18% GST will be applied to your product until September 21, 11:59 PM, and 5% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_18_New_40| 18% GST will be applied to your product until September 21, 11:59 PM, and 40% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_18_New_0 | 18% GST will be applied to your product until September 21, 11:59 PM, and 0% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_28_New_18| 28% GST will be applied to your product until September 21, 11:59 PM, and 18% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_28_New_40| 28% GST will be applied to your product until September 21, 11:59 PM, and 40% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ | New | GST_Old_28_New_5 | 28% GST will be applied to your product until September 21, 11:59 PM, and 5% from | | | | September 22, 00:00 hours. | +-----------------------------+------------------+-------------------------------------------------------------------------------------------+ Output: .. container:: toggle .. container:: header ☰ Toggle **Response Headers** +--------------+---------------------------------+ | Header | Meaning | +==============+=================================+ | Content-Type | application/json; charset=utf-8 | +--------------+---------------------------------+ **Status Codes** This call may return the HTTP status codes defined in the table below. +--------+----------------------+ | Status | Interpretation | +========+======================+ | 200 | Success. Individual | | | SKUs may have | | | failed. The | | | ``status`` field | | | has to be tested to | | | determine the actual | | | result. | +--------+----------------------+ | 400 | Bad Request | +--------+----------------------+ | 500 | Internal Server | | | Error | +--------+----------------------+ **Payload Model** 1. 200 OK .. literalinclude:: v3/payloads/ListingChangeResponse.json :linenos: :language: json 2. 400 Bad Request .. literalinclude:: v3/payloads/ClientErrorResponse.json :linenos: :language: json 3. 500 Bad Request .. literalinclude:: v3/payloads/ServerErrorResponse.json :linenos: :language: json **Response field descriptions** The response is a map of SKU identifiers to their corresponding UpdateListingResponse objects. The fields of the UpdateListingResponse are defined in the table below. +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | Field | Type | Occurrence | Description | +====================================+=============+=============+===================================================================+ | status | Enumeration | Mandatory | Indicates the status of the request. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | errors | Array | Conditional | Indicates errors encountered while processing the request, if | | | | | any. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | errors[].severity | Enumeration | Mandatory | The severity of the error. Warnings may require no further | | | | | action. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | errors[].code | Integer | Mandatory | The error code. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | errors[].description | String | Mandatory | The error description. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | attribute_errors | Array | Conditional | Indicates validation errors tied to a specified request | | | | | attribute. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | attribute_errors[].severity | Enumeration | Mandatory | The severity of the error. Warnings may require no further | | | | | action. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | attribute_errors[].code | Integer | Mandatory | The error code. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | attribute_errors[].description | String | Mandatory | The error description. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+ | attribute_errors[].path | String | Mandatory | The JSON path to the attribute. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+