Generates GS1 labels at a specific pack **level** — carton (SSCC, AI 00),

inner (a case of one trade item: GTIN AI 02 + count AI 37), or each (a single unit: GTIN AI 01) — applying the partner’s [LabelProfile] placement (size,…

POST /v1/labels/856/{partner_id}/level/{level}

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/labels/856/{partner_id}/level/{level}' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "bol_number": "string",
  "carrier_scac": "string",
  "orders": [
    {
      "cartons": [],
      "items": [],
      "po_number": "ORD-10042"
    }
  ],
  "packages": 1,
  "ship_date": "2026-08-31",
  "ship_from": {
    "address_lines": [
      "548 Market St"
    ],
    "city": "San Francisco",
    "country": "US",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id_qualifier": "string",
    "name": "Two-Person Tent",
    "postal_code": "94107",
    "role": "string",
    "state": "CA"
  },
  "ship_time": "2026-08-31T14:22:05Z",
  "ship_to": {
    "address_lines": [
      "548 Market St"
    ],
    "city": "San Francisco",
    "country": "US",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id_qualifier": "string",
    "name": "Two-Person Tent",
    "postal_code": "94107",
    "role": "string",
    "state": "CA"
  },
  "shipment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tracking_number": "1Z999AA10123456784",
  "transport_method": "string",
  "weight": "string",
  "weight_uom": "string"
}'

inner (a case of one trade item: GTIN AI 02 + count AI 37), or each (a single unit: GTIN AI 01) — applying the partner’s [LabelProfile] placement (size, darkness, required mark). Pallet labels come from the carton endpoint with ?pallet_sscc=.

Path parameters

partner_id · string · required

Partner ID

level · string · required

Pack level: carton | inner | each

Request body

Asn856

bol_number · string

REF*BM — bill of lading.

carrier_scac · string

TD503 — Standard Carrier Alpha Code.

orders · AsnOrder[] · required

packages · integer (int32)

TD101 / TD102 — packaging code and lading quantity (e.g. CTN25 × 3).

ship_date · string (date) · required

ship_from · object

ship_time · string

HHMM; defaults to 0000 on the wire when absent.

ship_to · object

shipment_id · string · required

BSN02 — shipment identification.

tracking_number · string

REF*CN — carrier pro / tracking number.

transport_method · string

TD504 — transportation method (M motor, A air, …).

weight · string

TD107/TD108 — total weight and unit.

weight_uom · string

Response

No response body. Labels for the requested pack level.

Status codes

Code	Meaning
200	Labels for the requested pack level
403	Not this credential’s partner
422	Unknown level or invalid ASN

cURL

curl --request POST \
  --url 'https://edi.stateset.com/v1/labels/856/{partner_id}/level/{level}' \
  --header "Authorization: Bearer $STATESET_EDI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "bol_number": "string",
  "carrier_scac": "string",
  "orders": [
    {
      "cartons": [],
      "items": [],
      "po_number": "ORD-10042"
    }
  ],
  "packages": 1,
  "ship_date": "2026-08-31",
  "ship_from": {
    "address_lines": [
      "548 Market St"
    ],
    "city": "San Francisco",
    "country": "US",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id_qualifier": "string",
    "name": "Two-Person Tent",
    "postal_code": "94107",
    "role": "string",
    "state": "CA"
  },
  "ship_time": "2026-08-31T14:22:05Z",
  "ship_to": {
    "address_lines": [
      "548 Market St"
    ],
    "city": "San Francisco",
    "country": "US",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id_qualifier": "string",
    "name": "Two-Person Tent",
    "postal_code": "94107",
    "role": "string",
    "state": "CA"
  },
  "shipment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tracking_number": "1Z999AA10123456784",
  "transport_method": "string",
  "weight": "string",
  "weight_uom": "string"
}'