Skip to main content

Get 2D Barcode Data

GET 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/labels/2d-barcode-data

Get the 2D box-content barcode content strings for every box of a packing group that was submitted with the BARCODE_2D content information source. Returns one entry per box with the content string in Amazon's documented AMZN 2D box-content format:

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

AMZN,PO:<shipment reference>,<CODE>:<item id>,QTY:<qty>[,EXP:<YYMMDD>],<CODE>:...

The PO: reference is the shipment confirmation ID (FBA…) when available, falling back to the Amazon shipment ID, then PLAN-{id}. Each box item contributes an item-code/QTY: pair using a code Amazon's 2D barcode sheet accepts: FNSKU: with the listing's FNSKU, or — when no FNSKU is known — UPC: / EAN: with the product's 12-digit UPC or 13-digit EAN barcode (the merchant SKU is never encoded). EXP: follows the pair it applies to when the item has an expiration date. All data is uppercase with no spaces.

Note: this endpoint returns content STRINGS only — PDF417 graphic rendering is deferred (render client-side or in a later phase).

Query parameters:

  • packing_group_id (integer, required) — the packing group; must belong to this draft inbound plan (404 otherwise)

422 conditions: the packing group was not submitted with the BARCODE_2D content information source; or a box item has no FNSKU and no 12-digit UPC / 13-digit EAN barcode (the message names the SKUs and says to sync the inbound plan from Amazon or add a UPC/EAN barcode to the product).

Returns 404 when the inbound plan (or a shipment, box, option or item nested under it) in the path belongs to a different Amazon account than the one in the URL.

Request​

Responses​

OK

Response Headers
    Content-Type