Vendor Direct Fulfillment Orders API

You use the Vendor Direct Fulfillment Orders API to access your direct fulfillment vendor order data. You can receive purchase orders and send order acknowledgments.

To learn more about the terms that are used in this guide, refer to Terminology.

📘

Note

You use the getOrders operation with includeDetails=false as a query parameter to retrieve order numbers without complete order details. The default value for this parameter is true. If you don't include this query parameter, it returns the full details of the purchase orders.

The following diagram shows the workflow using the Direct Fulfillment Orders APIs:

Direct Fulfillment customer data transmission

Amazon label only vendors do not receive customer data such as name, address, or phone number for some orders returned using the getOrder and getOrders operations. Direct Fulfillment shares customer information directly on Amazon provided shipping labels. This applies to all shipments fulfilled by Amazon label only vendors and Amazon Transportation Services-Small Parcel. Customer ship-to details are only returned for Vendor Own Label (VOL) or Vendor Own Carrier (VOC).

Customer name, address, and phone number are available if your operations require you to generate a label using a Direct Fulfillment Amazon carrier account. The information is also available to you if you use a vendor own label (VOL) or vendor own carrier (VOC) shipping label to fulfill the Direct Fulfillment order. If you generate your own AMXL shipping labels, you can access customer data.

⭐

Tip

If you use AMXL and AT shipping methods for the same warehouse, the AMXL Oversize and XL markers on the label help differentiate between AMXL and AT labels.

Use cases

The following use case examples are available for the Vendor Direct Fulfillment Orders API:

• Get a list of orders: Get a list of order references or complete order details.
• Get an order: Get purchase order information, including line item details, quantity, and cost.
• Submit an acknowledgement: Submits acknowledgments for one or more purchase orders.

Roles