Vendor Direct Fulfillment FAQ

SP-API vendor direct fulfillment frequently asked questions.

Can a vendor increase the original quantity submitted in the purchase order using the Order Acknowledgment API?

Select to expand the answer.

No, Amazon does not allow the vendor to send a higher quantity in the acknowledgment than what was submitted in the purchase order.

Is it a requirement to send an order acknowledgment for each purchase order?

Select to expand the answer.

Yes, in order to update the status of an order in the Amazon system correctly, Amazon requires PO confirmation using the API or Vendor Central. If you are unable to meet our order acknowledgement requirements using the API, you must confirm your POs using Vendor Central. Please contact your Amazon business representative if you do not have a Vendor Central account.

Is it a requirement to provide every PO line item in the corresponding order acknowledgment?

Select to expand the answer.

Yes, so Amazon can update the order status correctly.

How should invalid items or details on an order be reported using the order acknowledgment?

Select to expand the answer.

Do not process or ship an item that arrived with an invalid item number on the order. Please return the invalid item number on the acknowledgment and acknowledge it with the codes provided in the Vendor Direct Fulfillment APIs User Guide.

Do I need to return the same product identifier in the acknowledgment that I received in the orders transaction?

Select to expand the answer.

Acknowledgments must return exactly the same product identifier that were sent in the purchase order.

Is it required to provide an acknowledgement code for all line items regardless of status?

Select to expand the answer.

Yes, it is required so we can correctly update the status of the order. If the acknowledgment code is omitted, the acknowledgment will be rejected in our EDI system.

What is the policy on partial shipments? How should partial shipments be reported when submitting an order acknowledgment?

Select to expand the answer. Partial shipments are not allowed. Vendors need to either confirm or reject the full order.

I am having issues submitting shipment confirmations, what can I do?

Select to expand the answer.

Vendors can verify the status of their shipment confirmations via Vendor Central > Orders > Direct Fulfillment Orders or using the Direct-fulfillment Transaction Status API. Allow the system up to 10 min to see the status once submitted.

Here are some common errors a vendor might face when submitting this API call:

  • You should use this API to confirm shipment of an order within 4 hours after the order has shipped from your warehouse.
  • For floor denied shipments, send shipmentStatus field value as “FLOOR_DENIAL”.
  • All the purchase order line items should be present in the shipment confirmation. Partial order fulfillment is not allowed. Vendors should reject the order as floor denial if any of the line items are not available to fulfill.
  • itemSequenceNumber for an item should be same as received in order message.
  • Either buyerProductIdentifier or vendorProductIdentifier is mandatory to send in the shipment confirmation. You need to send the same value as received in purchase order.
  • For vendor own carriers, sending scacCode is mandatory.
  • If the shipment label is provided by Amazon, then container section is optional since Amazon has access to the package information. Items section is mandatory to submit.

What kind of labels are available to download?

Select to expand the answer.

ZPL and PNG labels should be requested only on the day when the orders are due for shipping.

Are packing slips required for all orders?

Select to expand the answer.

Packing slip is required only if it is a Business to Business [B2B] order or a gift order. isPslipRequired field from the Order message must be read and if it is true, Packing slip is required for that order.

What kind of customer invoices are available to download?

Select to expand the answer.

Customer invoice is a PDF file which is encoded in binary64 string format. All purchases orders for IN region should have a customer invoice created which should be sent with the shipment.

Can the package/items data be omitted from a shipping label request?

Select to expand the answer.

Yes, shipping labels can be requested by providing only the minimal 3 fields, order id, vendor code SellingParty and warehouse code shipFromParty. Amazon will get the information about items from catalogue in this order and create a shipping label. If there is custom information like multi box scenario, then the package loop is mandatory to request labels so they are created as per dimensions provided.

Shipping labels are not available when making the GET call?

Select to expand the answer.

Shipping labels must be created first by making a POST call with the information about the order. Only if that request succeeds, a label will be available in the back end to request via the GET call. Make sure the POST call is made first, the status is checked via the transaction status API before trying to download a label via GET call.

By when should the order be shipped?

Select to expand the answer.

You are required to read the value in the requiredShipDate field, which is the latest date the order should be shipped from the warehouse. The promisedDeliveryDate field value denotes the date we promised to deliver to the customer.

Can I change an order using the API?

Select to expand the answer.

No, submitting a change to an order using the API is not possible at this time. After an order has been placed, changing it is not possible.


Need more help?

For additional support, contact Selling Partner API Developer Support. For vendor applications, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.