接口说明
- 该接口支持根据滴滴侧申请单号，查询关联的用车订单信息
基本信息
|
HTTP URL |
/river/Approval/getOrder |
|---|---|
|
HTTP Method |
GET |
|
权限要求 |
|
请求头
|
参数名称 |
参数值 |
|---|---|
|
Content-Type |
application/x-www-form-urlencoded |
请求参数
|
字段名 |
字段说明 |
字段类型 |
必填 |
备注 |
|---|---|---|---|---|
|
client_id |
应用唯一标识 |
string |
Y |
滴滴开放平台创建应用时，由平台分配的唯一标识，用于识别调用方身份 |
|
access_token |
接口调用授权凭证 |
string |
Y |
授权认证后获取的访问令牌，用于校验接口调用权限；授权认证方式参见【接口认证-授权认证】 |
|
company_id |
租户唯一标识 |
string |
Y |
滴滴企业版租户唯一 ID，代表当前操作的企业主体 |
|
timestamp |
当前时间戳 |
int |
Y |
当前时间戳，精确到秒级 |
|
sign |
签名 |
string |
Y |
根据规则生成的接口签名，用于校验请求合法性与完整性；生成方式参见【接口认证-授权认证】 |
|
approval_id |
申请单ID |
string |
Y |
通过API创建申请单时，滴滴侧返回的滴滴侧申请单ID |
|
offset |
数据开始位置 |
int |
Y |
数据分页起始位置，从 0 开始计数，后续查询需为 length 的倍数 |
|
length |
数据条数 |
int |
Y |
每页返回数据条数，最大值为 50 条 |
如果采用集团账户方案，并且配置了由【上级公司统一对接】（具体配置请咨询滴滴侧对接人），请求参数有如下变化：
新增参数：
|
字段名 |
字段名称 |
类型 |
是否必填 |
备注 |
|---|---|---|---|---|
|
belong_enterprise_name |
归属企业名称 |
string |
N |
company_id传集团公司ID时，可通过该字段确定处理哪个子公司的数据 |
|
taxpayer_no |
纳税人识别号 |
string |
N |
company_id传集团公司ID时，可通过该字段确定处理哪个子公司的数据 |
请求示例
curl -X GET -H "Content-Type: application/x-www-form-urlencoded" https://api.es.xiaojukeji.com/river/Approval/getOrder?client_id=client_id_test&access_token=access_token_test×tamp=1566764837&approval_id=781948394919012&company_id=12345678980&offset=0&length=100&sign=fba8dfb887afe16cb71c50b26a5eae0e
响应参数
records
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
records |
数组 |
array |
|
records为二维数组，每个订单为一个数组元素，参数说明如下：
|
字段名 |
字段说明 |
字段类型 |
备注 |
|---|---|---|---|
|
基本信息 |
|
|
|
|
order_id |
订单ID |
string |
|
|
order_status |
订单状态 |
string |
枚举值数字： |
|
pay_type |
支付方式 |
string |
首次发起支付时，记录对应支付类型 |
|
is_invoice |
是否已开票 |
int |
枚举值数字： |
|
用车场景 |
|
|
|
|
scene_type |
因公出行场景 |
string |
因公出行场景 |
|
scene_id |
场景ID |
string |
枚举值数字： |
|
车型 |
|
|
|
|
use_car_type |
用车方式 |
string |
用车方式，枚举值数字： |
|
car_level |
车型 |
string |
枚举值数字： |
|
叫车人信息 |
|
|
|
|
call_phone |
叫车人手机号 |
string |
|
|
乘车人信息 |
|
|
|
|
passenger_phone |
乘车人手机号 |
string |
|
|
行程信息 |
|
|
|
|
city_name |
出发城市名称 |
string |
|
|
start_name |
出发地名称 |
string |
|
|
actual_start_name |
实际出发地名称（司机点击开始的位置） |
string |
|
|
actual_flat |
实际出发地纬度（司机点击开始的位置） |
string |
|
|
actual_flng |
实际出发地经度（司机点击开始的位置） |
string |
|
|
end_name |
目的地名称 |
string |
|
|
actual_end_name |
实际目的地名称（司机点击结束的位置） |
string |
|
|
actual_tlat |
实际目的地纬度（司机点击结束的位置） |
string |
|
|
actual_tlng |
实际目的地经度（司机点击结束的位置） |
string |
|
|
时间信息 |
|
|
|
|
order_create_time |
下单时间(订单生成时间) |
string |
时间戳格式，如：1675602713 |
|
begin_charge_time |
开始计价时间 |
string |
时间戳格式，如：1675582413 |
|
finish_time |
结束计价时间 |
string |
时间戳格式，如：1675583857 |
|
departure_time |
出发时间(预约单为预约出发时间) |
string |
时间戳格式，如：1675582103 |
|
pay_time |
支付时间 |
string |
支付时间 |
|
金额信息 |
|
|
|
|
total_price |
订单总金额 |
string |
包含车费与平台使用费（含异步），单位：元 |
|
actual_price |
实付金额 |
float |
=订单总金额-券抵扣金额，单位：元 |
|
refund_price |
退款金额 |
string |
总退款金额（企业支付退款+个人支付退款） |
|
discount_fee |
补贴金额 |
string |
给企业的优惠金额；补贴金额=整单立减金额/尊享折扣+企业抵扣券金额 |
|
es_cut_fee |
整单立减金额 |
BigDecimal |
针对企业特价快车、远必省场景，订单整单优惠的金额，包含了尊享立减/远途立省 |
|
pre_total_fee |
特惠快车原价金额 |
string |
特惠快车原价金额，单位：元 |
|
fixed_discount_fee |
特惠快车尊享折扣金额 |
string |
历史冗余字段，26年4月15日后新产生的用车订单，该字段值为0，后续请使用es_cut_fee（整单立减金额） |
|
公司/个人部分的金额信息 |
|
|
|
|
company_pay |
公司支付金额 |
string |
公司应付金额，单位：元 |
|
company_real_pay |
公司实付金额 |
string |
公司实付金额，单位：元 |
|
personal_pay |
个人支付金额 |
string |
个人应付金额，单位：元 |
|
personal_real_pay |
个人实付金额 |
string |
个人实付金额，单位：元 |
|
company_real_refund |
公司实际退款金额 |
string |
公司实退金额，单位：元 |
|
personal_real_refund |
个人实际退款金额 |
string |
个人实退金额，单位：元 |
|
制度信息 |
|
|
|
|
regulation_id |
制度ID |
string |
|
|
rule_id |
用车规则ID |
string |
|
|
申请单信息 |
|
|
|
|
approval_id |
滴滴侧申请单ID |
string |
订单关联的滴滴侧申请单ID |
|
out_approval_id |
客户侧申请单ID |
string |
订单关联的申请单外部ID |
|
extra_info |
扩展信息 |
json |
通过API创建申请单时携带的扩展信息 |
|
成本中心与备注 |
|
|
|
|
budget_center_id |
成本中心ID |
string |
通过API创建申请单时携带的成本中心信息，或下单时选择的成本中心 |
|
budget_center_list |
多成本中心 |
array |
通过API创建申请单时携带的成本中心列表，或下单时选择的成本中心列表，参考budget_center_list对象 |
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 |
对应成本中心的编码 |
响应示例
正常示例
{
"errno": 0,
"errmsg": "SUCCESS",
"data": {
"records": [
{
"begin_charge_time": "0",
"finish_time": "0",
"departure_time": "1684831780",
"use_car_type": "3",
"start_name": "天津水晶宫饭店-上车点",
"end_name": "天津万象城",
"pay_time": "0",
"pay_type": "0",
"is_invoice": "0",
"call_phone": "11000009676",
"passenger_phone": "11000009676",
"total_price": "0.00",
"budget_center_id": "0",
"refund_price": "0.00",
"company_pay": "0.00",
"personal_pay": "0.00",
"company_real_pay": "0.00",
"personal_real_pay": "0.00",
"scene_type": "2",
"scene_id": "101",
"actual_flat": "0.000000000000",
"actual_flng": "0.000000000000",
"actual_tlat": "0.000000000000",
"actual_tlng": "0.000000000000",
"approve_id": "1125920600603705",
"out_approval_id": "didi1002",
"regulation_id": "1125915714586642",
"order_id": "1125920600705290",
"order_status": "4",
"company_refund": "0.00",
"personal_refund": "0.00",
"order_create_time": "1684831780",
"car_level": "600",
"actual_price": 0,
"actual_start_name": "",
"actual_end_name": "",
"city_name": "",
"extra_info": "",
"pre_total_fee": "16.00",
"fixed_discount_fee": "0.14",
"budget_center_list": [
{
"sequence": 1,
"id": "1125938477770589",
"code": "001",
"value": "项目一",
"app_name": "成本中心一按次-不填"
},
{
"sequence": 2,
"id": "",
"value": "扩展001的",
"app_name": "成本中心二按次-必填"
},
{
"sequence": 3,
"id": "",
"value": "扩展02的",
"app_name": "成本中心三按次-选填"
},
{
"sequence": 4,
"id": "",
"value": "扩展03的",
"app_name": "成本中心四"
}
],
"discount_fee": "0.14"
}
],
"total": 3
},
"request_id": "i+2SqRl3AckP+GRuAjAzLXilyer2/QufmRLC/+OlyJJM24vvi+z3LnBj7bBeRLkC"
}
异常示例
错误码
附录
车型
|
CODE |
说明 |
|---|---|
|
100 |
专车舒适型 |
|
200 |
专车行政型 |
|
400 |
六座商务 |
|
450 |
滴滴轻享 |
|
500 |
专车优选型 |
|
600 |
普通快车 |
|
900 |
优享 |
|
1000 |
豪华车 |
|
1100 |
企业出租车 |
|
2000 |
优选出租车 |
|
40600 |
企业特价快车 |
|
2300 |
同时呼叫（司机接单后为实际的车型） |
|
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 |
豪华车-捷豹路虎 |
版本记录
|
日期 |
更新人 |
更新内容 |
上线时间 |
|---|---|---|---|
|
2024.03.18 |
陈继诗 |
迁移文档 |
|
|
2024.03.18 |
陈继诗 |
返回增加rule_id |
2024.03.18 |
|
2024.09.13 |
陈继诗 |
返回增加budget_center_list |
2024.09.13 |
|
2025.06.30 |
杨露佳 |
car_level新增枚举 450 （滴滴轻享） |
2025.06.30 |
|
2026.04.15 |
谢朱莉 |
更新整单立减相关逻辑 |
2026.04.15 |