Amazon SP API Listing Delete

Summary of Changes: (The purpose of this table is to keep traceability and Product team to highlight the things that were changed into the scope, based on comments or discussions)

Version	Date	Created / Updated	Notes
v1.0	N/A	Hristiyan	First publish

We are only able to delete listings and not catalog products in Amazon. This means we will delete the listin from the seller central for the specific seller but the item will still be available on Amazon. This is simply because Amazon is catalogue based.

Delete Listing Item

API Call: DELETE /listings/2021-08-01/items/{sellerId}/{sku}

API Docs: https://developer-docs.amazon.com/sp-api/docs/listings-items-api-v2021-08-01-reference#deletelistingsitem

Usage plan:

Plan type	Rate (requests per second)	Burst
Default	5	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation but based on different sellers the rates might be higher so we need to implement a logic that will abide to the x-amzn-RateLimit-Limit response.

The triggers for picking listings for delete will be :

(Product Account > Delete Variant = Yes OR

Product Account > End Listing = Yes)

Product Account > Listing Status = Active Product Account > Product Status = Product Published

All validations etc are as per our listing abstraction - Product Listing general requirements

Parameters

Type	Name	Description	Schema
Path	sellerId required	A selling partner identifier, such as a merchant account or vendor code.	string
Path	sku required	A selling partner provided identifier for an Amazon listing.	string
Query	marketplaceIds required	A comma-delimited list of Amazon marketplace identifiers for the request.	< string > array(csv)
Query	issueLocale optional	A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: `en_US`, `fr_CA`, `fr_FR`. Localized messages default to `en_US` when a localization is not available in the specified locale.	strin

Mapping:

Amazon Parameter	Hemi Field
sellerId	`Amazon Account` > `Merchant ID`
sku	`Product` > `SKU`
marketplaceIds	Hardcoded per account region
issueLocale	N/A

Example response:

{
    "sku": "4067981446940",
    "status": "ACCEPTED",
    "submissionId": "920db7dd92ba440ca8963817c688c059",
    "issues": []
}

If we receive “ACCEPTED” status this means we have successfully deleted the item. We should remove the variant listing only when the flag delete variation has been used, otherwise we remove the whole variation. Once a listing has been successfully deleted we are to put the product listing status on “Inactive“ and product status on “Product Removed”. Any errors we will receive in the issues object and will have different status than ACCEPTED and are to be stored in the Product Account > End Listing Error

Marketplaces / Amazon SP API - Technical Scope / Amazon SP API Product Management / Amazon SP API Listing Delete

Amazon SP API Listing Delete

Delete Listing Item