接口文档

接口文档

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否发件人公司
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需传)
declaring_unitstring否申报单位,有申报需求的如(gofo、uniuni需传)
declared_weightstring否申报重量,有申报需求的如(gofo、uniuni需传)
declared_quantitystring否申报数量,有申报需求的如(gofo、uniuni需传)
skustring否SKU,有申报需求的如(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): 点击下载示例代码