列表

请求地址

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

返回数据格式

JSON

请求方式

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

请求示例

curl -X GET -H "Content-Type: application/x-www-form-urlencoded" https://api.es.xiaojukeji.com/river/Order/get?client_id=client_id_test&access_token=141ea31466478eab2f1c1ddcca2675b989a16552&timestamp=1566764837&company_id=12345678980&offset=0&length=100&sign=091cf244ad5ab16935cfe44fc698bc58

返回参数说明

返回值字段 字段类型 字段说明
errno string 0表示成功,非0表示失败
errmsg string errno=0时为常量"SUCCESS",errno!=0时为错误信息
data object 员工列表信息
data数据格式
返回值字段 字段类型 字段说明
total int 此次查询符合条件的订单总数
records array 订单集合
records数组元素格式
返回值字段 字段类型 字段说明
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

返回示例

{
    "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"
            }
        ]
    }
}

接口错误解决方案

通用错误解决文档

  1. 4xx 错误
  2. 1xxx 错误

results matching ""

    No results matching ""