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:
☰ Toggle

Payload Model

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.

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:
☰ 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
  1. 400 Bad Request
  1. 500 Bad Request

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.