Transaction Declaration Filing

File Format Requirements

Column order and fields must be fixed.

The first row must be the header.

Common Fields for Orders Across All Trade Scenarios

Field	Required	Description
`orderId`	M	Order reference, unique in the platform
`orderTime`	M	Order created time. Format: `YYYY-MM-DD HH:mm:ss`
`platform`	M	Order Platform
`sellerID`	M	The client's shop ID or seller ID on the platform
`shopURL`	M	The shop link address on the platform
`orderCurrency`	M	The order's original payment currency. ISO 4217 3-letter code allowed
`orderAmount`	M	The order's original payment amount
`equivalentCNY`	O	The equivalent amount in CNY
`beneficiaryDistrict`	M	The seller's district. ISO 3166-2 letter code allowed
`beneficiaryName`	M	The shop owner/seller's name in Chinese
`beneficiaryIdType`	M	The ID type of the seller/shop owner. Allowed values: `IDENTITY_CARD` – 身份证 `HKMOPASS` – 回乡证 (Mainland Travel Permit for Hong Kong and Macao Residents) `TWCARD` – 台胞证 (Mainland Travel Permit for Taiwan Residents) `CN_RESIDENCE_CARD` – 港澳台居住证 (Residence Permit for Hong Kong, Macao, and Taiwan Residents) `PASSPORT` – Foreign Passport
`beneficiaryID`	M	The shop owner/seller's national ID number
`MCC`	M	Merchandise Catalog Code

`Trade of goods details`

Required when MCC is one of the following:
100200, 100201, 100202, 100203, 100204, 100205 (Cross-border E-commerce Goods Trade)
100700 (Small-value B2B Goods Trade)
100800 (General Trade) — Enterprise-only; not supported in Phase 1
100900 (Market Procurement) — Enterprise-only; not supported in Phase 1

Field	Required	Description
`productName`	M	The product name of the order
`quantity`	M	The product quantity of the order
`buyerType`	O	The buyer's type. Allowed values: `INDIVIDUAL` `CORPORATE`
`buyerName`	M	The buyer's name
`buyerDistrict`	O	The buyer's district. ISO 3166-2 letter code allowed
`buyerAddress`	M	The buyer's address
`logistics`	M	The logistics company name
`logisticsTrackingNumber`	M	The logistics tracking number
`logisticsShipmentDate`	O	The shipment date of the order
`orderPaymentType`	O	The payment type of the order. Allowed values: `PAYMENT_ON_DELIVERY` `PAYMENT_IN_ADVANCE`
`customsDeclarationNo`	C	For mode `9610`: customs declaration number or customs manifest is required; for other modes: customs declaration number is required.
`customsSupervisionMode`	C	The Customs supervision mode. Allowed values: `9710` – Cross-border E-commerce B2B `9810` – Cross-border E-commerce Export Overseas Warehouse `0110` – General Trade `1039` – Market Procurement `9610` – E-commerce

`Intl. Logistics Details`

Required when MCC is one of the following:
400204, 401204, 402204, 403204, 404204, 405204, 406204, 407204, 408204, 409204, 410204
Enterprise-only; not supported in Phase 1

Field	Required	Description
`goodsName`	O	Logistics carrier commodity name. Multiple entries allowed if a batch involves multiple commodities.
`logistics`	M	Logistics company name
`logisticsTrackingNumber`	M	Logistics tracking number
`logisticsMode`	O	Allowed values: `DECLARE_TO_CUSTOMS` – Customs Declaration `DIRECT_MAIL` – Direct Mail
`destinationCountry`	M	Destination Country
`departureCountry`	M	Departure Country

`Advertising Details`

Required when MCC = 228024 (Advertising Services). Only one set allowed per order.

Field	Required	Description
`productName`	M	Advertising service name
`advertisingPlatform`	M	Advertising Platform

`Software Provider`

Required when MCC is one of the following:
400207, 400210, 401210, 400208, 400209, 400205, 228023 (Software & Related Services)

Field	Required	Description
`productName`	M
`productId`	M
`serviceProvider`	O

`Conference Details`

Enterprise-only; not supported in Phase 1

Field	Required	Description
`conferenceName`	M
`organizer`	O
`hostCountry`	O
`participant`	M
`contactNumber`	O
`participationDate`	O

Transaction Declaration Filing

File Format Requirements#

Common Fields for Orders Across All Trade Scenarios#

Trade of goods details#

Intl. Logistics Details#

Advertising Details#

Software Provider#