1 批量本地订单上传（接口）
2 接口
3 订单请求参数
4 2、接口示例
- 4.1 接口请求示例
- 4.2 接口返回示例
- 4.3 返回异常示例:
- 4.4 变更记录

批量本地订单上传（接口）

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	email	选填	VARCHAR	电子邮箱
13	sales_order_id	选填【yodel 出口必填】	VARCHAR	销售订单ID
14	payment_reference	选填	VARCHAR	付款凭证
15	special_instruction	选填	VARCHAR	备注1
16	product_company_ref	必填产品信息寄存当前字段下	VARCHAR	批量订单产品代码 "#":"//产品sku产品数量\|\|eBay订单交易号\|\|eBay产品ID，\|\|平台销售单价+产品id产品数量\|\|eBay订单交易号\|\|eBay产品ID\|\|平台销售单价", "product_company_ref": "1-19961291\|\|ebayid\|\|ebatproduct\|\|18+19961251\|\|ebayid2\|\|ebatproduct2\|\|20",
17	delivery_service_name	选填	VARCHAR	邮递服务名称参考接口: https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/1540407
18	status	选填	VARCHAR	订单状态：PENDING
19	type	选填	VARCHAR	订单类型：LOCAL
20	thirty_system_id	选填	VARCHAR
21	sales_reference	选填	VARCHAR	销售跟踪号
22	sales_price	选填	VARCHAR	销售平台单价
23	omp_name	选填【royal mail，yodel 出口必填	VARCHAR	销售平台名称，(必须是英文), ebay, amazon 等
24	omp_vat_number	选填【yodel 出口必填】英国发往非英国且公司不为空（“business_name“字段）的DPD订单要求必填	VARCHAR	销售平台VAT号
25	shipper_eori	选填【royal mail，dpd 出口必填】英国发往EU必填英国发往非英国的DPD服务必填	VARCHAR	客户的EORI号由国家代码+12位数字组成的vat号. 例如GB000001234567. 必须在鸟系统中有备案, 备案流程详询客服。参考接口: 获取VAT账号
26	reason_for_export	选填【dpd 出口必填】	VARCHAR	出口原因，值【Sale:销售; ReturnReplacement:退换; Gift:礼物】
27	content_type	选填【royalmail 出口必填】	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

[
     {
          "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"
     }
]

接口返回示例

{
    "message": "File successfully uploaded! 1 records has been imported.",
    "success": true,
    "moduleName": "client"
}

返回异常示例:

报错时需检查字段填写是否完整。contact, post_code, city, country_name, product sku, quantity, address_line1.

{
    "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编号	上线日期	开发	改动前	改动后

BirdSystem 开发指南

1-3-1. 添加批量临时本地订单