Listing Management API Reference

You can use the following APIs to create, get, or update various product stock and listing related details.

POST skus/{SKUID}/listings

Description - Create and update listing attributes such as stock, price, and procurement SLA, for a particular skuId.

Request and Response Parameters

☰ SHOW | HIDE

Path parameter: SKUID

Body parameter: listingRequest (listingID or skuId is not mandatory as the SKU ID is passed in the URL)

URL: https://api.flipkart.net/sellers/skus/SKUID/listings

Headers: Content-type:application/json

Response: StatusOutput


Examples

☰ SHOW | HIDE

Example 1 - Create Listing

Success: HTTP code 2xx

Request: https://api.flipkart.net/sellers/skus/SKUID/listings

{
    "fsn": "TSHEEG86JGBEABHS",
    "skuId": "P9_30Dec_20000942",
    "attributeValues": {
        "mrp": 140,
        "selling_price": "130",
        "listing_status": "INACTIVE",
        "fulfilled_by": "seller",
        "procurement_sla": "3",
        "stock_count": "23",
        "selling_region_restriction": "none",
        "procurement_type": "REGULAR"
    }
}

Response:

{
    "status": "success"
    "response": {
        "skuId": "P9_30Dec_20000942"
        "listingId": "LSTTSHEEG86JGBEABHSMWPX8X"
        "status": "created"
        "errors": [0]
    }
}

Example 2 - Update Listing

Success: HTTP code 2xx

Request: https://api.flipkart.net/sellers/skus/SKUID/listings

{
    "fsn": "TSHEEG86JGBEABHS",
    "skuId": "P9_30Dec_20000942",
    "attributeValues": {
        "mrp": 140,
        "selling_price": "130",
        "listing_status": "INACTIVE",
        "fulfilled_by": "seller",
        "procurement_sla": "3",
        "stock_count": "23",
        "selling_region_restriction": "none",
        "procurement_type": "REGULAR"
    }
}

Response:

{
    "status": "success"
    "response": {
        "skuId": "P9_30Dec_20000942"
        "listingId": "LSTTSHEEG86JGBEABHSR68Y9G"
        "status": "updated"
        "errors": [0]
    }
}

Failure: HTTP code 4xx, 5xx

Request: https://api.flipkart.net/sellers/skus/SKUID/listings

{
    "listingId": "LISTINGID",
    "skuId": "SKUID",
    "attributeValues": {
        "mrp": 100,
        "selling_price": 120,
        "stock_count": 185
    }
}

Response:

{
    "status": "failure",
    "response": {
        "skuId": "SKUID",
        "listingId": "LISTINGID",
        "status": "failure",
        "errors": [
        {
            "errorCode": "GREATER_THAN_UPPER_BOUND",
            "message": "Your Stock Count can not be more than 50. For more details please check Flipkart Marketplace Selling Policies.",
            "attributeName": "stock_count"
        },
        {
            "errorCode": "FSP_MORE_THAN_MRP",
            "message": "Your Selling Price should never be greater than MRP.",
            "attributeName": "selling_price"
        }
        ]
    }
}


POST skus/listings/{LISTINGID}

Description - Update listing attributes such as stock, price, and pocurement SLA for a particular ListingID.

Request and Response Parameters

☰ SHOW | HIDE

Path Parameter: ListingID

Body Parameter: listingRequest (listingID or skuId is not mandatory as the Listing ID is passed in the URL)

URL: https://api.flipkart.net/sellers/skus/listings/LISTINGID

Headers: Content-type:application/json

Response: StatusOutput


Example

☰ SHOW | HIDE

Success: HTTP code 2xx

Request: https://api.flipkart.net/sellers/skus/listings/LISTINGID

{
    "skuId": "SKUID",
    "attributeValues": {
        "mrp": 140,
        "selling_price": 120,
        "procurement_type": "REGULAR"
    }
}

Response:

{
    "status": "success",
    "response": {
        "skuId": "SKUID",
        "listingId": "LISTINGID",
        "status": "updated",
        "errors": []
    }
}

Failure: HTTP code 4xx, 5xx

Request: https://api.flipkart.net/sellers/skus/listings/LISTINGID

