Skip to main content

Dla programistów · Schematy

Schematy i mapowanie pól CN 23

Jeden schemat w formacie JSON Schema dla przesyłek pocztowych. Odwzorowuje deklarację celną CN 22 i CN 23, którą komunikat UPU ITMATT przekazuje w formie elektronicznej.

Do pobrania

JSON Schema, draft 2020-12. Za pomocą wartości SHA-256 mogą Państwo sprawdzić swoją kopię.

JSON Schema 2020-12

postal-items.v1.json

Partia, ekspedycja, przesyłka i zawartość.

SHA-256:
ddfdad6b61137e8e68298b39716200a95c2a577914c9bae8bca4b74b59d87884
Rozmiar:
8,237 B
Pobierz

Przykład

postal-items.v1.example.json

Jedna ekspedycja z jedną przesyłką. Jest zgodna ze schematem.

SHA-256:
02cf9af6f851f2b89d658b9fe4cf82bdd2270f1739ef89b3e9b081ed783bec4a
Rozmiar:
1,179 B
Pobierz

OpenAPI 3.1Planowane

postal-api.v1.yaml

Opis API, publikowany razem ze środowiskiem testowym.

Zawartość CN 23, pole Allied i rekord ACE

Przesyłki pocztowe nie mają głównego lotniczego listu przewozowego (master air waybill) ani lotniczego listu przewozowego spedytora (house air waybill). Tę rolę pełni identyfikator przesyłki S10 (WCO-UPU Guidelines on Exchange of Electronic Advance Data, 2025).
Zawartość CN 23, pole Allied i rekord ACE
Zawartość CN 22 / CN 23Pole AlliedACE, zgłoszenie typu 13
Identyfikator przesyłki S10item_idList przewozowy SE15 (transport lotniczy: SFP + S10, pole wystawcy puste; drogowy, kolejowy, morski: wystawca SFP); AE, rekord 23, typ M
NadawcasenderNazwa SE30 i adres SE35 (obowiązkowe)
AdresataddresseeOdbiorca SE30 według nazwy i adresu; strona Final Delivered To
Kategoria przesyłkinature_code (lista kodów UPU 136)Dane do analizy ryzyka
Ilość i szczegółowy opiscontents[].description, quantityOpis handlowy SE40 (obowiązkowy)
Waga nettocontents[].net_weight_kgIlość i waga, gdy ma zastosowanie stawka specyficzna
Wartośćcontents[].value, currencyWartość pozycji SE60 (obowiązkowa); limit $2,500 (kod 323)
Numer taryfowy HScontents[].hs_code10-cyfrowy numer HTSUS i numery z Chapter 99 (SE60), nadawane przez Allied
Kraj pochodzeniacontents[].origin_countryKraj pochodzenia

Pola przesyłki

Pola jednej przesyłki.
Pola przesyłki
PoleTypWymaganeReguła
item_idstringTakUPU S10: 2 litery, 8 cyfr, cyfra kontrolna, 2 litery.
nature_codeintegerTakLista kodów UPU 136.
senderobjectTakNazwa i adres (wiersz 1, miejscowość, kraj).
addresseeobjectTakNazwa i adres w USA z 5-cyfrowym kodem ZIP.
contents[]arrayTakOd 1 do 99 pozycji.
contents[].descriptionstringTakOd 3 do 200 znaków, opis wystarczająco szczegółowy do klasyfikacji.
contents[].quantityintegerTak1 lub więcej.
contents[].net_weight_kgnumberTakWięcej niż 0.
contents[].valuestringTakLiczba dziesiętna z 2 miejscami dziesiętnymi, na przykład 45.00.
contents[].hs_codestringTakOd 6 do 10 cyfr.
contents[].origin_countrystringTakKod kraju ISO 3166-1 alpha-2.
currencystringTakKod waluty ISO 4217.
gross_weight_kgnumberTakWięcej niż 0.
postage_paid, insurancestringNieLiczba dziesiętna z 2 miejscami dziesiętnymi.
receptacle_idstringNieIdentyfikator UPU S9 worka, w którym jest przesyłka.

Kody rodzaju przesyłki

Lista kodów UPU 136.
Kody rodzaju przesyłki
KodZnaczenie
11Sprzedaż towarów
111Handlowa sprzedaż towarów (między firmami)
21Towary zwracane
31Prezent
32Próbka handlowa
91Dokumenty
999Inne

Przykładowa partia

Plik postal-items.v1.example.json.
postal-items.v1.example.json
{  "batch_ref": "POST-DISPATCH-2026-10-01-A",  "sent_at": "2026-10-01T09:30:00Z",  "dispatch": {    "dispatch_id": "DISPATCH-0001",    "mode": "AIR",    "carrier": "EXAMPLE AIRLINE",    "flight_or_trip": "XX123",    "us_port_code": "4701",    "expected_arrival_date": "2026-10-02"  },  "items": [    {      "item_id": "CP123456785CA",      "nature_code": 11,      "sender": {        "name": "EXAMPLE SHOP LTD",        "address": {          "line1": "100 EXAMPLE ST",          "city": "TORONTO",          "region": "ON",          "postal_code": "M5V1A1",          "country": "CA"        }      },      "addressee": {        "name": "JANE SAMPLE",        "address": {          "line1": "100 MAIN ST",          "city": "NEWARK",          "state": "NJ",          "zip5": "07102"        }      },      "contents": [        {          "description": "WOMEN'S KNITTED COTTON SWEATER",          "quantity": 1,          "net_weight_kg": 0.4,          "value": "45.00",          "hs_code": "611020",          "origin_country": "CA"        }      ],      "currency": "CAD",      "gross_weight_kg": 0.5,      "postage_paid": "18.50"    }  ]}

Zacznijmy od testu danych

Prosimy przesłać przykładową ekspedycję w formacie JSON, CSV lub Excel. Przed pierwszym zgłoszeniem informujemy o każdej luce w danych. Wycena na zapytanie.

Prosimy dzwonić pod (908) 291-8001 lub pisać na mail@alliedchb.com

E-mail do działu pocztowegoZgłoszenie typu 13: omówienie

Ta strona jest tłumaczeniem. Oficjalną wersją tej witryny jest wersja angielska. Nasze formularze online i dokumenty są w języku angielskim. English