接口说明

创建海外仓一件代发小包订单创建直邮小包订单

路径

HTTP Verb	URL

POST

Post

qa:

https://cfs-qa.etowertech.com/api/supplier-service/

/

api

v1/

supplier-service

openApi/

v2

packetOrder/b2c/

orders

createOrders

请求头样例

POST

POST /

api

v1/

supplier-service

openApi/

v2

packetOrder/b2c/

orders

createOrders HTTP/1.1

Host: http://cfs-qa.etowertech.com/
Content-Type: application/json
Accept: application/json
Authorization:WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81A
X-WallTech-Date:Tue, 02 Aug 2022 06:43:37 GMT

请求字段（request）

...

Table Filter

...

fixedCols

...

totalrow

...

ddSeparator

...

sparkName

...

Sparkline

...

hidePane

...

Filtration Panel

...

limitHeight

...

default

...

cell-width

...

贸易术语（新增）

DDU

DDP

...

揽收类型（新增）

pick up 上门揽收

drop off 自送到仓（不填默认）

...

是否投保（新增）

是

否（默认）

...

是否签名（新增）

是

否（默认）

...

收件人地址代码

比如ONT8表示某个亚马逊仓库

...

收件人电话

...

拓展字段key-value形式

...

totalRowName

...

渠道名称

仅限英文字符

...

B2C=小包直邮

Fulfillment =一件代发（此处固定为该值）

固定值Fulfillment=?（新增）

totalColName
id	1678688780671
formatVersion	2
order
inverse
numbering
isNew	false
sort
totalcol
rowsPerPage
separator	Point (.)
labels
thousandSeparator
ignoreFirstNrows
heightValue
isOR	AND

字段	三级字段	四级字段	类型	长度限制	中文含义	描述	是否必填	补充描述
facility			String	50	发件人网点	B2C：shipper facility FF：warehouse	M
~~orderUniqueNumber~~ referenceNo			String	50	订单唯一编码	区分不同订单用	M
orderType			String	10	订单类型	枚举: B2C=小包直邮（此处为该值） Fulfillment=仓库一件代发	M
originPortCode			String		始发港（空港/海港）	英文代码	O
injectPortCode			String	50	目的港	英文代码	O
channelCode			String	64	渠道代码	英文、英文标点	M
channelOption			String	64	渠道选项	英文、英文标点	O
platform			Short	20	平台	枚举 ~~1: Amazon~~ ~~2: eBay~~ 请按照页面底部附件“平台名称”要求填写	O
incoterm			String	50	贸易术语	枚举 DDU DDP	O
collectionType				20	揽收类型	枚举 Pick up上门揽收 Drop off自送到仓不填默认drop off	O
~~insuranceOrNot~~ isInsurance			Boolean	3	是否投保	boolean 不填默认false	O
~~signatureOrNot~~ isSignature			Boolean	3	是否签名	boolean 不填默认false	O
remark				200	备注		O
extendData					拓展字段	比如IOSS key-value形式
consignee	addressCode		String	50	收件人地址代码	比如ONT8表示某个亚马逊仓库
	name		String	50	收件人姓名		M	orderType=Fulfillment ：不必填； orderType=B2C ：必填；
	company		String	512	收件人公司
	phone		String	50

...

收件人电话
email		String	50

...

收件人邮箱
countryCode		String	2

...

目的国二字代码

...

英文代码

...

M	orderType=Fulfillment ：不必填； orderType=B2C ：必填；
state		String	80

...

收件人省/州
city		String	80

...

	收件人城市		M	orderType=Fulfillment ：不必填； orderType=B2C ：必填；
district		String	128

...

收件人区
addressLine1		String	200

...

收件人地址第一行		M	orderType=Fulfillment ：不必填； orderType=B2C ：必填；
addressLine2		String	200

...

收件人地址第二行
addressLine3		String	80

...

收件人地址第三行
zipCode		String	16

...

收件人邮编
taxId

...

String

...

