接口文档

接口文档

API

价格试算

查看API域名

接口地址:

/order/rate

请求方式:POST

请求头:

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

请求参数:

参数名参数值必填描述
product_codestring渠道地址名(在获取发货渠道地址API中获取)
currency_codestring货币代码,如美元:USD。不填默认为USD
customer_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发件人公司
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收货地公司
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需传)
declaring_unitstring申报单位,有申报需求的如(gofo、uniuni需传)
declared_weightstring申报重量,有申报需求的如(gofo、uniuni需传)
declared_quantitystring申报数量,有申报需求的如(gofo、uniuni需传)
skustringSKU,有申报需求的如(gofo、uniuni需传)
remarkstring备注

响应结果:

参数名参数值是否一定回传描述
err_codeint状态码,详见状态码表
msgstring描述信息
resultstring(JSON)否,code为200回传结果(结果集)
result结果集(code=200回传):
参数名参数值是否一定回传描述
totaldouble总费用
fee_liststring(JSON)费用清单
rate_order_numstring测价订单号
customer_order_numstring客户订单号
fee_list结果集(code=200回传):
参数名参数值是否一定回传描述
namestring费用名
sumdouble地址ID
zon_codestring计费区间

响应示例:

成功:
{
	"success": true,
	"err_code": 200,
	"msg": "价格测算成功",
	"result": {
		"total": "7.07",
		"fee_list": [
			{
				"name": "快递费",
				"zon_code": "2",
				"sum": "5.94"
			},
			{
				"name": "燃油附加费",
				"zon_code": "2",
				"sum": "1.13"
			}
		],
		"rate_order_num": "RATE371529484479893504",
		"customer_order_num": "test1234567896069"
	}
}
失败:
{
	"err_code": 404,
	"msg": "错误描述"
}
下载示例代码(内有C#,Java,PHP): 点击下载示例代码