管理API对接文档

最近更新时间：


该接口用于创建出行审批单，创建成功后会立即在企业APP上显示审批单信息

接口说明

注意

城市

  1. 创建审批单时：若传递的城市ID为县级市，自动替换为对应的地级市，当传递的城市ID与城市名称不一致时，以城市ID为准，替换为城市ID对应的正确城市名称
  2. 城市 ID 错误：未开国际品类，创建申请单成功，但是申请单上城市不可用；开了国际品类，拦截报错
  3. 不传城市 ID：如果是国内城市，会按照名称模糊匹配，按照 全称、市、区、县 的优先级找到返回的第一条数据
  4. 所有用车出发地城市和目的地城市参数都应传入城市级别id（当用车出发地城市和目的地城市级别为区县时，应该传入对应所属地级市城市id、区县名称）
  5. 当差旅制度中，出差城市配置为无需员工填写时，出发地、目的地城市传空

travel_detail

  1. 目前每个行程的开始日期、结束日期，依赖于travel_detail中的start_date、end_date
  2. 为出发地城市创建【送机】和【市内用车】的用车规则。第一个行程的出发地城市无【市内用车】
  3. 为目的地城市创建【接机】和【市内用车】的用车规则。最后一个行程的目的地城市的【市内用车】依赖于end_city_rule
  4. trip中城市行数量限制40个

passenger_list

出行人限制：30 个人

会议管控：40个人

out_approval_id

唯一性校验：company_id+approval_type+申请人维度

代订制度使用

代订使用的制度无限制，所有差旅制度都可以，只用来使用差标。


说明

1，申请单新增的budget_center_list字段，用于多成本中心字段。支持9个字段。

2，budget_center_id，name，out_budget_id，extend_field_list四个字段与budget_center_list不可以同时使用。

3，历史客户可以使用历史4个字段可以兼容映射到新字段处理使用多成本中心。需要甲子开关切换多成本中心功能。

4，新建取值优先级最外层budget_center_list 大于 人维度budget_center_list 大于budget_center_id，name，out_budget_id，extend_field_list

序号1字段

sequence=1时，

字段

历史字段

id

budget_center_id

value

name

code

out_budget_id

序号2字段

sequence=2时，

字段

历史字段

id


value

extend_field_01

code


序号3字段

sequence=3时，

字段

历史字段

id


value

extend_field_02

code


序号4字段

sequence=4时，

字段

历史字段

id


value

extend_field_03

code




结构说明




基本信息

HTTP URL

/river/Approval/create

HTTP Method

POST

权限要求


请求头

参数名称

参数值

Content-Type

application/json

请求参数

字段名

字段说明

字段类型

必填

备注

client_id

申请应用时分配的AppKey

string

Y

申请应用时分配的AppKey

access_token

授权后的access token

string

Y

授权后的access token

timestamp

当前时间戳(精确到秒级)

int

Y


company_id

滴滴公司 ID

string

Y


sign

签名

string

Y







out_trip_id

外部tripid

string

N

用于滴滴首页合并卡片展示

out_trip_info

外部trip信息

string

N

用于滴滴首页合并卡片展示






approval_type

审批单类型

int

Y

枚举值数字：
1:差旅单
2: 行前审批-按次数
3: 行前审批-按日期

regulation_id

审批制度ID

string

N

(差旅/行前)申请单对应的需审批制度ID regulation_id与policy_type、policy_type_value至少有一组有值

policy_type

执行政策指定项类型

int

N

1：out_rank_id 外部职级编号
2：employee_number 员工工号
3：employee_phone 员工手机号
4：employee_email 员工邮箱
5：regulation_id 制度I
指定生效policy_type_value内对应的值

policy_type_value

执行政策指定项

string

N

使用海外手机号时输入格式为 +90 137****0001 ，国内可以不加区号

out_approval_id

外部申请单ID

string

N

客户侧申请单ID，不大于 120 字符。
eg: TA_100002，与返回中的approvalid一一对应

budget_center_id

