operationPackages(修改重量和尺寸)

接口说明

    用于修改预报包裹重量信息,已入仓,已发货的包裹不允许修改重量,单次最大查询包裹数量为100个 。


1.请求参数

参数级别/参数名称 类型/关系 是否必须提交 参数含义及数值要求
packageList/ 一对多 Y
packageList/
syOrderNo
String N 顺友流水号
客户订单号
注意:只能出现二者中的一个。
packageList/
customerNo
String N
packageList/
predictionWeight
Double Y 包裹总重量(单位:kg)
系统接收后自动四舍五入至3位小数
packageList/
packageLength
Double N 包裹长度(单位:cm)
系统接收后自动四舍五入至2位小数
packageList/
packageWidth
Double N 包裹宽度(单位:cm)
系统接收后自动四舍五入至2位小数
packageList/
packageHeight
Double N 包高高度(单位:cm)
系统接收后自动四舍五入至2位小数

2.请求示例 复制代码

					
{
    "data": {
        "packageList":[
            {
               "syOrderNo":"SY10000050059",
               "packageLength" : 1.00,
               "packageWidth" : 1.00,
               "packageHeight" : 1.00,
               "predictionWeight": 0.1
            },
            {
               "syOrderNo": "SY10000050067",
               "packageLength" : 2.00,
               "packageWidth" : 2.00,
               "packageHeight" : 2.00,
               "predictionWeight": 0.2
            }
         ]
     }
}
					
				



3.返回参数

参数级别/参数名称 类型/关系 是否必定返回 参数含义及数值要求
ack String Y 接口是否访问成功
SUCCESS:成功
FAILURE:失败
该字段仅用于判断服务接口是否正常响应,请勿用于判断包裹时否创建或预报成功。
errorCode String Y 当ack为FAILURE的时候,返回的错误代码
errorMsg String Y 当ack为FAILURE的时候,返回的错误信息
resultList / 一对多 N
resultList /
orderNo
String Y 传入的单号
resultList /
predictionWeight
Double N 传入的重量
resultList /
reviseWeight
Double N 修订的重量
resultList /
predictionFreight
Double N 预估的费用
resultList /
currencyCode
String N 费用的币种
resultList /
processStatus
String N 处理状态(success:成功 failure:失败)
存在resultList时必定返回
resultList /
errorCode
String N 错误代码
processStatus为failure时必定返回
请参见附录
resultList /
errorMsg
String N 错误信息
processStatus为failure时必定返回

4.返回示例 复制代码

					
成功:
{
    "ack":"success",
    "accessId":"1523212195922387848",
    "data":{
        "resultList":[
           {
              "processStatus":"success",
              "orderNo":"SY10000050059"
           }
        ]
    }
}
失败:
{
    "ack": "failure",
    "errorMsg": "非法的传入参数",
    "errorCode": "S1002"
}