接口说明

创建直邮小包订单

路径

HTTP Verb	URL
Post	qa: https://cfs-qa.etowertech.com/api/supplier-service/ /v1/openApi/packetOrder/b2c/createOrders

请求头样例

POST

POST /v1/openApi/packetOrder/b2c/createOrders HTTP/1.1
Content-Type: application/json
Accept: application/json
User-Agent: Mozilla 5.0

lang:zh_CN

Host: http://cfs-qa.etowertech.com/api/supplier-service

X-WallTech-Date: Thu, 06 Aug 2020 06:21:24 GMT
Authorization: WallTech testLvs2jdug2qIoRsJyuxs:2THPh5_j4OTYUGdinstTC4nYqDE=

请求字段（request）

一级字段	二级字段	三级字段	四级字段	类型	长度限制	中文含义	描述	是否必填
order	facility			String	50	发件人网点	B2C：shipper facility FF：warehouse	O
	orderUniqueNumber			String	50	订单唯一编码	区分不同订单用	M
	orderType			String	10	订单类型	枚举: B2C=小包直邮 BBC=仓库一件代发	M
	originPortCode			String		始发港（空港/海港）	英文代码	O
	injectPortCode			String	50	目的港	英文代码	O
	channelCode			String	64	渠道代码	英文、英文标点	M
	channelOption			String	64	渠道选项	英文、英文标点	O
	platform			String	20	平台		O
	incoterm			String	50	贸易术语	枚举 DDU DDP	O
	collectionType				20	揽收类型	枚举 Pick up上门揽收 Drop off自送到仓不填默认drop off	O
	insuranceOrNot			Boolean	3	是否投保	boolean 不填默认false	O
	signatureOrNot			Boolean	3	是否签名	boolean 不填默认false	O
	remark					备注		O
	extendData					拓展字段	比如IOSS key-value形式
	consignee	addressCode		String	50	收件人地址代码	比如ONT8表示某个亚马逊仓库
		name		String	50	收件人姓名		M
		company		String	512	收件人公司
		phone		String	50	收件人电话
		email		String	50	收件人邮箱
		countryCode		String	2	目的国二字代码	英文代码	M
		state		String	80	收件人省/州
		city		String	80	收件人城市		M
		district		String	128	收件人区
		addressLine1		String	200	收件人地址第一行		M
		addressLine2		String	200	收件人地址第二行
		addressLine3		String	80	收件人地址第三行
		zipCode		String	16	收件人邮编
		taxId		String	255	收件人税号
		taxId1		String	255	收件人税号1
		extendData				拓展字段
	shipper	name		String	50	发件人姓名
		company		String	512	发件人公司
		phone		String	50	发件人电话
		email		String	50	发件人邮箱
		countryCode		String	2	始发国二字代码	英文代码
		state		String	80	发件人省/州
		city		String	80	发件人城市
		district		String	128	发件人区
		addressLine1		String	200	发件人地址第一行
		addressLine2		String	200	发件人地址第二行
		addressLine3		String	80	发件人地址第三行
		zipCode		String	16	发件人邮编
		taxId		String	255	发件人税号
		taxId1		String	255	发件人税号1
		extendData				拓展字段 key-value
	returnAddress	returnOption	退件选项	String	50	枚举：退件销毁	枚举：退件销毁
		name	退件人姓名	String	512
		company	退件人公司	String	50
		phone	退件人电话	String	50
		email	退件人邮箱	String	2
		countryCode	退件人国家二字代码	String	80	英文代码	英文代码
		state	退件人省/州	String	80
		city	退件人城市	String	128
		district	退件人区	String	200
		addressLine1	退件人地址第一行	String	200
		addressLine2	退件人地址第二行	String	80
		addressLine3	退件人地址第三行	String	16
		zipCode	退件人邮编	String	255
		extendData	拓展字段
	parcels	referenceNo		String	80	包裹参考号		M
		referenceNo1		String	80	包裹参考号1
		referenceNo2		String	80	包裹参考号2
		consignmentId		String	50	包裹货物ID	澳邮要求MLID+ConsignmentID 2年内不得重复使用数字
		trackingNo		String	80	包裹跟踪号
		descriptionEn		String	255	包裹英文描述		M
		description		String	255	包裹中文描述
		dangerousGoods		Boolean	3	包裹是否危险品	true=危险品 false=非危险品
		batteryType		Boolean	3	包裹带电类型	枚举 true=带电 false=不带电
		weight		BigDecimal	8,3	包裹重量	8位，小数点后3位	M
		weightUnit		String	10	重量单位	枚举： KG(默认) G LB
		length		BigDecimal	8,3	包裹长
		width		BigDecimal	8,3	包裹宽
		height		BigDecimal	8,3	包裹高
		dimensionUnit		String	8	尺寸单位	枚举： CM（默认） M
		invoiceCurrencyCode		String	5	发票币种三字代码	英文代码
		invoiceValue		BigDecimal	20,3	发票金额		M
		shippingInstruction		String	50	装运指示	会显示在部分渠道的面单上
		sortCode		String	50	分拣码	会显示在部分渠道的面单上
		extendData				拓展字段
		items	itemNumber	String	128	商品编号
			itemDescEn	String	255	商品英文描述
			itemDesc	String	255	商品本地描述
			sku	String	128	SKU编码
			hsCode	String	128	海关编码
			quantity	Integer	11	商品数量
			quantityUnit	String	10	商品数量单位
			unitPrice	decimal	10,2	单价
			picture	String		图片	base64
			salesURL	String	500	销售链接
			originCountryCode	String	10	原产国二字代码	英文代码
			weight	BigDecimal	10,3	重量
			usage	String	255	用途
			matertial	String	255	材质
			extendData			拓展字段
		insurance （说明：如果isInsurance是true要填）	insuranceType	String	30	投保类型	可能是用来区分不同的保险第三方平台或者产品
			beneficiaryType	String	20	受益人类型	枚举：公司=company 个人=individual
			beneficiary	String	255	受益人/公司
			beneficiaryId	String	20	身份证/组织机构代码证
			insuranceCurrencyCode	String	8	投保二字代码币种
			insuranceAmount	BigDecimal	20,3	保险金额
			extendData			拓展字段
	collectionInfo （说明：如果类型是pickup，要填）	date		date	3	揽收日期	年月日
		name		String	512	客户姓名
		company		String	50	客户公司
		phone		String	50	客户电话
		email		String	2	客户邮箱
		countryCode		String	80	客户国家二字代码	英文代码
		state		String	80	客户省/州
		city		String	128	客户城市
		district		String	200	客户区
		addressLine1		String	200	客户地址第一行
		addressLine2		String	80	客户地址第二行
		addressLine3		String	16	客户地址第三行
		zipCode		String	255	客户邮编
		extendData				拓展字段

