创建快件订单,仓储订单,快递制单：[createOrder]

--新增参数Salesplatform（订单平台网址）、Reserve3（销售平台） 2024-09-19
--新增返回参数ifPianYuan （制单返回是否偏远） 2024-12-10
--新增制单参数IsSatDelivery (是否周六派送，0否，1是)
--新增制单参数Mfmid (制造商MID，如果为空，则根据制造商信息自动生成)
--新增制单参数Mfcountry (制造商国家二字码)
--新增制单参数Mfcity (制造商城市)
--新增制单参数Mfpost (制造商邮编)
--新增制单参数Mftel (制造商电话)
--新增制单参数SendDate (是否周六派送，0否，1是) 2025-03-03
--新增制单参数broker（代理清关人）2025-04-15
--新增参数 Freight（运费）2025-05-13

请求参数

Query 参数

method

string

必需

示例值:

createOrder

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=UTF-8

Body 参数application/json

Verify

object

验证信息

必需

Clientid

string

必需

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

Token

string

必需

验证Token（由物流商提供）

ClientSaleman

string

可选

客户联系人（子账号必填）

OrderType

string

必需

订单类型1：快件订单2：快递制单-延时返回单号(需要二次获取) 3：仓储订单4：快递制单-实时返回单号*创建快递制单选择4后，后续如需调用其他方法，例如调用打印标签，OrderType 请选择2。

OrderDatas

array [object {46}]

必需

CorpBillid

string

必需

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

CustomerNumber

string

必需

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

Refernumb2

string

可选

参考号2，多用于UPS和FEDEX

FbaId

string

fba订单可以传值

可选

ConfirmationNumber

string

可选

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

TrackNumber

string

可选

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

ChannelCode

string

必需

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

CountryCode

string

国家/地区二字代码

必需

HouseCode

string

可选

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

TotalWeight

string

订单总重量(KG)

必需

TotalValue

string

订单总申报价值

必需

Number

integer

必需

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

Collamt

string

代收货款

可选

PackageType

string

可选

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

Battery

string

可选

是否带电(0:不带电,1:带电)

GoodsType

string

可选

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

Domesticno

string

国内快递单号

可选

Note

string

订单备注

可选

FeePayData

object

可选

运费支付信息OrderType 为[快递制单] 时必传字段

TaxPayData

object

可选

税金/关税支付信息OrderType 为[快递制单] 时必传字段

Recipient

object

收件人信息

可选

Sender

object

寄件人信息（选传）

可选

OrderItems

array [object {20}]

订单明细产品信息

可选

POAnumber

string

POAnumber

可选

Volumes

array [object {10}]

可选

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

TradeNo

string

交易号

可选

LabelBillid

string

标签单号

可选

Collccycode

string

代收货款币别

可选

ProductTypeid

string

可选

物品类别编码（带电产品咨询代理k5上的物品类别编码，传递对应的编码就能用k5的带电信息和电池金句提交，PackageType 字段可以不传）

VatNumber

string

可选

Vat 增值税号（寄件人）

VatCorpName

string

Vat 公司名

可选

VatCorpAddress

string

Vat 公司地址

可选

EoriNumber

string

可选

EORI 企业号，EORI 欧盟税号

FBAWarehouseCode

string

FBA 仓库编号

可选

Salesplatform

string

平台网址

可选

Reserve3

string

可选

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

TariffType

string

可选

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

Ifret

string

可选

是否退件0:是1:否

Insurance

object

是否购买保险

可选

NoticeInfo

object

进口商信息（选传）

可选

FeeInfo

object

快递制单发票信息

可选

Declatype

string

可选

快件报关（传中文；需与代理有相同报关名称）

Buyer

object

买家信息（选传）

可选

SendDate

string

可选

自定义发件日期，仅适用于FEDEX渠道，格式YYYY-MM-DD

broker

object

代理清关人

可选

Freight

string

运费字段

可选

示例

