基础数据格式

Address

地址信息

名称 类型 是否必须 描述 示例值
Company String 联系人公司
Street1 String 必须 街道1
Street2 String 街道2
Street3 String 街道3
City String 必须 城市
Province String 视所属国家有无州省而定 州/省
CountryCode String 国家代码（ISO 3166-1 alpha-2标准）,创建包裹时国家代码与国家英文名称二者至少得有一个 US
Country String 国家英文名称 United States
Postcode String 视所属国家有无邮编而定 邮编
Contacter String 必须 收件人 zhangsan
Tel String 收件人联系电话
Email String 收件人邮箱
TaxId String 收件人/收件公司税号。不同国家叫法不完全一样，如美国为 Tax Identification Number，巴西为 CPF/CNPJ，墨西哥为 RFC/CURP。

Money

金额

名称 类型 是否必须 描述 示例值
Code string 必须 货币类型 USD, GBP, CNY
Value decimal 必须 金额

CubeSize

尺寸规格

名称 类型 是否必须 描述 示例值
Height decimal 必须 高 1
Length decimal 必须 长 1
Width decimal 必须 宽 1
Unit string 必须 计量单位 CM=厘米, M=米

ParcelItemDetail

包裹内件明细

名称 类型 是否必须 描述 示例值
GoodsId String 货物编号 如SKU,库存编号
GoodsTitle String 货物描述
DeclaredNameEn string 必须 英文申报名称
DeclaredNameCn String 必须 中文申报名称
DeclaredValue Money 必须 单件目的国申报价值 { "Code": "USD", "Value": 15 }
ExportDeclaredValue Money 必须 单件出口申报价值 { "Code": "USD", "Value": 20 }
WeightInKg decimal 必须 单件重量(KG) 1.5
Quantity int 必须 件数
HSCode String 海关编码
CaseCode String 箱号(一票多件) Box123
SalesUrl String 销售平台链接 http://www.amazon.co.uk/gp/product/B00FEDIPQ4
IsSensitive bool 是否为敏感货物/带电/带磁等
Brand String 品牌
Model String 型号
MaterialCn String 材质（中文）
MaterialEn String 材质（英文）
UsageCn String 用途（中文）
UsageEn String 用途（英文）
Manufacturer ParcelItemManufacturer 在目的国海关备案的制造商

ParcelItemManufacturer

商品制造商

名称 类型 是否必须 描述 示例值
MID String 必须 在目的国海关备案的制造商ID
Name String 必须 商品制造商名称
Address ParcelItemManufacturerAddress 必须 商品制造商备案地址

ParcelItemManufacturerAddress

商品制造商备案地址

名称 类型 是否必须 描述 示例值
CountryCode String 必须 国家代码
State String 必须 州省
City String 必须 城市
Address String 必须 详细街道地址
PostCode String 必须 邮编

WithBatteryType

包裹带电类型

名称 描述
NOBattery 不带电
WithBattery 带电
Battery 纯电池

ParcelItemType

包裹类型

名称 描述
DOC 文件
SPX 包裹

ParcelTradeType

包裹对应订单交易类型

名称 描述
B2C B2C
B2B B2B

DutyPaymentMethod

关税付款方式方式

名称 描述
DDP Delivered Duty Paid，完税后交货
DDU Delivered Duty Unpaid，未完税交货

ParcelMPSType

包裹一票多件类型

名称 描述
Normal Normal
FBA FBA，亚马逊FBA

ParcelCaseInfo

快递一票多件箱子信息

名称 类型 是否必须 描述 示例值
Code string 必须 箱号 Box001
WeightInKg decimal 必须 箱子重量 2.5
Volume CubeSize 必须 体积

ParcelShippingMethod

发运服务

名称 类型 是否必须 描述 示例值
Code string 必须 服务代码
Name string 必须 服务名称
IsTracking bool 必须 是否挂号
IsVolumeWeight bool 必须 是否计泡
MaxVolumeWeightInCm decimal 最大体积重量限制
MaxWeightInKg decimal 最大重量限制(KG) 2
Region string 可到达区域 全球,欧洲
Description string 服务描述

Warehouse

仓库

名称 类型 是否必须 描述 示例值
Code string 必须 仓库代码
Name string 必须 仓库名称

TrackingNoProcessResult

挂号处理结果

名称 类型 是否必须 描述 示例值
Code string 必须 代码 Processing: 系统正在分配跟踪号
Success: 分配跟踪号成功
Error: 分配跟踪号失败
Message string 必须 消息文本
IsVirtual bool 必须 是否为虚拟单号

ParcelShipperInfo

发件人信息

发件人地址必须为英文或者拼音。
发往欧盟国包裹，需要提供 IOSS 税号，否则需要进行税费代缴代扣。
按美国 T86 新规，进入美国的包裹需要提供完整的发件人信息(发件人名称，具体地址、邮箱、电话)方可清关。系统优先使用包裹上的发件人地址信息进行清关，如果包裹上未提供此信息，系统则取客户资料上留存的默认发件地址。
B2B类型或者B2C的高价值包裹必须填写 EORI。
名称 类型 是否必须 描述 示例值
CountryCode string 发件人国家代码
Province string 发件人省份
City string 发件人城市
Postcode string 发件人邮编
Name string 发件人名称/公司名称
Address string 发件人地址
ContactInfo string 联系信息(邮箱 或者 电话)
Email string 发件人邮箱
Tel string 发件人电话
Taxations ParcelShipperTaxation[] 发件人税号信息，可传多个 [{"TaxType": "IOSS", "Number": "***" }]
VatNo string 已废弃，请使用 Taxations 字段
EORI string 已废弃，请使用 Taxations 字段

ParcelShipperTaxation

发件人税号信息

名称 类型 是否必须 描述 示例值
TaxType string 是 税号类型 VatNo: 增值税号，默认值。英国脱欧后，进入英国货物需要提供此值
EORI: B2B类型以及B2C的高价值包裹必须提供EORI
IOSS: 欧盟2021税改后，进入欧盟货物需要提供 IOSS
Number string 是 税号

SellingPlatformOrder

销售平台订单信息

名称 类型 是否必须 描述 示例值
SellingPlatform Url 否 销售平台官网首页链接 https://www.amazon.co.uk
SellingPlatformName string 是 电商平台名称 PDD
OrderId string 否 销售平台订单号

ProductionOrSalesCompany

生产销售单位信息

名称 类型 是否必须 描述 示例值
Name string 是 生产销售单位名称 PDD
USCC string 是 生产销售单位统一社会信用代码 91310106575864243X