页面历史

API Description

Create Fulfillment Order

Endpoint

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

Sample

Request Headers

POST /v1/openApi/packetOrder/b2c/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
totalRowName
totalColName
id	1678688780671
formatVersion	2
order
inverse
numbering
isNew	false
sort
totalcol
rowsPerPage
separator	Point (.)
labels
thousandSeparator
ignoreFirstNrows
heightValue
isOR	AND

补充描述MB2C：发货人网点
Fulfillment：仓库代码区分不同订单用英文代码英文代码英文、英文标点英文、英文标点枚举：请按照页面底部附件“平台名称”要求填写boolean 不填默认falseboolean 不填默认false

orderType=Fulfillment ：必填；

orderType=B2C ：必填；英文代码收件人省/州

orderType=Fulfillment ：必填；

orderType=B2C ：必填；orderType=Fulfillment ：必填；英文代码退件选项退件人电话退件人邮箱退件人国家二字代码退件人省/州退件人城市退件人区退件人地址第一行退件人邮编拓展字段自定义拓展字段澳邮要求MLID+ConsignmentID 2年内不得重复使用数字8位，小数点后3位枚举：CM（默认）、M英文代码电商平台成交币种电商平台成交金额需要包含文件类型，如: 出库单会显示在部分渠道的面单上会显示在部分渠道的面单上拓展字段英文代码拓展字段可能是用来区分不同的保险第三方平台或者产品枚举：
公司=company
个人=自定义拓展字段自定义拓展字段（说明：如果类型是pickup，要填）英文代码

一级字段	二级字段	三级字段	类型	长度限制	中文含义	描述	是否必填	Level 1 Field	Level 2 Field	Level 3 Field	Type	Length Limit	Meaning	Description	Required	Remark
orderType			String		订单类型Order Type	枚举 Enumeration: B2C =小包直邮 Fulfillment=仓库一件代发	(End-to-end Small Parcel) Fulfillment (Warehouse Dropshipping)	M	When using eTower WMS module, please pass 'Fulfillment'
facility			String	50	发件人网点Sender Facility/仓库代码	Warehouse Code	B2C: Sender facility code; Fulfillment: Warehouse code	M
referenceNo			String	50	订单唯一编码	Order Unique Code	Used to differentiate orders	M
originPortCode			String	始发港（空港/海港）		Origin Port (Airport/Seaport)	English Character Code	O
injectPortCode			String	50	目的港	Destination Port	English Character Code	O
channelCode			String	64	渠道名称	Channel Name	English & English punctuation	M	Note: When orderType=Fulfillment使用查询仓库服务列表接口中返回的serviceType=5且active=1的serviceName下单, use the serviceName returned in 18. Query Warehouse Service List API where serviceType=5 and active=1 for placing orders
channelOption			String	64	渠道选项	Channel Option	English & English punctuation	O
platform			String	20	平台	Platform	Enumeration: Please fill according to "Platform Names" attachment at the bottom of the page	O
incoterm			String	50	Trade Term贸易术语	Enumeration: 枚举：DDU、DDP DDU、DDP	O
collectionType				20	揽收类型Collection Type	枚举 Pick up上门揽收 Drop off自送到仓不填默认Drop off Enumeration: Pickup (door-to-door collection) Drop off (self-delivery to warehouse). Default Drop off if not filled	O
isInsurance			Boolean	5	是否投保	Whether to Add Insurance	Default false if not filled	O
isSignature			Boolean	5	是否签名	Whether Signature Required	Default false if not filled	O
remark				200	备注Remarks		O
~~isOffLineOrder~~			~~Boolean~~	~~是否线下订单~~	~~boolean 不填默认false~~	O	~~orderType=Fulfillment相关参数~~ ~~true：下单时需要传入面单信息，字段：labelType、label、labelName~~ ~~false：下单时不需要传入面单信息~~		Abandoned Flied
isNeedConfirm			Boolean	是否自动确认发送	默认为true	orderType=Fulfillment相关参数 true：订单自动确认，确认后订单信息无法修改 false：订单创建为草稿，订单信息可修改；则需要再调用“8.预报出库单”进行确认	extendData	拓展字段	比如IOSS key-value形式		consignee	Whether Auto-Confirm	Default is true.		Parameters related to orderType=Fulfillment ： true means: Order is auto-confirmed, cannot modify after confirmation; false means: Order is created as draft, can modify; needs to call "8. Forecast Outbound Order" for confirmation
extendData					Extended Fields	e.g., IOSS, key-value format
consignee	addressCode		String	50	收件人地址代码	比如ONT8表示某个亚马逊仓库	Consignee Address Code	e.g., ONT8 represents an FBA warehouse		Parameters related to orderType=B2C 相关参数
	name		String	50	收件人姓名Consignee Name		M
	company		String	512	收件人公司Consignee Company
	phone		String	50	收件人电话Consignee Phone
	email		String	50	收件人邮箱Consignee Email
	countryCode		String	2	目的国二字代码	Destination Country 2-Character Code	English code	M	orderType=Fulfillment ：必填； orderType=B2C ：必填；
	state	String	80	state		String	80	Consignee Province/State
	city		String	80	收件人城市Consignee City		M
	district		String	128	收件人区Consignee District
	addressLine1		String	200	收件人地址第一行Consignee Address Line 1		M	orderType=B2C ：必填；
	addressLine2		String	200	收件人地址第二行Consignee Address Line 2
	addressLine3		String	80	收件人地址第三行Consignee Address Line 3
	zipCode		String	16	收件人邮编Consignee Postal Code
	taxId		String	255	收件人税号Consignee Tax ID
	taxId1		String	255	收件人税号1Consignee Tax ID1
	extendData				拓展字段Extended Fields
