Skip to main content

generateFulfillmentContainerLabels

Generates retailer-compliant GS1 carton labels for every container on the fulfillment by rendering the sales channel's Endless EDI label mapping once per container and sending the batch to Endless EDI. Returns a single PDF holding one page per container, records that labels were generated, and queues filing the PDF on the order's documents.

Business Rules​

  • One label per container, ordered by creation, so the printed carton number matches the container order shown in the app.
  • Archived containers are excluded.
  • Filing on the order is asynchronous and archival: the labels return regardless, and the document appears shortly afterwards. Regenerating replaces the order's existing carton label document rather than adding a second copy.
  • Every container must carry an SSCC of 18 digits with a valid GS1 check digit; the retailer barcode is that SSCC prefixed with application identifier 00.

Error Scenarios​

  • The order's sales channel has no carton label mapping configured.
  • The order's integration has no Endless EDI API token.
  • The fulfillment has no containers, or a container has no SSCC.
  • Endless EDI rejects the label data; the failing field paths are returned.

Permissions Required​

  • orders:generate_fulfillment_container_labels permission
generateFulfillmentContainerLabels(
  input: GenerateFulfillmentContainerLabelsInput!
): CartonLabelBatch!

Arguments​

generateFulfillmentContainerLabels.input ● GenerateFulfillmentContainerLabelsInput! non-null input common​

Parameters for GenerateFulfillmentContainerLabels

Type​

CartonLabelBatch object shipments​

A generated batch of retailer carton labels: one PDF holding one page per container.