Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
批量本地订单上传(接口)
1、接口说明
批量订单是为了方便进行一次性处理大量订单而提供的一个创建临时处理订单的接口,通过派分处理任务让系统自动处理临时订单并自动生成本地出库订单
接口
url | http://test.birdsystem.com/client/consignment-upload/Temp-Consignment-Json | ||
接口功能 | 批量添加订单 | ||
支持格式 | JSON | 开发人员 | |
method | POST | 发布日期 |
订单请求参数
参数 | 必选 | 类型 | 说明 | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | contact |
| VARCHAR | 联系人 | ||||||||
2 | business_name |
| VARCHAR | 公司名称 | ||||||||
3 | name_customs |
| VARCHAR | 产品英文名称 | ||||||||
4 | address_line1 |
| VARCHAR | 地址行1 | ||||||||
5 | address_line2 |
| VARCHAR | 地址行2 | ||||||||
6 | address_line3 |
| VARCHAR | 地址行3 | ||||||||
7 | city |
| VARCHAR | 城市 | ||||||||
8 | county |
| VARCHAR | 省/郡 | ||||||||
9 | post_code |
| VARCHAR | 邮编 | ||||||||
10 | country_name |
| VARCHAR | 国家名称 | ||||||||
11 | telephone |
| INT | 电话号码 | ||||||||
12 |
| VARCHAR | 电子邮箱 | |||||||||
13 | sales_order_id |
| VARCHAR | 销售订单ID | ||||||||
14 | payment_reference |
| VARCHAR | 付款凭证 | ||||||||
15 | special_instruction |
| VARCHAR | 备注1 | ||||||||
16 | product_company_ref |
产品信息寄存当前字段下 | VARCHAR |
| ||||||||
17 | delivery_service_name |
| VARCHAR | 邮递服务名称 参考接口: 获取邮递服务 | ||||||||
18 | status |
| VARCHAR | 订单状态:PENDING | ||||||||
19 | type |
| VARCHAR | 订单类型:LOCAL | ||||||||
20 | thirty_system_id |
| VARCHAR | |||||||||
21 | sales_reference |
| VARCHAR | 销售跟踪号 | ||||||||
22 | sales_price |
| VARCHAR | 销售平台单价 | ||||||||
23 | omp_name |
| VARCHAR | 销售平台名称,(必须是英文), ebay, amazon 等 | ||||||||
24 | omp_vat_number |
英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填 | VARCHAR | 销售平台VAT号 | ||||||||
25 | shipper_eori |
英国发往EU必填 英国发往非英国的DPD服务必填 | VARCHAR | 客户的EORI号 由国家代码+12位数字组成的vat号. 例如GB000001234567. 必须在鸟系统中有备案, 备案流程详询客服。参考接口: 获取VAT账号 | ||||||||
26 | reason_for_export |
| VARCHAR | 出口原因,值【Sale:销售; ReturnReplacement:退换; Gift:礼物】 | ||||||||
27 | content_type |
| VARCHAR | 包裹类型,值【Gift 礼物;Documents 文件和 Other 其他】 | ||||||||
28 | ebay_transaction_id |
| VARCHAR(50) | eBay订单交易号,加在product_company_ref里边 | ||||||||
29 | ebay_item_no |
| VARCHA | eBay产品ID,加在product_company_ref里边 | ||||||||
30 | ioss_vat_number |
| VARCHAR(12) | IOSS号,限制填12位字符,格式两位字母+十位数字 | ||||||||
31 | receiver_eori | 收件人EORI | 选填(DPD服务按要求必填) | 英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填 | ||||||||
32 | receiver_pid_number | 收件人个人证件号 | 选填(DPD服务按要求必填) | 英国发往挪威、西班牙、意大利的DPD订单 要求必填 | ||||||||
33 | is_compensation_for_delay |
是否需要“晚必赔”服务(只支持部分邮递服务,偏远地区除外) | BOOL | 晚必赔服务,传0/1,默认为0,非0传1 |
2、接口示例
接口请求示例
地址:http://branch.birdsystem.com/client/consignment-upload/temp-consignment-json
Code Block | ||
---|---|---|
| ||
[
{
"contact": "Norman Drury",
"business_name": 1,
"address_line1": "3Northam Close",
"address_line2": "Marshside",
"address_line3": null,
"city": "Southport",
"county": "Merseyside",
"post_code": "12345",
"country_name": "Norway",
"telephone": "01704 226830",
"email": null,
"delivery_service_id": "5315",
"sales_reference": "2",
"sales_order_id": "1234567654",
"special_instruction": null,
"product_company_ref": "1-1*1||ebayid||ebatproduct||18+1996125*1||ebayid2||ebatproduct2||20",
"type": "LOCAL",
"sender_contact": "123",
"omp_name": "ebay",
"omp_vat_number": "12345",
"shipper_eori": "12345600",
"reason_for_export": "Sale",
"content_type": "Gift",
"ioss_vat_number": 172848,
"receiver_eori":"123456",
"receiver_pid_number":"12",
"sender_address_line1": "SHENZHENG BANTIAN",
"sender_city": "SHENZHEN",
"sender_post_code": 12345,
"sender_country_iso": "CN",
"sender_telephone": "155465751714",
"is_compensation_for_delay": "1"
}
] |
接口返回示例
Code Block | ||
---|---|---|
| ||
{ "message": "File successfully uploaded! 1 records has been imported.", "success": true, "moduleName": "client" } |
返回异常示例:
报错时需检查字段填写是否完整。contact, post_code, city, country_name, product sku, quantity, address_line1.
Code Block | ||
---|---|---|
| ||
{ "success": false, "message": "Accounted the following exceptions:<br> Row: 1 : Bulk Order with required the following fields:contact, post_code, city, country_name, product sku, quantity, address_line1.<br>" } |
变更记录
Jira编号 | 上线日期 | 开发 | 改动前 | 改动后 |
|
|
|
|
|
|
|
|
|