You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 28
Next »
接口说明:
批量订单是为了方便地处理大量订单而提供的一个临时订单,包括邮递服务、地址等信息,通过如下API创建:
参数说明:
参数 | 说明 | 必选 | 类型 |
---|
contact | 联系人 | 必填 | VARCHAR(100) | business_name | 公司 |
| VARCHAR(255) | address_line1 | 地址行1 | 必填 | VARCHAR(100) | address_line2 | 地址行2 |
| VARCHAR(100) | address_line3 | 地址行3 |
| VARCHAR(100) | city | 城市 | 必填 | VARCHAR(50) | county | 省/郡 |
| VARCHAR(50) | post_code | 邮编 | 必填 | VARCHAR(10) | country_name | 国家 获取国家 | 必填 | CHAR(2) | telephone | 电话 |
| VARCHAR(50) | email | 电子邮件 |
| VARCHAR(255) | sales_reference | 销售跟踪号 |
| VARCHAR(50) | | 付款跟踪号 |
| VARCHAR(50) | telephone | 电话 |
| VARCHAR(50) | special_instruction | 备注1 |
| VARCHAR(255) | neighbour_instruction | 备注2 |
| VARCHAR(255) | sales_order_id | eBay或Amazon订单ID (注:对eBay订单,如果客户有多个eBay账户,那么请把eBay卖家ID信息 也填在这里,可以按以下格式: “SellerUserID : OrderID” ) |
| VARCHAR(50) | custom_identity_reference
| 自定义惟一标识 (注: 如果填写了,会进行检测,同一种类型同一站点下的批量订单,6个月内不能有重复的标识) 重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"} |
| VARCHAR(50) | product_company_ref | 产品信息,格式如下: Product_name##Product_name_cn##client_sku||ProductPrice||ProductWeight||ProductCustomsProperty||attachment-url*Quantity 多个产品用“+”号相连,示例: Product1##产品##062589||2||10||其他*1+Product2##产品2##78954623||2||30||电池,其他*1 (多个海关属性用逗号连接) 获取产品属性 | 必填 | VARCHAR(255) | delivery_service_name | 邮递服务名称,或者使用delivery_service_id参数,指的是邮递服务id,即渠道代码 获取邮递服务 | 必填 | INT(4) | status | 批量订单状态 | 必填 | 'PENDING' | type | 订单类型 | 必填 | 'AGENT_DIRECT' | thirty_system_id | 第三方系统id |
| VARCHAR(50) |
请求示例:
[
{
"contact": "Norman Drury",
"business_name": null,
"address_line1": "3, Northam Close",
"address_line2": "Marshside",
"address_line3": null,
"city": "Southport",
"county": "Merseyside",
"post_code": "PR9 9GA",
"country_name": "United Kingdom",
"telephone": "01704 226830",
"email": null,
"sales_order_id": "110222319566-0",
"custom_identity_reference":"24S5662a321",
"product_company_ref": "apple##苹果##0256987||2||3||其它||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg*1+Light##灯##0782564||1||35||其它||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg*1",
"delivery_service_name": "D 中英平邮(B2P)",
"status": "PENDING",
"type": "AGENT_DIRECT",
"thirty_system_id":"2222"
}
]
注:产品的“品牌”字段暂时无法用此接口上传。 |
返回示例
{
"data": {
"2222": "46520946"
},
"message": "File successfully uploaded! 1 records has been imported.",
"success": true,
"moduleName": "client"
}
返回参数说明:
参数 | 说明 |
---|
data | 键值对分别是 thirty_system_id和临时批量订单id |
message | 成功/失败信息 |
success | true/false |
moduleName | client |