滴滴企业版

接口说明

说明

查询商旅、网约车、出租车的账单列表信息

注意

4.0用车账单返回的列表顺序为账期倒序，3.0账单列表顺序为正序。

基本信息

HTTP URL	/river/Bill/get
HTTP Method	GET
权限要求

请求头

参数名称	参数值
Content-Type	application/x-www-form-urlencoded

请求参数

字段名	字段说明	字段类型	必填	备注
client_id	申请应用时分配的AppKey	string	yes
access_token	授权后的access token	string	yes
timestamp	当前时间戳	bigint	yes	精确到秒级
company_id	企业ID	string	yes
bill_status	当前状态	int	no	枚举值数字 1：待确认；3：已确认商旅暂不支持
offset	数据开始位置	int	yes	数据开始位置
length	数据条数（最大100条）	int	yes	数据条数（最大100条）
business_line	业务线	int	no	枚举值数字：0：网约车；1：商旅；100：出租车；40:代驾）；当业务线传值为空时，系统默认查询网约车业务线的账单列表
sign	签名	string	yes

请求示例

响应参数

网约车

字段名	字段说明	字段类型	备注
bill_id	结算单号	string
bill_period	结算周期	string
bill_status	当前状态	int	枚举值数字：1：待确认；3：已确认
bill_amount	应结算金额	float
bill_consumption	消耗金额	float
bill_refund	退款金额	float
bill_difference	差异金额	float

商旅：

字段名	字段说明	字段类型	备注
bill_id	结算单号	long	结算单号
root_batch_id	根结点批次	long	根结点批次
start_date	开始时间	string	开始时间
end_date	结束时间	string	结束时间
bill_period	结算周期	string	结算周期
status	账单状态	int	账单状态 0. 生成中 1. 生成成功（待确认） 2.生成失败 3.已确认

出租车

字段名	字段说明	字段类型	备注
bill_id	结算单号	long	结算单号
bill_period	结算周期	string	结算周期
bill_status	当前状态	int	当前状态（1：待确认；3：已确认）
bill_amount	应结算金额	float	应结算金额
bill_consumption	消耗金额	float	消耗金额
bill_refund	退款金额	float	退款金额
bill_difference	调整金额	float	调整金额

响应示例

网约车返回示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "records": [
            {
                "bill_amount": 1,
                "bill_consumption": 123.65,
                "bill_difference": 0,
                "bill_id": 1125927947011387,
                "bill_period": "2024年01月01日 - 2024年02月01日",
                "bill_refund": -122.65,
                "bill_status": 3,
                "companyId": "",
                "companyName": "",
                "end_date": "",
                "groupType": 0,
                "root_batch_id": 0,
                "start_date": "",
                "status": 0
            }
        ],
        "total": 5
    },
    "request_id": "b7tL/EnaLhpJYyzVIPJ0/muAAB7BBIu3Wsc9LvRPI7IUzVxFaoZPq/CqsAo6Iicp"
}

商旅返回示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "records": [
            {
                "bill_amount": 0,
                "bill_consumption": 0,
                "bill_difference": 0,
                "bill_id": 1125927947705968,
                "bill_period": "2023年12月16日 - 2023年12月31日",
                "bill_refund": 0,
                "bill_status": 0,
                "companyId": "",
                "companyName": "",
                "end_date": "2024-01-01 00:00:00",
                "groupType": 0,
                "root_batch_id": 1125927947705968,
                "start_date": "2023-12-16 00:00:00",
                "status": 3
            }
        ],
        "total": 4
    },
    "request_id": "7YN9f1zgAR9vs+piuIhg9CiLyVjasFvLCUCI29BBHXnDXN3yH6y3bNYLHev0AA6B"
}

出租车返回示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "records": [
            {
                "bill_amount": 1,
                "bill_consumption": 123.65,
                "bill_difference": 0,
                "bill_id": 1125927947011387,
                "bill_period": "2024年01月01日 - 2024年02月01日",
                "bill_refund": -122.65,
                "bill_status": 3,
                "companyId": "",
                "companyName": "",
                "end_date": "",
                "groupType": 0,
                "root_batch_id": 0,
                "start_date": "",
                "status": 0
            }
        ],
        "total": 5
    },
    "request_id": "b7tL/EnaLhpJYyzVIPJ0/muAAB7BBIu3Wsc9LvRPI7IUzVxFaoZPq/CqsAo6Iicp"
}

错误码

通用错误解决方案

版本记录

日期	更新人	更新内容	上线时间
2023.12.27	陈继诗	迁移文档