Submit shipping label requests

Learn how to use the Vendor Direct Fulfillment Shipping API to submit shipping label requests. The submitShippingLabelRequest operation lets vendors request shipping label information from Amazon for each purchase order. You can send multiple shipping label requests in bulk in one API call by adhering to the schema. When shipment labels are created by Amazon, they will be available to download using the getShippingLabel operation.

📘

Note

The submitShippingLabelRequest operation is only available to vendors who use Amazon carriers.

Verify shipping label submission requests

You can verify the status of your shipping label requests using the Vendor DF Transactions API. Allow the system up to 15 minutes to show the status after submission. If the transaction status is not updated after 30 minutes, open a Contact Us case in Vendor Central.

The following diagram shows the workflow for submitting shipping label requests.

Business requirements

• The purchase order must be successfully confirmed via API, EDI, or Vendor Central before you submit the shipping label request. Shipping label requests for unconfirmed or cancelled purchase orders are rejected.

• If you use Amazon-owned shipping labels, sending item information or package information in the request is optional.

Advance shipment notification

You can't request a shipping label after you submit an advance shipment notification (ASN). An ASN must reflect the actual shipping method. If you try to request the shipping label after an ASN, your request is rejected. You can request shipping labels more than once before submitting the ASN, though the label might flip to a different shipping method when you request a new label.

In the ASN, you must provide the shipping method and tracking number that you receive in the shipping label from Amazon even if there is a UPS tracking number on the label. You can differentiate a standard UPS label from a Landmark-UPS label based on the presence or absence of a Landmark logo in the corner of the label.

This scenario is common. For example, you might see a UPS tracking number for a Landmark shipping method in multi-leg shipments that Landmark orchestrates.

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 a shipping label request

To request shipping labels, call the submitShippingLabelRequest operation.

You can submit shipping label requests between the carrier pick-up time of the previous day of the expected ship date and the actual day of shipping. If you submit requests earlier, a label flip might occur. Requests might also fail if you reach the capacity limits on that day. It is best practice to request your shipping labels on the day that the orders are shipped.