Build China Customs Declaration (报关单) Data via the Single Window
Skill: Convert shipment data into the China customs declaration dataset submitted through the International Trade Single Window
Region: China (中国) Category: Customs — 报关 (customs declaration) Does: Takes export/import shipment data and maps it onto the China customs declaration (报关单 / 中华人民共和国海关进出口货物报关单) dataset, submitted electronically through the China International Trade Single Window (中国国际贸易单一窗口) to the General Administration of Customs (海关总署 / GACC). System: 中国国际贸易单一窗口 (China International Trade Single Window) — 进/出口货物报关单, administered by 海关总署 (GACC)
The customs declaration is portal-mediated: the declaration data is entered or imported into the 单一窗口 standard application (报关单录入 / QP message), validated and lodged to GACC, which returns the declaration status and the 报关单号 (customs declaration number). There is no public fixed third-party schema for general use; the field names below follow the official 报关单 fill-in specification (报关单填制规范) and the Single Window data items, which GACC revises periodically. Confidence is at the example level.
When this applies
- A consignor/consignee or a customs broker (报关企业) lodges an import (进口) or export (出口) goods declaration for a shipment crossing the Chinese customs border.
- One declaration covers goods under the same mode of transport / contract / mode of trade (贸易方式) for one customs office; multiple HS lines are listed as 商品项 (commodity items).
- Linked records — manifest (舱单), the goods declaration, and (where applicable) inspection/quarantine items — are consolidated under the Single Window's integrated 报关报检 flow.
Input data required
| Group | Fields |
|---|---|
| Header | 进/出口 flag, 境内收发货人 / 境外收发货人, 申报单位 (declarant), 备案号 (filing no.) |
| Customs | 进出境关别 (customs office), 进/出口日期, 申报日期, 运输方式 (mode), 运输工具名称, 提运单号 (B/L no.) |
| Trade | 监管方式 / 贸易方式 (mode of trade, e.g. 一般贸易 0110), 征免性质, 成交方式 (trade terms: FOB/CIF/CFR…) |
| Geography | 启运国/运抵国 (country of departure/arrival), 指运港/装货港, 境内目的地/货源地 |
| Charges | 运费 (freight), 保费 (insurance), 杂费 (other charges) |
| Commodity items[] | 商品编号 (HS code, 10-digit), 商品名称及规格型号, 数量及单位, 单价 / 总价 / 币制, 原产国/目的国, 征免方式 |
| Documents | contract no., invoice no., packing, 件数 / 包装种类, 毛重/净重 (kg), 集装箱号 (container) |
Field structure (报关单, conceptual)
报关单 (进口/出口货物报关单)
├── 表头 (header)
│ ├── 预录入编号 / 海关编号(报关单号, GACC-assigned)
│ ├── 境内收发货人 / 境外收发货人 / 生产销售单位 / 申报单位 (各含 18位统一社会信用代码 or 海关编码)
│ ├── 进出境关别 / 进出口日期 / 申报日期
│ ├── 运输方式 / 运输工具名称 / 提运单号
│ ├── 监管方式(贸易方式) / 征免性质 / 备案号
│ ├── 成交方式(FOB/CIF/CFR) / 运费 / 保费 / 杂费 / 币制
│ └── 启运国(地区) / 运抵国(地区) / 指运港 / 境内目的地
├── 表体 (commodity items[])
│ └── 项号 · 商品编号(HS,10位) · 商品名称及规格型号 · 数量及单位 · 单价 · 总价 · 币制 · 原产国 · 最终目的国 · 征免
└── 其他: 件数 / 包装种类 / 毛重 / 净重 / 集装箱号 / 随附单证 / 标记唛码及备注
Calculation rules
- Each commodity item: 总价 (line total) = 单价 × 数量, in the stated 币制 (currency); the 数量及单位 must match the legal unit (法定计量单位) for that HS code.
- 成交方式 (trade terms) drives the customs value build-up: CIF is the basis for duty; from FOB add 运费 + 保费; from CFR/C&F add 保费 — declare 运费/保费/杂费 accordingly so GACC can derive the dutiable value.
- 商品编号 (HS code) is the 10-digit China HS code (8-digit international heading + 2 national digits); it determines duty rate, VAT/consumption tax on import, and any regulatory/inspection conditions (监管证件).
- 毛重/净重 in kilograms; declared currency consistent across the header and items where required; 件数 reconciles to packing.
Worked example (export declaration, one HS line — outline)
进/出口: 出口 申报日期: 2026-05-20 海关编号: (GACC-assigned on acceptance)
境内发货人: 上海示例科技有限公司 (统一社会信用代码 91310115MA1K3XYZ7A)
境外收货人: EXAMPLE TRADING LLC
申报单位: 上海示例报关有限公司
进出境关别: 上海浦东海关 运输方式: 航空运输 提运单号: 020-12345678
监管方式: 一般贸易 (0110) 征免性质: 一般征税 成交方式: FOB
运抵国(地区): 美国 指运港: 洛杉矶 境内货源地: 上海
商品项:
项号 商品编号(HS) 商品名称及规格型号 数量及单位 单价(USD) 总价(USD) 原产国 最终目的国
1 8517620000 交换机/网络设备 Model X 100 台 500.00 50000.00 中国 美国
件数: 20 CTN 包装种类: 纸箱 毛重: 1200 KG 净重: 1100 KG 币制: 美元(USD)
集装箱号: — 随附单证: 合同 HT-2026-0520 / 发票 INV-2026-0520 / 装箱单
Entered/imported into the 单一窗口 报关单 application and lodged to GACC; the system returns acceptance and the 海关编号 (报关单号).
Validation checklist
- Current 报关单 fill-in specification / Single Window data items used; 进口/出口 flag correct
- Parties (境内收发货人 / 申报单位 / 生产销售单位) with valid 18-digit 统一社会信用代码 or 海关编码
- 监管方式(贸易方式) and 征免性质 correct; 备案号 supplied where the trade mode requires it
- Each commodity item: valid 10-digit 商品编号 (HS), 法定计量单位, 单价 × 数量 = 总价, 原产国/目的国
- 成交方式 (FOB/CIF/CFR) consistent with declared 运费/保费/杂费 for the dutiable-value build-up
- 毛重/净重 in kg, 件数/包装 reconcile; 随附单证 (合同/发票/装箱单) and any 监管证件 attached
- Lodged via the 中国国际贸易单一窗口; GACC acceptance and 海关编号 (报关单号) recorded
Last updated: 2026-06-04 — confirm the active schema version, field codes, and portal/API requirements against the current State Taxation Administration (STA) specifications before use.