Versions Compared

Old Version 20

changes.mady.by.user Bess

Saved on

compared with

New Version 21

changes.mady.by.user Bess

Saved on

Key

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

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

接口说明：

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

URLhttp://test.birdsystem.com/client/consignment-upload/Temp-Consignment-Json

method

post

body

json属性如下:
接口功能
创建批量代理专线订单

支持格式

JSON开发人员
请求方式POST发布日期

参数说明：

js

3.thirty_system_id: 第三方系统id

4.payment_reference：流水号


参数

说明必选类型

delivery_service_name

邮递服务邮递服务名称，或者使用delivery_service_id参数，指的是邮递服务id，即渠道代码 获取邮递服务

必填

INT(4)

sales_reference

销售跟踪号


VARCHAR(50)

sales_order_id

eBay或Amazon订单ID

(注：对eBay订单，如果客户有多个eBay账户，那么请把eBay卖家ID信息

也填在这里，可以按以下格式： “SellerUserID : OrderID” )


VARCHAR(50)
delivery_reference邮递跟踪号运输跟踪号
VARCHAR(50)
custom_identity_reference

自定义惟一标识 

(注: 如果填写了，会进行检测，同一种类型同一站点下的批量订单，6个月内不能有重复的标识)

重复的话会返回: {"success":false,"message":"Duplicate consignment identity reference [....]"}


VARCHAR(50)

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)

product_company_ref

产品(定向共享产品标记为ClientId#ProductId#D * 数量)

代理专线订单是: product_name##product产品信息

示例：Product_name||Product_name_cn##client_refcn||ProductPrice||ProductWeight||ProductCustomsProperty*Quantity

例如: test1##测试1##47产品1||5||10||电池,其他*2 (多个海关属性用逗号连接)

注：若不填写client_ref（选填项），则格式为 ：                                                                                                                                               product_name##product_name_cn||ProductPrice||ProductWeight||ProductCustomsProperty*Quantity

若不填写product_name_cn，则格式为：

product_name##0##client_ref||ProductPrice||ProductWeight||ProductCustomsProperty*Quantity（用0占位）获取产品属性

必填VARCHAR(255)

email

电子邮件


VARCHAR(255)

special_instruction

:

备注1


VARCHAR(255)

neighbour_instruction

:

备注2


VARCHAR(255)

status批量订单状态必填'PENDING'

type

订单类型 必填'AGENT_DIRECT'

请求示例：

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_name": "United Kingdom",
        "telephone": "01704 226830",
        "email": null,
        "sales_order_id": "110222319566-0",
        "custom_identity_reference":"24S5662a321",
        "payment_reference": "Royal Mail 1st Class Standard",
        "special_instruction": null,
        "product_company_ref": "6apple29##灯1##47||2||3||其它||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg*1+7apple29##灯1##487||2||3||其它||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg*1",
        "delivery_service_name": "D 中英平邮（B2P）",
        "status": "PENDING",
        "type": "AGENT_DIRECT",
        "thirty_system_id":"2222"
    }
]
图片URL：直接在海关属性后面加"
注：
  1. attachment-url（图片URL）：直接在海关属性后面加||+
url"==>
  1. url        eg：||http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg
图片URL：attachment-url
新产品图片URL为必填，已存在的产品不用传图片URL（只能传网上的图片，不能传本地的）
2.品牌字段暂时这个接口无法上传
需要填写销售跟踪号请自行添加参数 sales_reference,  例如 "sales_reference":"12345"
返回
 Code Block
language
返回示例：

 Code Block
title创建批量代理专线订单返回结果
collapsetrue
{
    "data": {
        "2222": "
...
46520946"
    },
    "message": "File successfully uploaded! 1 records has been imported.",
    "success": true,
    "moduleName": "client"
}
...
参数
thirty_system_id: 第三方系统id
country_name: 可以通过/client/Country获取
delivery_service_name: 可以通过/client/Delivery-Service 获取
product_company_ref: 产品id*数量, 多个产品的话 产品id*数量+产品id*数量, 可以通过/client/Product 获取
...