开发者 · Schema
Schema 和 CN 23 字段对照表
邮件使用一个 JSON Schema。它遵循 CN 22 和 CN 23 海关申报单，UPU ITMATT 报文以电子形式传送该申报单。
下载
JSON Schema 草案 2020-12。请用 SHA-256 值核对您的副本。
JSON Schema 2020-12
postal-items.v1.json批次、总包、邮件和内件。
- SHA-256:
- ddfdad6b61137e8e68298b39716200a95c2a577914c9bae8bca4b74b59d87884
- 大小:
- 8,237 B
示例
postal-items.v1.example.json一个总包，含一件邮件。它通过 Schema 校验。
- SHA-256:
- 02cf9af6f851f2b89d658b9fe4cf82bdd2270f1739ef89b3e9b081ed783bec4a
- 大小:
- 1,179 B
OpenAPI 3.1计划中
postal-api.v1.yamlAPI 描述文件，随沙盒环境一同发布。
CN 23 内容、Allied 字段和 ACE 记录
邮件没有主运单或分运单。S10 邮件标识符起到这一作用（WCO-UPU 电子预先数据交换指南，2025年）。
| CN 22 / CN 23 内容 | Allied 字段 | ACE，报关类型 13 |
|---|---|---|
| S10 邮件标识符 | item_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） |
| HS 税则号 | contents[].hs_code | 10 位 HTSUS 税号和 Chapter 99 税号（SE60），由 Allied 确定 |
| 原产国 | contents[].origin_country | 原产国 |
邮件字段
一件邮件的字段。
| 字段 | 类型 | 必填 | 规则 |
|---|---|---|---|
item_id | string | 是 | UPU S10：2 个字母、8 位数字、校验码、2 个字母。 |
nature_code | integer | 是 | UPU 代码表 136。 |
sender | object | 是 | 姓名和地址（地址第 1 行、城市、国家）。 |
addressee | object | 是 | 姓名和美国地址，含 5 位 ZIP 邮编。 |
contents[] | array | 是 | 1 至 99 行。 |
contents[].description | string | 是 | 3 至 200 个字符，须足够具体，以便归类。 |
contents[].quantity | integer | 是 | 1 或以上。 |
contents[].net_weight_kg | number | 是 | 大于 0。 |
contents[].value | string | 是 | 保留 2 位小数的十进制数，例如 45.00 。 |
contents[].hs_code | string | 是 | 6 至 10 位数字。 |
contents[].origin_country | string | 是 | ISO 3166-1 alpha-2 国家代码。 |
currency | string | 是 | ISO 4217 货币代码。 |
gross_weight_kg | number | 是 | 大于 0。 |
postage_paid, insurance | string | 否 | 保留 2 位小数的十进制数。 |
receptacle_id | string | 否 | 装载该邮件的邮袋的 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
本页为翻译版本。本网站以英文版为正式版本。我们的在线表格及文件均为英文。 English