shipper	name		String	50	发件人姓名Shipper Name			only when orderType=B2C才可以填写shipper 对象，且非必填, shipper object can filled and it's optional
	company		String	512	发件人公司Shipper Company
	phone		String	50	发件人电话Shipper Phone
	email		String	50	发件人邮箱Shipper Email
	countryCode		String	2	始发国二字代码	Origin Country 2-Character Code	English code
	state		String	80	发件人省Shipper Province/州State
	city		String	80	发件人城市Shipper City
	district		String	128	发件人区Shipper District
	addressLine1		String	200	发件人地址第一行Shipper Address Line 1
	addressLine2		String	200	发件人地址第二行Shipper Address Line 2
	addressLine3		String	80	发件人地址第三行Shipper Address Line 3
	zipCode		String	16	发件人邮编Shipper Postal Code
	taxId		String	255	发件人税号Shipper Tax ID
	taxId1		String	255	发件人税号1Shipper Tax ID1
	extendData				Extended Fields 拓展字段 key key-value
returnAddress	returnOption			String	50	枚举：退件、销毁	Return Option	Enumeration: Return, Destroy.		only when orderType=B2C 才可以填写returnAddress对象，且非必填	name	退件人姓名	, shipper object can filled and it's optional
	name		String	50	Return（from) Contact Name
	company	退件人公司		String	512	Return （from) Company Name
	phone			String	50	email	Return （from) Phone
	email		String	50	Return （from) Email
	countryCode			String	2	英文代码	英文代码	state	Return （from) Country 2-Character Code		English code
	state		String	80	city	Return （from) Province/State
	city		String	80	Return （from) City
	district			String	128	Return （from) District
	addressLine1			String	200	Return（from) Address Line 1
	addressLine2	退件人地址第二行		String	200	Return（from) Address Line 2
	addressLine3	退件人地址第三行		String	80	zipCode	Return（from) Address Line 3
	zipCode		String	16	Return（from) Postal Code
	extendData		ObjectObject		Extended Fields
	extendData.shippingMethod	拓展字段1		String	255	Extended Fields1
	extendData.xxx	拓展字段2		String	255	Extended Fields2
