创建订单

Description

一个订单对应一个包裹和它的商品描述、重量、派送地址等信息。

Path

HTTP Verb	URL
Post	/services/shipper/orders

Paremters

#	Field (API)		Field (Excel Template)	Data Type	Length	Mandatory	Details
#	Field (API)		Field (Excel Template)	Data Type	Length	Mandatory
1	referenceNo		Ref No.	String	80	M	客户端的订单唯一标识
2	referenceNo1		referenceNo1	String	80	O	客户端订单号
3	trackingNo		Tracking No.	String	40	O	跟踪号
4	serviceCode		N/A	String	64	M	服务代码，物流商提供
5	incoterm		Incoterm	String	3	O	DDU/DDP
6	description		Goods Description	String	60	M	英文品名
7	nativeDescription		Native Description	String	255	O	中文品名
8	weight		Total weight	Double		M	重量(>=0.000001)
9	weightUnit		Total Weight Unit	String	3	O	重量单位，枚举值：G, KG,LB 默认值：KG
10	length		Length	Double		O	长
11	width		Width	Double		O	宽
12	height		Height	Double		O	高
13	volume		Volume	Double		O	体积(>=0.01)
14	dimensionUnit		Dimension Unit	String	3	O	长度单位，枚举值：M, CM 默认值：CM
15	invoiceValue		Invoice Value	Double		M	货值(>=0.01)，与sum(itemCount * unitValue)的误差不能超过0.1
16	invoiceCurrency		Invoice Currency	String	3	M	币种，ISO货币代码
17			Pick Up	Boolean	1	O	枚举值：Y/N 默认值：N
18	authorityToLeave		ATL	Boolean
19	lockerService		Locker Service	Boolean
20	batteryType		Battery Type	String	64	O	电池类型，枚举值： No Battery Lithium Ion Polymer Lithium Ion Alloy 默认值：No Battery
21	batteryPacking		Battery Packing	String	64	O	电池包装，枚举值： No Battery Inside Equipment Packaged with Equipment Battery Only Other 默认值：No Battery
22	dangerousGoods		Dangerours Goods	Boolean		O	默认值：false
23	sku		Packing List	String	128	O	捡货清单，一般面单上会显示出来
24	serviceOption		Service Option	String	60	O
25	instruction		Shipping Instructions	String	255	O	派送指令
26	facility		Shipper Facility/Origin	String	20	O	发件网点，物流商提供
27	platform		E-Commerce Platform	String	20	O	平台代码
28	recipientName		Recipient Name	String	50	M	收件人名称限制英语/法语字符/非纯数字自动去除特殊字符
29	recipientTaxId		Recipient Tax ID	String	100	O	收件人税号
30	recipientCompany		Recipient Company	String	50	O	收件人公司名
31	phone		Phone	String	20	O	电话
32	email		Email	String	50	O	邮箱
33	addressLine1		Address line 1	String	200	M	地址第一行限制英语/法语字符/非纯数字自动去除特殊字符
34	addressLine2		Address line 2	String	200	O	地址第二行
35	addressLine3		Address line 3	String	80	O	地址第三行
36	city		City/Suburb	String	80	M	城市
37	state		State	String	80	M	省限制英语/法语字符/非纯数字自动去除特殊字符
38	postcode		Postcode	String	16	O	邮编
39	country		Country	String	2	M	国家二字代码
40	shipperName		Shipper Name	String	50	M	发件人名称限制英语/法语字符/非纯数字自动去除特殊字符
41	shipperPhone		Shipper Phone	String	20	O	电话
42	shipperAddressLine1		Shipper Address Line1	String	200	O	地址第一行
43	shipperAddressLine2		Shipper Address Line2	String	200	O	地址第二行
44	shipperAddressLine3		Shipper Address Line3	String	80	O	地址第三行
45	shipperCity		Shipper Address City	String	80	O	城市
46	shipperState		Shipper Address State	String	80	O	省
47	shipperPostcode		Shipper Address Postcode	String	16	O	邮编
48	shipperCountry		Shipper Address Country	String	2	O	国家二字代码
49	returnOption		Return Option	String	100	O	退件选项
50	returnName		Return Name	String	50	M	退件接收人名称
51	returnAddressLine1		Return Address Line1	String	200	M	地址第一行
52	returnAddressLine2		Return Address Line2	String	200	O	地址第二行
53	returnAddressLine3		Return Address Line3	String	80	O	地址第三行
54	returnCity		Return Address City	String	80	M	城市
55	returnState		Return Address State	String	80	M	省
56	returnPostcode		Return Address Postcode	String	16	O	邮编
57	returnCountry		Return Address Country	String	2	M	国家二字代码
58	items		N/A	List		O	Item信息
59		itemNo	Item No	String	128	M	Item编号
60		sku	Item SKU	String	128	M	SKU
61		description	Item Desc	String	60	M	英文品名如果值为空，设置成订单级别的description 1. 不能包含设置的违禁品关键词 2. 必须是英文和法文字符或数字
62		nativeDescription	Item Native Desc	String	255	O	中文品名
63		hsCode	Item HSCode	String	60	O	HS Code
64		originCountry	Item Origin	String	60	M	国家二字代码，三字代码或名称
65		itemCount	Item Count	Integer		M	件数，>0
66		unitValue	Item Unit Value	Double		M	单价，>0
67		warehouseNo	Warehouse No		50	O	截取前50个字符
68		productURL	Item Product URL	String	512	O	产品链接
69		itemWeight	Item Weight	Double		O	Item重量，转换成KG
70	extendData		N/A	List		O	扩展字段
71		vendorid	vendorid	String	12	O	税号
72		gstexemptionCode	gstexemptionCode	Sting	4	O	GST免税码，如果vendorid正确，该字段值自动设置为“PAID”
73		senderTaxId	senderTaxId	String	255	O	发货人税号
74		InjectPort	InjectPort	String	256	O	订单配送港口，针对加拿大服务

