请求地址

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

返回数据格式

JSON

请求方式

GET

是否需要登录

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

访问授权限制

暂无

请求参数

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

注意事项

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数组元素格式
字段名称 字段类型 字段说明
order_id string 订单id
call_phone string 叫车人手机号
passenger_phone string 乘车人手机号
passenger_name string 乘车人名字
member_id string 员工在滴滴的id
city string 城市id
city_name string 城市名称
start_name string 出发地名称
actual_start_name string 实际出发地名称
end_name string 目的的名称
actual_end_name string 实际目的地名称
actual_flat string 出发地纬度
actual_flng string 出发地经度
actual_tlat string 目的地纬度
actual_tlng string 目的地经度
normal_distance string 总里程
create_time string 下单时间(订单生成时间)
departure_time string 出发时间(预约单为预约出发时间)
strive_time string 接单时间
meet_time string 接驾时间
begin_charge_time string 开始计价时间
finish_time string 结束计价时间
pay_time string 支付时间
refund_time string 退款时间
require_level string 用车车型
详见
use_car_type string 用车车型大类(2-专车、3-快车、5-豪华车)
sub_use_car_type int 用车场景, 0 - 市内用车,1 - 接送机,2 - 接送站,3 - 接送汽车站,4 - 接送渡口
status string 订单状态(2-已支付、3-已退款、4-已取消、7-部分退款)
pay_type string 支付类型(0-企业支付、1-个人支付、2-混合支付)
order_source string 订单来源(0-Web、1-滴滴出行App、2-H5、3-OpenAPI、4-企业APP、5-邀约券、6-SDK、8-Webapp、10-企业app H5)
pricing_mode int 计价模型(0-实时计价、1-一口价、2-两口价(一口价变成实时计价))
is_carpool string 是否为拼车(0-非拼车,1-拼车)
is_invoice int 是否已开票(0-未开票、1-已开票)
estimate_price string 预估金额,单位:元
total_price string 订单总金额,单位:元
actual_price string 实付金额(总金额-券抵扣金额),单位:元
refund_price string 退款金额,单位:元
company_pay string 公司支付金额,单位:元
company_card_pay string 公司出行卡支付金额,单位:元
personal_pay string 个人支付金额,单位:元
company_real_pay string 公司实付金额,单位:元
company_card_real_pay string 公司出行卡实付金额,单位:元
personal_real_pay string 个人实付金额,单位:元
company_real_refund string 公司实际退款金额,单位:元
company_card_real_refund string 公司出行卡实际退款金额,单位:元
personal_real_refund string 个人实际退款金额,单位:元
budget_center_id string 成本中心id
use_car_config_id string 用车规则id
is_sensitive int 是否为敏感订单(0-不是敏感订单、1-敏感订单)
sensitive_rule_id string 命中的敏感规则id
approval_id string 滴滴内部审批单id
out_approval_id string 接入方审批单id
callback_info string 下单时用户携带的callback_info
extra_info string 扩展信息,自定义字段(创建审批单的扩展信息)
encrypted_info string 订单加密信息(可忽略)
remark string 备注信息
is_abnormal int 是否为敏感订单(0-否,1-是)
abnormal_explanation string 敏感订单员工说明文案;need_abnormal_msg为 true 时返回
abnormal_type string 敏感订单类型;need_abnormal_msg为 true 时返回
reason_type string 敏感订单解释原因类型;need_abnormal_msg为 true 时返回
rule_name string 制度名称(need_rule_info = 1 时返回)
regulation_id string 制度ID (need_rule_info = 1 时返回
type string 订单类型(0:实时、1:预约)
dest_city string 目的城市ID
dest_city_name string 目的城市名称
group_id string 部门ID
pre_total_fee string 特惠快车原价金额 单位元
fixed_discount_fee string 特惠快车尊享折扣金额 单位元
discount_fee string 补贴金额 单位元 在使用企业券时,补贴金额 = 尊享折扣 + 券金额,其他情况直接等于尊享折扣

返回示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "total": 15,
        "records": [
            {
                "order_id": "1125924646611270",
                "create_time": "2023-09-21 14:12:07",
                "require_level": "1100",
                "start_name": "中国银行(成都吉泰路支行)",
                "end_name": "港汇天地北门外-下车点",
                "departure_time": "2023-09-21 14:12:06",
                "strive_time": "2023-09-21 14:13:03",
                "meet_time": "2023-09-21 14:13:16",
                "begin_charge_time": "2023-09-21 14:13:23",
                "finish_time": "2023-09-21 14:14:34",
                "status": "3",
                "member_id": "1125924432653921",
                "pay_time": "2023-09-21 14:18:24",
                "estimate_price": "39.31",
                "total_price": "39.49",
                "actual_price": "39.49",
                "refund_price": "36.73",
                "refund_time": "2023-09-22 02:32:05",
                "is_invoice": 0,
                "use_car_type": "1",
                "call_phone": "00016118186",
                "passenger_phone": "00016118186",
                "passenger_name": "王舟舟",
                "pay_type": "0",
                "budget_center_id": "0",
                "budget_item_id": "0",
                "use_car_config_id": "1125924568437518",
                "city": "17",
                "order_source": "4",
                "company_real_pay": "39.49",
                "personal_real_pay": "0.00",
                "company_card_real_pay": "0.00",
                "personal_pay": "0.00",
                "company_pay": "39.49",
                "company_card_pay": "0.00",
                "company_real_refund": "36.73",
                "personal_real_refund": "0.00",
                "company_card_real_refund": "0.00",
                "is_carpool": "0",
                "remark": "",
                "actual_flat": "39.913370000000",
                "actual_flng": "116.452960000000",
                "actual_tlat": "39.933490000000",
                "actual_tlng": "116.514310000000",
                "normal_distance": "0.3",
                "actual_end_name": "赢韵日式美甲美睫养生会所(国美店)",
                "actual_start_name": "光华路口东-公交站",
                "city_name": "",
                "pricing_mode": 0,
                "encrypted_info": "VHkdsTn1jw6PG9s9PI6V9%2BjAJ2odNhG%2BbvRqxpgHKPqloehSuRDMbQuxiHk0c2MM1ckSL8XgcpMR29hfVnR6sEA00O%2BMQ3RisbgdZe%2BBtiuHRWeI7d145%2Biotdo1TUtR",
                "is_sensitive": 0,
                "sensitive_rule_id": 0,
                "callback_info": "",
                "upgrade_type": 0,
                "is_personal_dispatch": 0,
                "level_type": 0,
                "combo_type": 0,
                "sub_use_car_type": 0,
                "type": "0",
                "group_id": "1125915646135311",
                "dest_city_name": "",
                "dest_city": "17",
                "pre_total_fee": "16.00",
                "fixed_discount_fee": "0.14",
                "discount_fee": "0.14"
            }
        ]
    },
    "request_id": "zP0OSTssYlbjnpw9hS02YEoN1HMFfY94tsT/AFxwuYc6BiNCUQM9CuX4Sp7KV26l"
}

接口错误解决方案

通用错误解决文档

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

results matching ""

    No results matching ""