August 2022 SP-API Release Announcement
In August 2022 Amazon added the EasyShipShipmentStatus enum to the Orders v0 payload and introduced two new Services v1 endpoints—getRangeSlotCapacity and getFixedSlotCapacity—allowing sellers to retrieve exact shipment stages and real‑time delivery‑slot capacity.
Overview
In August 2022 Amazon released an updated version of the Selling Partner API (SP‑API) that adds new order‑status data for Easy Ship shipments and two fresh endpoints that expose delivery‑slot capacity. The changes let sellers pull precise shipment stages and programmatically check how many slots are open for a given date or time window, which is critical for anyone who relies on Amazon‑fulfilled logistics to keep delivery promises.
Key Points
- EasyShipShipmentStatus enum — A new field now appears in the order payload, indicating the exact stage of an Easy Ship order such as Pending, InTransit, Delivered or Cancelled.
- getRangeSlotCapacity endpoint — Returns capacity numbers for every delivery slot inside a requested date range, using the same schema as the existing slot‑availability records.
- getFixedSlotCapacity endpoint — Provides capacity information for a single, explicitly identified slot, enabling pinpoint‑level planning.
- Orders API v0 payload expansion — The added shipmentStatus attribute enlarges the order response, removing the need for separate carrier‑tracking calls.
- Services API v1 extension — The two capacity‑related calls are added under the Services namespace, turning a UI‑only view into a fully automatable data source.
How the New Features Work
-
EasyShipShipmentStatus enumeration —
- When a seller queries the Orders v0
GET /orders/v0/ordersendpoint, the JSON response now contains ashipmentStatusproperty. - For example, an order that has left the carrier’s hub will return
"InTransit", allowing the seller’s system to automatically fire a “your package is on the way” notification without consulting an external tracking API.
- When a seller queries the Orders v0
-
getRangeSlotCapacity operation —
- Sellers issue a request, supplying a start date, an end date, and the marketplace ID.
Analysis & Recommendations
Why This Matters
The shipmentStatus field now delivers authoritative Easy Ship status (e.g., "InTransit") directly in order responses, removing the need for separate carrier‑tracking calls. The new slot‑capacity endpoints let sellers programmatically verify available slots, preventing over‑booking and enabling precise demand‑planning for promotions.
Key Takeaways
- EasyShipShipmentStatus enum added to Orders v0 payload, exposing statuses like Pending, InTransit, Delivered, Cancelled.
- GET /services/v1/slotCapacity/range returns availableCapacity for every slot in a requested date range.
- GET /services/v1/slotCapacity/fixed returns capacity for a single identified slot, enabling pinpoint verification.
- ShipmentStatus field eliminates extra carrier‑lookup steps, streamlining automation.
Recommended Actions
- →Update order‑retrieval scripts to read the new shipmentStatus property from Orders v0 (GET /orders/v0/orders) in your codebase.
- →Add calls to GET /services/v1/slotCapacity/range and GET /services/v1/slotCapacity/fixed in your shipping module, using the API console or Postman ...
- →Validate slot capacity integration by querying a 7‑day range in Seller Central > Developer Console > API Test and adjust slot‑selection logic accor...
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!