接口文档

接口文档

API

创建运单

查看API域名

接口地址:

/order/create-order

请求方式:POST

请求头:

参数名参数值
Content-Typeapplication/x-www-form-urlencoded
AuthorizationBearer

请求参数:

参数名参数值必填描述
asyncint否异步获取面单设置,9:不启用(默认),10:启用(且必须在用户后台->设置->异步设置中填入URL并启用)详情点击目录的《异步回调设置》
product_codestring是渠道地址名(在获取发货渠道地址API中获取)
typeint否类型,仓库地址=>9(传空或不传值则默认9),GOFO和UNI上门取件(一票一件)=>10(在获取发货渠道地址API中获取)
currency_codestring否货币代码,如美元:USD。不填默认为USD
customer_order_numstring是客户订单号
rate_order_numstring是报价单号,由价格试算接口获取
shipper_namestring是发件人姓名
shipper_phoneint是发件人电话
shipper_postal_codestring否发件邮编,有申报需求的如(gofo、uniuni需传)
shipper_countrystring否发件人国家,有申报需求的如(gofo、uniuni需传)
shipper_statestring否发件州,有申报需求的如(gofo、uniuni需传)
shipper_citystring否发件城市,有申报需求的如(gofo、uniuni需传)
shipper_add_1string否发件地址1,有申报需求的如(gofo、uniuni需传)
shipper_add_2string否发件地址2
shipper_companystring否发件人公司
shipper_emailstring否发件人邮箱
unitint是尺寸-重量单位: Lbs-Inch/Kgs-Cm (9=>Lbs-Inch,10=>Kgs-Cm)默认Kgs-Cm
target_namestring是收货人姓名
target_phonestring是收货人电话
target_postal_codeint是收货地邮编
target_countrystring是收货地国家(如:US)
target_statestring是收货地洲
target_citystring是收货地城市
target_add_1string是街道地址1
target_add_2string否街道地址2(欧洲渠道的门牌号填写此处)
target_companystring否收货地公司
target_emailstring否收货邮箱,(欧洲渠道必填)
signature_servicestring否签名服务: None/Normal signature/Adult signature (传值填写:-/SSF/ASS)
package_qtyint是包裹数量
packagesJSON[]是包裹信息
packages参数:
参数名参数值必填描述
xdouble是长
yv是宽
zdouble是高
net_weightdouble是净重
qtyint是数量
seqint否箱号
name_cnstring否申报中文名,有申报需求的如(一票一件,gofo、uniuni需传)
name_enstring否申报英文名,有申报需求的如(一票一件,gofo、uniuni需传)
declared_valuestring否申报价格,有申报需求的如(一票一件,gofo、uniuni需传)
skustring否SKU,有申报需求的如(一票一件,gofo、uniuni需传)
remarkstring否备注

响应结果:

参数名参数值是否一定回传描述
err_codeint是状态码,详见状态码表
msgstring是描述信息
resultstring(JSON)否,code为200回传结果(结果集)
result结果集(code=200回传):
参数名参数值是否一定回传描述
asyncint是是否异步查询下单结果,(是:10,否:9)
totalint是预付总金额
fee_list_costJSON[]否费用清单
customer_order_numint是客户订单号
master_tracking_numberstring是主跟踪号
merge_labelstring是面单下载链接
order_numstring是订单号
packages_listJSON[]是包裹单号、面单、箱号等

响应示例:

成功(同步 async=9):
{
	"err_code": 200,
	"msg": "执行成功",
	"result": {
		"customer_order_num": "test1234567890001",
		"total": "14.43",
		"fee_list_cost": [
			{
				"code": "431580860",
				"name": "快递费",
				"currency": "USD",
				"zone_code": "2",
				"amount": "5.94"
			},
			{
				"code": "431580861",
				"name": "燃油附加费",
				"currency": "USD",
				"zone_code": "2",
				"amount": "1.13"
			},
			{
				"code": "431580862",
				"name": "快递费",
				"currency": "USD",
				"zone_code": "2",
				"amount": "5.94"
			},
			{
				"code": "431580864",
				"name": "燃油附加费",
				"currency": "USD",
				"zone_code": "2",
				"amount": "1.13"
			}
		],
		"master_tracking_number": "1ZK6B4420330175884",
		"merge_label": "xxxxxxxxx",
		"order_num": "LSM370918409065598976",
		"packages_list": [
			{
				"tracking_number": "96320019602069871xxxxxxxxx",
				"is_main": 10,
				"seq": "test1234567890001-1",
				"box_num": "1",
				"package_label": "http://xxxxxxx.pdf"
			},
			{
				"tracking_number": "9632001960206987xxxxxxxxx",
				"is_main": 9,
				"seq": "test1234567890001-2",
				"box_num": "2",
				"package_label": "http://xxxxxxx.pdf"
			}
		],
		"async": 9
	}
}
成功(异步 async=10):
{
	"success": true,
	"err_code": 200,
	"msg": "创建订单成功",
	"result": {
		"s_order_num": "test20261106-0006",
		"total": "31.66",
		"order_num": "LSM394024772809506816"
	},
	"async": 10
}
失败:
{
	"err_code": 404,
	"msg": "错误描述"
}
下载示例代码(内有C#,Java,PHP): 点击下载示例代码