Versions Compared

Key

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

调整:新增字段:"ioss_vat_number" // IOSS号

FBA订单
1、FBA订单-添加单个FBA订单接口

新增字段:"ioss_vat_number" // IOSS号
IOSS号,限制填6位数字IOSS号
订单发往欧盟国家时,必填

添加单个FBA订单
接口文档地址:https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/edit-v2/2221113589

Expand
titleFBA添加单个订单接口参数描述
Code Block
POST /client/Consignment/ HTTP/1.1
Host: www.bs-8262.test.birdsystem.com
api_key: 827ccb0eea8a706c4c34a16891f84e7b
company_id: 2
Content-Type: application/json
Cookie: PHPSESSID=pedg5aml9k4h3bsl2gvj3j0va6
Content-Length: 1190

{
    "is_urgent": "0",
    "delivery_service_id": "5319",
    "sales_reference": "MYSQL100",
    "sales_price": "100",
    "sales_order_id": "MYSQL100",
    "omp_name": "JAVA",
    "omp_vat_number": "202101110000",
    "shipper_eori": "202101110000",
    "reason_for_export": "SALE",
    "content_type": "GIFT",
    "custom_identity_reference": "1624440016",
    "special_instruction": "派大星",
    "contact": "派大星",
    "business_name": "bird",
    "address_line1": "云谷",
    "address_line2": "云阁",
    "address_line3": "一栈",
    "city": "云城",
    "county": "云岛",
    "post_code": "13149999",
    "country_iso": "GB",
    "telephone": "1851717668",
    "email": "1851717668@bird.co.uk",
    "sender_contact": "派大星",
    "sender_business_name": "bird",
    "sender_address_line1": "云谷",
    "sender_address_line2": "云阁",
    "sender_address_line3": "一栈",
    "sender_city": "云城",
    "sender_county": "云岛",
    "sender_post_code": "13149999",
    "sender_country_iso": "GB",
    "sender_telephone": "1851717668",
    "sender_email": "1851717668@bird.co.uk",
    "update_time": "2021-05-31 12:08:39",
    "type": "FBA",
    "ioss_vat_number":"172848" //新增IOSS字段
}

2、FBA订单,单个订单添加产品接口


新增字段:"ioss_vat_number" // IOSS号
IOSS号,限制填6位数字IOSS号
订单发往欧盟国家时,必填

添加单个FBA订单
接口文档地址:4-1-2、FBA单个订单添加产品

Expand
titleFBA订单,单个订单添加产品接口描述
Code Block
POST /client/Consignment-Product/ HTTP/1.1
Host: www.bs-8164.test.birdsystem.com
api_key: 827ccb0eea8a706c4c34a16891f84e7b
company_id: 1
Content-Type: application/json
Content-Length: 223

{
    "consignment_id": "2106180010000002",
    "product_id": "1996131",
    "client_id":null,
    "quantity": "2",
    "sales_price": "10",    //平台销售单价(必填)
    "ebay_transaction_id": "ebayID",
    "ebay_item_no": "eBayproductID"
}

本地订单/专线订单

1、批量创建本地/专线订单接口

新增字段:"ioss_vat_number" // IOSS号
IOSS号,限制填6位数字IOSS号
订单发往欧盟国家时,必填

批量创建本地/专线订单
接口文档地址: 1-2本地/2-2专线订单批量创建通用API

Expand
title批量创建本地/专线订单接口描述
Code Block
POST /client/Consignment/Post-Pending-Consignment-With-Products-Json HTTP/1.1
Host: www.bs-8262.test.birdsystem.com
api_key: 827ccb0eea8a706c4c34a16891f84e7b
company_id: 2
Content-Type: application/json
Cookie: PHPSESSID=pedg5aml9k4h3bsl2gvj3j0va6
Content-Length: 1294

