API 接口文档

Appearance

获取运单费用 orderRecSheets

​

接口说明 ​

通过此接口可获取运单的应收费用。

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

请求方式： POST

请求参数 ​

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

请求报文示例 ​

json
{
    "authorization": {
        "code": "clientid",
        "token": "api-token"
    },
    "datas": {
        "waybillnumber": [
            "HM08161647",
            "SYS211112000010"
        ]
    }
}
{
    "authorization": {
        "code": "clientid",
        "token": "api-token"
    },
    "datas": {
        "waybillnumber": [
            "HM08161647",
            "SYS211112000010"
        ]
    }
}

响应数据 ​

字段名称字段类型字段说明
code接口请求是否通过 0：表示接口请求通过，其他表示失败
msg说明信息
dataJSONArray
searchNumber查询的单号
errormsg错误信息，若存在错误则返回
inrweight收货实重
inmweight收货材重
clientweight计费重
number件数
square方数
recsheetListJSONArray费用清单
sheetid应收单据号
accountingperiod会计期间
status状态ID
statusName状态名称
costtype费用类型编码
costtypeName费用类型名称
currencycode币别编码
currencyname币别名称
recamountrmb应收金额(人民币)
recamount应收金额
sourcetypeName来源类型
price单价
priceunitName计价单位
priceunitnum计价数量
recccyrate应收汇率
recratedate汇率时间
occurdate发生日期
paydate应对账日期
editdate编辑日期

响应数据示例 ​

json
{
    "msg": "success",
    "code": 0,
    "data": [
        {
            "searchNumber": "HM08161647",
            "errormsg": "查询运单不存在"
        },
        {
            "searchNumber": "SYS211112000010",
            "waybillnumber": "SYS211112000010",
            "pkid": 46604,
            "number": 10,
            "clientweight": 156.200,
            "square": 2.160000,
            "inmweight": 360.000,
            "inrweight": 156.200,
            "recsheetList": [
                {
                    "sheetid": "REC211202000001",
                    "orderpkid": 46604,
                    "accountingperiod": "202206",
                    "costtype": "CT0040",
                    "costtypename": "test",
                    "status": 1,
                    "statusName": "待审核",
                    "currencycode": "RMB",
                    "currencyname": "人民币",
                    "price": 10.0,
                    "priceunit": "ordernum",
                    "priceunitnum": 1.0,
                    "recamount": 10.0,
                    "recamountrmb": 10.0,
                    "priceunitName": "票数",
                    "recccyrate": 1.0,
                    "recratedate": "2021-12-02 16:26:55",
                    "sourcetype": 3,
                    "sourcetypeName": "手动添加",
                    "paydate": "2021-12-05 00:00:00",
                    "editdate": "2021-12-02 16:27:24",
                    "occurdate": "2021-12-02 16:26:55",
                },
                // ...
            ]
        }
    ]
}
{
    "msg": "success",
    "code": 0,
    "data": [
        {
            "searchNumber": "HM08161647",
            "errormsg": "查询运单不存在"
        },
        {
            "searchNumber": "SYS211112000010",
            "waybillnumber": "SYS211112000010",
            "pkid": 46604,
            "number": 10,
            "clientweight": 156.200,
            "square": 2.160000,
            "inmweight": 360.000,
            "inrweight": 156.200,
            "recsheetList": [
                {
                    "sheetid": "REC211202000001",
                    "orderpkid": 46604,
                    "accountingperiod": "202206",
                    "costtype": "CT0040",
                    "costtypename": "test",
                    "status": 1,
                    "statusName": "待审核",
                    "currencycode": "RMB",
                    "currencyname": "人民币",
                    "price": 10.0,
                    "priceunit": "ordernum",
                    "priceunitnum": 1.0,
                    "recamount": 10.0,
                    "recamountrmb": 10.0,
                    "priceunitName": "票数",
                    "recccyrate": 1.0,
                    "recratedate": "2021-12-02 16:26:55",
                    "sourcetype": 3,
                    "sourcetypeName": "手动添加",
                    "paydate": "2021-12-05 00:00:00",
                    "editdate": "2021-12-02 16:27:24",
                    "occurdate": "2021-12-02 16:26:55",
                },
                // ...
            ]
        }
    ]
}