Versions Compared

Old Version 14

changes.mady.by.user to Hallucin Grape

Saved on

compared with

New Version 15

changes.mady.by.user to Hallucin Grape

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

接口描述

...

URL

接口描述

URL

https://test.birdsystem.com/client/Consignment/Post-Pending-Consignment-With-Products-Json

1

接口功能

批量创建订单接口

订单类型

本地订单/专线订单

2

支持格式

JSON

开发人员

数据已丢失

3

请求方式

POST/GET

发布日期

数据已丢失

...

参数

说明

是否必填

是否对接字段/取值内容（请求根据实际情况选择填写）

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

email

电子邮箱

选填

按用户填的传

16

special_instruction

备注1

选填

按用户填的传

17

neighbour_instruction

备注2

选填

按用户填的传

18

type

订单类型

必填

本地订单传（LOCAL）
专线订单（DIRECT）

19

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
/平台销售价格, 美元)
按客户填的传(必填）

20

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'=手工订单

21

omp_vat_number

销售平台VAT号

选填

收件人是英国的才会传

22

shipper_eori

客人的EORI号

必填

收件人是英国的才会传

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服务必填）

按客户填的传

请求描述
（以下为折叠内容，签署合同时以下信息无需参考，仅供第三方对接参考）

Expand
title（以下为折叠内容，签署合同时以下信息无需参考，仅供第三方对接参考）

请求描述

Python_requests请求格式：

Code Block
languagepy
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]"
"""注释"""
#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)