parcels	referenceNo		String	80	包裹参考号Package Reference No		M
	referenceNo1		String	80	包裹参考号1Package Reference No1
	referenceNo2		String	80	包裹参考号2Package Reference No2
	consignmentId		String	50	包裹货物ID	Package Consignment ID	Australia Post requires MLID+ConsignmentID must not be reused within 2 years
	descriptionEn		String	255	包裹英文描述Package Tracking No		M	orderType=Fulfillment ：不必填；：Optional； orderType=B2C ：必填；：Mandatory；
	description		String	255	包裹中文描述Package Chinese Description
	dangerousGoods		Boolean	5	包裹是否危险品Whether Package is Dangerous Goods	true =危险品 :Dangerous goods false =非危险品 :Non-dangerous goods
	batteryType		Boolean	5	包裹带电类型Package Battery Type	枚举 true=带电 false=不带电true: With battery false: Without battery
	weight		BigDecimal	8,3	包裹重量	Package Weight	8 digits, 3 decimal places	M	orderType=Fulfillment ：不必填；：Optional； orderType=B2C ：必填；：Mandatory；
	weightUnit		String	2	Weight Unit重量单位	Enumeration: 枚举：KG KG ( 默认)、G、LB default), G, LB
	length		BigDecimal	8,2	包裹长Package Length
	width		BigDecimal	8,2	包裹宽Package Width
	height		BigDecimal	8,2	包裹高Package Height
	dimensionUnit		String	8	尺寸单位		Dimension Unit	Enumeration: CM (default), M
	invoiceCurrencyCode		String	3	发票币种三字代码	Invoice Currency Code,3-Character code	English Code
	invoiceValue		BigDecimal	20,2	发票金额Invoice Amount		M	orderType=Fulfillment ：不必填；：Optional； orderType=B2C ：必填；：Mandatory；
	transactionCurrency		BigDecimal	8,2	交易币种	Transaction Currency	E-commerce platform transaction currency
	transactionAmount		BigDecimal	8,2	交易金额	Transaction Amount	E-commerce platform transaction amount
	trackingNo		String	80	包裹跟踪号Package Tracking No			Required when orderType=Fulfillment 且所选服务是线下服务是时必填如果订单Label文件数量大于1，从第2个Label开始传入“attachments”参数中，filtType=1表示LbaelFulfillment & selected service is offline service If order Label file quantity >1, starting from the 2nd Label， pass the file in "attachments" parameter, filtType=1 represents Label
	labelType		Short		面单类型Label Type	枚举：Enumeration: 0: url 1:base64	C
	label		String		面单Label		C
	labelName		String	面单名称		Label Name	Must include file type, e.g.: outbound order.pdf		C
	shippingInstruction		String	50	装运指示	Shipping Instruction	Will appear on some channel labels
	sortCode		String	50	分拣码	Sort Code	Will appear on some channel labels
	extendData		Object		拓展字段Extended Fields	拓展字段keykey-value format key：keepShipService value：boolean		Can be used only when orderType=Fulfillment ：可用； orderType=B2C ：不用； ;
			String	255	Extended Fields

	attachments	attachName	String	95	附件名称Attachment Name		M	1.如有附件则三个字段都必填，如无附件，则三个字段都不必填；M: If there are attachments, all three fields are required; if no attachments, none are required. 2.最多5个附件；Maximum 5 attachments.
		attachData	String		附件内容Attachment Content	Base64格式Base64 format	M
		attachType	String	5	附件扩展名Attachment Extension	仅支持Only supports "rar", "zip", "pdf", "doc", "docx", "xls", "xlsx"	M
		filtType	Integer		Attachment Type附件类型	Enumeration: 1：Label 不填或其他值：Other1：Label If not filled or other values: Other	O
	items	itemNumber	String	128	商品编号Product Number

		itemDescEn	String	255	商品英文描述Product English Description
		itemDesc	String	255	商品本地描述Product Local Description
		sku	String	128	SKU编码SKU Code		M
		hsCode	String	128	海关编码Customs Code
		quantity	Integer	9	商品数量Product Quantity		M
		quantityUnit	String	10	商品数量单位Product Quantity Unit
		unitPrice	decimal		单价Unit Price
		picture	String		图片Image	base64
		salesURL	String	500	销售链接Sales Link
		originCountryCode	String	10	原产国二字代码	Origin Country 2-Character Code	English Code
		weight	BigDecimal		重量Weight
		usage	String	255	用途Purpose
		material	String	255	材质Material
		extendData			Extended Fields
	insurance （说明：如果isInsurance是true要填） (Note: Fill if isInsurance is true)	insuranceType	String	30	投保类型	Insurance Type	Can be used to differentiate different insurance third-party platforms or products		Note: Fill if isInsurance is true
		beneficiaryType	String	20	受益人类型	Beneficiary Type	Enumeration: company, individual
		beneficiary	String	255	受益人Beneficiary/公司Company
		beneficiaryId	String	20	身份证/组织机构代码证ID Card/Organization Code Certificate
		insuranceCurrencyCode	String	3	投保三字代码币种Insurance 3-Character Currency Code
		insuranceAmount	BigDecimal	20,3	保险金额Insurance Amount
		extendData	Object		拓展字段Extended Fields
		extendData.UPC	String	255	拓展字段1	Extended Fields1
		extendData.xx	String	255	拓展字段2	Extended Fields2

