API 接口文档

Appearance

获取单号 Waybillnumber

​

接口说明 ​

通过此接口可获取客户参考号对应的系统运单号和系统单号。

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

请求方式： POST

请求参数 ​

请求字段说明

字段名称字段类型字段长度是否必需字段说明
authorizationJSONObject接口校验信息
codeString5-20Y客户编码
tokenString50YAPI授权码
datasJSONOArray
customernumberJSONArrayY

客户参考号1

示例值: [ "T620200611-1001", "T620200611-1002" ]

请求报文示例 ​

json
{
    "authorization": {
        "code": "KJHB",
        "token": "c60bf762-01f7-470e-8c8f-acde06c81fed"
    },
    "datas": {
        "customernumber": [
            "T620200611-1001",
            "T620200611-1002"
        ]
    }
}
{
    "authorization": {
        "code": "KJHB",
        "token": "c60bf762-01f7-470e-8c8f-acde06c81fed"
    },
    "datas": {
        "customernumber": [
            "T620200611-1001",
            "T620200611-1002"
        ]
    }
}

响应数据 ​

响应字段说明

字段名称字段说明
code接口请求是否通过 0：表示接口请求通过，其他表示失败
msg说明信息
data
customernumber客户参考号1
code0：表示成功，其他表示失败
msg说明信息
customernumber客户参考号1
systemnumber我方系统单号
waybillnumber运单号
tracknumber转单号
shortnumber短单号
childs子单号
systemnumber 系统子单号
customernumber客户子单号
tracknumber转单子单号

响应数据示例 ​

json
{
    "code": 0,
    "msg": "调用成功",
    "data": {
        "customernumber": [
            {
                "code": 0,
                "msg": "获取单号成功",
                "customernumber": "T620200611-1001",
                "systemnumber": "1591857709631",
                "waybillnumber": "926129030293605",
                "tracknumber": "1Z76V3R40448621361",
                "childs": [
                    {
                        "customernumber": "CH-85120-1001",
                        "systemnumber": "1591857709631-1",
                        "tracknumber": "1Z76V3R40448621361"
                    },
                    {
                        "customernumber": "CH-85120-1002",
                        "systemnumber": "1591857709631-2",
                        "tracknumber": "1Z76V3R40448621362"
                    }
                ]
            },
            {
                "code": -1,
                "msg": "单号系统中不存在",
                "customernumber": "T620200611-10021"
            }
        ]
    }
}
{
    "code": 0,
    "msg": "调用成功",
    "data": {
        "customernumber": [
            {
                "code": 0,
                "msg": "获取单号成功",
                "customernumber": "T620200611-1001",
                "systemnumber": "1591857709631",
                "waybillnumber": "926129030293605",
                "tracknumber": "1Z76V3R40448621361",
                "childs": [
                    {
                        "customernumber": "CH-85120-1001",
                        "systemnumber": "1591857709631-1",
                        "tracknumber": "1Z76V3R40448621361"
                    },
                    {
                        "customernumber": "CH-85120-1002",
                        "systemnumber": "1591857709631-2",
                        "tracknumber": "1Z76V3R40448621362"
                    }
                ]
            },
            {
                "code": -1,
                "msg": "单号系统中不存在",
                "customernumber": "T620200611-10021"
            }
        ]
    }
}