Update: Fulfillment Inbound API v2024-03-20 now supports preparation details
In March 2024 Amazon refreshed the Fulfillment Inbound API (v2024-03-20) with new listPrepDetails and setPrepDetails operations. These let sellers read and write prepOwner, labelOwner, prepCategory and prepType per MSKU, automating inbound preparation.
Overview
In March 2024 Amazon refreshed the Fulfillment Inbound API (v2024‑03‑20) to expose preparation‑related fields for every merchant‑stock‑keeping unit (MSKU). The new endpoints let sellers programmatically read and write who is responsible for packaging, labeling, and the type of preparation required. This shift moves tasks that previously lived only in the Seller Central UI into API calls, giving high‑volume sellers a way to automate compliance, cut inbound mistakes, and accelerate shipment creation.
Key Points
- listPrepDetails operation — Returns every permissible preparation option for a specified MSKU, such as the allowed owners for packaging and labeling and the catalog of prep categories and types. Example: For SKU “XYZ‑789” the response may list
prepOwner: ["Seller","Amazon"],labelOwner: ["Seller"],prepCategory: ["Polybag","BubbleWrap"]. - setPrepDetails operation — Accepts a chosen combination of
prepOwner,labelOwner,prepCategoryandprepUnit(e.g., “Standard”, “Fragile”) and writes those values into the inbound shipment plan. Example: Sending a JSON payload that setsprepOwner:"Seller"andprepCategory:"Polybag"updates the plan accordingly. - Full API‑first compliance — Sellers can now embed preparation logic directly into inventory‑management or ERP systems, removing the need to open Seller Central for each product.
- Built‑in validation — The API cross‑checks the submitted owners and categories against the list returned by
listPrepDetails, immediately rejecting unsupported combinations and preventing downstream rejections. - Speed boost for large catalogs — Automating prep detail submission can shrink the time required to finalize inbound shipments by up to 30 % for sellers handling thousands of SKUs.
How the Updated Inbound API Works
- Retrieve allowed preparation data — Issue a request for the target MSKU. The service replies with a JSON array that enumerates every valid , , , and . : For SKU “ABC‑123” the response includes , , , .
Analysis & Recommendations
Why This Matters
Automating preparation details removes manual UI steps, cutting inbound shipment finalisation time by up to 30% for catalogs of thousands of SKUs. Built‑in validation prevents unsupported combos, reducing rejection rates. Sellers can batch listPrepDetails calls (≈5 calls/sec) to stay within rate limits.
Key Takeaways
- listPrepDetails returns all allowed prepOwner, labelOwner, prepCategory and prepType values for a given MSKU.
- setPrepDetails writes the chosen preparation configuration and returns HTTP 200 on success.
- Automation can shrink inbound shipment finalisation time by up to 30% for large catalogs.
- Amazon recommends batching listPrepDetails requests to ≤5 calls per second to respect rate limits.
Recommended Actions
- →Add calls to GET /inbound/v2024-03-20/sku/{sku}/prep (listPrepDetails) and POST /inbound/v2024-03-20/sku/{sku}/prep (setPrepDetails) in your inboun...
- →Validate the new workflow in the Amazon sandbox; ensure setPrepDetails returns 200 OK and the prep fields appear in the mock shipment plan.
- →Implement logging for 400/422 responses from setPrepDetails and set up alerts for spikes, adjusting your mapping logic as needed.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!