批量订单是为了方便地处理大量订单而提供的一个临时订单,包括邮递服务、地址等信息,通过如下API创建:
url | http://test.birdsystem.com/client/consignment-upload/Temp-Consignment-Json |
method | post |
| json属性如下:
|
|
|
|
---|
delivery_service_name | 邮递服务 | 必填 | INT(4) | sales_reference | 销售跟踪号 |
| VARCHAR(50) | sales_order_id | eBay或Amazon订单ID (注:对eBay订单,如果客户有多个eBay账户,那么请把eBay卖家ID信息 也填在这里,可以按以下格式: “SellerUserID : OrderID” ) |
| VARCHAR(50) | delivery_reference | 邮递跟踪号 |
| VARCHAR(50) | custom_identity_reference
| 自定义惟一标识 (注: 如果填写了,会进行检测,同一种类型同一站点下的批量订单,6个月内不能有重复的标识) 重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"} |
| VARCHAR(50) | 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) | product_company_ref | 产品(定向共享产品标记为ClientId#ProductId#D * 数量) 代理专线订单是: product_name##product_name_cn##client_ref||ProductPrice||ProductWeight||ProductCustomsProperty*Quantity 例如: test1##测试1##47||5||10||电池,其他*2 (多个海关属性用逗号连接) 注:若不填写client_ref(选填项),则格式为 : product_name##product_name_cn||ProductPrice||ProductWeight||ProductCustomsProperty*Quantity 若不填写product_name_cn,则格式为: product_name##0##client_ref||ProductPrice||ProductWeight||ProductCustomsProperty*Quantity(用0占位) | 必填 | VARCHAR(255) | email | 电子邮件 |
| VARCHAR(255) | special_instruction: | 备注1 |
| VARCHAR(255) | neighbour_instruction: | 备注2 |
| VARCHAR(255) | type | 订单类型 | 必填 | 'AGENT_DIRECT' |
Code Block |
---|
| [
{
"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",
"payment_reference": "Royal Mail 1st Class Standard",
"special_instruction": null,
"product_company_ref": "light1##灯1##476apple29##灯1##47||2||3||其它||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg*1+light2##灯2##477apple29##灯1##487||112||3||其它||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg*1",
"delivery_service_name": "代理平邮UK24D 中英平邮(B2P)",
"status": "PENDING",
"type": "AGENT_DIRECT",
"thirty_system_id":"2222"
}
] |
图片URL:直接在海关属性后面加"||+url"==>||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg 图片URL:attachment-url 新产品图片URL为必填,已存在的产品不用传图片URL(只能传网上的图片,不能传本地的) 品牌字段暂时这个接口无法上传 需要填写销售跟踪号请自行添加参数 sales_reference, 例如 "sales_reference":"12345" |
返回 |
Code Block |
---|
| {
"data": {
"2222": "41295"
},
"message": "File successfully uploaded! 1 records has been imported.",
"success": true,
"moduleName": "client"
} |
|
参数 | thirty_system_id: 第三方系统id country_name: 可以通过/client/Country获取 delivery_service_name: 可以通过/client/Delivery-Service 获取 product_company_ref: 产品id*数量, 多个产品的话 产品id*数量+产品id*数量, 可以通过/client/Product 获取 如果是代理专线订单,product_company_ref格式变为: Product_name||Product_name_cn||ProductPrice||ProductWeight||ProductCustomsProperty*Quantity 例如: 产品1||5||10||电池,其他*2 (多个海关属性用逗号连接) |
...