2-1-1. 创建订单

创建订单主要是将订单需要的邮递服务,联系人,邮编,地址等信息post给服务器,

接口如下:

url

http://test.birdsystem.com/client/Consignment

method

post

body

form 参数如下:

1

is_urgent

是否是紧急订单


TINYINT(1)

2

delivery_service_id

邮递服务

必填

INT(4)

3return_consignment_action-id退货服务号退货订单时必填INT(4)
4

sales_reference

销售跟踪号(可自定义填写编码)


VARCHAR(50)

5sales_order_id

eBay或Amazon订单ID

(注:对eBay订单,如果客户有多个eBay账户,那么请把eBay卖家ID信息

也填在这里,可以按以下格式: “SellerUserID : OrderID” )


VARCHAR(50)
6delivery_reference邮递跟踪号
VARCHAR(50)
7custom_identity_reference

自定义惟一标识

(注: 如果填写了,会进行检测,同一种类型同一站点下的订单,6个月内不能有重复的标识)

重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"}


VARCHAR(50)
8

contact

联系人

必填

VARCHAR(100)

9

business_name

公司


VARCHAR(255)

10

address_line1

地址行1

必填

VARCHAR(100)

11

address_line2

地址行2


VARCHAR(100)

12

address_line3

地址行3


VARCHAR(100)

13

city

城市

必填

VARCHAR(50)

14

county

省/郡


VARCHAR(50)

15

post_code

邮编

必填

VARCHAR(10)

16

country_iso

国家

必填

CHAR(2)

17

telephone

电话


VARCHAR(50)

18

email

电子邮件


VARCHAR(255)

19

special_instruction:

备注1


VARCHAR(255)

20

neighbour_instruction:

备注2


VARCHAR(255)

21

type

订单类型


'DIRECT'

22

omp_vat_number

销售平台VAT号

选填(DPD服务按要求必填)

英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填

23

shipper_eori

客人的EORI号

选填

英国发往EU必填

英国发往非英国的DPD服务必填

24

receiver_eori

收件人EORI

选填(DPD服务按要求必填)

英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填

25

receiver_pid_number

收件人个人证件号

选填(DPD服务按要求必填)

英国发往挪威、西班牙、意大利的DPD订单 要求必填

返回

{
    "success":true,
    "data":{
		"id":"2006143004830001",
		"delivery_service_id":"12010433",
		"...":"..."
	}
}

样例

# api_key和company_id和提交数据中的delivery_service_id需要替换成实际数据
curl -X POST \
  https://test.birdsystem.com/client/consignment \
  -H 'api_key: 248ccb90dff2b99465b54c113765360c' \
  -H 'company_id: 36' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -d 'contact=Norman%20Drury&address_line1=3%2C%20Northam%20Close&address_line2=Marshside&city=Southport&county=Merseyside&post_code=PR9%209GA&country_iso=GB&telephone=01704%20226830&sales_reference=2&type=DIRECT&delivery_service_id=3862'

请注意,订单的邮递服务ID,是和你当前所在的仓库和联系人国家相关的,如果在提交的时候发生邮递服务的错误,请优先检查这部分的问题。