创建订单主要是将订单需要的邮递服务,联系人,邮编,地址等信息post给服务器,
接口如下:
url | http://test.birdsystem.com/client/Consignment |
method | post |
| form 参数如下: 1 | is_urgent | 是否是紧急订单 |
| TINYINT(1) | 2 | delivery_service_id | 邮递服务 | 必填 | INT(4) | 3 | return_consignment_action-id | 退货服务号 | 退货订单时必填 | INT(4) | 4 | sales_reference | 销售跟踪号(可自定义填写编码) |
| VARCHAR(50) | 5 | sales_order_id | eBay或Amazon订单ID (注:对eBay订单,如果客户有多个eBay账户,那么请把eBay卖家ID信息 也填在这里,可以按以下格式: “SellerUserID : OrderID” ) |
| VARCHAR(50) | 6 | delivery_reference | 邮递跟踪号 |
| VARCHAR(50) | 7 | custom_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,是和你当前所在的仓库和联系人国家相关的,如果在提交的时候发生邮递服务的错误,请优先检查这部分的问题。