collection	date		date	揽收日期	年月日		Collection Date	Year-Month-Day		Note: Fill if Collection Type is pickup
	name		String	50	客户姓名Customer Name
	company		String	512	客户公司Customer Company
	phone		String	50	客户电话Customer Phone
	email		String	50	客户邮箱Customer Email
	countryCode		String	2	客户国家二字代码	Customer Country 2-Character Code	English Code
	state		String	80	客户省Customer Province/州State
	city		String	80	客户城市Customer City
	district		String	128	客户区Customer District
	addressLine1		String	200	客户地址第一行Customer Address Line 1
	addressLine2		String	200	客户地址第二行Customer Address Line 2
	addressLine3		String	80	客户地址第三行Customer Address Line 3
	zipCode		String	16	客户邮编Customer Postal Code
	extendData				拓展字段Extended Fields

...

Sample Request

1、"ordertype":"Fulfillment"

...

代码块

[
    {
        "facility": "B2C321",
        "channelCode": "UBI.CN2US.AC.GENERAL.LIGHT",
        "channelOption": "B2Cchanneloption",
        "referenceNo": "XB03094",
        "orderType": "B2C",
        "originPortCode": "",
        "injectPortCode": "",
        "platform": "eBay",
        "incoterm": "DDP",
        "collectionType": "Drop off",
        "isInsurance": false,
        "isSignature": false,
        "remark": "testremark",
        "extendData": {
            "extend": null
        },
        "consignee": {
            "addressCode": null,
            "addressLine1": "testaddressline1",
            "addressLine2": "8349hao",
            "addressLine3": "345shi",
            "city": "testcity",
            "company": "testcompany",
            "countryCode": "us",
            "district": "testdistrict",
            "email": "testemail@123.com",
            "extendData": null,
            "name": "testconsigneename",
            "phone": "36247938384",
            "state": "teststate",
            "taxId": "testtaxid",
            "taxId1": "testtaxid1",
            "zipCode": "8238juej"
        },
        "shipper": {
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "us",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "",
            "phone": "",
            "state": "",
            "taxId": "",
            "taxId1": "",
            "zipCode": ""
        },
        "returnAddress": {
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": "",
            "city": "",
            "company": "",
            "countryCode": "",
            "district": "",
            "email": "",
            "extendData": null,
            "name": "",
            "phone": "",
            "returnOption": "",
            "state": "",
            "zipCode": ""
        },
        "parcels": [
            {
                "referenceNo": "PARCEL0323002",
                "referenceNo1": "",
                "referenceNo2": "",
                "consignmentId": "",
                "trackingNo": "",
                "descriptionEn": "descriptionen",
                "description": "description",
                "dangerousGoods": true,
                "batteryType": true,
                "weight": 1.245,
                "weightUnit": null,
                "length": "25",
                "width": "26",
                "height": "27",
                "dimensionUnit": null,
                "invoiceCurrencyCode": "USD",
                "invoiceValue": 12.5,
                "transactionCurrency": null,
                "transactionAmount": null,
                "shippingInstruction": "",
                "sortCode": "",
                "extendData": {
                    "keepShipService": false
                },
                "items": [
                    {
                        "extendData": null,
                        "hsCode": "111",
                        "itemDesc": "desc",
                        "itemDescEn": "descen",
                        "itemNumber": "1",
                        "material": "testmaterial",
                        "originCountryCode": "cn",
                        "picture": "",
                        "quantity": "1",
                        "quantityUnit": "个",
                        "salesURL": "testsalesurl",
                        "sku": "QW",
                        "unitPrice": "21",
                        "usage": "testusage",
                        "weight": "12"
                    }
                ],
                "insurance": [
                    {
                        "insuranceAmount": "12",
                        "insuranceCurrencyCode": "usd",
                        "insuranceType": null,
                        "beneficiaryType": null,
                        "beneficiary": null,
                        "beneficiaryId": null,
                        "extendData": null
                    }
                ]
            }
        ],
        "collection": {
            "date": "2023-03-09",
            "addressLine1": "testaddress1",
            "addressLine2": "testaddress2",
            "addressLine3": "testaddress3",
            "city": "testcity",
            "company": "testcompany",
            "countryCode": "us",
            "district": "testdistrict",
            "email": "testemail@123.com",
            "extendData": null,
            "name": "testname",
            "phone": "phone",
            "state": "teststate",
            "zipCode": "123456"
        }
    }
]