255

...

收件人税号

...


taxId1

...

String

...

255

...

收件人税号1

...


extendData

...

拓展字段

...


shipper	name

...

String

...

50

...

发件人姓名

...

dangerousGoods

...

危险品

DG=危险品

空=非危险品（默认）

...

包裹类型（新增）

No Battery 不带电：（值）

Inside Equipment 带电：（值）

...

重量单位：

KG(默认)
G
LB

...

尺寸单位

CM（默认）
M

...

发票币种三字代码（新增）

（传了用传的，没传的话系统根据SKU算）

...

发票金额（新增）

（传了用传的，没传的话系统根据SKU算）

...

拓展字段key-value（新增）

'keepShipService': xxx boolean?是=否

'xxId':xxx

...

受益人

或

公司

...

受益人的身份证

或

收益公司的组织机构代码证

...

投保币种三字代码

比如CNY；USD

...

date

...

请求样例

...

[
{
"facility": "Canada Warehouse Toronto 3-FBA2431425677i656434536",
"channelCode": "hwc",
"platform": "12345678901234567890",
"remark": "testremark",
"consignee": {
"addressCode": "test",
"name": "testname",
"company": "testcompany",
"countryCode": "cn",
"state": "teststate",
"city": "testcity",
"district": "testdistirct",
"addressLine1": "testaddressline1",
"addressLine2": "testaddressline2",
"addressLine3": "testaddressline3",
"zipCode": "testzipcode",
"phone": "testphone",
"email": "testemail@123.com"
},
"shipper": {
"addressCode": "",
"name": "",
"company": "",
"countryCode": "",
"state": "",
"city": "",
"district": "",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"zipCode": "",
"phone": "",
"email": ""
},
"parcels": {
"referenceNo": "testnewapi017",
"description": "GOODSSKG",
"weight": "12",
"weightUnit": "",
"length": "",
"width": "",
"height": "",
"dimensionUnit": "CM",
"items": [
{
"sku": "testgoods",
"quantity": "1"
}
]
}
},
{
"facility": "Canada Warehouse Toronto 3-FBA2431425677i656434536",
"channelCode": "hwc",
"platform": "12345678901234567890",
"remark": "testremark",
"consignee": {
"addressCode": "11112",
"name": "testname",
"company": "testcompany",
"countryCode": "cn",
"state": "teststate",
"city": "testcity",
"district": "testdistirct",
"addressLine1": "testaddressline1",
"addressLine2": "testaddressline2",
"addressLine3": "testaddressline3",
"zipCode": "testzipcode",
"phone": "testphone",
"email": "testemail@123.com"
},
"shipper": {
"addressCode": "",
"name": "",
"company": "",
"countryCode": "",
"state": "",
"city": "",
"district": "",
"addressLine1": "",
"addressLine2": "",
"addressLine3": "",
"zipCode": "",
"phone": "",
"email": ""
},
"parcels": {
"referenceNo": "testnewapi018",
"description": "GOODSSKG",
"weight": "12",
"weightUnit": "",
"length": "",
"width": "",
"height": "",
"dimensionUnit": "CM",
"items": [
{
"sku": "testgoods",
"quantity": "1"
}
]
}
}
]

返回样例

成功样例

