Questions about SP-API Delete Listings Endpoint

[coderpang]

Description:
I am using the DELETE /listings/2021-08-01/items/{sellerId}/{sku} endpoint to delete specific SKUs and have a few questions:

Checking deletion request status
A successful request returns a submissionId. Which endpoint can be used to check the status of this deletion operation (e.g., whether it has been processed successfully or failed)?

Deleting a parent SKU and its variations
If I delete a parent SKU, will its child/variation SKUs also be deleted automatically, or will they remain active?

Batch deletion capability
The current endpoint seems to handle only one SKU per request. Is there another endpoint or method to delete multiple SKUs (especially variations) in a single batch operation?

Environment:

Amazon SP-API

Listings Items API version: 2021-08-01

[mafge]

Hi @coderpang,
thanks for reaching out!

• Checking deletion request status: There is no API that takes the submissionId and returns a status. However, you can either use LISTINGS_ITEM_STATUS_CHANGE notification to get informed when a listing has been deleted or query the listing directly with getListingItem operation (If the deletion was successful, the API will return 404).
• Deleting a parent SKU and its variations: In case you delete a parent SKU, the child SKUs will remain and not get deleted automatically. Howeber, the relationship will be removed from all children.
• Batch deletion capability: You can use JSON_LISTINGS_FEED from Feeds API to delete multiple SKUs in one go.
  Hope this helps!
  Best,
  Marc
  Selling Partner Developer Services

[coderpang]

Hi @coderpang, thanks for reaching out!

• Checking deletion request status: There is no API that takes the submissionId and returns a status. However, you can either use LISTINGS_ITEM_STATUS_CHANGE notification to get informed when a listing has been deleted or query the listing directly with getListingItem operation (If the deletion was successful, the API will return 404).
• Deleting a parent SKU and its variations: In case you delete a parent SKU, the child SKUs will remain and not get deleted automatically. Howeber, the relationship will be removed from all children.
• Batch deletion capability: You can use JSON_LISTINGS_FEED from Feeds API to delete multiple SKUs in one go.
  Hope this helps!
  Best,
  Marc
  Selling Partner Developer Services

Thanks. I kmow "Delisting" and "deletion" are definitely different functionalities. So, if I want to achieve delisting instead of deletion, which API endpoint should I call, and what are the required parameters?

[mafge]

There are multiple ways to set a SKU to inactive using patchListingsItem operation:

• Set inventory to 0
• Set purchasable_offer.end_at to a date in the past
• Delete purchasable offer

E.g. to set inventory to 0:

{
  "productType": "PRODUCT",
  "patches": [{
    "op": "replace",
    "path": "/attributes/fulfillment_availability",
    "value": [{
      "fulfillment_channel_code": "DEFAULT",
      "quantity": 0
    }]
  }]
}