请求地址

https://api.es.xiaojukeji.com/river/Approval/create

返回数据格式

JSON

请求方式

POST

请求头格式

application/json

请求参数

passenger_list（代订出行人数据）

travel_detail

trip

business_trip_detail （按次数）

例如：

{
    "start_time": "2023-10-26 21:13:53",
    "end_time": "2023-10-27 09:13:47",
    "departure_city_id": 17,
    "departure_city": "成都",
    "destination_city_id": 17,
    "destination_city": "成都",
    "start_name": "银河商业广场",
    "start_address": "四川省成都市成华区二环路东三段40-7号",
    "flat": 30.651025,
    "flng": 104.115213,
    "end_name": "旺府豪庭",
    "end_address": "万和北路99号",
    "tlat": 30.81427,
    "tlng": 104.190051,
    "is_return": 0,
    "trip_times": 1,
    "perorder_money_quota": 999900
}

business_trip_detail（按日期）

extend_field_list

返回参数

data

注

1. 为出发地城市创建【送机】和【市内用车】的用车规则。第一个行程的出发地城市无【市内用车】
2. 为目的地城市创建【接机】和【市内用车】的用车规则。最后一个行程的目的地城市的【市内用车】依赖于end_city_rule
3. 目前每个行程的开始日期、结束日期，依赖于travel_detail中的start_date、end_date
4. 当所有的城市id都为空时，系统会根据城市名称匹配对应id，存在id匹配失败的情况；当城市id至少有一个非空，以传入的城市id为准，系统不会进行匹配。建议根据城市查询API传入对应的城市id
5. 所有用车出发地城市和目的地城市参数都应传入城市级别id（当用车出发地城市和目的地城市级别为区县时，应该传入对应所属地级市城市id、区县名称）
6. 当差旅制度中，出差城市配置为无需员工填写时，出发地、目的地城市传空
7. 当行程使用的制度(regulation_id)中，出差城市配置为不管控时（city_type = 0），trips可为空，否则必传，需按照行程顺序填写；
8. 当制度配置“中度管控”（city_type = 1）时，实际行程校验时间使用travel_detail的start_date、end_date字段；trips内的start_date、end_date不生效；轻度管控、中度管控、不管控时，hotel_total_count,train_total_count、flight_total_count会生效
9. 当制度配置“严格管控”（city_type = 2）时，trips内的start_date、end_date会用于校验行程；此种模式下还需要传trip_type字段。此情况下，酒店权限受start_city_rule、end_city_rule影响
10. 出行方式，trip_type，在制度“严格管控”city_type=2时必传)，支持多个(用车默认有)，city_type=1和3时非必传。trip_type 传0 接送机和市内用车 、酒店可以用；trip_type 传1 接送机和市内用车、酒店、火车票 可以用，不管传不传trip_type 都不会控制酒店，只能控制火车和机票。

请求示例

差旅单

1. 轻度管控

curl --location 'https://api.es.xiaojukeji.com/river/Approval/create' \
--header 'Content-Type: application/json' \
--data '{
    "reason":"灰度代订-出行人制度-轻度",
    "executive_regulation_type":0,
    "travel_detail":"{\"end_date\":\"2023-12-19\",\"start_city_rule\":1,\"end_city_rule\":1,\"trips\":[{\"end_date\":\"2023-12-19\",\"departure_city_id\":\"1\",\"to_citys\":[{\"name\":\"hangzhou\",\"id\":3}],\"departure_city\":\"Beijing\",\"start_date\":\"2023-05-10\"}],\"flight_total_count\":1,\"hotel_total_count\":1,\"train_total_count\":1,\"start_date\":\"2023-05-10\"}",
    "company_id":"1125915646167936",
    "approval_type":1,
    "sign":"5f8ab402ccea6d15bfeecc3241cbecda",
    "executive_regulation_id":"1125921250369120",
    "client_id":"87fca1dc60c9de0a96c20fccf2ccaa40_test",
    "sign_key":"f86b6735313052FD7d0f",
    "access_token":"669fd272aa07179f49613e5e8eeffe81c4ae4427",
    "regulation_id":"1125921427436424",
    "phone":"11100009915",
    "executive_regulation_member":"00016180318",
    "timestamp":1690362081,
    "passenger_list":"[{\"passenger_type\":\"0\",\"passenger_phone\":\"11100011964\",\"passenger_name\":\"曹正博\"},{\"passenger_type\":\"0\",\"passenger_phone\":\"00016180318\",\"passenger_name\":\"刘培行\"},{\"passenger_type\":\"0\",\"passenger_phone\":\"00016180328\",\"passenger_name\":\"DMETERTEST1\"},{\"passenger_type\":\"1\",\"passenger_phone\":\"00016180328\",\"passenger_name\":\"dmeter\"}]"
}'

1. 中度、严格管控

