Skip to main content

Розробникам · Схеми

Схеми та відповідність полів CN 23

Одна JSON Schema для поштових відправлень. Вона відповідає митній декларації CN 22 і CN 23, яку повідомлення UPU ITMATT передає в електронній формі.

Файли для завантаження

JSON Schema draft 2020-12. Перевірте свою копію за значенням SHA-256.

JSON Schema 2020-12

postal-items.v1.json

Пакет, відправка, відправлення та вміст.

SHA-256:
ddfdad6b61137e8e68298b39716200a95c2a577914c9bae8bca4b74b59d87884
Розмір:
8,237 B
Завантажити

Приклад

postal-items.v1.example.json

Одна відправка з одним відправленням. Вона проходить перевірку за схемою.

SHA-256:
02cf9af6f851f2b89d658b9fe4cf82bdd2270f1739ef89b3e9b081ed783bec4a
Розмір:
1,179 B
Завантажити

OpenAPI 3.1Заплановано

postal-api.v1.yaml

Опис API, який публікується разом із тестовим середовищем.

Вміст CN 23, поле Allied і запис ACE

Поштові відправлення не мають основної чи домашньої авіанакладної. Цю роль виконує ідентифікатор відправлення S10 (Настанови WCO-UPU щодо обміну електронними попередніми даними, 2025).
Вміст CN 23, поле Allied і запис ACE
Вміст CN 22 / CN 23Поле AlliedACE, декларація типу 13
Ідентифікатор відправлення S10item_idНакладна в SE15 (авіа: SFP + S10, поле видавця порожнє; автомобільний, залізничний, морський транспорт: видавець SFP); запис AE 23, тип M
ВідправникsenderІм’я (SE30) і адреса (SE35), обов’язкові
АдресатaddresseeВантажоодержувач у SE30 за ім’ям та адресою; сторона кінцевої доставки (Final Delivered To)
Категорія відправленняnature_code (список кодів UPU 136)Вхідні дані для скринінгу
Кількість і докладний описcontents[].description, quantityКомерційний опис у SE40 (обов’язковий)
Вага неттоcontents[].net_weight_kgКількість і вага, якщо застосовується специфічна ставка мита
Вартістьcontents[].value, currencyВартість рядка в SE60 (обов’язкова); ліміт $2,500 (код 323)
Тарифний номер HScontents[].hs_code10-значний номер HTSUS і номери Chapter 99 (SE60), які присвоює Allied
Країна походженняcontents[].origin_countryКраїна походження

Поля відправлення

Поля одного відправлення.
Поля відправлення
ПолеТипОбов’язковеПравило
item_idstringТакUPU S10: 2 літери, 8 цифр, контрольна цифра, 2 літери.
nature_codeintegerТакСписок кодів UPU 136.
senderobjectТакІм’я та адреса (рядок 1, місто, країна).
addresseeobjectТакІм’я та адреса в США з 5-значним ZIP-кодом.
contents[]arrayТакВід 1 до 99 рядків.
contents[].descriptionstringТакВід 3 до 200 символів, достатньо точний для класифікації.
contents[].quantityintegerТак1 або більше.
contents[].net_weight_kgnumberТакБільше ніж 0.
contents[].valuestringТакДесяткове число з 2 знаками після крапки, наприклад 45.00.
contents[].hs_codestringТакВід 6 до 10 цифр.
contents[].origin_countrystringТакКод країни за ISO 3166-1 alpha-2.
currencystringТакКод валюти за ISO 4217.
gross_weight_kgnumberТакБільше ніж 0.
postage_paid, insurancestringНіДесяткове число з 2 знаками після крапки.
receptacle_idstringНіІдентифікатор UPU S9 мішка, у якому перебуває відправлення.

Коди категорії відправлення

Список кодів UPU 136.
Коди категорії відправлення
КодЗначення
11Продаж товарів
111Комерційний продаж товарів (між підприємствами)
21Повернені товари
31Подарунок
32Комерційний зразок
91Документи
999Інше

Приклад пакета

Файл 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"    }  ]}

Почніть із тестування даних

Надішліть нам зразок відправки в JSON, CSV або Excel. Ми повідомляємо про кожну прогалину в даних до першої декларації. Вартість за запитом.

Телефонуйте (908) 291-8001 або пишіть на mail@alliedchb.com

Написати поштовому відділуОгляд декларації типу 13

Ця сторінка є перекладом. Офіційною версією цього сайту є англійська версія. Наші онлайн-форми та документи складено англійською мовою. English