| 参数级别/参数名称 | 类型/关系 | 是否必须提交 | 参数含义及数值要求 |
|---|---|---|---|
| countryCode | String | Y | 目的国家二字代码 可参考附录7.0国家代码 Lenth = 2 |
| weight | Double | Y | 包裹总重量(单位:kg) 系统接收后自动四舍五入至3位小数 重量需要大于0小于等于99999.999 |
| length | Double | N | 包裹长度(单位:cm) 系统接收后自动四舍五入至2位小数 长宽高非必填,长宽高需大于0且小于等于10000,且全部不为空才会参与运费试算 |
| width | Double | N | 包裹宽度(单位:cm) 系统接收后自动四舍五入至2位小数 |
| height | Double | N | 包裹高度(单位:cm) 系统接收后自动四舍五入至2位小数 |
| postCode | String | N | 收件人邮编 Length <= 32 |
| shippingMethodCode | String | N | 邮寄方式编码, 可通过4.07findShippingMethods接口获取。 Length <= 20 |
{
"data": {
"countryCode": "US",
"weight": 0.88
}
}
| 参数级别/参数名称 | 类型/关系 | 是否必定返回 | 参数含义及数值要求 |
|---|---|---|---|
| ack | String | Y | 接口是否访问成功 SUCCESS:成功 FAILURE:失败 该字段仅用于判断服务接口是否正常响应,请勿用于判断运费试算是否返回数据。 |
| errorCode | String | Y | 当ack为FAILURE的时候,返回的错误代码 |
| errorMsg | String | Y | 当ack为FAILURE的时候,返回的错误信息 |
| countryCode / | String | N | 国家二字码 |
| countryCnName / | String | N | 国家中文名称 |
| resultList / | 一对多 | N | |
| resultList / shippingMethodCode |
String | Y | 邮寄方式代码 存在resultList时必定返回 |
| resultList / shippingMethodCnName |
String | Y | 邮寄方式名称 存在resultList时必定返回 |
| resultList / weight |
Double | Y | 结算重量 存在resultList时必定返回 |
| resultList / freight |
Double | Y | 合计 存在resultList时必定返回 |
| resultList / currencyCode |
String | Y | 币种 存在resultList时必定返回 |
| resultList / sendTime |
String | Y | 运输时效 存在resultList时必定返回 |
成功:
{
"ack": "success",
"accessId": "1745905613648455135",
"data": {
"countryCode": "US",
"countryCnName": "美国",
"resultList": [
{
"shippingMethodCode": "TEST",
"shippingMethodCnName": "测试邮寄方式",
"weight": 1.0,
"freight": 28.6,
"currencyCode": "CNY",
"sendTime": "7-15"
}
]
}
}
失败:
{
"ack": "failure",
"errorMsg": "系统错误",
"errorCode": "S1000",
"accessId": "1745890517931986823",
"data": null
}