Overview

In February 2023 Amazon expanded the Selling Partner API (SP‑API) Orders v0 endpoint to include delivery‑preference data for Amazon Business buyers. The new fields let sellers retrieve exact time windows, drop‑off locations, and other business‑specific instructions directly from the order payload. Sellers serving Business customers must adjust their fulfillment workflows now to avoid missed windows, higher Order Defect Rates, and potential penalties.

Key Points

• Delivery‑preference data added to Orders API — The response payload now contains a deliveryPreferences object that holds buyer‑specified windows and areas when the purchaser is an Amazon Business customer.
• Expectation of on‑time, windowed delivery — Business buyers anticipate the same reliability as consumer orders, plus strict adherence to any declared delivery times or zones.
• Expanded JSON structure — New nodes such as deliveryPreferences, preferredDeliveryWindow, and preferredDeliveryArea appear only when the buyer has provided them, leaving legacy fields untouched.
• Legacy integrations remain functional — Existing code that ignores the new nodes will still receive the standard order information, but it will miss the chance to meet Business‑buyer expectations.
• Performance metrics now tied to compliance — Ignoring a buyer’s stated window can raise the seller’s Order Defect Rate (ODR) and trigger alerts in the Business Seller Dashboard.
• Updated documentation and sandbox — Amazon released revised Swagger files and sandbox test cases so developers can validate handling of the new fields before pushing changes to production.

How the Updated Orders v0 API Works

1. Requesting an order — A seller issues a GET /orders/v0/orders/{orderId} call with the usual authentication headers.

   • Example: Querying order 112-1234567-8910112 returns the typical order details plus a block when the purchaser is a Business customer.