Skip to main content

開發者 · 結構描述

結構描述及 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

一批發運，內含一件郵件。此範例通過結構描述驗證。

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 內容Allied 欄位ACE，報關類型 13
S10 郵件識別碼item_idSE15 提單（空運：SFP + S10，簽發人空白；卡車、鐵路、海運：簽發人 SFP）；AE 23 記錄 type M
寄件人senderSE30 姓名及 SE35 地址（必填）
收件人addresseeSE30 收貨人，以姓名及地址申報；最終送達方（Final Delivered To）
郵件類別nature_code（UPU 代碼表 136）篩查輸入資料
數量及詳細描述contents[].description, quantitySE40 商業描述（必填）
淨重contents[].net_weight_kg適用從量稅率時的數量及重量
價值contents[].value, currencySE60 項次價值（必填）；$2,500 上限（代碼 323）
HS 稅則號碼contents[].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 位數郵遞區號的美國地址。
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