Versions Compared

Key

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

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

url

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

method

post

body

json属性如下:





delivery_service_name

邮递服务

必填

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 * 数量;父账号下单格式:ShareFromClientId#ProductId#D#ShareToClientId)

代理专线订单是: ProductName||ProductPrice||ProductWeight*Quantity

必填VARCHAR(255)

email

电子邮件


VARCHAR(255)

special_instruction:

备注1


VARCHAR(255)

neighbour_instruction:

备注2


VARCHAR(255)

type

订单类型必填['LOCAL','RETURN']



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_reference": "2", 
		"sales_order_id": "110222319566-0",
        "payment_reference": "Royal Mail 1st Class Standard", 
        "special_instruction": null, 
        "product_company_ref": "983#494721#D*1+983#310657#D", 
        "delivery_service_name": "Royal Mail 1st Class Standard", 
        "status": "PENDING", 
        "type": "LOCAL", 
        "thirty_system_id":"2222" 
    } 
]


返回


Code Block
languagejs
{
    "success":true,
    "message":"File successfully uploaded! 1 records has been imported.",
    "data":{"2222":"12010433"}
}


参数

thirty_system_id: 第三方系统id

country_name: 可以通过/client/Country获取

delivery_service_name: 可以通过/client/Delivery-Service 获取

product_company_ref: 产品id*数量, 多个产品的话 产品id*数量+产品id*数量, 可以通过/client/Product 获取