Submit shipment confirmations

Learn how to use the Vendor Direct Fulfillment Shipping API to submit shipment confirmations. The submitShipmentConfirmations operation lets vendors submit shipment confirmations to Amazon. Your shipment confirmation allows us to efficiently track your shipments and inform our customers. It contains information about the items being shipped, including purchase order number, ship date, estimated delivery date, and tracking number.

Shipment confirmations allow us to collaborate more effectively with carriers in tracking your shipments.

The lack of valid shipment confirmations can result in:

• Inadequate visibility about shipments

• Errors in reconciling the physical shipments with purchase orders

• Manual follow-ups to resolve discrepancies

Verification of successfully submitted shipment confirmations

Vendors can verify the status of their shipment confirmations via Vendor Central > Orders > Direct Fulfillment Orders or using the Vendor DF Transactions API. Allow the system up to 10 min to determine the status after submission. If Vendor Central is not showing the correct values for the shipment confirmation, open a Contact Us case in Vendor Central. Refer to the Business Requirements section for information about creating shipment confirmations.

The following diagram shows the integration workflow for submitting shipment confirmations:

Business requirements

• Use this API to confirm shipment of an order within four hours after the order has shipped from your warehouse.

• For floor denied shipments, set the shipmentStatus field value to FLOOR_DENIAL.

• All the purchase order line items must 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.

• The itemSequenceNumber for an item should be the same as was received in the order message.

• Either buyerProductIdentifier or vendorProductIdentifier is mandatory to send in the shipment confirmation. You need to send the same value as received in the purchase order.

• For VOcs, sending scacCode is mandatory.

• If the shipment label is provided by Amazon, then the container section is optional since Amazon has access to the package information. Items section is mandatory to submit.

• The container in a shipment confirmation must have a shipMethod specified.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
• The Direct-to-Consumer Shipping (Restricted) role assigned to your developer profile.
• The Direct-to-Consumer Shipping (Restricted) role selected in the app registration page for your application.

Submit shipment confirmations

To submit shipment confirmations, call the submitShipmentConfirmations operation.