API 接口文档

Appearance

获取运单收货材积信息 orderVolume

​

接口说明 ​

通过此接口可获取运单的收货材积相关信息。

接口地址: http://tms.gateway.sc-express.cn/api/order/orderVolume

请求方式： POST

请求参数 ​

字段名称字段类型字段长度是否必需字段说明
authorizationJSONObject接口校验信息
codeString5-20Y客户编码
tokenString50YAPI授权码
datasJSONObject
waybillnumberJSONArrayY运单号,最多一次查询20个单号，与系统单号二选一提交即可
systemnumberJSONArrayY系统单号,最多一次查询20个单号，与运单号二选一提交即可

请求报文示例 ​

json
{
    "authorization": {
        "code": "test",
        "token": "7a6a2c0d-7508-4113-9c64-037f67e7a13c"
    },
    "datas": {
        "waybillnumber": [
            "9316760611",
            "EV00000001847CN",
            "SYS211112000010"
        ]
    }
}
{
    "authorization": {
        "code": "test",
        "token": "7a6a2c0d-7508-4113-9c64-037f67e7a13c"
    },
    "datas": {
        "waybillnumber": [
            "9316760611",
            "EV00000001847CN",
            "SYS211112000010"
        ]
    }
}

响应数据 ​

字段名称字段类型字段说明
code接口请求是否通过 0：表示接口请求通过，其他表示失败
msg说明信息
dataJSONArray
searchNumber查询的单号
errormsg错误信息，若存在错误则返回
systemnumber系统单号
waybillnumber运单号
customernumber1客户参考号1
forecastweight预报重
forecastmweight预报材重
inrweight收货实重
inmweight收货材重
inweight收货结算重
square方数
number总件数
volumesJSONArray收货材积
number箱序号
prenum件数
prelength长
prewidth宽
preheight高
prerweight单件实重
preweight单件结算重

响应数据示例 ​

json
{
    "msg": "success",
    "code": 0,
    "data": [
        {
            "searchNumber": "9316760611",
            "success": true,
            "systemnumber": "8960230517000059",
            "waybillnumber": "9316760611",
            "customernumber1": "8960230517000059",
            "forecastweight": 1.000,
            "forecastmweight": 0.166,
            "inweight": 0.000,
            "inmweight": 0.000,
            "inrweight": 0.000,
            "square": 0.001000,
            "number": 1,
            "volumes": []
        },
        {
            "searchNumber": "EV00000001847CN",
            "success": true,
            "systemnumber": "TEST230506000014",
            "waybillnumber": "EV00000001847CN",
            "customernumber1": "TEST230506000014",
            "forecastweight": 0.000,
            "forecastmweight": 5.000,
            "inweight": 30.000,
            "inmweight": 5.000,
            "inrweight": 0.000,
            "square": 0.030000,
            "number": 3,
            "volumes": [
                {
                    "number": "1-2",
                    "prewidth": 20.000,
                    "prelength": 10.000,
                    "preweight": 10.000,
                    "prenum": 2,
                    "preheight": 50.000,
                    "prerweight": 0.000
                },
                {
                    "number": "3",
                    "prewidth": 20.000,
                    "prelength": 10.000,
                    "preweight": 10.000,
                    "prenum": 1,
                    "preheight": 50.000,
                    "prerweight": 0.000
                }
            ]
        },
        {
            "searchNumber": "SYS211112000010",
            "success": false,
            "msg": "运单不存在"
        }
    ]
}
{
    "msg": "success",
    "code": 0,
    "data": [
        {
            "searchNumber": "9316760611",
            "success": true,
            "systemnumber": "8960230517000059",
            "waybillnumber": "9316760611",
            "customernumber1": "8960230517000059",
            "forecastweight": 1.000,
            "forecastmweight": 0.166,
            "inweight": 0.000,
            "inmweight": 0.000,
            "inrweight": 0.000,
            "square": 0.001000,
            "number": 1,
            "volumes": []
        },
        {
            "searchNumber": "EV00000001847CN",
            "success": true,
            "systemnumber": "TEST230506000014",
            "waybillnumber": "EV00000001847CN",
            "customernumber1": "TEST230506000014",
            "forecastweight": 0.000,
            "forecastmweight": 5.000,
            "inweight": 30.000,
            "inmweight": 5.000,
            "inrweight": 0.000,
            "square": 0.030000,
            "number": 3,
            "volumes": [
                {
                    "number": "1-2",
                    "prewidth": 20.000,
                    "prelength": 10.000,
                    "preweight": 10.000,
                    "prenum": 2,
                    "preheight": 50.000,
                    "prerweight": 0.000
                },
                {
                    "number": "3",
                    "prewidth": 20.000,
                    "prelength": 10.000,
                    "preweight": 10.000,
                    "prenum": 1,
                    "preheight": 50.000,
                    "prerweight": 0.000
                }
            ]
        },
        {
            "searchNumber": "SYS211112000010",
            "success": false,
            "msg": "运单不存在"
        }
    ]
}