创建出库单：[createOrder] - K5物流软件 API文档

请求参数

Query 参数

method

string

必需

示例值:

createOrder

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=UTF-8

Body 参数application/json

Verify

object

验证信息

必需

Clientid

string

必需

客户编码（由物流商提供）

Token

string

必需

验证Token（由物流商提供）

OrderType

string

必需

3：仓储出库订单固定传值3

OrderDatas

array [object {29}]

订单数据

必需

CorpBillid

string

可选

订单号注意：创建订单后返回，修改订单必传

CustomerNumber

string

必需

客户订单号(可传入贵公司内部单号)

Refernumb2

string

可选

参考号2，多用于UPS和FEDEX

ConfirmationNumber

string

可选

大货预约编码，用于联邦IPF/IEF等大货服务

TrackNumber

string

可选

跟踪号,服务商单号,转单号

LabelData

string

可选

面单/地址标签，pdf转Base64格式。

ChannelCode

string

必需

渠道代码可调用[searchStartChannel]方法获取

CountryCode

string

国家二字代码

必需

HouseCode

string

必需

仓库代码(仓储出库订单必传) 可调用[searchStartHouse]方法获取

TotalWeight

number

订单总重量(KG)

必需

TotalValue

number

订单总申报价值

必需

Number

integer

必需

总件数（必须等于材积明细件数之和）

Domesticno

string

国内快递单号

可选

Collamt

string

代收货款

可选

Collccycode

string

代收货款币别

可选

PackageType

string

可选

物品类别(G:礼物,D:文件,S:商业样本,O:其它)

ProductTypeid

string

可选

物品类别编码（带电产品可以直接传k5上的物品类别编码，就能用k5 的带电信息和电池金句提交，PackageType字段可以不传）

GoodsType

string

可选

包裹类型(WPX:包裹,DOC:文件,PAK:PAK袋)

Note

string

订单备注

可选

VatNumber

string

可选

Vat 增值税号（寄件人Vat）

VatCorpName

string

Vat 公司名

可选

VatCorpAddress

string

Vat 公司地址

可选

EoriNumber

string

可选

EORI 企业号，EORI 欧盟税号

Salesplatform

string

可选

销售平台（平台标识）例如：速卖通

TariffType

string

可选

关税类型（快件订单）1300：预缴增值税IOSS1301：预缴增值税no-IOSS1302：预缴增值税other

Recipient

object

收件人信息

必需

Sender

array [object {14}]

寄件人信息（选传）

必需

OrderItems

array [object {2}]

订单明细产品信息

必需

Volumes

array [object {6}]

可选

材积明细(OrderType为快递制单必传)

示例

