Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
生效日期: 2021年1月1日
| Table of Contents |
|---|
本地订单/专线订单
批量创建本地订单/专线订单
接口文档链接：
本地订单：1-2. 批量创建本地订单
专线订单：2-2. 批量创建专线订单
接口地址：https://test.birdsystem.co.uk/client/consignment/post-pending-consignment-with-products-json
| Code Block | ||
|---|---|---|
| ||
[ { "contact": "Norman Drury", "business_name": null, "address_line1": "3, Northam Close", "address_line2": "Marshside", "address_line3": null, "city": "Southport", "county": "Merseyside", "post_code": "PR9 9GA", "country_iso": "GB", "telephone": "01704 226830", "email": null, "delivery_service_id": "2662", "sales_reference": "2", "sales_order_id": "110222319566-0", "special_instruction": null, "products":[ {"client_sku":"kise","quantity":1,"ebay_transaction_id":"2222","ebay_item_no":"33"}, {"id":2989316,"quantity":1,"ebay_transaction_id":"2222","ebay_item_no":"33", // 新增 销售价格 【royal mail，dpd，yodel 出口必填】 "sales_price":"10", // 新增 产地 【CN,GB,US等国家二字码】 "country_of_origin":"CN" } ], // 新增 销售订单ID 【yodel 出口必填】 "sales_order_id": "1234567654", // 新增 |
...
销售平台名称 (必须是英文), ebay, amazon 等 【royal mail，yodel 出口必填】 "omp_name": "ebay", // 新增 销售平台的vat号 【yodel 出口必填】 " |
...
omp_ |
...
vat_number": "12345" // 新增 客户的eori号 【royal mail，dpd 出口必填】 "shipper_eori": " |
...
12345000", // 新增 出口原因: ( |
...
SALE:销售; |
...
RETURNREPLACEMENT:退换; |
...
GIFT:礼物），【dpd 出口必填】 "reason_for_ |
...
export": " |
...
SALE", // 新增 包裹类型: （Gift:礼物；Documents:文件,Other:其他），【royalmail 出口必填】 "content_type": 'Gift' } ] |
本地订单和专线订单的 royalmail, dpd, yodel 出口， 需要去产品信息那里给添加上销售价格
dpd出口的，还需要在产品信息那里添加产地
注意：该接口产品信息中的 country_of_origin 是选填，如果产品库里已经有了相关信息，可以不填。
填了会自动更新到产品库。
批量临时本地订单
接口文档链接：1-3-1. 添加批量临时本地订单
接口地址：http://test.birdsystem.com/client/consignment-upload/Temp-Consignment-Json
| Code Block |
|---|
[
{
"contact": "test",
"business_name": null,
"address_line1": "41 Caistor Road",
"address_line2": "",
"address_line3": null,
"city": "Atlanta",
"county": "test",
"post_code": "30309",
"country_name": "Germany",
"telephone": "185455455447",
"email": null,
"payment_reference": null,
"special_instruction": null,
//产品sku的格式 产品sku*产品数量||eBay订单交易号||eBay产品ID||平台销售单价
"product_company_ref": "kise*2||ebay1234||ebayproduct123||12.22",
"delivery_service_name": "本地库存下架",
"status": "PENDING",
"type": "LOCAL",
"thirty_system_id":null,
"sales_reference":"RT22507382",
// 新增 销售订单ID 【yodel 出口必填】
"sales_order_id": "1234567654",
// 新增 销售平台名称 (必须是英文), ebay, amazon 等 【royal mail，yodel 出口必填】
"omp_name": "ebay",
// 新增 销售平台的vat号 【yodel 出口必填】
"omp_vat_number": "12345"
// 新增 客户的eori号 【royal mail，dpd 出口必填】
"shipper_eori": "12345000",
// 新增 出口原因: (SALE:销售; RETURNREPLACEMENT:退换; GIFT:礼物），【dpd 出口必填】
"reason_for_export": "SALE",
// 新增 包裹类型: （Gift:礼物；Documents:文件,Other:其他），【royalmail 出口必填】
"content_type": 'Gift'
}
] |
批量临时专线订单
接口文档链接：2-3-1. 添加
接口地址：http://test.birdsystem.com/client/consignment-upload/Temp-Consignment-Json
| Code Block |
|---|
[
{
"contact": "Norman Drury",
"business_name": null,
"address_line1": "3, Northam Close",
"address_line2": "Marshside",
"address_line3": null,
"city": "Southport",
"county": "Merseyside",
"post_code": "PR9 9GA",
"country_name": "United Kingdom",
"telephone": "01704 226830",
"email": null,
"payment_reference": "Royal Mail 1st Class Standard",
"special_instruction": null,
//产品sku的格式 产品sku*产品数量||eBay订单交易号||eBay产品ID||平台销售单价
"product_company_ref": "kise*2||ebay1234||ebayproduct123||12.22",
"delivery_service_name": "D 平邮",
"status": "PENDING",
"type": "DIRECT",
"thirty_system_id":"2222",
// 新增 销售订单ID 【yodel 出口必填】
"sales_order_id": "1234567654",
// 新增 销售平台名称 (必须是英文), ebay, amazon 等 【royal mail，yodel 出口必填】
"omp_name": "ebay",
// 新增 销售平台的vat号 【yodel 出口必填】
"omp_vat_number": "12345"
// 新增 客户的eori号 【royal mail，dpd 出口必填】
"shipper_eori": "12345000",
// 新增 出口原因: (SALE:销售; RETURNREPLACEMENT:退换; GIFT:礼物），【dpd 出口必填】
"reason_for_export": "SALE",
// 新增 包裹类型: （Gift:礼物；Documents:文件,Other:其他），【royalmail 出口必填】
"content_type": 'Gift'
}
] |
代理专线订单
接口文档链接：
代理专线订单：3-2批量创建代理专线订单（接口）
https://test.birdsystem.co.uk/client/consignment/post-pending-consignment-with-products-json
| Code Block |
|---|
[
{
"contact": "Norman Drury",
"business_name": null,
"address_line1": "3, Northam Close",
"address_line2": "Marshside",
"address_line3": null,
"city": "Southport",
"county": "Merseyside",
"post_code": "PR9 9GA",
"country_iso": "GB",
"telephone": "01704 226830",
"email": "mm",
"delivery_service_id": "5947",
"sales_reference": "2",
"sales_order_id": "110222319566-0",
"products":[
{
"product_name": "3apple29",
"product_name_cn":"3苹果29",
"brand":"asd品牌",
"client_ref":"a4624",
"price_customs_export": "3",
// |
...
新增 销售价格 【royal mail，dpd，yodel 出口必填】 "sales_price":"10", // 新增 hs code 【royal mail 出口必修】 "hs_code":"12121212" "weight": "300", "quantity": "1", "product_customs_property":["其它","电池","纯电池"], "attachment-url":"http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg", // 新增 产地 【CN,GB,US等国家二字码】 "country_of_origin":"CN" } ], "type":"AGENT_DIRECT", // 新增 |
...
销售订单ID 【yodel 出口必填】 "sales_order_id": "1234567654", // 新增 销售平台名称 (必须是英文), ebay, amazon 等 【royal mail，yodel 出口必填】 "omp_name": ”ebay“ // 新增 销售平台的vat号 【yodel 出口必填】 " |
...
omp_ |
...
vat_number": "12345" // 新增 客户的eori号 【royal mail，dpd 出口必填】 "shipper_eori": " |
...
12345000" |
...
// 新增 出口原因: ( |
...
SALE:销售; |
...
RETURNREPLACEMENT:退换; |
...
GIFT:礼物），【dpd 出口必填】 "reason_for_ |
...
export": " |
...
SALE", // 新增 包裹类型: （Gift:礼物；Documents:文件,Other:其他），【royalmail 出口必填】 "content_type": 'Gift' } ] |
...
如果使用的是vat号，请在鸟系统中添加相对应的vat号信息
...
涉及的服务ID
...
| View file | ||
|---|---|---|
|
各接口新增的字段
consignment 接口 新增
销售平台名称 omp_name
销售平台VAT号 omp_vat_number
eori号 shipper_eori
出口原因 reason_for_export 【SALE:销售; RETURNREPLACEMENT:退换; GIFT:礼物】
包裹类型 content_type 【Gift 礼物；Documents 文件和 Other 其他】
文档地址：（本地订单、专线订单使用同一接口）1-1-1. 创建订单（接口）
consignment product 接口 新增
销售价格 sales_price
文档地址：（本地订单、专线订单使用同一接口）1-1-2. 订单添加产品
agent direct consignment product接口 新增
产地 country_of_origin
销售价格 sales_price
海关编码 hs_code
文档地址：（代理专线使用接口）3-1-2. 单个代理专线订单添加产品
product 接口 新增
产地 country_of_origin
销售价格 sales_price
文档地址：（用于本地订单/专线订单产品备案）产品的增删改查