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); запись 23 в AE, тип 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