滴滴侧成本中心ID

string

N

滴滴侧成本中心ID；
获取方式接口返回的 ID（可为项目/部门ID)
eg : 1125920020961744 关联部门 时， id和out_budget_id 优先处理id关联项目时 id和 out_budget_id与 name 组合唯一值时 优先处理id ，out_budget_id与 name 同时有值时按照项目处理，out_budget_id有值且name为空时，按照部门处理。

name

部门/项目名称

string

N

不大于 200 字符

out_budget_id

编号

string

N

长度限制：≤ 64 字符

reason

申请原因

string

N

申请原因，限制 200 字符；默认为空字符
eg: 北京出差，行程维度事由。使用卡片事由时，可以为空。

extra_info

扩展信息

string

N

扩展信息，自定义字段；最长不大于 500 字符；(必须为json字符串)；默认为空字符

extend_field_list

扩展信息list

string

N

自定义字段，最长不大于 500 字符
将extend_field_list转为 json 字符串
三个字段仅作为备注性字段。详见extend_field_list

travel_detail

差旅单行程信息

string

N

差旅单行程信息
将travel_detail的值转为 json 字符串
approval_type = 1 时必传。

business_trip_detail

因公用车审批行程数据

string

N

行前行程信息, 将 business_trip_detail转为 json 字符串
approval_type = 2 或 approval_type = 3 必填。详见 [business_trip_detail](#business_trip_detail （按次数）

travel_budget

差旅预算总额

string

N

差旅预算控制，一个申请单对应一个总预算纬度，一次只能全部或者选择部分品类。

travel_management

差旅管控

string

N

差旅管控，目前仅支持市内用车每日限额设置（为json字符串类型，具体看请求示例）。使用此字段需在es后台制度中开启每日限额配置。

member_type

申请人唯一键类型

int

N

枚举值数字：
0：手机号，phone 必填
1：工号，employee_number 必填
2：邮箱，email 必填
默认为0

phone

申请人手机号

string

N

申请人手机号；默认为空字符；member_type不传 或者member_type 为0时phone必传 使用海外手机号时输入格式为 +90 137****0001 ，国内可以不加区号

employee_number

申请人工号

string

N

申请人工号，默认为空字符

email

申请人邮箱

string

N

申请人邮箱；默认为空字符






passenger_list

出行人信息

string

N

出行人信息，不传时默认出行人为申请人，
将passenger_list 转为 json 数组字符串。详见passenger_list

executive_regulation_type

代订执行制度类型

int

N

枚举值数字：
0: 执行申请人制度
1: 执行外部出行人不限差标:（需要passenger_list都是外部出行人）
2: 执行出行人制度，作用于预订时生效的差标。
3: 执行多人多差标制度

executive_regulation_id

代订执行人的制度

string

N

代订执行人的制度，executive_regulation_type=2 时选填，传了就生效
不传：选择 executive_regulation_member 最新绑定的一条制度

executive_regulation_member_type

代订执行人标识类型

int

N

枚举值数字：
0：手机号，executive_regulation_member 为执行人手机号
1：工号，executive_regulation_member 为执行人工号
2：邮箱：executive_regulation_member 为执行人邮箱
默认为0

executive_regulation_member

代订执行人(手机号/工号/邮箱)

string

N

代订执行人(手机号/工号/邮箱)；默认手机号
注意：执行出行人制度的时候，需要是出行人passenger_list里的员工，
executive_regulation_type=2时必传， 只能是内部员工 使用海外手机号时输入格式为 +90 137****0001 ，国内可以不加区号

budget_center_list

多成本中心

string

N

序号1对应远成本中心字段，依然支持滴滴内部主键ID。使用部门CODE主键，和项目时名称和code作为主键。

car_city_rule

用车跨城规则

string

N

审批单类型approval_type=2或approval_type=3时有效。
将car_city_rule转为 json 字符串。


travel_budget

字段

类型

是否必传

说明

budget_amount

int

Y

申请单总预算金额 单位 分 需要100整数倍

budget_type

int

Y

预算类型
1 申请单维度

budget_share

array

Y

需要申请单使用的制度内开启对应的品类。且最终取两者交集。
使用数字，预算可使用品类：
1 市内用车
2 接送场景
301 国内酒店
401 火车票
601 国内机票
701 国际机票
801 国际酒店


travel_management

字段

类型

是否必传

说明

daily_amount_control

array

Y

每日金额管控内容


daily_amount_control

字段

类型

是否必传

说明

daily_amount

int

Y

每人日金额管控（单位：分）

control_type

int

N

管控方式1 日清

control_product

array

Y

1 市内用车


budget_center_list

注意

成本中心传输需要有业务含义，不能传输空值。

字段

类型

是否必传

说明

sequence

int

Y

字段序号 支持从1到9

id

string

N

sequence为1时，生效

value

string

N

对应成本中心的值。sequence为1时传入的value与name字段一致，sequence为2时，对应extend_field_01，sequence为3时，对应extend_field_02，sequence为4时，对应extend_field_03 sequence为1时,id和value优先处理id,关联项目时 id和 value与 code 组合唯一值时 优先处理id ，value与 code 同时有值时按照项目处理，code有值且value为空时，按照部门处理。

code

string

N

对应成本中心的编码。sequence为1时与out_budget_id字段一致



extend_field_list

字段

类型

是否必传

说明

extend_field_01

string

N

扩展信息一

extend_field_02

string

N

扩展信息二

extend_field_03

string

N

扩展信息三


passenger_list

字段名

字段说明

字段类型

必填

备注

passenger_type

出行人类型

int

Y

枚举值数字：
0：员工；1：外部出行人

budget_center_list

多成本中心

list

N


passenger_name

出行人姓名

string

Y

出行人姓名/员工姓名

passenger_english_surname

英文姓

string

N

同lastname内外部人传了落地后不可修改，新建可以做新增，内部员工主数据对应更新。 内部名字需要校验主数据一致性（空除外）。

passenger_english_name

英文名

string

N

同firstname 有middlename时 english_name=firstname middlename内外部人传了落地后不可修改，新建可以做新增，内部员工主数据对应更新。内部名字需要校验主数据一致性（空除外）。

policy_type

执行政策指定项类型

int

N

1：out_rank_id 外部职级编号
2：employee_number 员工工号
3：employee_phone 员工手机号
4：employee_email 员工邮箱
5：regulation_id 制度ID
指定生效policy_type_value内对应的值，executive_regulation_type=3时生效。

policy_type_value

执行政策指定项

string

N

使用海外手机号时输入格式为 +90 137****0001 ，国内可以不加区号

以下是内部人员字段传输





member_type


int

N

出行人类型
0：手机号，passenger_phone
1：工号；employee_number 必填
2：邮箱：email 必填
默认为0
以 member_type 对应的值为准，其他字段传了不生效

passenger_phone

员工手机号

string

N

使用海外手机号时输入格式为 +90 137****0001 ，国内可以不加区号

employee_number

员工工号

string

N


email

员工邮箱

string

N


以下是外部人员字段传输





member_type

出行人 key 标识

int

N

枚举值数字：
0：手机号，passenger_phone
3: 外部出行人ID，traveler_id
4：外部出行人外部主键, out_traveler_id
以 member_type 对应的值为准，其他字段传了不生效
在passenger_type为1时，member_type可以不传，手机号也可以不传递。

passenger_phone

出行人手机号

string

N

注意：涉及用车品类外部出行人需要给手机号，不传手机号无法下单关联成本中心。

traveler_id

外部出行人 ID

string

N


out_traveler_id

外部出行人外部主键

string

N


card_list

证件信息

[]object

N

内部人员传了，目前不生效。


card_list

字段名

字段说明

字段类型

必填

备注

card_type

证件类型

int

Y

枚举值数字 1. 身份证，2. 护照，3. 港澳台居民居住证，4. 台胞证，5. 军官证，6. 回乡证，7. 外国人永久居留身份证

card_no

证件号码

string

Y

证件号码
注：
1、若采用AES256整体加密，此字段需明文传输，无需单独再加密
2、若不整体加密传输时，此字段只可采用AES128加密传输
3、若采用AES128整体加密，此字段仍需采用AES128单独加密（存在历史客户原因）

expire_date

证件过期日期

string

Y

格式：2050-01-01
注：
1、若采用AES256整体加密，此字段需明文传输，无需单独再加密
2、若不整体加密传输时，此字段只可采用AES128加密传输
3、若采用AES128整体加密，此字段仍需采用AES128单独加密（存在历史客户原因）


out_trip_info

字段名

字段说明

字段类型

必填

备注

begin_time

外部申请单开始时间

int

N

时间戳

end_time

外部申请单结束时间

int

N

时间戳

travel_purpose

出差事由

string

N

滴滴首页卡片合并展示的事由


travel_detail

字段名

字段说明

字段类型

必填

备注

start_date

行程开始时间

date

Y

格式： YYYY-MM-DD

end_date

行程结束时间

date

Y

格式： YYYY-MM-DD

trips

行程信息

list<trip>

N

行程信息；行程使用的制度(regulation_id)中，出差城市配置为无需填写时，trips可为空。否则必传，需按照行程顺序填写 详见 trip

meeting_trip

会议行程信息

详见下方 meeting_trip

N

会议行程信息；当制度(regulation_id)使用的是会议管控的制度时，此字段必传，填写会议城市信息。

start_city_rule

行程起点城市是否包含市内用车权限和酒店

int

N

（0-不包含，1-包含），trips第一行视为起点城市；默认为无市内用车和酒店，不管控和轻度管控不生效
不影响接送机服务

end_city_rule

行程终点城市是否包含市内用车权限和酒店

int

Y

（0-不包含，1-包含），trips最后一行视为终点城市，不管控和轻度管控不生效
不影响接送机服务,中度管控只对市内用车生效。严格管控下，对市内用车和酒店生效

train_total_count

火车票次数

int

N

火车票次数；火车票次数 （不传走默认计算逻辑，传0代表火车票不可用）

flight_total_count

机票次数

int

N

机票次数（不传走默认计算逻辑，传0代表机票不可用，对国内机票、国际机票都生效）

hotel_total_count

酒店总间夜

int

N

酒店总间夜（不传走默认计算逻辑，传0代表酒店不可用，对国内酒店、国际酒店都生效）

pickup_total_count

接送机总次数

int

N

接送机总次数（不传走默认计算逻辑，其他参数代表接送机总次数）

category_control

品类控制开关

[]int

N

品类控制开关；制度有权限时,控制申请单是否创建品类对应服务
3-市内用车；4-火车票服务；6-机票服务；9-接送服务；10-酒店服务；11-国际机票服务，12 国际酒店服务
如果传了机火两个品类。制度上只开了机票品牌。则创建申请单成功，只能使用机票服务
category_control 传空数组会报错 举例：[4,10]，同时传递国内国际机票类别时，需要至少有一段国内城市对，否则报错。


trip

字段名

字段说明

字段类型

必填

备注

departure_address_dimension

出发地维度0：城市(包括县级市) 1：国家；2：省

int

N

出发地址维度，不传默认为0；

departure_country_id

出发国家ID

int

N

出发地址维度为1时必需

departure_country_name

出发国家名称

string

N

出发地址维度为1时必需

departure_province_id

出发省ID

int

N

出发地址维度为2时必需

departure_province_name

出发省名称

string

N

出发地址维度为2时必需

departure_city

出发城市名称

string

N

出发地址维度不传或传0时必需

departure_city_id

滴滴出发城市ID

int

N

出发城市 ID，国际需要使用ID，出发地址维度不传或传0时必需

departure_city_adcode

出发城市行政区划代码

string

N

departure_city_adcode与departure_city_id任选一个传值即可
均传值时，ID优先级更高
仅支持国内行政区划代码，国际依然需要传滴滴ID
支持的国内区划代码请参考民政部官网 http://xzqh.mca.gov.cn/defaultQuery?shengji=%B1%B1%BE%A9%CA%D0%A3%A8%BE%A9%A3%A9&diji=-1&xianji=-1

destination_address_dimension

目的地维度 0：城市(包括县级市) 1：国家 2：省

int

N

目的地址维度，不传默认为0；

destination_country_id

到达国家ID

int

N

目的地址维度为1时必需

destination_country_name

到达国家名称

string

N

目的地址维度为1时必需

destination_province_id

到达省ID

int

N

目的地址维度为2时必需

destination_province_name

到达省名称

string

N

目的地址维度为2时必需

destination_city

到达城市名称

string

N

到达城市名称 ；非轻度管控必传，目的地址维度不传或传0时必需

destination_city_id

滴滴到达城市ID

int

N

到达城市 ID；非轻度管控必传 国际需要使用ID，目的地址维度不传或传0时必需

destination_city_adcode

到达城市行政区划代码

string

N

destination_city_adcode与destination_city_id任选一个传值即可
均传值时，ID优先级更高
仅支持国内行政区划代码，国际依然需要传滴滴ID
支持的国内区划代码请参考民政部官网http://xzqh.mca.gov.cn/defaultQuery?shengji=�����У�����&diji=-1&xianji=-1

start_date

行程段开始时间

date

Y

行程段开始时间
轻度管控模式下，必须与 travel_detail 中的 start_date 相同 举例：2023-01-02

end_date

行程段结束时间

date

Y

行程段结束时间
轻度管控模式下，必须与 travel_detail 中的 end_date 相同 举例：2023-01-14

trip_type

出行方式

string

N

出行方式：0-其他；1-火车 ;2-飞机；支持多个，多个用英文逗号分开（用车酒店默认根据制度配置生效）举例：0,1,2，中度管控按照第一段生效

to_citys

目的城市集合

[]object

N

目的国家、省、城市集合
轻度管控必传，其他模式传了不生效

address_dimension——目的地维度（0:城市 1:国家 2：省）；非必传，不传默认为城市

country_id——国家ID；address_dimension=1时必传

country_name——国家名称；address_dimension=1时必传

province_id——省ID；address_dimension=2时必传

province_name——省名称；address_dimension=2时必传

id——滴滴城市ID；address_dimension不传或传0时，与adcode任选一个传值即可

adcode——城市行政区划代码；address_dimension不传或传0时，与id任选一个传值即可

name——城市名称；address_dimension不传或传0时必传

示例："to_citys": [{"name": "成都市", "adcode": 510100, "address_dimension": 0},{"name": "北京市", "adcode": 110000, "address_dimension": 0}]
"to_citys": [{"province_name": "河南省", "province_id": 410000, "address_dimension": 2}]

is_return

单程/往返

int

N

控制严格管控模式下，滴滴侧是否识别这个trip为往返行程生成返程行程权限
非必传字段，0-单程， 1-往返；默认为单程；
传1后的拆分逻辑为：去程使用trip的传参生成，返程生成规则为：目的地-出发地，end_date-end_date，使用去程的trip_type；
若对去程和返程的交通方式有分别管控诉求，不推荐使用此字段，建议拆成两个trip传输


meeting_trip

字段名

字段说明

字段类型

必填

备注

meeting_city

会议城市

array

N

会议管控必传

 
{
  "meeting_trip": {
        "meeting_city": [
            {
                "city_id": 1,
                "city_adcode": 110000,//city_id（滴滴城市ID）与city_adcode（城市行政区划代码）任选一个传值即可
                "city": "北京"
            },
            {
                "city_id": 2,
                "city_adcode":310000,//city_id（滴滴城市ID）与city_adcode（城市行政区划代码）任选一个传值即可
                "city": "上海"
            }
        ]
    }
}


business_trip_detail （按次数）

字段名

字段说明

字段类型

必填

备注

start_time

开始时间

datetime

Y

开始时间，需要大于等于接口调用当前时间。
如果传年月日时分秒，例如：2025-06-16 12:00:09，将按照传的时间生效
如果传年月日，例如：2025-06-16，将会处理成 2025-06-16 00:00:00

end_time

结束时间

datetime

Y

结束时间，需大于等于开始时间。
如果传年月日时分秒，例如：2025-06-16 12:00:09，将按照传的时间生效
如果传年月日，例如：2025-06-16，将会处理成 2025-06-16 23:59:59

departure_city_id

滴滴出发城市 ID

int

N

出发城市 ID；制度配置需要填写时必填

departure_city_adcode

出发城市行政区划代码

string

N

departure_city_adcode与departure_city_id任选一个传值即可
均传值时，ID优先级更高
支持的国内区划代码请参考民政部官网
http://xzqh.mca.gov.cn/defaultQuery?shengji=����������&diji=-1&xianji=-1

departure_city

出发地城市名称

string

N

出发地城市名称（指定出发地时必填）

destination_city_id

滴滴目的地城市ID

int

N

目的地城市id（指定目的地时必填）

destination_city_adcode

到达城市行政区划代码

string

N

destination_city_adcode与destination_city_id任选一个传值即可
均传值时，ID优先级更高
支持的国内区划代码请参考民政部官网
http://xzqh.mca.gov.cn/defaultQuery?shengji=����������&diji=-1&xianji=-1

destination_city

目的地城市名称

string

N

目的地城市名称（指定目的地时必填）

start_name

出发地名称

string

N

出发地名称（最多50个字）（指定出发地时必填）

start_address

出发地详细地址

string

N

出发地详细地址（最多100个字）（指定出发地时必填）

flat

出发地纬度

float

N

出发地纬度 （指定出发地时必填

flng

出发地经度

float

N

出发地经度 （指定出发地时必填）

end_name

目的地名称

string

N

目的地名称（最多50个字）（指定目的地时必填）

end_address

目的地详细地址

string

N

目的地详细地址（最多100个字）（指定目的地时必填）

tlat

目的地纬度

float

N

目的地纬度（指定目的地时必填）

tlng

目的地经度

float

N

目的地经度（指定目的地时必填）

is_return

是否往返

int

N

是否往返，0-不往返，1-往返，默认为0

trip_times

用车次数

int

Y

用车次数，当is_return为1时，用车次数必须为偶数（去程一次+回程一次
制度配置为无需填写，传了不生效

perorder_money_quota

每单限额

int

N

同一用车申请单下，每个订单的限额。单位:分。
新客户：可以为任意整数
历史客户：需大于100生效，小于 100 为不限。需是 100 的整数倍。可联系滴滴侧调整为新逻辑
注意：1. 制度配置无需填写，但是API又传了金额，以制度配置为准；
2. 制度配置了由员工填写，以API传的金额为准；
3. 制度配置了限制金额，以制度配置为准。

total_money_quota

总限额

int

N

总限额，单位：分。
新客户：可以为任意整数；传“-1”时，代表不限制
历史客户：需大于100生效，小于 100 为不限。需是 100 的整数倍。可联系滴滴侧调整为新逻辑。
注意：
制度配置为无需填写，但是API又传了金额，以制度配置为准

business_trip_detail （按日期）

字段名

字段说明

字段类型

必填

备注

start_time

开始时间

datetime

Y

开始时间，需要大于等于接口调用当前时间。
如果传年月日时分秒，例如：2025-06-16 12:00:09，将按照传的时间生效
如果传年月日，例如：2025-06-16，将会处理成 2025-06-16 00:00:00

end_time

结束时间

datetime

Y

结束时间，需大于等于开始时间。
如果传年月日时分秒，例如：2025-06-16 12:00:09，将按照传的时间生效
如果传年月日，例如：2025-06-16，将会处理成 2025-06-16 23:59:59

trips

用车城市列表

[]object

N

创建规则时如果选择了“由员工填写”则必填
制度配置为无需填写城市时，传了城市列表也不生效
示例：[{ "city_id": 1, "city": "北京" ,“city_adcode”:110000},{ "city_id": 2, "city": "上海",“city_adcode”:310000}]
city_id（滴滴城市ID）与city_adcode（城市行政区划代码）任选一个传值即可

trip_amount

用车金额

int

N

单位：分。
新客户：可以为任意整数；传“-1”时，代表不限制
历史客户：需大于100生效，小于 100 为不限。需是 100 的整数倍。可联系滴滴侧调整为新逻辑。
注意：
制度配置为无需填写，但是API又传了金额，以制度配置为准

trip_times

用车次数

int

N

用车次数，非必传只在制度配置为【由员工填写时】生效不传、传空报错，建议传大于0的整数
若想不限次数可以传负数比如-1

perorder_money_quota

每单限额

int

N

同一用车申请单下，每个订单的限额。单位:分。
新客户：可以为任意整数
历史客户：需大于100生效，小于 100 为不限。需是 100 的整数倍。可联系滴滴侧调整为新逻辑
注意：1. 制度配置无需填写，但是API又传了金额，以制度配置为准；
2. 制度配置了由员工填写，以API传的金额为准；
3. 制度配置了限制金额，以制度配置为准。

car_city_rule

字段名

字段说明

字段类型

必填

备注

rule_type

跨城规则

int

Y

0：不允许跨城
1：允许跨城

intercity_prohibit_scope

不允许跨城的范围

int

N

0：不允许跨地级市
1：不允许跨地级市及区县

当跨城规则=0：不允许跨城时需传值，不传默认为0：不允许跨地级市

allow_intercity_scope

允许跨城的范围

int

N

0：允许单向跨城
1：允许双向跨城
2：允许部分城市双向跨城

当跨城规则=1：允许跨城时需传值，不传默认为0：允许单向跨城

city_pairs

城市对

object

N

允许跨城的范围=2：允许部分城市双向跨城的情况下必传

intercity_judge_source

跨城判断数据来源

int

N

1：员工填写的上下车点
2：员工实际的上下车点

不传默认为1：员工填写的上下车点

city_pairs

字段名

字段说明

字段类型

必填

备注

city_a

a城市

object

Y

需要传城市name、id或国标码city_adcode。

city_b

b城市

object

Y

需要传城市name、id或国标码city_adcode。

示例

✅正确案例1 传id和name

[
    {
      "city_a": {"name": "北京","id": 1},
      "city_b": {"name": "上海","id": 2}
    },
    {
      "city_a": {"name": "广州","id": 3},
      "city_b": {"name": "深圳","id": 4}
    }
]

✅正确案例2 传id和name 或者 city_adcode

[
    {
      "city_a": {"city_adcode": "440100"},
      "city_b": {"city_adcode": "110000"}
    },
    {
      "city_a": {"name": "广州","id": 3},
      "city_b": {"name": "深圳","id": 4}
    }
]

✅正确案例3 传city_adcode

[
   
    {
      "city_a": {"city_adcode": "440100"},
      "city_b": {"city_adcode": "110000"}
    }
]

❎错误示例1 city_a、city_b使用不同的格式

[
    {
      "city_a": {"city_adcode": "440100"}, 
      "city_b": {"name": "深圳","id": 4}
    }
]


请求示例

差旅单

  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",
    "budget_center_list": "[{\"sequence\":4,\"id\":\"1125936653991724\",\"code\":\"3\",\"value\":\"3级部门\"},{\"sequence\":5,\"id\":\"1125936600271495\",\"code\":\"002\",\"value\":\"自动化修改02\"},{\"sequence\":9,\"id\":\"1125936361127392\",\"code\":\"2\",\"value\":\"二级部门\"}]",
    "timestamp":"1690362081530",
    "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\"}",
    "travel_budget": "{\"budget_amount\":2600,\"budget_type\":1,\"budget_share\":[2]}",
    "travel_management": "{\"daily_amount_control\":[{\"daily_amount\":1500,\"control_type\":1,\"control_product\":[1]}]}",
    "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":"1690362702226",
    "passenger_list": "[{\"passenger_type\":1,\"passenger_phone\":\"15201255543\",\"passenger_name\":\"赵利荣\",\"budget_center_list\":[{\"sequence\":4,\"id\":\"1125936653991724\",\"code\":\"3\",\"value\":\"3级部门\"},{\"sequence\":5,\"id\":\"1125936600271495\",\"code\":\"002\",\"value\":\"自动化修改02\"}]},{\"passenger_type\":0,\"passenger_phone\":\"00016237918\",\"passenger_name\":\"初管7918\",\"budget_center_list\":[{\"sequence\":9,\"id\":\"1125936361127392\",\"code\":\"2\",\"value\":\"二级部门\"}]}]" 
}'

