.. _create-listings-label: **POST** /listings/v3 --------------------- Summary: Create product listings in Flipkart's Marketplace. Description: This call creates new listings against the specified SKUs. If the SKU already exists in the system, then this call will *overwrite* the listing information associated with it. The rules for listing a product in the marketplace are subject to change, so it is recommended to handle errors explicitly. It is also recommended to call upon the validate API (to be announced) prior to making this call. 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/CreateListingRequest.json :linenos: :language: json **Request field descriptions** The payload is a map of SKU identifiers to their corresponding CreateListingRequest. Max batch size allowed is "10". The fields of the CreateListingRequest 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 | Non-negative 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 at MyListings page. | +---------------------------------------------+-----------------------+-------------+--------------------------------------------------------------------------------------------------------------------------+ | 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[].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 number of items you have in stock. | +---------------------------------------------+-----------------------+-------------+--------------------------------------------------------------------------------------------------------------------------+ | 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 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) | +---------------------------------------------+-----------------------+-------------+--------------------------------------------------------------------------------------------------------------------------+ 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 CreateListingResponse objects. The fields of the CreateListingResponse 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. | +------------------------------------+-------------+-------------+-------------------------------------------------------------------+