接口说明
- 1、关于个人垫付订单当开通企业审批报销高级版、第三方费控报销高级版时，能查看所有端的个人垫付订单当未开通以上高级版时，只能查看滴滴企业版App的个人垫付订单
- 2、订单详情不建议作为报销数据。
基本信息
|
HTTP URL |
/river/Order/detail |
|---|---|
|
HTTP Method |
GET |
|
权限要求 |
|
请求头
|
参数名称 |
参数值 |
|---|---|
|
Content-Type |
application/json |
请求参数
|
字段名 |
字段说明 |
字段类型必填 |
必填 |
备注 |
|---|---|---|---|---|
|
client_id |
申请应用时分配的AppKey |
string |
Y |
|
|
access_token |
授权后的access token |
string |
Y |
|
|
company_id |
企业ID |
string |
Y |
|
|
timestamp |
当前时间戳(精确到秒级) |
int |
Y |
|
|
order_id |
订单ID |
string |
Y |
|
|
need_abnormal_msg |
是否返回敏感订单信息 |
int |
N |
枚举值数字 0-否；1-是 |
|
need_rule_info |
是否返回制度信息 |
int |
N |
枚举值数字 0- 不返回；1-返回，（为 1 时返回 rule_name, regulation_id） |
|
need_call_employee_number |
是否返回叫车人员工编号 |
int |
N |
枚举值数字 0- 不返回；1-返回 |
请求示例
curl -X GET -H "Content-Type: application/x-www-form-urlencoded" https://api.es.xiaojukeji.com/river/Order/detail?client_id=client_id_test&access_token=141ea31466478eab2f1c1ddcca2675b989a16552×tamp=1566764837&company_id=12345678980&order_id=11112345678980&sign=091cf244ad5ab16935cfe44fc698bc58
响应参数
返回参数：
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
errno |
错误，0表示成功，非0表示失败 |
int |
Y |
|
|
errmsg |
成功返回"SUCCESS",失败返回对应的错误信息 |
string |
Y |
|
|
data |
数据 |
object |
Y |
|
data数据格式
|
字段名 |
字段中文说明 |
字段类型 |
备注 |
|---|---|---|---|
|
order_id |
订单id |
string |
|
|
company_id |
公司id |
string |
|
|
call_phone |
叫车人手机号 |
string |
|
|
call_employee_number |
叫车人员工工号 |
string |
|
|
passenger_phone |
乘车人手机号 |
string |
|
|
passenger_name |
乘车人名字 |
string |
|
|
passenger_employee_number |
乘车人工号 |
string |
注：若人员离职或删除，该字段不会返回 |
|
city |
出发地城市id |
int |
|
|
city_name |
出发地城市名称 |
string |
|
|
start_name |
出发地名称 |
string |
|
|
flat |
出发地纬度 |
string |
|
|
flng |
出发地经度 |
string |
|
|
actual_start_name |
实际出发地名称（司机点击开始的位置） |
string |
|
|
actual_start_address |
实际出发地址 |
string |
|
|
actual_end_address |
实际目的地址 |
string |
|
|
departure_county_id |
出发区县 ID |
string |
|
|
departure_county_name |
出发区县名称 |
string |
|
|
destination_county_id |
到达区县 ID |
string |
|
|
destination_county_name |
到达区县 名称 |
string |
|
|
actual_flat |
实际出发地纬度（司机点击开始的位置） |
string |
|
|
actual_flng |
实际出发地经度（司机点击开始的位置） |
string |
|
|
dest_city |
目的地城市id |
int |
|
|
dest_city_name |
目的地城市名称 |
string |
|
|
end_name |
目的地名称 |
string |
|
|
tlat |
目的地纬度 |
string |
|
|
tlng |
目的地经度 |
string |
|
|
actual_end_name |
实际目的地名称（司机点击结束的位置） |
string |
|
|
actual_tlat |
实际目的地纬度（司机点击结束的位置） |
string |
|
|
actual_tlng |
实际目的地经度（司机点击结束的位置） |
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 |
用车车型 |
int |
（100-专车舒适型、200-专车行政型、400-专车商务型、600-普通快车、900-快车优享型、1000-豪华车、40600-企业特价快车）列举为最常用的枚举。完整分类请参考附录。 |
|
use_car_srv |
计价类型 |
int |
（101-出租车、201-专车用车、202-专车包车、203-专车接机、204-专车送机、205-专车接程、206-专车送程、301-快车用车、305-快车接程、306-快车送程、401-代驾、501-豪华车、502-豪华包车、503-豪华车接机、504-豪华车送机、601-私车公用（顺风车）602-私车公用（自驾）） |
|
use_car_type |
用车车型大类 |
int |
（2-专车、3-快车、5-豪华车） |
|
sub_use_car_type |
用车场景 |
int |
0 - 市内用车，1 - 接送机，2 - 接送站，3 - 接送汽车站，4 - 接送渡口 |
|
status |
订单状态 |
int |
（0-行程中、1-下单失败、2-已支付、3-已退款、4-已取消、5-待支付、6-部分支付、7-部分退款），不返回0、5、6状态的订单 |
|
type |
订单类型 |
int |
（0-实时、1-预约） |
|
pay_type |
支付类型 |
int |
（0-企业支付、1-个人支付、2-混合支付） |
|
order_source |
订单来源 |
int |
（0-Web、1-滴滴出行App、2-H5、3-OpenAPI、4-企业APP、5-邀约券、6-SDK、8-Webapp、10-企业app H5） |
|
supplier_type |
运力来源 |
int |
枚举值 0自营 1API 2花小猪自营 3鸿鹄三方 |
|
pricing_mode |
计价模型 |
int |
（0-实时计价、1-一口价、2-两口价(一口价变成实时计价)） |
|
is_carpool |
是否为拼车 |
int |
（0-非拼车，1-拼车） |
|
is_invoice |
是否已开票 |
int |
（0-未开票、1-已开票） |
|
estimate_price |
预估金额 |
string |
预估金额，单位：元 |
|
reimbursement_flag |
是否为个人垫付订单 |
int |
（0-非个人垫付订单、1-个人订单）（备注：个垫管控下无法拉回个人订单） |
|
total_price |
订单总金额 |
float |
单位：元 包含呼返立减，不包含尊享折扣 |
|
actual_price |
实付金额 |
float |
（总金额-券抵扣金额），单位：元 |
|
voucher_pay |
券抵扣金额 |
float |
单位：元 |
|
company_pay |
公司支付金额 |
float |
单位：元 |
|
company_card_pay |
公司出行卡支付金额 |
float |
单位：元 |
|
personal_pay |
个人支付金额 |
float |
单位：元 |
|
company_real_pay |
公司实付金额 |
float |
单位：元 |
|
company_card_real_pay |
公司出行卡实付金额 |
float |
单位：元 |
|
personal_real_pay |
个人实付金额 |
float |
单位：元 |
|
company_real_refund |
公司实际退款金额 |
float |
单位：元 |
|
company_card_real_refund |
公司出行卡实际退款金额 |
float |
单位：元 |
|
personal_real_refund |
个人实际退款金额 |
float |
单位：元 |
|
price |
费用明细 |
array |
返回的是值大于的0订单金额信息 |
|
price[0].name |
费用名称 |
string |
|
|
price[0].amount |
费用金额 |
float |
单位：元 |
|
price[0].type |
费用类型 |
string |
|
|
normal_distance |
总里程 |
float |
单位：千米 |
|
estimated_distance |
预估里程 |
float |
单位：千米 |
|
budget_center_id |
成本中心id |
string |
对应的CODE可以使用budget_center_list内的字段 |
|
use_car_config_id |
用车规则id |
string |
|
|
is_sensitive |
是否为敏感订单 |
int |
（0-不是敏感订单、1-敏感订单），1.0方案，新用户可忽略 |
|
sensitive_explanation |
敏感订单解释 |
string |
1.0方案，新用户可忽略 |
|
sensitive_rule_id |
命中的敏感规则id |
string |
1.0方案，新用户可忽略 |
|
sensitive_reason |
敏感订单原因 |
string |
多个原因用英文";"隔开，1.0方案，新用户可忽略 |
|
approval_id |
滴滴内部审批单id |
string |
|
|
out_approval_id |
接入方审批单id |
string |
|
|
callback_info |
下单时用户携带的callback_info |
string |
|
|
extra_info |
扩展信息 |
string |
自定义字段(创建审批单的扩展信息) |
|
encrypted_info |
订单加密信息 |
string |
（可忽略） |
|
group_id |
部门id |
string |
|
|
department_code |
部门编码 |
string |
部门id对应的部门编码 |
|
is_abnormal |
是否为敏感订单 |
int |
(0-否，1-是) |
|
abnormal_explanation |
敏感订单员工说明文案 |
string |
need_abnormal_msg为 1时返回 |
|
abnormal_type |
敏感订单类型 |
string |
need_abnormal_msg为 1时返回 |
|
reason_type |
敏感订单解释原因类型 |
string |
need_abnormal_msg为 1时返回 |
|
operation_type |
敏感订单干预方式 |
int |
0 、无，限仅开通敏感订单1.0 或 未开通敏感订单（含1.0+2.0） |
|
member_id |
员工 ID |
int64 |
|
|
rule_name |
制度名称 |
string |
（need_rule_info = 1 时返回） |
|
regulation_id |
制度ID |
int64 |
（need_rule_info = 1 时返回） |
|
extend_field_list |
申请单基础信息 |
string |
拓展信息list |
|
upgrade_type |
升舱类型 |
int |
0非升舱 1升舱 2 专车拼车 3 降舱 4免费升舱 |
|
level_type |
是否为特快 |
int |
0 非特快 1 特快 |
|
combo_type |
快车的计价类型 |
int |
4 拼车，306 顺路车，302远途拼车 |
|
product_category |
品类/3.0车型列表 |
int |
（5000快车、5001特快、5002优享、5003拼车、5004出租车）列举为最常用的枚举。完整分类请参考附录。 |
|
change_end_count |
修改目的地的次数 |
int |
|
|
remark |
用车备注信息 |
string |
|
|
total_cost |
折后的车费 + 折后的服务费 |
string |
|
|
refund_price |
退款金额 |
string |
|
|
pre_total_fee |
特惠快车原价金额 |
string |
特惠快车原价金额 单位元 包含尊享折扣+呼返立减 |
|
fixed_discount_fee |
特惠快车尊享折扣金额 |
string |
特惠快车尊享折扣金额+呼返立减金额 单位元 |
|
discount_fee |
补贴金额 |
string |
补贴金额 单位元 在使用企业券时，补贴金额 = 尊享折扣 + 券金额，其他情况直接等于尊享折扣，企业节省金额。 |
|
cut_company_cost |
尊享企业立减 |
string |
单位元 尊享折扣+呼返立减=尊享企业支付+尊享个人支付 |
|
cut_personal_cost |
尊享个人立减 |
string |
单位元 |
|
budget_center_list |
多成本中心 |
array |
参考budget_center_list对象 |
|
stopover_points |
途径点 |
array |
参考stopover_points 对象 |
|
legal_entity_info |
所属公司信息 |
object |
参考legal_entity_info对象 |
|
history_destinations |
修改过的历史目的地信息 |
array |
参考history_destinations对象 |
budget_center_list
|
字段 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
app_name |
字段员工侧展示名称 |
string |
|
|
sequence |
字段序号 |
int |
字段序号 支持从1到9 |
|
id |
滴滴主键 |
string |
sequence为1时，生效 |
|
value |
对应成本中心的值 |
string |
对应成本中心的值。sequence为1时与name字段一致，sequence为2时，对应extend_field_01，sequence为3时，对应extend_field_02，sequence为4时，对应extend_field_03 |
|
code |
对应成本中心的编码 |
string |
对应成本中心的编码。sequence为1时与out_budget_id字段一致 sequence为2到9时，CODE无效。 |
extend_field_list
|
字段名 |
字段中文说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
extend_field_01 |
扩展信息一 |
string |
N |
|
|
extend_field_02 |
扩展信息二 |
string |
N |
|
|
extend_field_03 |
扩展信息三 |
string |
N |
|
stopover_points
|
字段 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
cityid |
途经点城市id |
string |
|
|
address |
详细地址 |
string |
途经点的详细地址 |
|
stop_id |
途径点id |
int |
|
|
city |
途经点城市名称 |
string |
|
|
lng |
途经点经度 |
string |
|
|
lat |
途经点维度 |
string |
|
|
name |
途经点名称 |
string |
|
|
status |
途径点状态 |
int |
状态分为0和1 , 0代表还未经过该途经点,1 代表已经经过该途经点 |
legal_entity_info
|
字段 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
legal_entity_id |
叫车人所属公司id |
string |
|
|
out_legal_entity_id |
叫车人所属公司业务编码 |
string |
|
|
legal_entity_name |
叫车人所属公司名称 |
string |
|
history_destinations
|
字段 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
address |
历史目的地详细地址 |
string |
|
|
lng |
历史目的地经度 |
string |
|
|
lat |
历史目的地维度 |
string |
|
|
name |
历史目的地地址名称 |
string |
|
|
sequence |
历史目的地序号 |
int |
序号从1开始递增，存在多次修改目的地时，1表示最早修改的那次 |
price中可能包含的费用如下（会有变动）：
tip_fee:小费,
dynamic_price:动态加价,
start_price:起步价格,
normal_fee:正常行驶距离费,
low_speed_fee:低速费,
empty_fee:远途费,
night_fee:夜间费,
bridge_fee:路桥费,
highway_fee:高速费,
park_fee:停车费,
wait_fee:等候费,
limit_pay:快车 补足基础费的值,
other_fee:其他费用,
normal_time_fee:快车时长费,
discount_after_price:服务费,
red_packet:春节司机服务费,
incentive_fee:调度费,
peak_fee:临时加价,
clean_car_fee:洗车费,
cross_city_fee:跨城费,
promotion_pay:优惠金额,
combo_fee:套餐费用,
cancel_fee:违约费用,
talos_remote_area_fee:偏远地区接驾费
energy_consume_fee:综合能耗费
talos_spacious_car_selection_fee:宽敞好车选车费
sps_pick_up_service_fee:举牌费用
sps_pick_up_service_free:举牌折扣费用
reduction_fee:三方车型折扣费用（此金额虽为正数，业务上是一个扣减金额）
fuel_surcharge：燃油附加费
响应示例
正常示例
{
"errno": 0,
"errmsg": "SUCCESS",
"data": {
"member_id": 1125933586415050,
"city": "1",
"city_name": "北京市",
"dest_city": 1,
"dest_city_name": "北京市",
"type": "0",
"call_phone": "11100038381",
"passenger_phone": "11100038381",
"passenger_name": "11100038381",
"flat": "40.038660000000",
"flng": "116.307250000000",
"tlat": "40.081173000000",
"tlng": "116.363015000000",
"company_id": "1125933586460036",
"create_time": "2024-07-05 15:35:32",
"use_car_type": "3",
"sub_use_car_type": 0,
"require_level": "40600",
"supplier_type": 0,
"start_name": "弘源·新时代东门",
"end_name": "回龙观东大街-地铁站",
"departure_time": "2024-07-05 15:35:32",
"begin_charge_time": "2024-07-05 15:37:10",
"finish_time": "2024-07-05 15:39:38",
"strive_time": "2024-07-05 15:35:59",
"meet_time": "2024-07-05 15:36:32",
"status": "7",
"pay_time": "2024-07-05 15:41:19",
"estimate_price": "26.40",
"total_price": "13.76",
"total_cost": "12.61",
"actual_price": "12.14",
"voucher_pay": "0.47",
"refund_price": "4.14",
"refund_time": "2024-07-05 15:49:28",
"price": [
{
"name": "服务费",
"amount": "1.00",
"type": "discount_after_price",
"content": ""
}
],
"remark": "",
"is_invoice": 0,
"order_id": "1125936440597419",
"estimated_distance": "8.22",
"normal_distance": "0.01",
"pay_type": "2",
"budget_center_id": "0",
"budget_item_id": "0",
"use_car_config_id": "1125936273306388",
"order_source": "4",
"company_real_pay": "8.00",
"personal_real_pay": "4.14",
"personal_pay": "4.61",
"company_pay": "8.00",
"company_card_pay": "0.00",
"company_card_real_pay": "0.00",
"company_card_real_refund": "0.00",
"company_real_refund": "0.00",
"personal_real_refund": "4.14",
"is_carpool": "0",
"pricing_mode": 2,
"use_car_srv": "301",
"actual_start_name": "四方大厦(上地四街)附近",
"actual_end_name": "回龙观东大街地铁站C口西南侧",
"actual_start_address": "北京市海淀区上地四街9号",
"actual_end_address": "地铁8号线",
"actual_flat": "40.038282000000",
"actual_flng": "116.306714000000",
"actual_tlat": "40.080145000000",
"actual_tlng": "116.363669000000",
"is_sensitive": 0,
"sensitive_explanation": "",
"sensitive_rule_id": "",
"sensitive_reason": "",
"reimbursement_flag": 1,
"callback_info": "",
"upgrade_type": 0,
"level_type": 0,
"combo_type": 0,
"product_category": 5024,
"change_end_count": 0,
"group_id": "1125933586429884",
"fixed_discount_fee": "1.69",
"pre_total_fee": "14.30",
"discount_fee": "0.00",
"cut_company_cost": "0.00",
"cut_personal_cost": "1.69",
"encrypted_info": "NMfZzYYXFGbH%2F2lmk0wqNfG7r84%2FyjWOQlLFknxdeccJzGERvIPn9j1POWeaSjKBw0CGzVE57I0y8e7QU54Hv04oKykjy9un5XVcv7jGQGI%3D",
"reason_type": "",
"abnormal_explanation": "",
"abnormal_type": "",
"is_abnormal": 0,
"operation_type": 0,
"approval_id": "",
"out_approval_id": "",
"extra_info": "",
"extend_field_list": ""
},
"request_id": "+xvHWIzBGl0JQb5bQdJCfO4uDwUTCi7YVkO0lSvXUWMCtuk6izRSfA0FoRWupFu9"
}
异常示例
{
"errno": 401,
"errmsg": "access_token不合法或已过期",
"request_id": "202311010956450ab68d336541b05d4add9cabab572002"
}
错误码
附录
require_level全量枚举：
|
CODE |
说明 |
|---|---|
|
100 |
专车舒适型 |
|
200 |
专车行政型 |
|
400 |
专车商务型 |
|
450 |
快车轻享型 |
|
500 |
专车优选型 |
|
600 |
普通快车 |
|
900 |
快车优享型 |
|
1000 |
豪华车 |
|
1400 |
豪华车-宝马5系 |
|
1401 |
豪华车-奥迪A6L |
|
1402 |
豪华车-专车页面下豪华车 |
|
1403 |
豪华车-特斯拉 |
|
1404 |
豪华车-奔驰S级 |
|
1405 |
豪华车-奔驰V级 |
|
1406 |
豪华车-豪华六座 |
|
1407 |
豪华车-埃尔法 |
|
1408 |
豪华车-场景车型 |
|
1409 |
豪华车-Panamera |
|
1410 |
豪华车-豪华轿车 |
|
1411 |
豪华车-红旗H7 |
|
1412 |
豪华车-英菲尼迪 |
|
1413 |
豪华车-保时捷 |
|
1414 |
豪华车-林肯大陆 |
|
1415 |
豪华车-奥迪A8L |
|
1416 |
豪华车-讴歌RDX |
|
1417 |
豪华车-蔚来ES8 |
|
1418 |
豪华车-兰博基尼 |
|
1419 |
豪华车-雷克萨斯 |
|
1420 |
豪华车-沃尔沃 |
|
1500 |
好豪华车-奔驰E级 |
|
1600 |
豪华车-捷豹路虎 |
|
1100 |
企业出租车 |
|
2000 |
优选出租车 |
|
2300 |
同时呼叫 |
|
40600 |
企业特价快车 |
product_category 全量枚举
|
5000 |
快车 |
|---|---|
|
5001 |
特快 |
|
5002 |
优享 |
|
5003 |
拼车 |
|
5004 |
出租车 |
|
5005 |
舒适专车 |
|
5006 |
行政专车 |
|
5007 |
六座商务 |
|
5008 |
优选新出租 |
|
5009 |
任何豪华车 |
|
5010 |
奥迪e-tron |
|
5011 |
丰田埃尔法 |
|
5012 |
奔驰E级 |
|
5013 |
红旗H7 |
|
5014 |
红旗H9 |
|
5015 |
林肯飞行家 |
|
5016 |
林肯大陆 |
|
5017 |
奥迪A8L |
|
5018 |
捷豹XFL |
|
5019 |
宝马5系 |
|
5020 |
奥迪A6L |
|
5021 |
特斯拉 |
|
5022 |
奔驰S级 |
|
5023 |
奔驰Vito |
|
5024 |
滴滴特惠 |
|
193 |
滴滴轻享 |
版本记录
|
日期 |
更新人 |
更新内容 |
上线时间 |
|---|---|---|---|
|
2023.12.06 |
陈继诗 |
文档迁移 |
2024.03.26 |
|
2023.12.20 |
陈继诗 |
|
|
|
2023.03.19 |
陈继诗 |
增加driver_card（白名单字段），pre_total_fee，fixed_discount_fee，discount_fee |
2024.03.26 |
|
2024.03.26 |
陈继诗 |
增加need_call_employee_number请求参数，call_employee_number返回数据 |
2024.03.26 |
|
2024.05.06 |
陈继诗 |
require_level增加枚举40600 |
2024.05.06 |
|
2024.05.13 |
陈继诗 |
文档更新：增加预估金额返回 |
2024.05.13 |
|
2024.06.20 |
陈继诗 |
文档更新：增加supplier_type |
2024.06.20 |
|
2024.07.22 |
陈继诗 |
文档更新：返回增加operation_type |
2024.07.22 |
|
2024.07.25 |
陈继诗 |
文档更新：返回增加cut_company_cost，cut_personal_cost，normal_distance含义变更字段：total_price，fixed_discount_fee，pre_total_fee |
2024.09.13 |
|
2024.09.02 |
陈继诗 |
文档更新：返回增加budget_center_list信息 |
2024.09.13 |
|
2024.09.27 |
陈继诗 |
新增actual_start_address，actual_end_address，departure_county_id，departure_county_name，destination_county_id，destination_county_name |
2024.11.04 |
|
2025.2.19 |
梁镇超 |
新增stopover_points |
2025.2.19 |
|
2025.2.27 |
高洋洋 |
补充passenger_employee_number、department_code的说明 |
2025.2.27 |
|
2025.3.18 |
高洋洋 |
price明细增加：综合能耗费、宽敞好车选车费、举牌费用 、举牌折扣费用、三方车型折扣费用 |
2025.3.18 |
|
2025.05.23 |
高洋洋 |
新增legal_entity_info信息 |
2025.05.23 |
|
2025.05.26 |
高洋洋 |
新增history_destinations信息 |
2025.06.04 |
|
2025.06.26 |
杨露佳 |
新增fuel_surcharge（燃油附加费） |
2025.06.26 |
|
2025.06.30 |
杨露佳 |
require_level新增枚举 450 （滴滴轻享）,product_category新增枚举 193 |
2025.06.30 |