{
    "skuId": "SKUID",
    "attributeValues": {
        "mrp": ABCD,
        "selling_price": 120,
        "procurement_type": "REGULAR"
    }
}

Response:

{
    "status": "failure",
    "response": {
        "skuId": "SKUID",
        "listingId": "LISTINGID",
        "errors": [{
            "errorCode": "INVALID_MRP",
            "message": "MRP is not a valid number"
        }]
    }
}


POST skus/listings/bulk

Description - Create and update listing attributes such as stock, price, and procurement SLA for multiple SKUs. A maximum of 10 listings can be updated.

Request and Response Parameters

☰ SHOW | HIDE

Body Parameter: BulkListingRequest (either listingId or skuId is mandatory)

URL: https://api.flipkart.net/sellers/skus/listings/bulk

Headers: Content-type:application/json

Response: BulkStatusOutput


Examples

☰ SHOW | HIDE

Example 1 - Create Bulk Listing

Success: HTTP code 2xx

Request: https://api.flipkart.net/sellers/skus/listings/bulk

{
    "listings": [
    {
        "skuId": "SKUID1",
        "fsn": "FSN1",
        "attributeValues": {
            "mrp": "2400",
            "selling_price": "2300",
            "listing_status": "INACTIVE",
            "fulfilled_by": "seller",
            "national_shipping_charge": "20",
            "zonal_shipping_charge": "20",
            "local_shipping_charge": "20",
            "procurement_sla": "3",
            "stock_count": "23",
            "procurement_type": "REGULAR"
        }
    },
    {
        "skuId": "SKUID2",
        "fsn": "FSN2",
        "attributeValues": {
            "mrp": "2400",
            "selling_price": "2300",
            "listing_status": "INACTIVE",
            "fulfilled_by": "seller",
            "national_shipping_charge": "20",
            "zonal_shipping_charge": "20",
            "local_shipping_charge": "20",
            "procurement_sla": "3",
            "stock_count": "23",
            "procurement_type": "REGULAR"
        }
    }
    ]
}

Response:

{
    "status": "success",
    "response": [
    {
        "skuId": "SKUID1",
        "listingId": "LISTINGID1",
        "status": "created",
        "errors": []
    },
    {
        "skuId": "SKUID2",
        "listingId": "LISTINGID2",
        "status": "created",
        "errors": []
    }
    ]
}

Example 2 - Update Listing

Success: HTTP code 2xx

Request: https://api.flipkart.net/sellers/skus/listings/bulk

{
    "listings": [
    {
        "listingId": "LISTINGID1",
        "skuId": "SKUID1",
        "fsn": "FSN1",
        "attributeValues": {
            "mrp": "2400",
            "selling_price": "2300",
            "listing_status": "INACTIVE",
            "fulfilled_by": "seller",
            "national_shipping_charge": "20",
            "zonal_shipping_charge": "20",
            "local_shipping_charge": "20",
            "procurement_sla": "3",
            "stock_count": "23",
            "procurement_type": "REGULAR"
        }
    },
    {
        "listingId": "LISTINGID2",
        "skuId": "SKUID2",
        "fsn": "FSN2",
        "attributeValues": {
            "mrp": "2400",
            "selling_price": "2300",
            "listing_status": "INACTIVE",
            "fulfilled_by": "seller",
            "national_shipping_charge": "20",
            "zonal_shipping_charge": "20",
            "local_shipping_charge": "20",
            "procurement_sla": "3",
            "stock_count": "23",
            "procurement_type": "REGULAR"
        }
    }
    ]
}

Response:

{
    "status": "success",
    "response": [
    {
        "skuId": "SKUID1",
        "listingId": "LISTINGID1",
        "status": "updated",
        "errors": []
    },
    {
        "skuId": "SKUID2",
        "listingId": "LISTINGID2",
        "status": "updated",
        "errors": []
    }
    ]
}

Failure: HTTP code 4xx, 5xx

Request: https://api.flipkart.net/sellers/skus/listings/bulk

