| 一级字段 | 二级字段 | 三级字段 | 类型 | 长度限制 | 中文含义 | 描述 | 是否必填 | 补充描述 |
| orderType |
|
| String |
| 订单类型 | 枚举: B2C=小包直邮 Fulfillment=仓库一件代发 | M |
|
| facility |
|
| String | 50 | 发件人网点/仓库代码 | B2C:发货人网点 Fulfillment:仓库代码 | M |
|
referenceNo |
|
| String | 50 | 订单唯一编码 | 区分不同订单用 | M |
|
| originPortCode |
|
| String |
| 始发港(空港/海港) | 英文代码 | O |
|
| injectPortCode |
|
| String | 50 | 目的港 | 英文代码 | O |
|
| channelCode |
|
| String | 64 | 渠道名称 | 英文、英文标点 | M |
|
| channelOption |
|
| String | 64 | 渠道选项 | 英文、英文标点 | O |
|
| platform |
|
| Short | 20 | 平台 | 枚举:请按照页面底部附件“平台名称”要求填写 | O |
|
| incoterm |
|
| String | 50 | 贸易术语 | 枚举:DDU、DDP | O |
|
| collectionType |
|
|
| 20 | 揽收类型 | 枚举 Pick up上门揽收 Drop off自送到仓 不填默认Drop off | O |
|
isInsurance |
|
| Boolean | 5 | 是否投保 | boolean 不填默认false | O |
|
isSignature |
|
| Boolean | 5 | 是否签名 | boolean 不填默认false | O |
|
| remark |
|
|
| 200 | 备注 |
| O |
|
| isOffLineOrder |
|
| Boolean |
| 是否线下订单 | boolean 不填默认false | O | orderType=Fulfillment相关参数 |
| isNeedConfirm |
|
| Boolean |
| 是否自动确认发送 | 默认为true true则无需再调用8.预报出库单接口,会自动进行预报 false则需要再调用8.预报出库单接口,否则订单只是草稿订单 |
| orderType=Fulfillment相关参数 |
| extendData |
|
|
|
| 拓展字段 | 比如IOSS key-value形式 |
|
|
| consignee | addressCode |
| String | 50 | 收件人地址代码 | 比如ONT8表示某个亚马逊仓库 |
consignee |
|
|
| name |
| String | 50 | 收件人姓名 |
| M | orderType=Fulfillment :必填; orderType=B2C :必填; |
consigneeconsignee | consignee | consignee |
|
|
|
| countryCode |
| String | 2 | 目的国二字代码 | 英文代码 | M | orderType=Fulfillment :必填; orderType=B2C :必填; |
consigneeconsignee |
|
|
|
| city |
| String | 80 | 收件人城市 |
| M | orderType=Fulfillment :必填; orderType=B2C :必填; |
consigneeconsignee |
|
|
|
| addressLine1 |
| String | 200 | 收件人地址第一行 |
| M | orderType=Fulfillment :必填; orderType=B2C :必填; |
consignee | | addressLine2 |
| String | 200 | 收件人地址第二行 |
consignee |
|
|
|
| addressLine3 |
| String | 80 | 收件人地址第三行 |
consignee | consigneeconsignee | consignee |
|
|
|
| extendData |
|
|
| 拓展字段 |
|
|
|
| shipper | name |
| String | 50 | 发件人姓名 |
|
| orderType=B2C 才可以填写shipper 对象,且非必填 |
shipper | orderType=B2C 才可以填写shipper 对象,且非必填 | shipperorderType=B2C 才可以填写shipper 对象,且非必填 | shipperorderType=B2C才可以填写shipper 对象,且非必填
shipper |
|
|
| countryCode |
| String | 2 | 始发国二字代码 | 英文代码 |
orderType=B2C 才可以填写shipper 对象,且非必填 | shipper | shipper | city | String | 80 | 发件人城市 | orderType=B2C 才可以填写shipper 对象,且非必填 | shipper | orderType=B2C 才可以填写shipper 对象,且非必填 | shipper | | city |
| String | 80 | 发件人城市 |
|
|
| district |
| String | 128 | 发件人区 |
orderType=B2C 才可以填写shipper 对象,且非必填 | shipper | | addressLine1 |
| String | 200 | 发件人地址第一行 |
orderType=B2C 才可以填写shipper 对象,且非必填 | | addressLine2 |
| String | 200 | 发件人地址第二行 |
orderType=B2C
才可以填写shipper 对象,且非必填shipper |
|
|
| addressLine3 |
| String | 80 | 发件人地址第三行 |
orderType=B2C
才可以填写shipper 对象,且非必填shipper | orderType=B2C 才可以填写shipper 对象,且非必填 | shipper | shipper | orderType=B2C 才可以填写shipper 对象,且非必填 | extendDataorderType=B2C 才可以填写shipper 对象,且非必填 | shipper | orderType=B2C才可以填写shipper 对象,且非必填
|
|
returnAddress | returnOption | 退件选项 | String | 50 | 枚举:退件、销毁 |
|
| orderType=B2C 才可以填写returnAddress对象,且非必填 |
returnAddress | returnAddress | orderType=B2C 才可以填写returnAddress对象,且非必填 | returnAddress | orderType=B2C 才可以填写returnAddress对象,且非必填 | orderType=B2C才可以填写returnAddress对象,且非必填
returnAddress | orderType=B2C
才可以填写returnAddress对象,且非必填returnAddress |
|
|
|
| countryCode | 退件人国家二字代码 | String | 2 | 英文代码 | 英文代码 |
orderType=B2C 才可以填写returnAddress对象,且非必填 | returnAddress | returnAddress | orderType=B2C 才可以填写returnAddress对象,且非必填 | returnAddress | district | orderType=B2C 才可以填写returnAddress对象,且非必填 | orderType=B2C
才可以填写returnAddress对象,且非必填returnAddress | returnAddress |
|
|
|
| addressLine1 | 退件人地址第一行 | String | 200 |
orderType=B2C 才可以填写returnAddress对象,且非必填 | returnAddress | | addressLine2 | 退件人地址第二行 | String | 200 |
orderType=B2C 才可以填写returnAddress对象,且非必填 | | addressLine3 | 退件人地址第三行 | String | 80 |
orderType=B2C 才可以填写returnAddress对象,且非必填 | returnAddressorderType=B2C 才可以填写returnAddress对象,且非必填 | returnAddressorderType=B2C 才可以填写returnAddress对象,且非必填 |
|
|
|
|
|
| parcels | referenceNo |
| String | 80 | 包裹参考号 |
| M |
parcels |
|
| referenceNo1 |
| String | 80 | 包裹参考号1 |
parcels |
|
|
|
| referenceNo2 |
| String | 80 | 包裹参考号2 |
parcels |
|
|
|
| consignmentId |
| String | 50 | 包裹货物ID | 澳邮要求MLID+ConsignmentID 2年内不得重复使用数字 |
parcels |
|
|
| trackingNo |
| String | 80 | 包裹跟踪号 |
|
| orderType=Fulfillment and isoffLineOrder=true 必填 |
parcels | | descriptionEn |
| String | 255 | 包裹英文描述 |
| M | orderType=Fulfillment :不必填; orderType=B2C :必填; |
parcels | | description |
| String | 255 | 包裹中文描述 |
parcels |
|
|
|
| dangerousGoods |
| Boolean | 5 | 包裹是否危险品 | true=危险品 false=非危险品 |
parcels |
|
|
| batteryType |
| Boolean | 5 | 包裹带电类型 | 枚举 true=带电 false=不带电 |
parcels |
|
|
| weight |
| BigDecimal | 8,3 | 包裹重量 | 8位,小数点后3位 | M | orderType=Fulfillment :不必填; orderType=B2C :必填; |
parcels | | weightUnit |
| String | 2 | 重量单位 | 枚举:KG(默认)、G、LB |
parcels | parcelsparcels | parcels |
|
|
|
| dimensionUnit |
| String | 8 | 尺寸单位 | 枚举:CM(默认)、M |
parcels |
|
|
| invoiceCurrencyCode |
| String | 3 | 发票币种三字代码 | 英文代码 |
parcels |
|
|
| invoiceValue |
| BigDecimal | 20,2 | 发票金额 |
| M | orderType=Fulfillment :不必填; orderType=B2C :必填; |
parcels |
| transactionCurrency |
| BigDecimal | 8,2 | 交易币种 | 电商平台成交币种 |
parcels |
|
|
| transactionAmount |
| BigDecimal | 8,2 | 交易金额 | 电商平台成交金额 |
parcels |
|
|
| labelType |
| Short |
| 面单类型 | 枚举: 0: url 1:base64 | C | orderType=Fulfillment and isoffLineOrder=true 必填 |
parcels | parcels | orderType=Fulfillment and isoffLineOrder=true 必填 | | shippingInstruction |
| String | 50 | 装运指示 | 会显示在部分渠道的面单上 |
parcels |
|
|
| sortCode |
| String | 50 | 分拣码 | 会显示在部分渠道的面单上 |
parcels |
|
|
| extendData |
|
|
| 拓展字段 | 拓展字段key-value key:keepShipService value:boolean |
| orderType=Fulfillment :可用; orderType=B2C :不用; |
attachments | attachName | String | 95 | 附件名称 |
| M | 1.如有附件则三个字段都必填,如无附件,则三个字段都不必填; 2.最多5个附件; |
| attachData | String |
| 附件内容 | Base64格式 | M |
| attachType | String | 5 | 附件扩展名 | 仅支持"rar", "zip", "pdf", "doc", "docx", "xls", "xlsx" | M |
parcels | | items | itemNumber | String | 128 | 商品编号 |
parcels | items | parcels | items |
|
|
|
|
|
|
|
|
|
|
| itemDescEn | String | 255 | 商品英文描述 |
parcelsitems | parcels | items | parcels | itemsparcelsitems | parcels | items |
|
| quantityUnit | String | 10 | 商品数量单位 |
parcels | items | parcels | items | parcels | items | parcels | items |
|
|
|
| originCountryCode | String | 10 | 原产国二字代码 | 英文代码 |
parcelsitems | parcels | items | usageparcels | items | parcels | itemsparcels |
|
|
|
insurance (说明:如果isInsurance是true要填) | insuranceType | String | 30 | 投保类型 | 可能是用来区分不同的保险第三方平台或者产品 |
parcels | insurance (说明:如果isInsurance是true要填) |
|
|
| beneficiaryType | String | 20 | 受益人类型 | 枚举: 公司=company 个人=individual |
parcels | insurance (说明:如果isInsurance是true要填) |
|
|
| beneficiary | String | 255 | 受益人/公司 |
parcels | insurance (说明:如果isInsurance是true要填) |
|
|
|
| beneficiaryId | String | 20 | 身份证/组织机构代码证 |
parcels | insurance (说明:如果isInsurance是true要填) |
|
|
|
| insuranceCurrencyCode | String | 3 | 投保三字代码币种 |
parcels | insurance(说明:如果isInsurance是true要填) |
|
|
|
| insuranceAmount | BigDecimal | 20,3 | 保险金额 |
parcelsinsurance (说明:如果isInsurance是true要填) | parcels | insurance(说明:如果isInsurance是true要填) |
|
|
|
collection
| date |
| date |
| 揽收日期 | 年月日 |
| (说明:如果类型是pickup,要填) |
collectioncollection
(说明:如果类型是pickup,要填) | collection
(说明:如果类型是pickup,要填) | (说明:如果类型是pickup,要填)collection
collection
(说明:如果类型是pickup,要填) | collection
| countryCode |
| String | 2 | 客户国家二字代码 | 英文代码 |
(说明:如果类型是pickup,要填) | (说明:如果类型是pickup,要填) | collectioncollection
district | String(说明:如果类型是pickup,要填) | collection
(说明:如果类型是pickup,要填) | | addressLine1 |
| String | 200 | 客户地址第一行 |
(说明:如果类型是pickup,要填) | collection |
|
|
| addressLine2 |
| String | 200 | 客户地址第二行 |
(说明:如果类型是pickup,要填)collection
collection
|
|
| addressLine3 |
| String | 80 | 客户地址第三行 |
(说明:如果类型是pickup,要填) | collection
(说明:如果类型是pickup,要填) | (说明:如果类型是pickup,要填)