订单查询

订单查询

地址URL

https://api.es.xiaojukeji.com/river/Order/get

支持格式

Json

HTTP请求方式

Get

是否需要登录

是 关于登录授权,参见 如何登录授权

访问授权限制

暂无

请求参数

名称 类型 必选 描述
client_id string yes 申请应用时分配的AppKey
access_token string yes 授权后的access token
timestamp string yes 当前时间戳
company_id string yes 企业ID
call_phone string no 叫车人手机号
phone string no 乘客手机号
start_date string no 开始日期(如:2015-05-01)
end_date string no 结束日期(如:2015-05-28)
start_time string no 开始时间(如:2018-12-12 20:00:00)
end_time string no 结束时间(如:2018-12-12 21:00:00)
use_car_type int no 用车方式(1:出租车,2:专车,3:快车,4:代驾,5:豪华车)
pay_type int no 支付方式(0企业支付 1个人垫付 2混合支付)
is_invoice int no 开票状态(1:开过 0:未开)
offset int yes 数据开始位置。第一次查询,offset应为0;涉及多次查询时,offset应为length的整数倍
length int yes 数据条数(最大100条)
sign string yes 签名
need_approval_id int no 是否需要返回审批单ID字段 0:不返回 1:返回。默认0

注意事项

1、关于开始日期、结束日期、开始时间、结束时间
订单列表接口会根据支付时间、退款时间、个人支付转个人垫付时间查,这三个时间的任意一个在时间范围内,就会被查询出来。2018-08-23这个订单个人支付转个人垫付时间是2018-10-8 07:58 所以滴滴返回的订单列表中含有 paytime=2018-08-23 08:51:29的订单

2、关于分页
第一次查询,offset应为0;涉及多次查询时,后续的offset应为length的整数倍。根据返回值的total(总条数),判断一共需要查询几次(total/length 向上取整)
例如:第一次offset 0, length 100, 第二次应该是offset 100, length 100。offset应为length的整数倍

3、关于个人垫付订单
当开通企业审批报销高级版、第三方费控报销高级版时,能查看所有端的个人垫付订单
当未开通以上高级版时,只能查看滴滴企业版App的个人垫付订单

4、订单查询请求的开始日期和结束日期时间跨度不能大于七天。若只传开始日期,则返回结果为开始日期后的七天范围内的订单查询结果;若只传结束日期,则返回结果为结束日期前七天范围内的订单

返回数据

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "total": 6,
        "records": [
            {
                "order_id": "6166067918382059610",
                "create_time": "2015-11-30 10:39:31",
                "require_level": "100",
                "city": "1",
                "city_name": "北京市",
                "start_name": "当代城市家园",
                "end_name": "北京南站",
                "actual_start_name": "当代城市家园",
                "actual_end_name": "北京南站",
                "actual_flat": "40.043900000000",
                "actual_flng": "116.322556000000",
                "actual_tlat": "39.871201000000",
                "actual_tlng": "116.386002000000",
                "departure_time": "2015-11-30 10:39:31",
                "finish_time": "2015-11-30 10:40:33",
                "status": "2",
                "pay_type": "1",
                "member_id": "2992137043884639240",
                "pay_time": "2015-11-30 10:59:16",
                "total_price": "10.00",
                "actual_price": "10.00",
                "refund_price": "0.00",
                "company_real_pay": "10.00",
                "company_card_pay": "10.00",
                "personal_real_pay": "0.00",
                "personal_pay": "0.00",
                "company_pay": "10.00",
                "company_real_refund": "0.00",
                "personal_real_refund": "0.00",
                "is_invoice": "0",
                "use_car_type": "2",
                "normal_distance": "0.00",
                "call_phone": "13086000110",
                "passenger_phone": "13086000110",
                "budget_center_id": "5576477588712326171",
                "budget_item_id": "5576477588712326272",
                "use_car_config_id":"5489198484344538189",
                "order_source":"3",
                "is_carpool":"1",
                "encrypted_info":"L32HWhrHmgorFYp0lCJ6h6i24PqdjP9Nlsj1F2Hv0M%2FqedfadfaRfv1g3fPdD%2BesMCLni4BIviMjagk7Z8SeRu4FU60jCw3GYzFhHrZoXEX4VTx2o%3D",

            },
            ....
        ]
    }
}
返回值字段 字段类型 字段说明
total string 总条数
order_id string 订单ID
create_time string 叫单时间
use_car_type string 用车方式
require_level string 车型(100舒适型,400六座商务, 200行政级,600普通快车,900优享快车)
city string 城市ID
city_name string 城市名称
start_name string 出发地地址
end_name string 目的地地址
actual_start_name string 实际出发地(司机点击开始的位置)
actual_end_name string 实际目的地(司机点击结束的位置)
actual_flat string 实际出发地纬度(司机点击开始的位置)
actual_flng string 实际出发地经度(司机点击开始的位置)
actual_tlat string 实际目的地纬度(司机点击结束的位置)
actual_tlng string 实际目的地经度(司机点击结束的位置)
departure_time int 出发时间
finish_time string 结束计价时间
status int 订单状态(2-已支付 3-已退款 4-已取消 7-部分退款)
pay_type int 支付方式(0企业支付 1个人垫付 2混合支付)
member_id bigint 员工在滴滴企业的ID(同员工新增接口中返回的id)
pay_time string 支付时间
normal_distance int 总里程
total_price float 总金额
actual_price float 实付金额(总金额-券抵扣金额)
refund_time string 退款时间
refund_price float 退款金额
company_pay float 公司支付金额
company_card_pay float 公司出行卡支付金额
personal_pay float 个人支付金额
company_real_pay float 公司实付金额
company_card_real_pay float 公司出行卡实付金额
personal_real_pay float 个人实付金额(支付时,个人实际支付的金额。后续如有退款,会在personal_real_refund中体现)
company_real_refund float 公司实际退款金额
company_card_real_refund float 公司出行卡实际退款金额
personal_real_refund float 个人实际退款金额
is_invoice int 报销开票状态(1:开过 0:未开)
call_phone int 叫车人手机号
passenger_phone int 乘车人手机号
passenger_name string 乘车人姓名
budget_center_id int 成本中心ID
budget_item_id int 费用科目ID
use_car_config_id int 用车规则ID
order_source int 订单来源(0-Web 1-滴滴出行App 2-H5 3-OpenAPI 4-企业APP 5-邀约券 6-SDK)
is_carpool int 是否拼车(0-不是 1-是)
encrypted_info string 价格加密信息
approval_id string 滴滴内部审批单ID
out_approval_id string 接入方内部审批单ID

results matching ""

    No results matching ""