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
languagejs
[
    {
        "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号,请在鸟系统中添加相对应的vat号信息

...

涉及的服务ID

1站点,19站点,20站点的DPD,Royal Mail 和 36站点的 YODEL

View file
name脱欧.xlsx

...

各接口新增的字段

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
文档地址:(用于本地订单/专线订单产品备案)产品的增删改查