Vendor Direct Fulfillment Orders API

Learn how to use the 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.

Current versionLegacy versionsAvailable to sellersAvailable to vendors
v2021-12-28 (Reference | Model)v1NoYes
Release notes

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:

The Direct Fulfillment orders workflow.

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:

Roles

getOrder
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Direct to Consumer Shipping (Restricted)
getOrders
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Direct to Consumer Shipping (Restricted)
submitAcknowledgement
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Direct to Consumer Shipping (Restricted)