> ## 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 a UCC-128 shipping label (SSCC-18 + ZPL) from an 856 ASN body…

> SSCC + ZPL shipping label

### Path parameters

**partner\_id** `string` *required*

Partner ID

### Request body

`Asn856`

**bol\_number** `string,null`

REF\*BM — bill of lading.

**carrier\_scac** `string,null`

TD503 — Standard Carrier Alpha Code.

**orders** `AsnOrder[]` *required*

**AsnOrder**

**cartons** `AsnPack[]`

Carton/pack level: each carton carries an SSCC-18 (emitted as `HL*…*P` with `MAN*GM`) and the items packed in it. When non-empty, the ASN uses the S→O→P→I hierarchy retailers like QVC require, and `items` is ignored.

**AsnPack**

**items** `AsnItem[]` *required*

**sscc** `string` *required*

SSCC-18 marked on the carton's GS1-128 label (MAN\*GM). Must match the physical label so the carton scans against the ASN.

**items** `AsnItem[]`

Items shipped directly under the order (no carton breakdown). Used when `cartons` is empty.

**AsnItem**

**quantity** `string` *required*

**sku** `string` *required*

**sku\_qualifier** `string`

LIN qualifier for the identifier, e.g. SK / VN / UP.

**uom** `string`

**pallets** `AsnPallet[]`

Pallet (tare) level: each pallet carries its own SSCC-18 (emitted as `HL*…*T` with `MAN*GM`) and the cartons stacked on it, giving the S→O→T→P→I hierarchy. Pallets are emitted before any loose `cartons` (cartons shipped under the order without a pallet). When non-empty, `items` is ignored. Empty by default, so existing payloads (and their wire output) are unchanged.

**AsnPallet**

**cartons** `AsnPack[]`

Cartons on this pallet; each is an `HL*…*P` whose parent is the pallet.

**sscc** `string` *required*

SSCC-18 marked on the pallet's GS1-128 label (MAN\*GM on the `HL*…*T`).

**po\_number** `string` *required*

PRF01 — the buyer's PO number this shipment fulfills.

**packages** `integer,null (int32)`

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

**ship\_date** `string (date)` *required*

**ship\_from** `Party,null`

An N1 party loop (N1/N2/N3/N4).

**Party**

**address\_lines** `string[]`

**city** `string,null`

**country** `string,null`

**id** `string,null`

**id\_qualifier** `string,null`

N103/N104 — identification qualifier and code (e.g. `92` + store #).

**name** `string` *required*

**postal\_code** `string,null`

**role** `string` *required*

N101 entity identifier code: ST ship-to, BT bill-to, SF ship-from, VN vendor, BY buyer, ...

**state** `string,null`

**ship\_time** `string,null`

HHMM; defaults to 0000 on the wire when absent.

**ship\_to** `Party,null`

An N1 party loop (N1/N2/N3/N4).

**Party**

**address\_lines** `string[]`

**city** `string,null`

**country** `string,null`

**id** `string,null`

**id\_qualifier** `string,null`

N103/N104 — identification qualifier and code (e.g. `92` + store #).

**name** `string` *required*

**postal\_code** `string,null`

**role** `string` *required*

N101 entity identifier code: ST ship-to, BT bill-to, SF ship-from, VN vendor, BY buyer, ...

**state** `string,null`

**shipment\_id** `string` *required*

BSN02 — shipment identification.

**tracking\_number** `string,null`

REF\*CN — carrier pro / tracking number.

**transport\_method** `string,null`

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

**weight** `string,null`

TD107/TD108 — total weight and unit.

**weight\_uom** `string,null`

### Response

No response body. SSCC + ZPL shipping label.

### Status codes

| Code | Meaning |
| - | - |
| `200` | SSCC + ZPL shipping label |
| `403` | Not this credential's partner |
| `422` | GS1 company prefix not configured, or invalid ASN |

### Using this contract

Read the [source OpenAPI document](https://docs.stateset.com/spec/edi.json) for declared schemas and alternatives.
This page also includes documented corrections from the [spec overlays](https://github.com/stateset/docs/tree/main/spec/overlays).
Example IDs and values are illustrative; replace them with records from your workspace.

```bash cURL theme={null}
curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/labels/856/{partner_id}' \
  --header "Authorization: Bearer $EDI_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
  "shipment_id": "SHIP-123",
  "ship_date": "2026-10-20",
  "carrier_scac": "UPSN",
  "orders": [
    {
      "po_number": "PO-123",
      "cartons": [
        {
          "sscc": "000123456000000012",
          "items": [
            {
              "sku": "SKU-123",
              "quantity": "3",
              "sku_qualifier": "SK",
              "uom": "EA"
            }
          ]
        }
      ]
    }
  ]
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.