[
    {
        "contact": "yuhao",
        "business_name": null,
        "address_line1": "DPF4",
        "address_line2": "D474",
        "address_line3": null,
        "city": "Atlanta",
        "county": "Georgia",
        "post_code": "30309",
        "country_iso": "GB",
        "telephone": "01704 226830",
        "email": null,
        "delivery_service_id": "2709",
        "sales_reference": "2",
        "sales_order_id": "110222319566-0",
        "special_instruction": null,
        "products":[
            {"id":1996129,"quantity":1,sales_price”:10}  //sales_price-平台销售单价(必填)
        ],
        "#sales_order_id":" // 新增 销售订单ID 【yodel 出口必填】",
        "sales_order_id": "1234567654",
        "#omp_name":"// 新增 销售平台名称 (必须是英文), ebay, amazon 等 【royal mail,yodel 出口必填】",
        "omp_name": "ebay",
        "#omp_vat_number":"// 新增 销售平台的vat号 【yodel 出口必填】",
        "omp_vat_number": "12345",
        "#shipper_eori":"// 新增 客户的eori号  【royal mail,dpd 出口必填】mail,dpd,欧盟及全球派服务必填】",
        "shipper_eori": "12345000",
        "#reason_for_export":"// 新增 出口原因: (Sale:销售; ReturnReplacement:退换; Gift:礼物),【dpd 出口必填】",
        "reason_for_export": "Sale",
        "#content_type":"// 新增 包裹类型: (Gift:礼物;Documents:文件,Other:其他),【royalmail 出口必填】",
        "content_type": "Gift",
        "ioss_vat_number":"172848"  //新增IOSS字段
    }
]

2、批量本地/专线订单接口

新增字段:"ioss_vat_number" // IOSS号
IOSS号,限制填6位数字IOSS号
订单发往欧盟国家时,必填

批量创建本地/专线订单
接口文档地址: 1-3-1. 添加批量临时本地订单 2-3-1. 批量专线订单上传

...

产品接口添加的产品ID用于FBA订单,本地订单,专线订单添加产品时使用。
(FBA订单,本地订单,专线订单) \\商品报关编码字段为(commodity_code )在产品接口

接口文档地址:https://birdsystem.atlassian.net/wiki/spaces/DEV/pages/edit-v2/1953595810 产品添加API

代理专线订单

1、批量创建代理订单接口

新增字段:"ioss_vat_number" // IOSS号
IOSS号,限制填6位数字IOSS号
订单发往欧盟国家时,必填
(代理专线订单)\\商品报关编码字段为(hs_code),创建订单时,放在代理专线”products“里面一起推送即可!

批量创建本地/专线订单
接口文档地址: 3-2代理专线订单批量创建API

Expand
title批量创建代理订单接口描述
Code Block
POST /client/consignment/post-pending-consignment-with-products-json HTTP/1.1
Host: www.bs-8262.test.birdsystem.com
api_key: 827ccb0eea8a706c4c34a16891f84e7b
company_id: 2
Content-Type: application/json
Cookie: PHPSESSID=pedg5aml9k4h3bsl2gvj3j0va6
Content-Length: 2932