{
	"Verify": {
		"Clientid": "XC",
	    "Token": "WVFCVUc=ng7kbKSHS6gV0nJvkf8j"
	},
	"OrderType": "3",//3：仓储出库订单固定传值 3
	"OrderDatas": [{
		"CustomerNumber": "PO100000000DKGB",
		"TrackNumber": "",
		"ChannelCode": "SZEYB",
		"CountryCode": "DE",
		"HouseCode": "xh",
		"PackageType": "G",
		"GoodsType": "WPX",
		"TotalWeight": "0.54",
		"TotalValue": "0",
		"Number": "1",
		"Collamt": "0",
		"Note": "手机壳",
		"Recipient": {
			"Name": "Jasmin Mieth",
			"Company": "Jasmin Mieth",
			"Addres1": "Unterdorfstr. 6",
			"Addres2": "Unterdorfstr. 7",
			"Tel": "01521756877",
			"Mobile": "879821445",
			"Province": "Deutschland",
			"City": "Markelfingen",
			"Post": "78315",
			"Email": "Test@163.com",
			"Fax": "01521756877"
		},
		"Sender": {
			"Name": "David",
			"Company": "邮政寄件中心",
			"Addres": "111111",
            "Addres2": "222222",
            "Addres3": "333333",
			"Mobile": "15888887777",
			"Tel": "0755-8899895",
			"Post": "78315",
			"Province": "Deutschland",
			"City": "Markelfingen",
			"Country":"CN",
			"Email": "Test@163.com",
			"Fax": "0755-98974547"
		},
		"OrderItems": [{
			"Sku": "sku_pen",
			"Cnname": "钢笔",
			"Enname": "pen",
			"Price": "15.65",
			"SingleWeight": "1.52",
			"Num": "1",
			"Money": "USD",
			"Unit": "PCS",
			"ProductLink": "http://www.xxx.com/product/image-xx",
			"PackageNo": "1",
			"Texture": "Texture",
			"TransactionUrl": "http://www.xxx.com/product/xx";
			"Application": "Application",
			"CustomsCode": "Prodno",
			"PeihuoInfo": "时尚夜光背包 XL"
		}],
		"Volumes": [{
				"Weight": "0.54",
				"Number": "1",
				"Length": "20",
				"Width": "50",
				"Height": "50"
			},
			{
				"Weight": "0.55",
				"Number": "1",
				"Length": "25",
				"Width": "55",
				"Height": "55"
			}
		]
	}]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://yqbug.kingtrans.net/PostInterfaceService?method=createOrder' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
	"Verify": {
		"Clientid": "XC",
	    "Token": "WVFCVUc=ng7kbKSHS6gV0nJvkf8j"
	},
	"OrderType": "3",//3：仓储出库订单固定传值 3
	"OrderDatas": [{
		"CustomerNumber": "PO100000000DKGB",
		"TrackNumber": "",
		"ChannelCode": "SZEYB",
		"CountryCode": "DE",
		"HouseCode": "xh",
		"PackageType": "G",
		"GoodsType": "WPX",
		"TotalWeight": "0.54",
		"TotalValue": "0",
		"Number": "1",
		"Collamt": "0",
		"Note": "手机壳",
		"Recipient": {
			"Name": "Jasmin Mieth",
			"Company": "Jasmin Mieth",
			"Addres1": "Unterdorfstr. 6",
			"Addres2": "Unterdorfstr. 7",
			"Tel": "01521756877",
			"Mobile": "879821445",
			"Province": "Deutschland",
			"City": "Markelfingen",
			"Post": "78315",
			"Email": "Test@163.com",
			"Fax": "01521756877"
		},
		"Sender": {
			"Name": "David",
			"Company": "邮政寄件中心",
			"Addres": "111111",
            "Addres2": "222222",
            "Addres3": "333333",
			"Mobile": "15888887777",
			"Tel": "0755-8899895",
			"Post": "78315",
			"Province": "Deutschland",
			"City": "Markelfingen",
			"Country":"CN",
			"Email": "Test@163.com",
			"Fax": "0755-98974547"
		},
		"OrderItems": [{
			"Sku": "sku_pen",
			"Cnname": "钢笔",
			"Enname": "pen",
			"Price": "15.65",
			"SingleWeight": "1.52",
			"Num": "1",
			"Money": "USD",
			"Unit": "PCS",
			"ProductLink": "http://www.xxx.com/product/image-xx",
			"PackageNo": "1",
			"Texture": "Texture",
			"TransactionUrl": "http://www.xxx.com/product/xx";
			"Application": "Application",
			"CustomsCode": "Prodno",
			"PeihuoInfo": "时尚夜光背包 XL"
		}],
		"Volumes": [{
				"Weight": "0.54",
				"Number": "1",
				"Length": "20",
				"Width": "50",
				"Height": "50"
			},
			{
				"Weight": "0.55",
				"Number": "1",
				"Length": "25",
				"Width": "55",
				"Height": "55"
			}
		]
	}]'

返回响应

🟢200成功

application/json

Body

statusCode

string

可选

状态 (success：成功，error：失败)

returnDatas

array [object {6}]

必需

statusCode

string

可选

单个订单状态 (success：成功，error：失败)

corpBillid

string

可选

*公司订单号 (需要保存（不需要展示）,后续打印,获取转单号有用到该字段)

customerNumber

string

客户订单号

可选

trackNumber

string

可选

转单号,服务商单号,跟踪号

message

string

错误提示信息

可选

labelbillid

string

标签单号

可选

示例

{
    "statusCode": "string",
    "returnDatas": [
        {
            "statusCode": "string",
            "corpBillid": "string",
            "customerNumber": "string",
            "trackNumber": "string",
            "message": "string",
            "labelbillid": "string"
        }
    ]
}