{
	"Verify": {
		"Clientid": "XC",
		"Token": "WVFCVUc=ng7kbKSHS6gV0nJvkf8j"
	},
	"OrderType": "1",
	"FeeInfo": {
			"OtherAmt":"12"
	},
	
	"OrderDatas": [{       /*订单数据*/
		"CustomerNumber": "DD0619019966",
		"Refernumb2":"",
		"FbaId":"test001",
		"ConfirmationNumber": "",
		"TrackNumber": "",
		"ChannelCode": "SZEYB",
		"CountryCode": "ZA",
		"HouseCode": "" ,   /*仓库id*/
		"PackageType": "G",
		"GoodsType": "WPX",
		"TotalWeight": "2",
		"TotalValue": "15.65",
		"Number": "1",
		"Collamt": "0",
		"Declatype":"",
		"Note": "时尚夜光背包",
		"Buyer": {
			"FamilyName": "QQ",
			"FirstName": "",
			"BirthDate": "",
			"ReceiverPhone": "13005337555",
			"ReceiverEmail": "",
			"PassportSeries": "",
			"PassportNumber": "",
			"PassportIssueDate": "",
			"PassportIssuedBy": "",
			"TaxIdentificationNumber": ""
		},
		"FeePayData":{
			"FeePayType":"CC",
			"FeePayAccountNumber":"",
			"FeePayCountryCode":"",
			"FeePayPostCode":""
		},
		"TaxPayData":{
			"TaxPayType":"CC",
			"TaxPayAccountNumber":"",
			"TaxPayCountryCode":"",
			"TaxPayPostCode":""
		},
		"Recipient": {
			"Name": "Jasmin Mieth",
			"Company": "Jasmin Mieth",
			"Addres1": "Unterdorfstr. 6",
			"Addres2": "Unterdorfstr. 7",
			"Addres3": "",
			"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": "Malaysia",
			"City": "",
			"Country":"CN",
			"Email": "Test@163.com",
			"Fax": "0755-98974547"
		},
		"OrderItems": [{
			"Sku": "P_877003",
			"Cnname": "phone case",
			"Enname": "Fashion night light backpack",
			"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",
			"Origin":"",
			"DomesticNumber":"",
			"ImportCustomsCode":""

		},{
			"Sku": "P_877002",
			"Cnname": "phone case",
			"Enname": "Fashion night light backpack",
			"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",
			"Origin":"",
			"DomesticNumber":"",
			"ImportCustomsCode":""
		}],
		"Volumes": [{ /*材积明细 (OrderType 为2快递制单必传)*/
			"Weight": "0.54",
			"Number": "1",
			"Length": "20",
			"Width": "50",
			"Height": "50"
		}]
	}]
}

示例代码

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": "1",
	"FeeInfo": {
			"OtherAmt":"12"
	},
	
	"OrderDatas": [{       /*订单数据*/
		"CustomerNumber": "DD0619019966",
		"Refernumb2":"",
		"FbaId":"test001",
		"ConfirmationNumber": "",
		"TrackNumber": "",
		"ChannelCode": "SZEYB",
		"CountryCode": "ZA",
		"HouseCode": "" ,   /*仓库id*/
		"PackageType": "G",
		"GoodsType": "WPX",
		"TotalWeight": "2",
		"TotalValue": "15.65",
		"Number": "1",
		"Collamt": "0",
		"Declatype":"",
		"Note": "时尚夜光背包",
		"Buyer": {
			"FamilyName": "QQ",
			"FirstName": "",
			"BirthDate": "",
			"ReceiverPhone": "13005337555",
			"ReceiverEmail": "",
			"PassportSeries": "",
			"PassportNumber": "",
			"PassportIssueDate": "",
			"PassportIssuedBy": "",
			"TaxIdentificationNumber": ""
		},
		"FeePayData":{
			"FeePayType":"CC",
			"FeePayAccountNumber":"",
			"FeePayCountryCode":"",
			"FeePayPostCode":""
		},
		"TaxPayData":{
			"TaxPayType":"CC",
			"TaxPayAccountNumber":"",
			"TaxPayCountryCode":"",
			"TaxPayPostCode":""
		},
		"Recipient": {
			"Name": "Jasmin Mieth",
			"Company": "Jasmin Mieth",
			"Addres1": "Unterdorfstr. 6",
			"Addres2": "Unterdorfstr. 7",
			"Addres3": "",
			"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": "Malaysia",
			"City": "",
			"Country":"CN",
			"Email": "Test@163.com",
			"Fax": "0755-98974547"
		},
		"OrderItems": [{
			"Sku": "P_877003",
			"Cnname": "phone case",
			"Enname": "Fashion night light backpack",
			"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",
			"Origin":"",
			"DomesticNumber":"",
			"ImportCustomsCode":""

		},{
			"Sku": "P_877002",
			"Cnname": "phone case",
			"Enname": "Fashion night light backpack",
			"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",
			"Origin":"",
			"DomesticNumber":"",
			"ImportCustomsCode":""
		}],
		"Volumes": [{ /*材积明细 (OrderType 为2快递制单必传)*/
			"Weight": "0.54",
			"Number": "1",
			"Length": "20",
			"Width": "50",
			"Height": "50"
		}]
	}]
}'

返回响应

🟢200成功

application/json

Body

statusCode

string

可选

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

returnDatas

array [object {10}]

可选

statusCode

string

可选

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

corpBillid

string

必需

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

customerNumber

string

客户订单号

可选

trackNumber

string

可选

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

childTrackingNumber

string

子单号

可选

shipmentid

string

UPS 短单号

可选

message

string

错误提示信息

可选

labelbillid

string

标签单号

可选

ifras

string

可选

偏远（快件订单偏远返回）

ifPianYuan

integer

可选

偏远（制单单偏远返回 0：否 1：是）

示例

{
    "statusCode": "string",
    "returnDatas": [
        {
            "statusCode": "string",
            "corpBillid": "string",
            "customerNumber": "string",
            "trackNumber": "string",
            "childTrackingNumber": "string",
            "shipmentid": "string",
            "message": "string",
            "labelbillid": "string",
            "ifras": "string",
            "ifPianYuan": 0
        }
    ]
}