curl --location 'https://api.es.xiaojukeji.com/river/Approval/create' \
--header 'Content-Type: application/json' \
--data '{
    "reason":"灰度代订-出行人制度-轻度",
    "executive_regulation_type":0,
    "travel_detail":"{\"end_date\":\"2023-12-19\",\"start_city_rule\":1,\"end_city_rule\":1,\"trips\":[{\"end_date\":\"2023-12-19\",\"departure_city_id\":\"1\",\"departure_city\":\"Beijing\",\"destination_city\":\"hangzhou\",\"destination_city_id\":3,\"start_date\":\"2023-05-10\"}],\"flight_total_count\":1,\"hotel_total_count\":1,\"train_total_count\":1,\"start_date\":\"2023-05-10\"}",
    "company_id":"1125915646167936",
    "approval_type":1,
    "sign":"1df8889e0e2d945758458803cc9768e7",
    "executive_regulation_id":"1125921250369120",
    "client_id":"87fca1dc60c9de0a96c20fccf2ccaa40_test",
    "sign_key":"f86b6735313052FD7d0f",
    "access_token":"58716c11feb49816e599a72796e3b6919524879d",
    "regulation_id":"1125921427436424",
    "phone":"11100009915",
    "executive_regulation_member":"00016180318",
    "timestamp":1690362702,
    "passenger_list":"[{\"passenger_type\":\"0\",\"passenger_phone\":\"11100011964\",\"passenger_name\":\"曹正博\"},{\"passenger_type\":\"0\",\"passenger_phone\":\"00016180318\",\"passenger_name\":\"刘培行\"},{\"passenger_type\":\"0\",\"passenger_phone\":\"00016180328\",\"passenger_name\":\"DMETERTEST1\"},{\"passenger_type\":\"1\",\"passenger_phone\":\"00016180328\",\"passenger_name\":\"dmeter\"}]"
}'

行前按次数

curl --location 'https://api.es.xiaojukeji.com/river/Approval/create' \
--header 'Content-Type: application/json' \
--data '{
    "access_token":"e353748d8c0966a3ac4bad8395d188ac54e44e56",
    "reason":"123",
    "regulation_id":"1125921539238327",
    "company_id":"1125915646167936",
    "phone":"11100009915",
    "approval_type":2,
    "business_trip_detail":"{\"start_time\":\"2023-07-25 10:00:00\",\"end_time\":\"2023-07-25 18:00:00\",\"trip_times\":2,\"perorder_money_quota\":1000,\"total_money_quota\":1000}",
    "sign":"9435128168701c52eaba99b80f5c267f",
    "client_id":"87fca1dc60c9de0a96c20fccf2ccaa40_test",
    "sign_key":"f86b6735313052FD7d0f",
    "timestamp":1690255082
}'

行前按日期

curl --location 'https://api.es.xiaojukeji.com/river/Approval/create' \
--header 'Content-Type: application/json' \
--data '{
    "access_token":"5eec6522d911ee00625a91010319279021f07fd2",
    "reason":"123",
    "regulation_id":"1125921539238327",
    "company_id":"1125915646167936",
    "phone":"11100009915",
    "approval_type":3,
    "business_trip_detail":"{\"start_time\":\"2023-07-25 10:00:00\",\"trip_amount\":1000,\"trips\":[{\"city\":\"beijing\",\"city_id\":1}],\"end_time\":\"2023-07-25 18:00:00\"}",
    "sign":"88fda0fa7fd4aae80de7e412c04ddc58",
    "client_id":"87fca1dc60c9de0a96c20fccf2ccaa40_test",
    "sign_key":"f86b6735313052FD7d0f",
    "timestamp":1690363131
}'

返回示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {
        "approval_id": "9668294457792204005"
    }

}

接口错误解决方案

通用错误解决文档

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

10003(参数错误(xxxxxx))

xxxxxx有以下几种可能：

1. travel_detail格式错误
   1. travel_detail必须为数组
   2. 每一个开始日期必须小于等于结束日期
2. business_trip_detail格式错误
   1. 开始时间、结束时间不能为空
   2. 开始时间必须小于等于结束时间
3. 往返用车时, trip_times必须是偶数
   1. 当approval_type=2且business_trip_detail的is_return=1时，trip_times必须为偶数(因为这是往返行程)

50503(请求失败(xxxxxx))

xxxxxx有以下几种可能：

1. 员工不在该企业中，请添加后重试

   1. 传参中的phone和company_id没有一一对应

2. 用户

   未配置任何审批用车制度

   1. 传参中的regulation_id必须是差旅或者审批用车(按日期、次数的商务审批)的id
   2. 通过用车制度列表接口查询企业所有用车制度(返回值scene_type=2或96的才能用于创建审批单)
   3. 从第2步返回的结果中找到创建审批单传的regulation_id那条记录，然后去查看该员工是否绑定了该审批id:登录es后台 ——> 员工 ——> (根据姓名、工号、手机号)找到这个员工 ——> 编辑 ——> 管理用车制度

3. 用户

   身上未配置用车制度

   1. 用户配置了差旅或者审批制度，但是创建审批单传入的regulation_id不在该员工身上

50506(外部审批单号已被使用(对应的滴滴审批单ID为xxxxxx),请更换外部审批单号或调用审批单修改API)

1. 滴滴要求每次创建审批单的out_approval_id唯一，报该错时表明你此次传参中的out_approval_id与之前创建审批单(返回的approval_id为xxxxxx)的out_approval_id是一样的