2-3-1. 批量专线订单上传

批量订单是为了方便地处理大量订单而提供的一个临时订单,包括邮递服务、地址等信息,通过如下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 * 数量)

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

必填VARCHAR(255)

email

电子邮件


VARCHAR(255)

special_instruction:

备注1


VARCHAR(255)

neighbour_instruction:

备注2


VARCHAR(255)

type

订单类型必填'DIRECT'

omp_name

销售平台名称,(必须是英文), ebay, amazon 等


VARCHAR(50)

omp_vat_number

销售平台VAT号

英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填

VARCHAR(50)

shipper_eori

EORI号

英国发往非英国的DPD服务必填

VARCHAR(50)

reason_for_export

出口原因,值【Sale:销售; ReturnReplacement:退换; Gift:礼物】


ENUM("Sale","ReturnReplacement","Gift")

content_type

包裹类型,值【Gift 礼物;Documents 文件和 Other 其他】


ENUM("Gift","Documents","Other")

ioss_vat_number

IOSS号,限制填12位字符,格式两位字母+十位数字
订单发往欧盟国家时,必填

必填

VARCHAR(12)

receiver_eori

收件人EORI

选填(DPD服务按要求必填)

英国发往非英国且公司不为空(“business_name“字段)的DPD订单 要求必填

receiver_pid_number

收件人个人证件号

选填(DPD服务按要求必填)

英国发往挪威、西班牙、意大利的DPD订单 要求必填


需要销售跟踪号的请自行添加 sales_reference:your_sales_reference

[
     {
          "contact": "Norman Drury",
          "business_name": 1,
          "address_line1": "3Northam Close",
          "address_line2": "Marshside",
          "address_line3": null,
          "city": "Southport",
          "county": "Merseyside",
          "post_code": "12345",
          "country_name": "Norway",
          "telephone": "01704 226830",
          "email": null,
          "delivery_service_id": "5317",
          "sales_reference": "2",
          "sales_order_id": "1234567654",
          "special_instruction": null,
          "product_company_ref": "1-1*1||ebayid||ebatproduct||18+1996125*1||ebayid2||ebatproduct2||20",
          "type": "DIRECT",
          "sender_contact": "123",
          "omp_name": "ebay",
          "omp_vat_number": "12345",
          "shipper_eori": "12345600",
          "reason_for_export": "Sale",
          "content_type": "Gift",
          "ioss_vat_number": 172848,
          "receiver_eori":"123456",
          "receiver_pid_number":"12",
          "sender_address_line1": "SHENZHENG BANTIAN",
          "sender_city": "SHENZHEN",
          "sender_post_code": 12345,
          "sender_country_iso": "CN",
          "sender_telephone": "155465751714"
     }
]

返回

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

参数

 thirty_system_id: 第三方系统id

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

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

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