...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
URL
...
https://test.birdsystem.com/client/Consignment/Post-Pending-Consignment-With-Products-Json
...
接口功能
...
批量创建订单接口
...
订单类型
...
本地订单/专线订单
...
支持格式
...
JSON
...
开发人员
...
数据已丢失
...
请求方式
...
POST/GET
...
发布日期
...
数据已丢失
参数描述
...
参数
...
说明
...
是否必填
...
是否对接字段/取值内容（请求根据实际情况选择填写）
...
is_urgent
...
是否紧急订单
...
选填（0或1）
...
按客户填的传
...
delivery_service_id
...
邮递服务ID
...
必填
...
按客户填的传
...
sales_reference
...
销售跟踪号
...
选填
...
按用户填的传/或REP系统单号
...
sales_order_id
...
销售订单号
...
选填
...
按用户填的传/或REP系统单号
...
custom_identity_reference
...
自定义唯一标识
...
选填
...
按用户填的传/或REP系统单号（birdsystem会根据改字段判断订单是否重复）
...
contact
...
收件联系人
...
必填
...
按用户填的传
...
business_name
...
公司
...
选填
...
按用户填的传
...
address_line1
...
地址行1
...
必填
...
按用户填的传
...
address_line2
...
地址行2
...
选填
...
按用户填的传
...
city
...
城市
...
必填
...
按用户填的传
...
county
...
省/郡
...
选填
...
按用户填的传
...
post_code
...
邮编
...
必填
...
按用户填的传
...
country_iso
...
国家
...
必填
...
按用户填的传
...
telephone
...
电话
...
选填
...
按用户填的传
...
...
电子邮箱
...
选填
...
按用户填的传
...
special_instruction
...
备注1
...
选填
...
按用户填的传
...
neighbour_instruction
...
备注2
...
选填
...
按用户填的传
...
type
...
订单类型
...
必填
...
本地订单传（LOCAL）
专线订单（DIRECT）
...
products
...
产品
[ {"client_sku":”IP-XX3355”,"quantity":5，”sales_price”:10,”ebay_transaction_id”:”yuhao0001”,”ebay_item_no”:”0001yuhao”}, {"id":2,"quantity":4,”sales_price”:10,”ebay_transaction_id”:”yuhao0002”,”ebay_item_no”:”0002yuhao”}
]
...
必填
...
按客户填的传
client_sku/id，quantity（必填）
(ebay_transaction_id
/eBay订单交易号
ebay_item_no
/eBay产品ID)eBay的订单需要传(选填)
(sales_price
/平台销售价格, 美元)
按客户填的传(必填）
...
omp_name
...
销售平台名称
...
选填
...
举例
'wish'=Wish
'smt'=速卖通
'ebay'=eBay
'amazon'=Amazon
'lazada'=Lazada
'dh'=敦煌
'jd'=京东
'jdid'=京东印尼
'cd'=Cdiscount
'shopify'=Shopify
'magento'=Magento
'woocomm'=Woocommerce
'joom'=Joom
'shopee'=Shopee
'tophatter'=Tophatter
'magento2'=Magento2
'walmart'=Walmart
'mymall'=MyMall
'ueeshop'=Ueeshop
'shopyy'=Shopyy
'vova'=Vova
'kilimall'=Kilimall
'gogomall'=GogoMall
'shoplazza'=店匠
'gearbest'=Gearbest
'mercado'=Mercado
'jumia'=Jumia
'tiki'=Tiki
'xshoppy'=XShoppy
'shopline'=Shopline
'alibaba'=Alibaba
'bigcommer'=BigCommerce
'shopbase'=ShopBase
'allegro'=Allegro
'daraz'=Daraz
'other'=手工订单
...
omp_vat_number
...
销售平台VAT号
...
选填
...
收件人是英国的才会传
...
shipper_eori
...
客人的EORI号
...
必填
...
收件人是英国的才会传
...
reason_for_export
...
出口原因
...
选填
...
传：Sale
...
content_type
...
包裹类型
...
选填
...
传：Other
...
sender_contact
...
发件人
...
选填（DPD服务必填）
...
按客户填的传
...
sender_address_line1
...
发件人地址行1
...
选填（DPD服务必填）
...
按客户填的传
...
sender_address_line2
...
发件人地址行2
...
选填
...
按客户填的传
...
sender_city
...
发件人城市
...
选填（DPD服务必填）
...
按客户填的传
...
sender_county
...
发件人省/郡
...
选填
...
按客户填的传
...
sender_post_code
...
发件人邮编
...
选填（DPD服务必填）
...
按客户填的传
...
sender_country_iso
...
发件人国家
...
选填（DPD服务必填）
...
按客户填的传
...
sender_email
...
发件人电子邮箱
...
选填
...
按客户填的传
...
sender_telephone
...
发件人电话
...
选填（DPD服务必填）
...
按客户填的传
请求描述
（以下为折叠内容，签署合同时以下信息无需参考，仅供第三方对接参考）
...
| title | （以下为折叠内容，签署合同时以下信息无需参考，仅供第三方对接参考） |
|---|
请求描述
温馨提示：
1、请注意必填字段，创建订单时，必填字段未填会报错。
2、如遇到下单被拦截提示报错的情况，请及时反馈飞鸟客服协助处理。
Python_requests请求格式：
| Code Block | ||
|---|---|---|
| ||
import requests
import time
url = "https://test.birdsystem.com/client/Consignment/Post-Pending-Consignment-With-Products-Json"
payload="[\r\n {\r\n \"contact\": \"yuhao\",\r\n \"business_name\": null,\r\n \"address_line1\": \"DPF4\",\r\n \"address_line2\": \"D474\",\r\n \"address_line3\": null,\r\n \"city\": \"Atlanta\",\r\n \"county\": \"Georgia\",\r\n \"post_code\": \"30309\",\r\n \"country_iso\": \"GB\",\r\n \"telephone\": \"01704 226830\",\r\n \"email\": null,\r\n \"delivery_service_id\": \"2709\",\r\n \"sales_reference\": \"2\",\r\n \"sales_order_id\": \"110222319566-0\",\r\n \"special_instruction\": null,\r\n \"products\":[\r\n {\"id\":2685282,\"quantity\":1,\"ebay_transaction_id\":\"ebay_id\",\"ebay_item_no\":\"ebay_product_id\"}\r\n ],\r\n \"sales_order_id\": \"1234567654\",\r\n\r\n \"omp_name\": \"ebay\",\r\n\r\n \"omp_vat_number\": \"239\",\r\n \r\n \"shipper_eori\": \"1616407137\",\r\n \r\n \"reason_for_export\": \"Sale\",\r\n \"content_type\": \"Gift\"\r\n \r\n }\r\n]"
"""data注释"""
#payload="[\r\n {\r\n \"contact\": \"yuhao\",\r\n \"business_name\": null,\r\n \"address_line1\": \"DPF4\",\r\n \"address_line2\": \"D474\",\r\n \"address_line3\": null,\r\n \"city\": \"Atlanta\",\r\n \"county\": \"Georgia\",\r\n \"post_code\": \"30309\",\r\n \"country_iso\": \"GB\",\r\n \"telephone\": \"01704 226830\",\r\n \"email\": null,\r\n \"delivery_service_id\": \"2709\",\r\n \"sales_reference\": \"2\",\r\n \"sales_order_id\": \"110222319566-0\",\r\n \"special_instruction\": null, \r\n \"products\":[\r\n {\"id\":2685282,\"quantity\":1,\"ebay_transaction_id\":\"ebay_id\",\"ebay_item_no\":\"ebay_product_id\"}\r\n ],\r\n \"#\":\" // 新增 销售订单ID 【yodel 出口必填】\",\r\n \"sales_order_id\": \"1234567654\",\r\n \"#\":\"// 新增 销售平台名称 (必须是英文), ebay, amazon 等 【royal mail，yodel 出口必填】\",\r\n \"omp_name\": \"ebay\",\r\n \"#\":\"// 新增 销售平台的vat号 【yodel 出口必填】\",\r\n \"omp_vat_number\": \"617\",\r\n \"#\":\"// 新增 客户的eori号 【royal mail，dpd 出口必填】\",\r\n \"shipper_eori\": \"1616407583\",\r\n \"#\":\"// 新增 出口原因: (Sale:销售; ReturnReplacement:退换; Gift:礼物），【dpd 出口必填】\",\r\n \"reason_for_export\": \"Sale\",\r\n \"#\":\"// 新增 包裹类型: （Gift:礼物；Documents:文件,Other:其他），【royalmail 出口必填】\",\r\n \"content_type\": \"Gift\"\r\n }\r\n]"
headers = {
'company_id': '36',
'api_key': '7a8ec5ff51bc45e26a11a54a755adcd8',
'Content-Type': 'application/json',
'Cookie': 'PHPSESSID=iunfg3velvm9tl67t3mg182lg4'
}
response = requests.request("POST", url, headers=headers, data=payload)
print("url:","\n",response.url)
print("text:","\n",response.text)
print(response.json) |
返回结果：
...
| language | json |
|---|
...
1-2本地/2-2专线订单批量创建接口描述
URL | https://test.birdsystem.com/client/Consignment/Post-Pending-Consignment-With-Products-Json | |||
|---|---|---|---|---|
| 1 | 接口功能 | 批量创建订单接口 | 订单类型 | 本地订单/专线订单 |
| 2 | 支持格式 | JSON | 开发人员 | |
| 3 | 请求方式 | POST/GET | 发布日期 | |
| 4 | 请求改动 | |||
接口请求参数描述
参数 | 说明 | 是否必填 | 是否对接字段/取值内容（请求根据实际情况选择填写） | ||||||
|---|---|---|---|---|---|---|---|---|---|
| 1 | is_urgent | 是否紧急订单 | 选填（0或1） | 按客户填的传 | |||||
| 2 | delivery_service_id | 邮递服务ID | 必填 | 按客户填的传 | |||||
| 3 | sales_reference | 销售跟踪号 | 选填 | 按用户填的传/或REP系统单号 | |||||
| 4 | sales_order_id | 销售订单号 | 选填 | 按用户填的传/或REP系统单号 | |||||
| 5 | custom_identity_reference | 自定义唯一跟踪号 | 选填 | 按用户填的传/或REP系统单号（birdsystem会根据改字段判断订单是否重复） | |||||
| 6 | contact | 收件联系人 | 必填 | 按用户填的传 | |||||
| 7 | business_name | 公司 | 选填 | 按用户填的传 | |||||
| 8 | address_line1 | 地址行1 | 必填 | 按用户填的传 | |||||
| 9 | address_line2 | 地址行2 | 选填 | 按用户填的传 | |||||
| 10 | city | 城市 | 必填 | 按用户填的传 | |||||
| 11 | county | 省/郡 | 选填 | 按用户填的传 | |||||
| 12 | post_code | 邮编 | 必填 | 按用户填的传 | |||||
| 13 | country_iso | 国家 | 必填 | 按用户填的传 | |||||
| 14 | telephone | 电话 | 选填 | 按用户填的传 | |||||
| 15 | 电子邮箱 | 选填 | 按用户填的传 | ||||||
| 16 | special_instruction | 备注1 | 选填 | 按用户填的传 | |||||
| 17 | neighbour_instruction | 备注2 | 选填 | 按用户填的传 | |||||
| 18 | type | 订单类型 | 必填 | 本地订单传（LOCAL） | |||||
| 19 | products | 产品 ] | 必填 | 按客户填的传 (ebay_transaction_id (sales_price | |||||
| 20 | omp_name | 销售平台名称 | 选填 | 按用户填的传
| |||||
| 21 | omp_vat_number | 销售平台VAT号 | 选填（DPD服务按要求必填） | 英国发往非英国且公司不为空（“business_name“字段）的DPD订单 要求必填 | |||||
| 22 | shipper_eori | 客人的EORI号 | 选填 | 英国发往EU必填 英国发往非英国的DPD服务必填 | |||||
| 23 | reason_for_export | 出口原因 | 选填 | 传：SALE | |||||
| 24 | content_type | 包裹类型 | 选填 | 传：Other | |||||
| 25 | sender_contact | 发件人 | 选填（DPD服务必填） | 按客户填的传 | |||||
| 26 | sender_address_line1 | 发件人地址行1 | 选填（DPD服务必填） | 按客户填的传 | |||||
| 27 | sender_address_line2 | 发件人地址行2 | 选填 | 按客户填的传 | |||||
| 28 | sender_city | 发件人城市 | 选填（DPD服务必填） | 按客户填的传 | |||||
| 29 | sender_county | 发件人省/郡 | 选填 | 按客户填的传 | |||||
| 30 | sender_post_code | 发件人邮编 | 选填（DPD服务必填） | 按客户填的传 | |||||
| 31 | sender_country_iso | 发件人国家 | 选填（DPD服务必填） | 按客户填的传 | |||||
| 32 | sender_email | 发件人电子邮箱 | 选填 | 按客户填的传 | |||||
| 33 | sender_telephone | 发件人电话 | 选填（DPD服务必填） | 按客户填的传 | |||||
| 34 | ioss_vat_number | IOSS号 | 必填 | 填写客户实际IOSS号 | |||||
| 35 | receiver_eori | 收件人EORI | 选填（DPD服务按要求必填） | 英国发往非英国且公司不为空（“business_name“字段）的DPD订单 要求必填 | |||||
| 36 | receiver_pid_number | 收件人个人证件号 | 选填（DPD服务按要求必填） | 英国发往挪威、西班牙、意大利的DPD订单 要求必填 | |||||
| 37 | is_compensation_for_delay | 是否需要晚必赔服务（仅支持部分服务，偏远地区除外） | 选填 | 取值0/1，默认为0，非0传1 |
请求描述
（以下为折叠内容，签署合同时以下信息无需参考，仅供第三方对接参考）
| Expand | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
温馨提示： JSON请求格式：
返回结果：
line: 创建失败的时候, 会告知是哪一个line出错. 返回异常示例 必填项
|