[
    {
        "contact": "Norman Drury",
        "business_name": null,
        "address_line1": "3Northam Close",
        "address_line2": "Marshside",
        "address_line3": null,
        "city": "Southport",
        "county": "Merseyside",
        "post_code": "12345",
        "country_iso": "DE",
        "telephone": "01704 226830",
        "email": null,
        "delivery_service_id": "5318",
        "sales_reference": "2",
        "sales_order_id": "110222319566-0",
        "special_instruction": null,
        "products":[
           {
           	"product_name": "3apple297777777",
        	"product_name_cn":"3苹果2955555555",
        	"brand":"asd品牌",
        	"client_ref":"a4624777777",
        	"price_customs_export": "3",
        	"sales_price":"10", //平台销售单格(必填)
        	"weight": "300",
        	"quantity": "1",
        	"product_customs_property":["其它"],
        	"attachment-url":"http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg",
            "hs_code":"172848"  //商品报关编码
           },{
           	"product_name": "3apple299999999",
        	"product_name_cn":"3苹果2944444444444",
        	"brand":"asd品牌",
        	"client_ref":"a4624888888",
        	"price_customs_export": "3",
        	"sales_price":"10",  //平台销售单格(必填)
        	"weight": "300",
        	"quantity": "1",
        	"product_customs_property":["其它"],
        	"attachment-url":"http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg",
            "hs_code":"172848"  //商品报关编码
           },{
           	"product_name": "3apple2988888",
        	"product_name_cn":"3苹果23222222222222",
        	"brand":"asd品牌",
        	"client_ref":"a46249999999",
        	"price_customs_export": "3",
        	"sales_price":"10",    //平台销售单格(必填)
        	"weight": "300",
        	"quantity": "1",
        	"product_customs_property":["其它"],
        	"attachment-url":"http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg",
            "hs_code":"172848"  //商品报关编码
        ],
        "type":"AGENT_DIRECT",
        "sender_contact":"123",
        "#sales_order_id":" // 新增 销售订单ID 【yodel 出口必填】",
        "sales_order_id": "1234567654",
        "#omp_name":"// 新增 销售平台名称 (必须是英文), ebay, amazon 等 【royal mail,yodel 出口必填】",
        "omp_name": "ebay",
        "#omp_vat_number":"// 新增 销售平台的vat号 【yodel 出口必填】",
        "omp_vat_number": "12345",
        "#shipper_eori":"// 新增 客户的eori号  【royal mail,dpd 出口必填】mail,dpd,欧盟及全球派服务必填】",
        "shipper_eori": "12345600",
        "#reason_for_export":"// 新增 出口原因: (Sale:销售; ReturnReplacement:退换; Gift:礼物),【dpd 出口必填】",
        "reason_for_export": "Sale",
        "#content_type":"// 新增 包裹类型: (Gift:礼物;Documents:文件,Other:其他),【royalmail 出口必填】",
        "content_type": "Gift",
        "ioss_vat_number":172848,  //新增IOSS字段
        "sender_address_line1":"SHENZHENG BANTIAN",
        "sender_city":"SHENZHEN",
        "sender_post_code":12345,
        "sender_country_iso":"DE",
        "sender_telephone":"155465751714"
    }
]

2、批量代理专线订单接口

新增字段:"ioss_vat_number" // IOSS号
IOSS号,限制填6位数字IOSS号
订单发往欧盟国家时,必填

批量创建本地/专线订单
接口文档地址: 3-3. 批量代理专线订单

Expand
title批量代理专线订单接口描述
Code Block
[
    {
        "contact": "test",
        "business_name": null,
        "address_line1": "123 letter",
        "address_line2": "",
        "address_line3": null,
        "city": "Atlanta",
        "county": "",
        "post_code": "30309",
        "country_name": "Germany",
        "telephone": "",
        "email": null,
        "sales_order_id": "123456-789",
        "payment_reference": "",
        "special_instruction": null,
        "product_company_ref": "yuhao_product##yuhao_product_cn##122*1||1.5||2||其它||0||3||yuhao12||cn||eaby_yuhao1||eaby_yuhao1",
"###":"ProductName##ProductNameCN##ClientSKU*Quantity||ProductPrice||ProductWeight||productPropertyNames||imgSrc||PlatformSalesPrice||HsCode||CountryOfOrigin||ebayTransactionId||ebayItemNo",
        "#":"//产品sku&产品id&sku*产品数量##eBay订单交易号||eBay产品ID,||平台销售单格+产品sku&产品id*产品数量||eBay订单交易号||eBay产品ID,||平台销售单格",
        "delivery_service_name": "D 中德平邮",
        "status": "PENDING",
        "type": "AGENT_DIRECT",
        "thirty_system_id":"222",
        "sales_reference":"123456",
        "":"新增 销售订单ID 【yodel 出口必填】",
        "sales_order_id": "1234567654",
        "":"// 新增 销售平台名称 (必须是英文), ebay, amazon 等 【royal mail,yodel 出口必填】",
        "omp_name": "ebay",
        "":"// 新增 销售平台的vat号 【yodel 出口必填】",
        "omp_vat_number": "12345",
        "":"// 新增 客户的eori号  【royal mail,dpd 出口必填】mail,dpd,欧盟及全球派服务必填】",
        "shipper_eori": "12345000",
        "":"// 新增 出口原因: (Sale:销售; ReturnReplacement:退换; Gift:礼物),【dpd 出口必填】",
        "reason_for_export": "Sale",
        "":"// 新增 包裹类型: (Gift:礼物;Documents:文件,Other:其他),【royalmail 出口必填】",
        "content_type": "Gift",
        "ioss_vat_number":172848  //新增IOSS字段
    }
]