Update: Vendor Direct Fulfillment Shipping API v2021-12-28 now includes createContainerLabel
On 2024-05-23 Amazon announced that the Vendor Direct Fulfillment Shipping API (v2021-12-28) now supports the createContainerLabel operation. The new endpoint generates a single PDF pallet‑level label with a QR/barcode, enabling carriers to scan and confirm pickup of the entire container in one step.
Overview
Amazon has upgraded the Vendor Direct Fulfillment Shipping API (v2021‑12‑28) by adding a createContainerLabel operation. The new call lets vendors produce a single, pallet‑level shipping label that carriers scan to confirm pickup of every box on the pallet. This change is live across all Amazon marketplaces and directly affects sellers who ship large quantities in bulk.
Key Points
- Single‑label generation — The
createContainerLabelendpoint creates one PDF label for an entire pallet, eliminating the need to print dozens or hundreds of individual box labels. - Carrier scan verification — The pallet label embeds a QR or barcode that carriers scan at pickup, automatically confirming that the whole container has been collected.
- Global availability — The feature is enabled on every Amazon marketplace, from the United States and Canada to European and Asian sites, so sellers with international fulfillment networks can use it immediately.
- Container‑ID linkage — Each label is tied to a unique container identifier, which the system matches to the shipment record, reducing mismatches between shipped and received items.
- Real‑time pickup events — Once the carrier scans the label, the API returns a confirmation event, giving vendors instant visibility into the “picked up” status of large shipments.
How createContainerLabel Works
- Submit a container request — The vendor issues a
POSTrequest to thecreateContainerLabelendpoint, supplying the shipment reference, pallet dimensions, weight, and an array of package IDs or ASINs. Example: A vendor preparing a 48‑inch pallet that holds 120 boxes includes the pallet’s length, width, height, total weight, and the SKU list for each box in the request payload. - Receive the label PDF — Amazon responds with a base‑64‑encoded PDF that contains the carrier‑specific label, a scannable QR code, the human‑readable container number, and any handling instructions.
Analysis & Recommendations
Why This Matters
Vendors can replace dozens of box labels with one pallet label, cutting printing time and reducing mismatches. The carrier scan instantly updates the shipment status to “picked up,” giving real‑time visibility and speeding reimbursement for high‑volume shipments.
Key Takeaways
- createContainerLabel is a new POST operation in the v2021-12-28 Shipping API.
- The endpoint returns a base‑64‑encoded PDF label for the entire pallet, including a QR or barcode for carrier scan.
- Feature is live across all Amazon marketplaces globally as of the announcement date.
Recommended Actions
- →Update your integration to call POST /shipping/v2021-12-28/containerLabels (createContainerLabel) after pallet dimensions and weight are recorded.
- →Configure warehouse printers to decode the PDF response and print the 4 × 6‑inch label, then place it on the pallet top as per carrier guidelines.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!