getFreightTrialCalculation(包裹运费试算)

接口说明

    根据指定目的国、包裹重量等参数,获取包裹对应的预估运费

1.请求参数

参数级别/参数名称 类型/关系 是否必须提交 参数含义及数值要求
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

2.请求示例 复制代码

					
{
    "data": {
        "countryCode": "US",
        "weight": 0.88
    }
}
					
				



3.返回参数

参数级别/参数名称 类型/关系 是否必定返回 参数含义及数值要求
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时必定返回

4.返回示例 复制代码

					
成功:
{
    "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
}