{
     "listings": [
     {
         "listingId": "LISTINGID1",
         "skuId": "SKUID1",
         "fsn": "FSN1",
         "attributeValues": {
             "mrp": "2400",
             "selling_price": "2300",
             "listing_status": "INACTIVE",
             "fulfilled_by": "seller",
             "national_shipping_charge": "20",
             "zonal_shipping_charge": "20",
             "local_shipping_charge": "20",
             "procurement_sla": "3",
             "stock_count": "23",
             "procurement_type": "REGULAR"
         }
     },
     {
         "listingId": "LISTINGID2",
         "skuId": "SKUID2",
         "fsn": "FSN2",
         "attributeValues": {
             "mrp": "2400",
             "selling_price": "3000",
             "listing_status": "INACTIVE",
             "fulfilled_by": "seller",
             "national_shipping_charge": "20",
             "zonal_shipping_charge": "20",
             "local_shipping_charge": "20",
             "procurement_sla": "3",
             "stock_count": "100",
             "procurement_type": "REGULAR"
         }
     }
     ]
 }

Response:

{
    "status": "failure",
    "response": [
    {
        "skuId": "SKUID1",
        "listingId": "LISTINGID1",
        "status": "updated",
        "errors": []
    },
    {
        "skuId": "SKUID2",
        "listingId": "LISTINGID2",
        "status": "failure",
        "errors": [
        {
            "errorCode": "GREATER_THAN_UPPER_BOUND",
            "message": "Your Stock Count can not be more than 50. For more details please check Flipkart Marketplace Selling Policies.",
            "attributeName": "stock_count"
        },
        {
            "errorCode": "FSP_MORE_THAN_MRP",
            "message": "Your Selling Price should never be greater than MRP.",
            "attributeName": "selling_price"
        }
        ]
    }
    ]
}


GET skus/{SKUID}/listings

Description - Get listing attributes by providing its SKU ID and specifying required attributes. If no attributes are specified, all its attributes are returned.

Request and Response Parameters

☰ SHOW | HIDE

Path Parameter: skuId

Query Parameter: ListingAttribute(list)

URL: https://api.flipkart.net/sellers/skus/SKUID/listings

Response: ListingRequest


Example

☰ SHOW | HIDE

Request: https://api.flipkart.net/sellers/skus/SKUID/listings?attribute=mrp&attribute=selling_price

Response:

{
    "listingId": "LISTINGID",
    "skuId": "SKUID",
    "attributeValues": {
        "mrp": 100,
        "selling_price": 100
    }
}

Request: https://api.flipkart.net/sellers/skus/SKUID/listings

Response:

{
    "listingId": "LISTINGID",
    "skuId": "SKUID",
    "attributeValues": {
        "listing_status": "ACTIVE",
        "procurement_sla": 1,
        "zonal_shipping_charge": 10,
        "national_shipping_charge": 10,
        "selling_price": 80,
        "mrp": 100,
        "stock_count": 1,
        "local_shipping_charge": 10
    }
}


GET skus/listings/{LISTINGID}

Description - Get listing attributes by providing its listing ID and specifying required attributes. If no attributes are specified, all its attributes are returned.

Request and Response Parameters

☰ SHOW | HIDE

Path Parameter: ListingId

Query Parameter: ListingAttribute(list)

URL: https://api.flipkart.net/sellers/skus/listings/LISTINGID

Response: ListingRequest


Example

☰ SHOW | HIDE

Request: https://api.flipkart.net/sellers/skus/listings/LISTINGID?attribute=mrp&attribute=selling_price

Response:

{
    "listingId": "LISTINGID",
    "skuId": "SKUID",
    "attributeValues": {
        "mrp": 100,
        "selling_price": 100
    }
}

Request: https://api.flipkart.net/sellers/skus/listings/LISTINGID

Response:

{
    "listingId": "LISTINGID",
    "skuId": "null",
    "fsn": "FSN",
    "attributeValues": {
        "mrp": 0,
        "procurement_sla": 0,
        "national_shipping_charge": 0,
        "stock_count": 0,
        "listing_status": "INACTIVE",
        "selling_price": 0,
        "actual_stock_count": 0,
        "zonal_shipping_charge": 0,
        "local_shipping_charge": 0
    }
}