Page Comparison

接口说明：

批量订单是为了方便地处理大量订单而提供的一个临时订单，包括邮递服务、地址等信息，通过如下API创建：

URL	http://test.birdsystem.com/client/consignment-upload/Temp-Consignment-Json
接口功能	创建批量代理专线订单
支持格式	JSON	开发人员
请求方式	POST	发布日期

参数说明：

参数	说明	必选	类型
contact	联系人	必填	VARCHAR(100)
business_name	公司		VARCHAR(255)
address_line1	地址行1	必填	VARCHAR(100)
address_line2	地址行2		VARCHAR(100)
address_line3	地址行3		VARCHAR(100)
city	城市	必填	VARCHAR(50)
county	省/郡		VARCHAR(50)
post_code	邮编	必填	VARCHAR(10)
country_name	国家获取国家	必填	CHAR(2)
telephone	电话		VARCHAR(50)
email	电子邮件		VARCHAR(255)
sales_reference	销售跟踪号		VARCHAR(50)
payment_reference	付款跟踪号		VARCHAR(50)
telephone	电话		VARCHAR(50)
special_instruction	备注1		VARCHAR(255)
neighbour_instruction	备注2		VARCHAR(255)
sales_order_id	eBay或Amazon订单ID (注：对eBay订单，如果客户有多个eBay账户，那么请把eBay卖家ID信息也填在这里，可以按以下格式： “SellerUserID : OrderID” )		VARCHAR(50)
custom_identity_reference	自定义惟一标识 (注: 如果填写了，会进行检测，同一种类型同一站点下的批量订单，6个月内不能有重复的标识) 重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"}		VARCHAR(50)
product_company_ref	产品信息，格式如下：产品英文名称##产品中文名称##客户sku\|\|内部出口报关价\|\|重量\|\|产品属性\|\|图片URL\|\|平台销售单价平台销售单价（币种USD）\|\|出口报关编码\|\|产地数量多个产品用“+”号相连，示例： Product1##产品##062589\|\|2\|\|10\|\|其他\|\|www.baidu.com\|\|5\|\|4202929190\|\|cn1+Product2##产品2##78954623\|\|2\|\|30\|\|电池,其他\|\|www.baidu.com\|\|5\|\|4202929190\|\|cn*1 (多个海关属性用逗号连接) 获取产品属性 ps：不填写非必填字段，需用0占位；否则传值会错位显示	必填	VARCHAR(255)
delivery_service_name	邮递服务名称，或者使用delivery_service_id参数，指的是邮递服务id，即渠道代码获取邮递服务	必填	INT(4)
status	批量订单状态	必填	'PENDING'
type	订单类型	必填	'AGENT_DIRECT'
thirty_system_id	第三方系统id		VARCHAR(50)
ebay_transaction_id	eBay订单交易号，加在product_company_ref里边		VARCHAR(50)
ebay_item_no	eBay产品ID，加在product_company_ref里边		VARCHAR(50)
ioss_vat_number	IOSS号，订单发往欧盟国家是，必填，限制填12位字符，格式两位字母+十位数字	必填	VARCHAR(12)
omp_vat_number	销售平台VAT号英国发往非英国且公司不为空（“business_name“字段）的DPD订单要求必填	选填（DPD服务按要求必填）
shipper_eori	`royal mail，dpd，欧盟及全球派服务必填` 英国发往非英国的DPD服务必填	必填	VARCHAR(50)
receiver_eori	收件人EORI 英国发往非英国且公司不为空（“business_name“字段）的DPD订单要求必填	选填（DPD服务按要求必填）
receiver_pid_number	收件人个人证件号英国发往挪威、西班牙、意大利的DPD订单要求必填	选填（DPD服务按要求必填）
is_compensation_for_delay	是否需要“晚必赔”服务（只支持部分邮递服务，且偏远地区除外）传0/1，默认0，非0传1	选填	BOOL

请求示例：

Code Block

language	js

GET /client/Consignment/Post-Pending-Consignment-With-Products-Json HTTP/1.1
Host: {{Bird_URL}}
Headres:
  api_key: {{api_key}}
  company_id: {{company_id}}
  Cookie: PHPSESSID=3s3nejv43u9bhirsrvq9nge254
Body
raw
[
    {
        "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": "Germany##可乐##1996129yuhao_product##yuhao_product_cn##122*1||21.5||102||内置锂离子电池其它||www.baidu.com||3||5yuhao12||cn*1+test##可乐##1996125||2||10||内置锂离子电池||www.baidu.com||3||5||cn*1||eaby_yuhao1||eaby_yuhao1",
"product_company_ref":"ProductName##ProductNameCN##ClientSKU*Quantity||ProductPrice||ProductWeight||productPropertyNames||imgSrc||PlatformSalesPrice||HsCode||CountryOfOrigin||ebayTransactionId||ebayItemNo",
        //产品英文名称##产品中文名称##客户sku"product_company_ref":"产品英文名称##产品中文名称##sku*产品数量||内部出口报关价出口报关价格||重量||产品属性产品属性名称||图片URL图片地址||平台销售单价平台销售价格||出口报关编码商品报关编码||产地*数量+//产品英文名称##产品中文名称##客户sku||内部出口报关价ebay订单ID||重量||产品属性||图片URL||平台销售单价||出口报关编码||产地*数量"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,
        "is_compensation_for_delay": "1"
    }
]

注：产品的“品牌”字段暂时无法用此接口上传。

...

Code Block

title	创建批量代理专线订单返回结果
collapse	true

{
    "data": {
        "2222": "46520946"
    },
    "message": "File successfully uploaded! 1 records has been imported.",
    "success": true,
    "moduleName": "client"
}

返回参数说明：

参数	说明
data	键值对分别是 thirty_system_id和临时批量订单id
message	成功/失败信息
success	true/false
moduleName	client

Versions Compared

Old Version 32

New Version Current

Key

接口说明：

参数说明：

请求示例：

返回参数说明：