Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Table of Contents |
---|
接口说明
用于批量创建一个或者多个本地/专线订单,并将订单自动改到待处理状态,交由仓库处理.
接口格式
URL | https://test.birdsystem.com/client/Consignment/Post-Pending-Consignment-With-Products-Json | ||
---|---|---|---|
接口功能 | 批量创建本地/专线订单 | 订单类型 | 本地订单/专线订单 |
支持格式 | JSON | 开发人员 | |
请求方式 | POST | 发布日期 |
接口参数
参数 | 类型 | 必填 | 说明 | 是否对接字段/取值内容 | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
is_urgent | BOOL |
| 是否紧急订单,取值0或者1, 默认为0 | 按客户填的传 | |||||||||||||
delivery_service_id | INT |
| 邮递服务ID,从 邮递服务查询 获取可用邮递服务列表,只能填写订单类型为LOCAL/DIRECT的邮递服务 | 按客户填的传 | |||||||||||||
sales_reference | STRING |
| 销售跟踪号 | 按用户填的传/或REP系统单号 | |||||||||||||
sales_order_id | STRING |
| 销售订单号 | 按用户填的传/或REP系统单号 | |||||||||||||
custom_identity_reference | STRING |
| 自定义唯一跟踪号 (如果填写了,会进行检测,同一种类型同一站点下的订单,6个月内不能有重复的标识, 重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"}) | 按用户填的传/或REP系统单号(birdsystem会根据改字段判断订单是否重复) | |||||||||||||
contact | STRING |
| 收件联系人 | 按用户填的传 | |||||||||||||
business_name | STRING |
| 公司 | 按用户填的传 | |||||||||||||
address_line1 | STRING |
| 地址行1 | 按用户填的传 | |||||||||||||
address_line2 | STRING |
| 地址行2 | 按用户填的传 | |||||||||||||
city | STRING |
| 城市 | 按用户填的传 | |||||||||||||
county | STRING |
| 省/郡 | 按用户填的传 | |||||||||||||
post_code | STRING |
| 邮编 | 按用户填的传 | |||||||||||||
country_iso | STRING |
| 国家, 填2位ISO国家代码 | 按用户填的传 | |||||||||||||
telephone | STRING |
| 电话 | 按用户填的传 | |||||||||||||
STRING |
| 电子邮箱 | 按用户填的传 | ||||||||||||||
special_instruction | STRING |
| 备注1 | 按用户填的传 | |||||||||||||
neighbour_instruction | STRING |
| 备注2 | 按用户填的传 | |||||||||||||
type | STRING |
| 订单类型 取值LOCAL或DIRECT | 本地订单传(LOCAL)本地订单传 LOCAL | |||||||||||||
products | JSON ARRAY |
| 产品 "client_sku":”IP"IP-XX3355”XX3355", "quantity":5,”sales_price”5, "sales_price":10,” "ebay_transaction_id”":”yuhao0001”,”"yuhao0001", "ebay_item_no”:”0001yuhao””0001yuhao"}, { "id":2, "quantity":4,”sales_price” "sales_price":10,” "ebay_transaction_id”":”yuhao0002”,”"yuhao0002", "ebay_item_no”":”0002yuhao”"0002yuhao"} ] | 按客户填的传 (ebay_transaction_id (sales_price | |||||||||||||
ompparcel_namepieces | STRING JSON ARRAY |
| omp_vat_number销售平台名称多包裹信息,如果仅一个包裹时可不用填. | 按用户填的传
| [ {"weight":500, "length":25, "width":20, "depth":15, "description":"table"}, {"weight":400, "length":22, "width":18, "depth":13, "description":"chair"} ] 备注:重量为克(g),长度为毫米(mm) | 按用户填的传 | |||||||||||
payment_reference | STRING |
| 付款凭证 | 按用户填的传 | |||||||||||||
omp_name | STRING |
| 销售平台名称 | 按用户填的传
| |||||||||||||
omp_vat_number | STRING |
| 销售平台VAT号 英国发往非英国且公司不为空("business_name"字段)的DPD订单 要求必填 | ||||||||||||||
shipper_eori | STRING |
| 客人的EORI号, 必须是国家代码+12位数字,例如:GB000000777888 ,必须提前在鸟系统备案,详询客服. 参考接口: 获取VAT账号 英国发往EU必填 英国发往非英国的DPD服务必填 | ||||||||||||||
reason_for_export | STRING |
| 出口原因, 取值【Sale:销售; ReturnReplacement:退换; Gift:礼物】 | 一般传:SALE | |||||||||||||
content_type | STRING |
| 包裹类型, 取值【Gift 礼物;Documents 文件和 Other 其他】 | 一般传:Other | |||||||||||||
sender_contact | STRING |
| 发件人 (DPD服务必填) | 按客户填的传 | |||||||||||||
sender_address_line1 | STRING |
| 销售平台VAT号 英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填 | shipper_eori发件人地址行1 (DPD服务必填) | 按客户填的传 | ||||||||||||
sender_address_line2 | STRING |
| 客人的EORI号发件人地址行2 | 英国发往EU必填按客户填的传 英国发往非英国的DPD服务必填 | |||||||||||||
reason_for_exportsender_city | STRING |
| 出口原因发件人城市 (DPD服务必填) | 传:SALE按客户填的传 | |||||||||||||
contentsender_typecounty | STRING |
| 包裹类型发件人省/郡 | 传:Other 按客户填的传 | |||||||||||||
sender_post_contactcode | STRING |
| 发件人 发件人邮编 (DPD服务必填) | 按客户填的传 | |||||||||||||
sender_addresscountry_line1iso | STRING |
| 发件人地址行1 发件人国家 (DPD服务必填) | 按客户填的传 | |||||||||||||
sender_address_line2email | STRING |
| 发件人地址行2发件人电子邮箱 | 按客户填的传 | |||||||||||||
sender_citytelephone | STRING |
| 发件人城市 发件人电话 (DPD服务必填) | 按客户填的传 | |||||||||||||
senderioss_vat_countynumber | STRING |
| 发件人省/郡 | 按客户填的传 | sender_post_code
| IOSS号, 订单发往欧盟国家时必填 | 填写客户实际IOSS号 | ||||||||||
receiver_eori | STRING |
| 发件人邮编 (DPD服务必填) | 按客户填的传 | sender_country_iso收件人EORI 英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填 | ||||||||||||
receiver_pid_number | STRING |
| 发件人国家 (DPD服务必填) | 按客户填的传 | sender_email | STRING 收件人个人证件号 英国发往挪威、西班牙、意大利的DPD订单 要求必填 | |||||||||||
is_compensation_for_delay | BOOL |
| 发件人电子邮箱 | 按客户填的传 | sender_telephone | 是否需要晚必赔服务(仅支持部分服务,偏远地区除外), 取值0或者1, 默认为0 |
产品字段参数描述:products
参数 | 类型 | 必填 | 说明 | ||
---|---|---|---|---|---|
id/client_sku/reference | INT/STRING |
|
|
发件人电话 (DPD服务必填)
按客户填的传
ioss_vat_number
| 产品id/客户SKU/产品reference client_sku有另一个同义词是client_ref 产品reference是根据批量订单产品字段的设置来识别是id还是客户SKU | |||||||
quantity | INT |
|
IOSS号, 订单发往欧盟国家时必填
填写客户实际IOSS号
限制填12位字符,格式两位字母+十位数字
数量 | |||||
ebay_transaction_id | STRING |
|
|
收件人EORI 英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填
eBay订单交易号 | |||||
ebay_item_no | STRING |
|
|
eBay产品ID |
is_compensation_for_delay
sales_price | FLOAT |
|
|
销售价格 |
接口示例
Expand | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
温馨提示: 请求
返回
data是创建成功的订单号和跟踪号的键值对 json对象 异常返回必填项
|