请求样例

{
"order": [
{
"channelCode": "UBI.CN2US.AC.GENERAL.LIGHT",
"channelOption": "B2Cchanneloption",
"collectionInfo":

{ "addressCode": "", "addressLine1": "", "addressLine2": "", "addressLine3": "", "city": "", "company": "", "countryCode": "", "district": "", "email": "", "extendData": null, "name": "", "phone": "", "returnOption": "", "state": "", "taxId": "", "taxId1": "", "zipCode": "" }

,
"collectionType": "",
"consignee":

{ "addressCode": "", "addressLine1": "street9230", "addressLine2": "8349hao", "addressLine3": "345shi", "city": "testcity", "company": "testcompany", "countryCode": "us", "district": "testdistrict", "email": "testemail@123.com", "extendData": null, "name": "Mack", "phone": "36247938384", "state": "teststate", "taxId": "testtaxid", "taxId1": "testtaxid1", "zipCode": "8238juej" }

,
"extendData":

{ "extend": "extend" }

,
"facility": "B2C",
"incoterm": "DDP",
"injectPortCode": "",
"insuranceOrNot": "",
"orderType": "B2C",
"orderUniqueNumber":"test001",
"originPortCode": "",
"parcels": [
{
"batteryType": "false",
"consignmentId": "",
"dangerousGoods": false,
"description": "goodscn",
"descriptionEn": "goodsen",
"dimensionUnit": "CM",
"extendData": null,
"height": "10",
"invoiceCurrencyCode": "USD",
"invoiceValue": "35",
"insurance": [

{ "insuranceAmount": "", "insuranceCurrencyCode": "", "insuranceType": "", "modifiedAccount": "", "extendData": null }

],
"items": [

{ "extendData": null, "hsCode": "111", "itemDesc": "goodscn", "itemDescEn": "", "itemNumber": "Amireuxtest", "matertial": "testmatertial", "originCountryCode": "cn", "picture": "", "quantity": "1", "quantityUnit": "个", "salesURL": "testsalesurl", "sku": "testgoods", "unitPrice": "10", "usage": "testusage", "weight": "5" }

],
"length": "25",
"referenceNo": "APITES023",
"referenceNo1": "",
"referenceNo2": "",
"shippingInstruction": "",
"sortCode": "",
"trackingNo": "",
"weight": "5",
"weightUnit": "KG",
"width": "25"
}
],
"platform": "testplatform",
"remark": "testremark",
"returnAddress":

{ "addressCode": "", "addressLine1": "", "addressLine2": "", "addressLine3": "", "city": "", "company": "", "countryCode": "", "district": "", "email": "", "extendData": null, "name": "", "phone": "", "returnOption": "销毁", "state": "", "taxId": "", "taxId1": "", "zipCode": "" }

,
"shipper":

{ "addressCode": "", "addressLine1": "sipinglujiedao", "addressLine2": "gaoxinlu900hao", "addressLine3": "190shi", "city": "shanghaishi", "company": "shippercompany", "countryCode": "cn", "district": "yangpuqu", "email": "shippertest@123.com", "extendData": null, "name": "xiaozhang", "phone": "18893043453", "returnOption": "", "state": "shanghai", "taxId": "shippertaxid", "taxId1": "shippertaxid1", "zipCode": "300210" }

,
"signatureOrNot": ""
},
{
"channelCode": "UBI.CN2US.LHEST.STD.EXPRESS.CV",
"channelOption": "B2Cchanneloption",
"collectionInfo":

{ "addressCode": "", "addressLine1": "", "addressLine2": "", "addressLine3": "", "city": "", "company": "", "countryCode": "", "district": "", "email": "", "extendData": null, "name": "", "phone": "", "returnOption": "", "state": "", "taxId": "", "taxId1": "", "zipCode": "" }

,
"collectionType": "",
"consignee":

{ "addressCode": "", "addressLine1": "street9230", "addressLine2": "8349hao", "addressLine3": "345shi", "city": "testcity", "company": "testcompany", "countryCode": "us", "district": "testdistrict", "email": "testemail@123.com", "extendData": null, "name": "Mack", "phone": "36247938384", "state": "teststate", "taxId": "testtaxid", "taxId1": "testtaxid1", "zipCode": "8238juej" }

,
"extendData":

{ "extend": "extend" }

,
"facility": "B2C",
"incoterm": "DDP",
"injectPortCode": "",
"insuranceOrNot": "",
"orderType": "B2C",
"orderUniqueNumber":"test001",
"originPortCode": "",
"parcels": [
{
"batteryType": "false",
"consignmentId": "",
"dangerousGoods": false,
"description": "goodscn",
"descriptionEn": "goodsen",
"dimensionUnit": "CM",
"extendData": null,
"height": "10",
"invoiceCurrencyCode": "USD",
"invoiceValue": "35",
"insurance": [

{ "insuranceAmount": "", "insuranceCurrencyCode": "", "insuranceType": "", "modifiedAccount": "", "type": "", "typeDesc": "" }

],
"items": [

{ "extendData": null, "hsCode": "111", "itemDesc": "goodscn", "itemDescEn": "", "itemNumber": "Amireuxtest", "matertial": "testmatertial", "originCountryCode": "cn", "picture": "", "quantity": "1", "quantityUnit": "个", "salesURL": "testsalesurl", "sku": "testgoods", "unitPrice": "10", "usage": "testusage", "weight": "5" }

],
"length": "25",
"referenceNo": "APITES024",
"referenceNo1": "",
"referenceNo2": "",
"shippingInstruction": "",
"sortCode": "",
"trackingNo": "",
"weight": "5",
"weightUnit": "KG",
"width": "25"
}
],
"platform": "testplatform",
"remark": "testremark",
"returnAddress":

{ "addressCode": "", "addressLine1": "", "addressLine2": "", "addressLine3": "", "city": "", "company": "", "countryCode": "", "district": "", "email": "", "extendData": null, "name": "", "phone": "", "returnOption": "销毁", "state": "", "taxId": "", "taxId1": "", "zipCode": "" }

,
"shipper":

{ "addressCode": "", "addressLine1": "sipinglujiedao", "addressLine2": "gaoxinlu900hao", "addressLine3": "190shi", "city": "shanghaishi", "company": "shippercompany", "countryCode": "cn", "district": "yangpuqu", "email": "shippertest@123.com", "extendData": null, "name": "xiaozhang", "phone": "18893043453", "returnOption": "", "state": "shanghai", "taxId": "shippertaxid", "taxId1": "shippertaxid1", "zipCode": "300210" }

,
"signatureOrNot": ""
}
]
}

返回样例

成功样例

{
"code": "0",
"data": {},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}

失败样例

{
"code": "0",
"data": {
"test002": [

{ "code": "600222", "message": "referenceNo APITES032Field already exists, cannot be repeated" }

],
"test001": [

{ "code": "600222", "message": "referenceNo APITES033Field already exists, cannot be repeated" }

]
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}

ps: test001是订单唯一编码，区分不同订单的不同错误描述。批量操作成功的不会返回，会直接保存。