November 2023 SP-API Release Announcement
In November 2023 Amazon released the Supply Sources API v2020‑07‑01, letting sellers programmatically add, edit, and retrieve warehouse, store, and pop‑up shop data. The API supports detailed attributes like capacity limits, hazardous material tags, and operating hours, cutting spreadsheet errors and enabling real‑time order routing.
Overview
In November 2023 Amazon expanded the Selling Partner API (SP‑API) by adding the Supply Sources API (v2020‑07‑01). The new endpoint lets sellers programmatically create, update, and query physical supply locations such as warehouses, stores, and pop‑up shops. Sellers who manage inventory across multiple fulfillment points will find tighter integration and reduced manual effort.
Key Points
- New API Endpoint – The Supply Sources API v2020‑07‑01 is now live, enabling sellers to add, edit, and retrieve supply source data directly from their systems.
- Location‑Level Fulfillment – Sellers can attach exact addresses, operating hours, and inventory types to each source, allowing Amazon to route orders to the most suitable location.
- Enhanced Data Accuracy – The API accepts detailed attributes like capacity limits, contact details, and compliance tags, cutting down on spreadsheet errors and data mismatches.
- Improved Automation – Inventory and order management platforms can now push source changes in real time, eliminating the need for manual uploads to Seller Central.
- Compliance Support – Fields for hazardous material handling, temperature control, and other regulatory requirements are included, helping sellers avoid order rejections.
- Developer Adoption – Amazon recommends migrating from legacy endpoints to the new SP‑API for better security, performance, and future‑proofing.
How the Supply Sources API Works
- Register a Supply Source – Sellers send a
POST /supplySourcesrequest with a JSON payload that includes the address, contact phone, and inventory type. Example: A retailer adds a Dallas warehouse with a 50,000‑SKU capacity and marks it as a “cold‑storage” source. - Retrieve Source Details – A
GET /supplySources/{sourceId}call returns the full record, including operating hours, compliance tags, and current capacity. Example: A seller checks that a Chicago location is flagged for hazardous material handling before shipping a new batch of chemicals.
Analysis & Recommendations
Why This Matters
Sellers can automate source management, syncing warehouse data via POST /supplySources, reducing manual entry and speeding order allocation. Detailed compliance tags prevent order rejections and improve inventory visibility.
Key Takeaways
- Supply Sources API v2020‑07‑01 launched in November 2023.
- Endpoints include POST, GET, PATCH, DELETE, and GET /supplySources with filters like state=CA.
- API accepts capacity limits, hazardous material handling, temperature control tags.
- OAuth 2.0 authentication over HTTPS with standard HTTP status codes.
Recommended Actions
- →Map your warehouse database to POST /supplySources to auto‑add new locations.
- →Use PATCH /supplySources/{sourceId} to sync capacity or operating hours whenever internal records change.
- →Set up CloudWatch alarms for 429 status codes to monitor rate‑limit issues.
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!