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.
Release notes
To learn more about the terms that are used in this guide, refer to Terminology.
Note
You use the
getOrders
operation withincludeDetails=false
as a query parameter to retrieve order numbers without complete order details. The default value for this parameter istrue
. 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
andXL
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
getOrder
Attribute | Value |
---|---|
Regions | NA, EU, FE |
Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
getOrders
Attribute | Value |
---|---|
Regions | NA, EU, FE |
Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
submitAcknowledgement
Attribute | Value |
---|---|
Regions | NA, EU, FE |
Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
Updated about 4 hours ago