New: FBA Inventory API dynamic sandbox
Amazon now offers two dynamic sandbox environments for the FBA Inventory and FBA Outbound APIs. Developers can start a session via the `createSandbox` endpoint (e.g., sandboxId = sbx-98765) to post shipments, update SKUs and process orders with live‑like latency, and inject errors using the `X-Inject-Error` header.
Overview
Amazon has introduced two new dynamic sandbox environments for the Fulfillment By Amazon (FBA) Inventory API and the FBA Outbound API. The sandboxes allow developers to execute full‑cycle tests—receiving shipments, adjusting stock, and fulfilling orders—without affecting any real seller account. This capability gives sellers and solution providers a safe space to verify code, troubleshoot edge cases, and certify integrations before they go live, thereby lowering the chance of costly mistakes.
Key Points
- Separate sandbox instances — One sandbox is dedicated to inventory‑related calls and another to outbound fulfillment, each reproducing the behavior of its production counterpart.
- Live‑like response timing — The test environments return status codes, latency, and payload structures that match the live APIs, so developers see realistic feedback.
- Persistent state across calls — Actions such as posting a shipment receipt, updating a SKU quantity, or creating a removal order remain stored for the duration of the session, enabling multi‑step scenarios in a single run.
- Isolation from real listings — All operations are confined to the sandbox, guaranteeing that test activity cannot alter a seller’s actual inventory, buy‑box eligibility, or sales statistics.
- Error‑injection capability — By setting a special header, developers can force common failure responses—like “InsufficientInventory” or “InvalidSKU”—to validate error‑handling logic.
- No charge for access — The sandboxes are freely available to any developer with an Amazon Marketplace developer account.
How the Dynamic Sandbox Works
-
Create a sandbox session — Call the
createSandboxendpoint with the desired region and API type; the service returns a unique sandbox identifier.- Example: A logistics partner posts
{ "region": "NA", "type": "FBA_INVENTORY" }and receivessandboxId: "sbx-98765". All subsequent requests must include this ID in the header.
- Example: A logistics partner posts
Analysis & Recommendations
Why This Matters
The sandboxes let sellers and partners run full inbound‑to‑outbound flows without touching live listings, reducing costly mistakes. Persistent state and error injection enable realistic end‑to‑end validation, speeding certification and lowering post‑launch support tickets.
Key Takeaways
- Separate sandbox instances exist for inventory (`FBA_INVENTORY`) and outbound (`FBA_OUTBOUND`) calls.
- A sandbox session persists state; a 150‑unit receipt drops to 146 units after a 4‑unit fulfillment.
- Error injection is enabled via the `X-Inject-Error: true` header to simulate errors like `InsufficientInventory`.
- Access to both sandboxes is free for any Amazon Marketplace developer account.
Recommended Actions
- →In Seller Central, go to Developer Central > SP‑API credentials and POST /sandbox/createSandbox with region and type to obtain a sandboxId.
- →Include the returned sandboxId in the `x-amz-sandbox-id` header for all subsequent FBA Inventory or Outbound API requests.
- →Add the `X-Inject-Error` header to test failure scenarios, then DELETE /sandbox/{sandboxId} to clean up the session.
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!