行前按次数

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":"1690255082134"
}'

行前按日期

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
}'

行前按日期 - 含用车跨城规则

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\"}",
    "car_city_rule": "{\"allow_intercity_scope\":2,\"rule_type\":1,\"city_pairs\":[{\"city_a\":{\"city_adcode\":\"440100\"},\"city_b\":{\"city_adcode\":\"110000\"}}]}",
    "sign":"88fda0fa7fd4aae80de7e412c04ddc58",
    "client_id":"87fca1dc60c9de0a96c20fccf2ccaa40_test",
    "sign_key":"f86b6735313052FD7d0f",
    "timestamp":1690363131
}'

响应参数


响应示例

正常示例

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

}

异常示例


错误码

通用错误解决方案

错误码

描述

50503

申请单创建失败

50506

外部申请单号重复

版本记录


日期

更新人

更新内容

上线时间

2023.10.30

陈继诗

增加字段：out_trip_id，out_trip_info

2024.01.10

2023.11.10

陈继诗

请求增加name与out_budget_id使用方法

2024.01.04

2024.01.12

陈继诗

增加meeting_trip

2024.01.12

2024.01.29

陈继诗

增加category_control枚举值，机票，酒店管控次数描述，城市ID描述

2024.01.29

2024.04.23

陈继诗

