> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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,…

`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

<ParamField path="partner_id" type="string" required>
  Partner ID
</ParamField>

<ParamField path="level" type="string" required>
  Pack level: carton | inner | each
</ParamField>

### Request body

`Asn856`

<ParamField body="bol_number" type="string">
  REF\*BM — bill of lading.
</ParamField>

<ParamField body="carrier_scac" type="string">
  TD503 — Standard Carrier Alpha Code.
</ParamField>

<ParamField body="orders" type="AsnOrder[]" required />

<ParamField body="packages" type="integer (int32)">
  TD101 / TD102 — packaging code and lading quantity (e.g. CTN25 × 3).
</ParamField>

<ParamField body="ship_date" type="string (date)" required />

<ParamField body="ship_from" type="object" />

<ParamField body="ship_time" type="string">
  HHMM; defaults to 0000 on the wire when absent.
</ParamField>

<ParamField body="ship_to" type="object" />

<ParamField body="shipment_id" type="string" required>
  BSN02 — shipment identification.
</ParamField>

<ParamField body="tracking_number" type="string">
  REF\*CN — carrier pro / tracking number.
</ParamField>

<ParamField body="transport_method" type="string">
  TD504 — transportation method (M motor, A air, ...).
</ParamField>

<ParamField body="weight" type="string">
  TD107/TD108 — total weight and unit.
</ParamField>

<ParamField body="weight_uom" type="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        |

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://edi.stateset.com/v1/labels/856/{partner_id}/level/{level}' \
    --header 'Authorization: Bearer YOUR_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"
  }'
  ```
</RequestExample>