[
{
"code": "0",
"data": {
"orderNo": "C12283230214000029O",
"referenceNo": "testnewapi017"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
},
{
"code": "0",
"data": {
"orderNo": "C12283230214000030O",
"referenceNo": "testnewapi018"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}
]

失败样例

...

orderType=B2C 才可以填写shipper 对象，且非必填
	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	枚举：退件销毁	枚举：退件销毁		orderType=B2C 才可以填写returnAddress对象，且非必填
	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	orderType=Fulfillment ：不必填； orderType=B2C ：必填；
	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,2	包裹长
	width		BigDecimal	8,2	包裹宽
	height		BigDecimal	8,2	包裹高
	dimensionUnit		String	8	尺寸单位	枚举： CM（默认） M
	invoiceCurrencyCode		String	5	发票币种三字代码	英文代码
	invoiceValue		BigDecimal	20,2	发票金额		M	orderType=Fulfillment ：不必填； orderType=B2C ：必填；
	transactionCurrency		BigDecimal	8,2	交易币种	电商平台成交币种
	transactionAmount		BigDecimal	8,2	交易金额	电商平台成交金额
	shippingInstruction		String	50	装运指示	会显示在部分渠道的面单上
	sortCode		String	50	分拣码	会显示在部分渠道的面单上
	extendData				拓展字段	拓展字段key-value（新增） 'keepShipService': xxx boolean 是/否 'xxId':xxx
	items	itemNumber	String	128	商品编号
		itemDescEn	String	255	商品英文描述
		itemDesc	String	255	商品本地描述
		sku	String	128	SKU编码		M
		hsCode	String	128	海关编码
		quantity	Integer	11	商品数量		M
		quantityUnit	String	10	商品数量单位
		unitPrice	decimal	10,2	单价
		picture	String		图片	base64
		salesURL	String	500	销售链接
		originCountryCode	String	10	原产国二字代码	英文代码
		weight	BigDecimal	10,3	重量
		usage	String	255	用途
		~~matertial~~ material	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~~ collection	date		date	3	揽收日期	年月日		（说明：如果类型是pickup，要填）
	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				拓展字段

请求样例

"ordertype":"Fulfillment"

代码块

[
    {
        "facility": "Australian Warehouse",
        "channelCode": "AU test",
        "channelOption": "",
        "referenceNo": "030919",
        "orderType": "Fulfillment",
        "originPortCode": "",
        "injectPortCode": "",
        "platform": "eBay",
        "incoterm": "",
        "collectionType": null,
        "isInsurance": "",
        "isSignature": "",
        "remark": "testremark",
        "extendData": {
            "extend": null
        },
        "consignee": {
            "addressCode": "11113",
            "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"
        },
        "shipper": {
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "1",
            "phone": "",
            "state": "",
            "taxId": "",
            "taxId1": "",
            "zipCode": ""
        },
        "returnAddress": {
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "",
            "phone": "",
            "returnOption": "",
            "state": "",
            "zipCode": ""
        },
        "parcels": [
            {
                "referenceNo": "12",
                "referenceNo1": "",
                "referenceNo2": "",
                "consignmentId": "",
                "trackingNo": "",
                "descriptionEn": "",
                "description": "",
                "dangerousGoods": false,
                "batteryType": "false",
                "weight": 1.245,
                "weightUnit": "",
                "length": "",
                "width": "",
                "height": "",
                "dimensionUnit": "CM",
                "invoiceCurrencyCode": "",
                "invoiceValue": "12.22",
				"transactionCurrency": "USD",
                "transactionAmount": "5.12",
                "shippingInstruction": "",
                "sortCode": "",
                "extendData": {
                    "keepShipService": false
                },
                "items": [
                    {
                        "extendData": null,
                        "hsCode": "",
                        "itemDesc": "",
                        "itemDescEn": "",
                        "itemNumber": "",
                        "matertial": "",
                        "originCountryCode": "",
                        "picture": "",
                        "quantity": "1",
                        "quantityUnit": "",
                        "salesURL": "",
                        "sku": "SKG",
                        "unitPrice": "",
                        "usage": "",
                        "weight": null
                    },
                    {
                        "extendData": null,
                        "hsCode": "",
                        "itemDesc": "",
                        "itemDescEn": "",
                        "itemNumber": "",
                        "matertial": "",
                        "originCountryCode": "",
                        "picture": "",
                        "quantity": "1",
                        "quantityUnit": "",
                        "salesURL": "",
                        "sku": "TESTcommodity",
                        "unitPrice": "",
                        "usage": "",
                        "weight": null
                    }
                ],
                "insurance": [
                    {
                        "insuranceAmount": "",
                        "insuranceCurrencyCode": "",
                        "insuranceType": "",
                        "beneficiaryType": "",
                        "beneficiary": "",
                        "beneficiaryId": "",
                        "extendData": null
                    }
                ]
            }
        ],
        "collection": {
            "date": "",
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "",
            "phone": "",
            "state": "",
            "zipCode": ""
        }
    },
    {
        "facility": "Australian Warehouse",
        "channelCode": "AU test",
        "channelOption": "",
        "referenceNo": "030920",
        "orderType": "Fulfillment",
        "originPortCode": "",
        "injectPortCode": "",
        "platform": "eBay",
        "incoterm": "",
        "collectionType": null,
        "isInsurance": "",
        "isSignature": "",
        "remark": "testremark",
        "extendData": {
            "extend": null
        },
        "consignee": {
            "addressCode": "11113",
            "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"
        },
        "shipper": {
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "1",
            "phone": "",
            "state": "",
            "taxId": "",
            "taxId1": "",
            "zipCode": ""
        },
        "returnAddress": {
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "",
            "phone": "",
            "returnOption": "",
            "state": "",
            "zipCode": ""
        },
        "parcels": [
            {
                "referenceNo": "12",
                "referenceNo1": "",
                "referenceNo2": "",
                "consignmentId": "",
                "trackingNo": "",
                "descriptionEn": "",
                "description": "",
                "dangerousGoods": false,
                "batteryType": "false",
                "weight": 1.245,
                "weightUnit": "",
                "length": "",
                "width": "",
                "height": "",
                "dimensionUnit": "CM",
                "invoiceCurrencyCode": "",
                "invoiceValue": "12.22",
                "shippingInstruction": "",
                "sortCode": "",
                "extendData": null,
                "items": [
                    {
                        "extendData": null,
                        "hsCode": "",
                        "itemDesc": "",
                        "itemDescEn": "",
                        "itemNumber": "",
                        "matertial": "",
                        "originCountryCode": "",
                        "picture": "",
                        "quantity": "1",
                        "quantityUnit": "",
                        "salesURL": "",
                        "sku": "SKG",
                        "unitPrice": "",
                        "usage": "",
                        "weight": null
                    },
                    {
                        "extendData": null,
                        "hsCode": "",
                        "itemDesc": "",
                        "itemDescEn": "",
                        "itemNumber": "",
                        "matertial": "",
                        "originCountryCode": "",
                        "picture": "",
                        "quantity": "1",
                        "quantityUnit": "",
                        "salesURL": "",
                        "sku": "TESTcommodity",
                        "unitPrice": "",
                        "usage": "",
                        "weight": null
                    }
                ],
                "insurance": [
                    {
                        "insuranceAmount": "",
                        "insuranceCurrencyCode": "",
                        "insuranceType": "",
                        "beneficiaryType": "",
                        "beneficiary": "",
                        "beneficiaryId": "",
                        "extendData": null
                    }
                ]
            }
        ],
        "collection": {
            "date": "",
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "",
            "phone": "",
            "state": "",
            "zipCode": ""
        }
    }
]

返回样例

成功样例

"ordertype":"Fulfillment"

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

失败样例

"ordertype":"Fulfillment"

代码块

{
    "code": "0",
    "data": {
        "030920": [
            {
                "code": "600904",
                "message": "referenceNo:030920,Already exists in the system"
            }
        ],
        "030919": [
            {
                "code": "600904",
                "message": "referenceNo:030919,Already exists in the system"
            }
        ]
    },
    "errors": "",
    "message": "",
    "messageId": "",
    "success": true,
    "warnList": ""
}

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

附件

页面树结构

版本比较

旧版本 44

新版本 45

标识

接口说明

路径

请求头样例

请求字段（request）

请求样例

返回样例

请求样例

页面树结构

页面历史

版本比较

旧版本 44

新版本 45

标识

接口说明

路径

请求头样例

请求字段（request）

请求样例

返回样例

请求样例