Entwickler · Schemas

Schemas und die Feldzuordnung der CN 23

Ein JSON Schema für Postsendungen. Es folgt der Zollinhaltserklärung CN 22 und CN 23, die die ITMATT-Nachricht der UPU in elektronischer Form überträgt.

Downloads

JSON Schema, Draft 2020-12. Prüfen Sie Ihre Kopie mit dem SHA-256-Wert.

JSON Schema 2020-12

postal-items.v1.json

Batch, Versand, Sendung und Inhalt.

SHA-256:: ddfdad6b61137e8e68298b39716200a95c2a577914c9bae8bca4b74b59d87884
Größe:: 8,237 B

Herunterladen

Beispiel

postal-items.v1.example.json

Ein Versand mit einer Sendung. Das Beispiel entspricht dem Schema.

SHA-256:: 02cf9af6f851f2b89d658b9fe4cf82bdd2270f1739ef89b3e9b081ed783bec4a
Größe:: 1,179 B

Herunterladen

OpenAPI 3.1Geplant

postal-api.v1.yaml

Die API-Beschreibung, veröffentlicht mit der Sandbox.

Inhalt der CN 23, Allied-Feld und ACE-Record

Postsendungen haben keinen Master- oder House-Luftfrachtbrief. Die S10-Sendungsnummer übernimmt diese Rolle (WCO-UPU Guidelines on Exchange of Electronic Advance Data, 2025).

Inhalt der CN 23, Allied-Feld und ACE-Record
Inhalt der CN 22 / CN 23	Allied-Feld	ACE, Anmeldungstyp 13
S10-Sendungsnummer	`item_id`	Frachtbrief in SE15 (Luft: `SFP` + S10, Aussteller leer; Lkw, Bahn, See: Aussteller `SFP`); AE 23-Record, Typ M
Absender	`sender`	Name in SE30 und Anschrift in SE35 (Pflichtangaben)
Empfänger	`addressee`	Warenempfänger in SE30 mit Name und Anschrift; Partei „Final Delivered To“
Art der Sendung	`nature_code` (UPU-Codeliste 136)	Eingabe für das Screening
Menge und detaillierte Beschreibung	`contents[].description`, `quantity`	Handelsübliche Warenbeschreibung in SE40 (Pflichtangabe)
Nettogewicht	`contents[].net_weight_kg`	Menge und Gewicht, wenn ein spezifischer Zollsatz gilt
Wert	`contents[].value`, `currency`	Positionswert in SE60 (Pflichtangabe); Wertgrenze $2,500 (Code 323)
HS-Tarifnummer	`contents[].hs_code`	10-stellige HTSUS-Nummer und Nummern nach Chapter 99 (SE60), von Allied bestimmt
Ursprungsland	`contents[].origin_country`	Ursprungsland

Felder der Sendung

Die Felder einer Sendung.

Felder der Sendung
Feld	Typ	Pflichtfeld	Regel
`item_id`	string	Ja	UPU S10: 2 Buchstaben, 8 Ziffern, Prüfziffer, 2 Buchstaben.
`nature_code`	integer	Ja	UPU-Codeliste 136.
`sender`	object	Ja	Name und Anschrift (Zeile 1, Ort, Land).
`addressee`	object	Ja	Name und US-Anschrift mit 5-stelliger Postleitzahl.
`contents[]`	array	Ja	1 bis 99 Positionen.
`contents[].description`	string	Ja	3 bis 200 Zeichen, genau genug für die Tarifierung.
`contents[].quantity`	integer	Ja	1 oder mehr.
`contents[].net_weight_kg`	number	Ja	Größer als 0.
`contents[].value`	string	Ja	Dezimalzahl mit 2 Nachkommastellen, zum Beispiel `45.00`.
`contents[].hs_code`	string	Ja	6 bis 10 Ziffern.
`contents[].origin_country`	string	Ja	Ländercode nach ISO 3166-1 alpha-2.
`currency`	string	Ja	Währungscode nach ISO 4217.
`gross_weight_kg`	number	Ja	Größer als 0.
`postage_paid`, `insurance`	string	Nein	Dezimalzahl mit 2 Nachkommastellen.
`receptacle_id`	string	Nein	Kennung nach UPU S9 für den Beutel, der die Sendung enthält.

Codes für die Art der Sendung

UPU-Codeliste 136.

Codes für die Art der Sendung
Code	Bedeutung
11	Verkauf von Waren
111	Gewerblicher Verkauf von Waren (zwischen Unternehmen)
21	Rücksendung von Waren
31	Geschenk
32	Warenmuster
91	Dokumente
999	Sonstiges

Beispiel-Batch

Die Datei postal-items.v1.example.json.

postal-items.v1.example.json

1{2  "batch_ref": "POST-DISPATCH-2026-10-01-A",3  "sent_at": "2026-10-01T09:30:00Z",4  "dispatch": {5    "dispatch_id": "DISPATCH-0001",6    "mode": "AIR",7    "carrier": "EXAMPLE AIRLINE",8    "flight_or_trip": "XX123",9    "us_port_code": "4701",10    "expected_arrival_date": "2026-10-02"11  },12  "items": [13    {14      "item_id": "CP123456785CA",15      "nature_code": 11,16      "sender": {17        "name": "EXAMPLE SHOP LTD",18        "address": {19          "line1": "100 EXAMPLE ST",20          "city": "TORONTO",21          "region": "ON",22          "postal_code": "M5V1A1",23          "country": "CA"24        }25      },26      "addressee": {27        "name": "JANE SAMPLE",28        "address": {29          "line1": "100 MAIN ST",30          "city": "NEWARK",31          "state": "NJ",32          "zip5": "07102"33        }34      },35      "contents": [36        {37          "description": "WOMEN'S KNITTED COTTON SWEATER",38          "quantity": 1,39          "net_weight_kg": 0.4,40          "value": "45.00",41          "hs_code": "611020",42          "origin_country": "CA"43        }44      ],45      "currency": "CAD",46      "gross_weight_kg": 0.5,47      "postage_paid": "18.50"48    }49  ]50}

Beginnen Sie mit einem Datentest

Senden Sie uns einen Beispielversand als JSON, CSV oder Excel. Wir melden jede Lücke in den Daten vor der ersten Anmeldung. Angebot auf Anfrage.

Rufen Sie (908) 291-8001 an oder schreiben Sie an mail@alliedchb.com

E-Mail an das Postteam Anmeldungstyp 13 im Überblick

Diese Seite ist eine Übersetzung. Die englische Fassung dieser Website ist die offizielle Fassung. Unsere Online-Formulare und Dokumente sind auf Englisch. English