Request

[
  {
    "referenceNo": "reedzhang1231211",
    "country": "AU",
    "serviceCode": "UBI.AU2AU.AUPOST.1",
    "serviceOption": "Expedited",
    "facility": "can",
    "state": "VICTORIA",
    "city": "Berwick",
    "postcode": "3806",
    "addressLine1": "3 Lakeside Drivie",
    "addressLine2": "",
    "recipientName": "Corrie McKee",
    "phone": "0403536112",
    "email": "corrie.mckee@monash.edu",
    "sku": "sw2111202146745684",
    "invoiceCurrency": "USD",
    "invoiceValue": 6.23,
    "weightUnit": "g",
    "weight": 264,
    "description": "sw2111202146745684",
    "nativeDescription": "连衣裙",
    "shipperName": "Jiang Yuanfei",
    "shipperPhone": "+86 02586707811",
    "shipperAddressLine1": "Prologis (Anbo) Logistics Center Datang Town,Sanshui Industrial Park",
    "vendorid": "111",
    "abnnumber": "",
    "gstexemptioncode": "PAID",
    "extendData": {
      "injectPort": null
    },
    "orderItems": [
      {
        "itemCount": 1,
        "originCountry": "CN",
        "description": "sw2111202146745684",
        "nativeDescription": "连衣裙",
        "unitValue": 3.87,
        "itemNo": "8247107",
        "sku": "sw2111202146745684"
      },
      {
        "itemCount": 1,
        "originCountry": "CN",
        "description": "sw2201125303640755",
        "nativeDescription": "背心",
        "unitValue": 2.36,
        "itemNo": "9743766",
        "sku": "sw2201125303640755"
      }
    ],
    "shipperCity": "FO SHAN",
    "volume": 0.1
  }
]

Response

 {
  "status": "Success",
  "errors": null,
  "data": [
    {
      "status": "Success",
      "errors": null,
      "warnings": null,
      "orderId": "z1Mkp-bpgIHPRFCcNg0cbw",
      "referenceNo": "Sammy2022318022939",
      "trackingNo": "9274890260113400044444",
      "connoteId": null,
      "piecesResult": null,
      "extraProperty": {
        "injectPort": "EWR",
        "customsClearanceType": "T"
      }
    }
  ],
  "warnings": null
}

页面树结构

创建订单