外部人员支持无手机号传输

2024.05.14

2024.05.31

陈继诗

修改regulation_id为非必填。增加policy_type，policy_type_value字段

2024.06.18

2024.08.28

陈继诗

新增加budget_center_list字段使用逻辑。影响历史budget_center_id和extend_field_list

2024.09.20

2024.09.20

陈继诗

新增travel_budget,差旅市内用车和接送场景

2024.09.24

2024.09.27

陈继诗

travel_budget,支持机酒火


2024.12.10

陈继诗

按日期tripamount 描述修改

2024.12.10

2024.12.27

高洋洋

增加差旅管控字段：travel_management

2024.01.02

2025.06.26

唐腾飞

出行人信息内增加policy_type，policy_type_value

2025.06.26

2025.07.01

唐腾飞

passenger_list 增加字段：passenger_english_surname、passenger_english_name、card_list

2025.07.01

2025.07.11

王亚兰

trip增加字段：departure_address_dimension、departure_country_id、departure_country_name、departure_province_id、departure_province_name、destination_address_dimension、destination_country_id、destination_country_name、destination_province_id、destination_province_name ；trip更新字段：departure_city、departure_city_id、to_citys；

2025.07.11

2025.08.25

高洋洋

travel_management字段描述补充

2025.08.25

2025.08.29

高洋洋

外部出行人外部主键支持

2025.08.29

2025.11.19

谢朱莉

更改出行人限制
城市名称支持县级市名称

2025.11.19

2025.11.26

谢朱莉

城市支持传行政区划编码
行前审批支持传日期

2025.11.21

2025.12.17

陈权

增加用车跨城规则

2025.12.19

2026.3.19

谢朱莉

增加用车限额、总限额支持小数点，以及传-1代表不限的逻辑

2026.3.18