...

Sample Response

...

Success Response

1、"ordertype":"Fulfillment"

...

代码块
[ { "code": "0", "data": { "orderNo": "UBI2303230008", "referenceNo": "XB03094" }, "errors": "", "message": "", "messageId": "", "success": true, "warnList": "" } ]

...

Failure Response

1、"ordertype":"Fulfillment"

...

代码块

[
    {
        "code": "0005",
        "data": "XB03094",
        "errors": [
            {
                "code": "600222",
                "message": "referenceNo:XB03094  field value already exists and cannot be repeated"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    }
]

Platform Name Enumeration:

Platform Name

eBay

Amazon

Aliexpress

Wish

LAZADA

Cdiscount

LINIO

Tobox

TopHatter

KiliMall

Shopify

Shopee

Joom

JD

BigCommerce

Ourmall

ZoodMall

Jumia

Jolly

Walmart

Vova

Shoplazza

Mercadolibre

AlibabaInternation

Tokopedia

Taobao

Daraz

Allegro

Pdd

Coupang

Newegg

EBG

Akulaku

Ueeshop

Shopline

shopBase

otto

yahoo

des

wayfair

OverStock

fordeal

TiKi

manomano

blibli

ozon

Shein

wownow

tiktok

Qoo10

shoppaas

JUMIA

wowma

Other

附件

页面树结构

版本比较

旧版本 1

新版本当前版本

标识

API Description

Create Fulfillment Order

Sample

Request Headers

Request

Sample Request

Sample Response

Success Response

Failure Response

Platform Name Enumeration:

Platform Name

页面树结构

页面历史

版本比较

旧版本 1

新版本 当前版本

标识

API Description

Create Fulfillment Order

Sample

Request Headers

Request

Sample Request

Sample Response

Success Response

Failure Response

Platform Name Enumeration:

Platform Name

新版本当前版本