3-1-1. 创建订单
接口说明:
url | http://test.birdsystem.com/client/Consignment/ | ||
接口功能 | 单个创建代理专线订单 | ||
支持格式 | JSON | 开发人员 | |
请求方式 | POST | 发布日期 |
参数说明:
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
delivery_service_id | Y | INT(4) | 请求的服务ID,即服务代码(文档最后有获取服务代码的接口示例)获取邮递服务 |
sales_reference | VARCHAR(50) | 销售跟踪号 | |
custom_identity_reference | VARCHAR(50) | 自定义唯一跟踪号 (注: 如果填写了,会进行检测,同一种类型同一站点下的订单,6个月内不能有重复的标识) | |
contact | Y | VARCHAR(100) | 联系人 |
business_name | VARCHAR(255) | 公司名 | |
telephone | VARCHAR(50) | 电话 | |
address_line1 | Y | VARCHAR(100) | 地址行1 |
address_line2 | VARCHAR(100) | 地址行2 | |
address_line3 | VARCHAR(100) | 地址行3 | |
city | Y | VARCHAR(50) | 城市 |
county | VARCHAR(50) | 省/郡 | |
post_code | Y | VARCHAR(10) | 邮编 |
country_iso | Y | CHAR(2) | 国家 |
type | Y | 'AGENT_DIRECT' | 订单类型 |
omp_vat_number | 选填(DPD服务按要求必填) | VARCHAR(50) | 销售平台VAT号 英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填 |
shipper_eori | 选填 | VARCHAR(50) | 客人的EORI号 英国发往EU必填 英国发往非英国的DPD服务必填 |
receiver_eori | 选填(DPD服务按要求必填) | VARCHAR(50) | 收件人EORI 英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填 |
receiver_pid_number | 选填(DPD服务按要求必填) | VARCHAR(50) | 收件人个人证件号 英国发往挪威、西班牙、意大利的DPD订单 要求必填 |
is_compensation_for_delay | 选填 | BOOL | 是否需要“晚必赔”服务 (只支持部分邮递服务,且偏远地区除外)传0/1,默认0,非0传1 |
接口请求示例:
创建代理专线订单请求示例
http://test.birdsystem.com/client/Consignment/ api_key=a0366845436b4775e6c5caef5ebc0d0d&company_id=36 delivery_service_id=5198&contact=alert wert&address_line1=123&city=calne&post_code=sn11 9dn&county_iso=GB&type=AGENT_DIRECT
接口返回示例:
返回字段说明:
字段名 | 说明 |
---|---|
type | 订单类型 |
id | 订单ID号,鸟系统自动生成 |
company_id | 站点ID |
client_id | 客户ID,与下单填写的api_key相关 |
delivery_service_id | 邮递服务ID,即渠道代码 |
delivery_package_size_id | 邮递服务包裹尺寸ID |
delivery_package_size_id_internal | 内部服务包裹尺寸ID |
create_time | 创建订单时间 |
update_time | 更新订单时间 |
status | 订单状态 |
stock_status | ? |