接口说明
创建小包订单
路径
HTTP Verb | URL |
|---|---|
| Post | qa: https://cfs-qa.etowertech.com/api/supplier-service/ prd: http://b2b.etowertech.com/ /v1/openApi/packetOrder/b2c/createOrders |
请求头样例
POST /v1/openApi/packetOrder/b2c/createOrders HTTP/1.1 lang:zh_CN Host: http://b2b.etowertech.com/api/supplier-service X-WallTech-Date: Thu, 06 Aug 2020 06:21:24 GMT |
请求字段（request）
| 一级字段 | 二级字段 | 三级字段 | 四级字段 | 类型 | 长度限制 | 中文含义 | 描述 | 是否必填 |
| order | facility | String | 20 | 发件人网点 | B2C：shipper facility FF：warehouse | O | ||
| orderType | String | 10 | 订单类型 | 枚举: B2C=小包直邮 BBC=仓库一件代发 | M | |||
| originPortCode | String | 始发港（空港/海港） | 英文代码 | O | ||||
| injectPortCode | String | 50 | 目的港 | 英文代码 | O | |||
| channelCode | String | 64 | 渠道代码 | 英文、英文标点 | M | |||
| channelOption | String | 64 | 渠道选项 | 英文、英文标点 | O | |||
| platform | String | 20 | 平台 | O | ||||
| incoterm | String | 50 | 贸易术语 | 枚举 DDU DDP | O | |||
| collectionType | 20 | 揽收类型 | 枚举 Pick up上门揽收 Drop off自送到仓 不填默认drop off | O | ||||
| insuranceOrNot | Boolean | 3 | 是否投保 | boolean 不填默认false | O | |||
| signatureOrNot | Boolean | 3 | 是否签名 | boolean 不填默认false | O | |||
| remark | 备注 | O | ||||||
| extendData | 拓展字段 | 比如IOSS key-value形式 | ||||||
| consignee | addressCode | String | 50 | 收件人地址代码 | 比如ONT8表示某个亚马逊仓库 | |||
| name | String | 50 | 收件人姓名 | M | ||||
| company | String | 512 | 收件人公司 | |||||
| phone | String | 50 | 收件人电话 | |||||
| String | 50 | 收件人邮箱 | ||||||
| countryCode | String | 2 | 目的国二字代码 | 英文代码 | M | |||
| state | String | 80 | 收件人省/州 | |||||
| city | String | 80 | 收件人城市 | M | ||||
| district | String | 128 | 收件人区 | |||||
| addressLine1 | String | 200 | 收件人地址第一行 | M | ||||
| addressLine2 | String | 200 | 收件人地址第二行 | |||||
| addressLine3 | String | 80 | 收件人地址第三行 | |||||
| zipCode | String | 16 | 收件人邮编 | |||||
| taxId | String | 255 | 收件人税号 | |||||
| taxId1 | String | 255 | 收件人税号1 | |||||
| extendData | 拓展字段 | |||||||
| shipper | name | String | 50 | 发件人姓名 | ||||
| company | String | 512 | 发件人公司 | |||||
| phone | String | 50 | 发件人电话 | |||||
| String | 50 | 发件人邮箱 | ||||||
| countryCode | String | 2 | 始发国二字代码 | 英文代码 | ||||
| state | String | 80 | 发件人省/州 | |||||
| city | String | 80 | 发件人城市 | |||||
| district | String | 128 | 发件人区 | |||||
| addressLine1 | String | 200 | 发件人地址第一行 | |||||
| addressLine2 | String | 200 | 发件人地址第二行 | |||||
| addressLine3 | String | 80 | 发件人地址第三行 | |||||
| zipCode | String | 16 | 发件人邮编 | |||||
| taxId | String | 255 | 发件人税号 | |||||
| taxId1 | String | 255 | 发件人税号1 | |||||
| extendData | 拓展字段 key-value | |||||||
| returnAddress | returnOption | 退件选项 | String | 50 | 枚举： 退件 销毁 | 枚举： 退件 销毁 | ||
| name | 退件人姓名 | String | 512 | |||||
| company | 退件人公司 | String | 50 | |||||
| phone | 退件人电话 | String | 50 | |||||
| 退件人邮箱 | String | 2 | ||||||
| countryCode | 退件人国家二字代码 | String | 80 | 英文代码 | 英文代码 | |||
| state | 退件人省/州 | String | 80 | |||||
| city | 退件人城市 | String | 128 | |||||
| district | 退件人区 | String | 200 | |||||
| addressLine1 | 退件人地址第一行 | String | 200 | |||||
| addressLine2 | 退件人地址第二行 | String | 80 | |||||
| addressLine3 | 退件人地址第三行 | String | 16 | |||||
| zipCode | 退件人邮编 | String | 255 | |||||
| extendData | 拓展字段 | |||||||
| parcels | referenceNo | String | 80 | 包裹参考号 | M | |||
| referenceNo1 | String | 80 | 包裹参考号1 | |||||
| referenceNo2 | String | 80 | 包裹参考号2 | |||||
| consignmentId | String | 50 | 包裹货物ID | 澳邮要求MLID+ConsignmentID 2年内不得重复使用数字 | ||||
| trackingNo | String | 80 | 包裹跟踪号 | |||||
| descriptionEn | String | 255 | 包裹英文描述 | M | ||||
| description | String | 255 | 包裹中文描述 | |||||
| dangerousGoods | Boolean | 3 | 包裹是否危险品 | true=危险品 false=非危险品 | ||||
| batteryType | Boolean | 3 | 包裹带电类型 | 枚举 true=带电 false=不带电 | ||||
| weight | BigDecimal | 8,3 | 包裹重量 | 8位，小数点后3位 | M | |||
| weightUnit | String | 10 | 重量单位 | 枚举： KG(默认) G LB | ||||
| length | BigDecimal | 8,3 | 包裹长 | |||||
| width | BigDecimal | 8,3 | 包裹宽 | |||||
| height | BigDecimal | 8,3 | 包裹高 | |||||
| dimensionUnit | String | 8 | 尺寸单位 | 枚举： CM（默认） M | ||||
| invoiceCurrencyCode | String | 5 | 发票币种三字代码 | 英文代码 | ||||
| invoiceValue | BigDecimal | 20,3 | 发票金额 | M | ||||
| shippingInstruction | String | 50 | 装运指示 | 会显示在部分渠道的面单上 | ||||
| sortCode | String | 50 | 分拣码 | 会显示在部分渠道的面单上 | ||||
| extendData | 拓展字段 | |||||||
| items | itemNumber | String | 128 | 商品编号 | ||||
| itemDescEn | String | 255 | 商品英文描述 | |||||
| itemDesc | String | 255 | 商品本地描述 | |||||
| sku | String | 128 | SKU编码 | |||||
| hsCode | String | 128 | 海关编码 | |||||
| quantity | Integer | 11 | 商品数量 | |||||
| quantityUnit | String | 10 | 商品数量单位 | |||||
| unitPrice | decimal | 10,2 | 单价 | |||||
| picture | String | 图片 | base64 | |||||
| salesURL | String | 500 | 销售链接 | |||||
| originCountryCode | String | 10 | 原产国二字代码 | 英文代码 | ||||
| weight | BigDecimal | 10,3 | 重量 | |||||
| usage | String | 255 | 用途 | |||||
| matertial | String | 255 | 材质 | |||||
| extendData | 拓展字段 | |||||||
| Insurance （说明：如果isInsurance是true要填） | insuranceType | String | 30 | 投保类型 | 可能是用来区分不同的保险第三方平台或者产品 | |||
| beneficiaryType | String | 20 | 受益人类型 | 枚举： 公司=company 个人=individual | ||||
| beneficiary | String | 255 | 受益人/公司 | |||||
| beneficiaryId | String | 20 | 身份证/组织机构代码证 | |||||
| insuranceCurrencyCode | String | 8 | 投保二字代码币种 | |||||
| insuranceAmount | BigDecimal | 20,3 | 保险金额 | |||||
| extendData | 拓展字段 | |||||||
| collectionInfo （说明：如果类型是pickup，要填） | date | date | 3 | 揽收日期 | 年月日 | |||
| name | String | 512 | 客户姓名 | |||||
| company | String | 50 | 客户公司 | |||||
| phone | String | 50 | 客户电话 | |||||
| String | 2 | 客户邮箱 | ||||||
| countryCode | String | 80 | 客户国家二字代码 | 英文代码 | ||||
| state | String | 80 | 客户省/州 | |||||
| city | String | 128 | 客户城市 | |||||
| district | String | 200 | 客户区 | |||||
| addressLine1 | String | 200 | 客户地址第一行 | |||||
| addressLine2 | String | 80 | 客户地址第二行 | |||||
| addressLine3 | String | 16 | 客户地址第三行 | |||||
| zipCode | String | 255 | 客户邮编 | |||||
| extendData | 拓展字段 |
请求样例
{
"order": [
{
"channelCode": "UBI.CN2US.AC.GENERAL.LIGHT",
"channelOption": "B2Cchanneloption",
"collectionInfo": {
"addressCode": "",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"returnOption": "",
"state": "",
"taxId": "",
"taxId1": "",
"zipCode": ""
},
"collectionType": "",
"consignee": {
"addressCode": "",
"addressLine1": "street9230",
"addressLine2": "8349hao",
"addressLine3": "345shi",
"city": "testcity",
"company": "testcompany",
"countryCode": "us",
"district": "testdistrict",
"email": "testemail@123.com",
"extendData": null,
"name": "Mack",
"phone": "36247938384",
"state": "teststate",
"taxId": "testtaxid",
"taxId1": "testtaxid1",
"zipCode": "8238juej"
},
"extendData": {
"extend": "extend"
},
"facility": "B2C",
"incoterm": "DDP",
"injectPortCode": "",
"insuranceOrNot": "",
"orderType": "B2C",
"originPortCode": "",
"parcels": [
{
"batteryType": "false",
"consignmentId": "",
"dangerousGoods": false,
"description": "goodscn",
"descriptionEn": "goodsen",
"dimensionUnit": "CM",
"extendData": null,
"height": "10",
"invoiceCurrencyCode": "USD",
"invoiceValue": "35",
"insurance": [
{
"insuranceAmount": "",
"insuranceCurrencyCode": "",
"insuranceType": "",
"modifiedAccount": "",
"type": "",
"typeDesc": ""
}
],
"items": [
{
"extendData": null,
"hsCode": "111",
"itemDesc": "goodscn",
"itemDescEn": "",
"itemNumber": "Amireuxtest",
"matertial": "testmatertial",
"originCountryCode": "cn",
"picture": "",
"quantity": "1",
"quantityUnit": "个",
"salesURL": "testsalesurl",
"sku": "testgoods",
"unitPrice": "10",
"usage": "testusage",
"weight": "5"
}
],
"length": "25",
"referenceNo": "APITES018",
"referenceNo1": "",
"referenceNo2": "",
"shippingInstruction": "",
"sortCode": "",
"trackingNo": "",
"weight": "5",
"weightUnit": "KG",
"width": "25"
}
],
"platform": "testplatform",
"remark": "testremark",
"returnAddress": {
"addressCode": "",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"returnOption": "销毁",
"state": "",
"taxId": "",
"taxId1": "",
"zipCode": ""
},
"shipper": {
"addressCode": "",
"addressLine1": "sipinglujiedao",
"addressLine2": "gaoxinlu900hao",
"addressLine3": "190shi",
"city": "shanghaishi",
"company": "shippercompany",
"countryCode": "cn",
"district": "yangpuqu",
"email": "shippertest@123.com",
"extendData": null,
"name": "xiaozhang",
"phone": "18893043453",
"returnOption": "",
"state": "shanghai",
"taxId": "shippertaxid",
"taxId1": "shippertaxid1",
"zipCode": "300210"
},
"signatureOrNot": ""
},
{
"channelCode": "UBI.CN2US.LHEST.STD.EXPRESS.CV",
"channelOption": "B2Cchanneloption",
"collectionInfo": {
"addressCode": "",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"returnOption": "",
"state": "",
"taxId": "",
"taxId1": "",
"zipCode": ""
},
"collectionType": "",
"consignee": {
"addressCode": "",
"addressLine1": "street9230",
"addressLine2": "8349hao",
"addressLine3": "345shi",
"city": "testcity",
"company": "testcompany",
"countryCode": "us",
"district": "testdistrict",
"email": "testemail@123.com",
"extendData": null,
"name": "Mack",
"phone": "36247938384",
"state": "teststate",
"taxId": "testtaxid",
"taxId1": "testtaxid1",
"zipCode": "8238juej"
},
"extendData": {
"extend": "extend"
},
"facility": "B2C",
"incoterm": "DDP",
"injectPortCode": "",
"insuranceOrNot": "",
"orderType": "B2C",
"originPortCode": "",
"parcels": [
{
"batteryType": "false",
"consignmentId": "",
"dangerousGoods": false,
"description": "goodscn",
"descriptionEn": "goodsen",
"dimensionUnit": "CM",
"extendData": null,
"height": "10",
"invoiceCurrencyCode": "USD",
"invoiceValue": "35",
"insurance": [
{
"insuranceAmount": "",
"insuranceCurrencyCode": "",
"insuranceType": "",
"modifiedAccount": "",
"type": "",
"typeDesc": ""
}
],
"items": [
{
"extendData": null,
"hsCode": "111",
"itemDesc": "goodscn",
"itemDescEn": "",
"itemNumber": "Amireuxtest",
"matertial": "testmatertial",
"originCountryCode": "cn",
"picture": "",
"quantity": "1",
"quantityUnit": "个",
"salesURL": "testsalesurl",
"sku": "testgoods",
"unitPrice": "10",
"usage": "testusage",
"weight": "5"
}
],
"length": "25",
"referenceNo": "APITES019",
"referenceNo1": "",
"referenceNo2": "",
"shippingInstruction": "",
"sortCode": "",
"trackingNo": "",
"weight": "5",
"weightUnit": "KG",
"width": "25"
}
],
"platform": "testplatform",
"remark": "testremark",
"returnAddress": {
"addressCode": "",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"city": "",
"company": "",
"countryCode": "",
"district": "",
"email": "",
"extendData": null,
"name": "",
"phone": "",
"returnOption": "销毁",
"state": "",
"taxId": "",
"taxId1": "",
"zipCode": ""
},
"shipper": {
"addressCode": "",
"addressLine1": "sipinglujiedao",
"addressLine2": "gaoxinlu900hao",
"addressLine3": "190shi",
"city": "shanghaishi",
"company": "shippercompany",
"countryCode": "cn",
"district": "yangpuqu",
"email": "shippertest@123.com",
"extendData": null,
"name": "xiaozhang",
"phone": "18893043453",
"returnOption": "",
"state": "shanghai",
"taxId": "shippertaxid",
"taxId1": "shippertaxid1",
"zipCode": "300210"
},
"signatureOrNot": ""
}
]
}
返回样例
成功样例
{ "code": "0", "data": [], "errors": "", "message": "", "messageId": "", "success": true, "warnList": "" }
失败样例
{
"code": "0",
"data": [
{
"code": "600222",
"message": "客户参考号APITES018Field already exists, cannot be repeated"
}
],
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}