滴滴实施指引

栏目：云星瀚知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

滴滴实施指引

1、对接的接口

2、实施步骤

1、找滴滴获取服务商配置信息、后台管理地址、管理员账号和密码

2、商旅设置-服务商配置，配置滴滴连接信息

3、防火墙检查

4、网络检查

5、参数设置

6、开票设置

7、组织同步

8、人员同步

9、商旅城市更新

10、滴滴配置标准控制，星瀚获取用车制度（要求每个人名下最多只能能有一个差旅标准、一条行前审批-按次数、一条行前审批-按日期控制的标准）--滴滴实施人员配置。

11、行程管控

12、出差申请单同步

13、用车申请单同步

14、滴滴单点登录预订

15、滴滴订单获取

16、结算单获取以及账单确认

17、出差申请单关联生成差旅报销单

18、报销、结算、付款

3、星瀚与滴滴集成的服务商配置

路径：

【应用-员工服务员-费用查询-商旅设置-服务商设置】

配置字段的说明：

字段名称	字段内容说明
编码	固定: DIDI,不可修改
服务商	固定：滴滴，不可修改
租户ID	苍穹为客户分配的租户ID,自动获取，不可修改
账套ID	数据库的账套ID,自动获取不可修改
服务商关联	滴滴对应的供应商基础数据，用于商旅结算单关联生成商旅付款申请时获取付款账号等数据
接入appkey	滴滴分配给客户公司的接入账号，由滴滴提供
接入app秘钥	滴滴分配给客户公司的接入密码，由滴滴提供
公司id	接入服务商客户公司ID，由滴滴提供
自定义字段1	在滴滴系统申请，客户账户管理应用Sign Key参数；
自定义字段2	在滴滴系统申请，客户账户管理应用Phone参数；
最后差量同步订单时间戳	默认是1900-00-00，订单通过定时任务获取时，获取的时间范围为该时间戳到系统当前时间
最后差量同步组织时间戳	默认1900-000-00，组织同步时，数据的范围为该时间戳到系统当前时间
最后差量同步人员时间戳	默认1900-00-00，人员同步时，数据的范围为该时间戳到系统当前时间

滴滴提供的接口信息如下图：

服务商设置页面图

4、星瀚与滴滴功能对接的模式

功能点	对接模式
组织同步	星瀚调用滴滴的接口，通过手工或者定时任务的方式，将组织同步至滴滴
人员	星瀚调用滴滴接口，将人员同步至滴滴
出差制度获取	星瀚调用滴滴接口，通过点击按钮手工获取的方式将出差用车制度同步至星瀚系统
出差申请单	星瀚调用滴滴接口，审核通过时，将单据同步至滴滴
移动单点	从移动端免密登录滴滴 (H5)
订单获取	星瀚调用滴滴接口，获取滴滴订单
结算单获取	通过点击按钮手工获取的方式获取滴滴结算数据
开票申请及发票获取	星瀚将开票申请推送给滴滴，滴滴收到信息后进行开票，后面由星瀚再自动拉取开票的结构化数据（该步骤可不实施，由客户账单确认之后，滴滴方直接开票）

5、防火墙配置

1、对于不同的星瀚环境，如果环境开启了防火墙，需要把对应的服务商的ip加入到防火墙的白名单中，允许服务商可以访问苍穹服务

2、需要将服务商将的ip地址加入到白名单中

6、网络检查

在配置完成之后，需要用wget命令检查滴滴地址的网络是否有问题。具体的方法见云社区文档：

https://vip.kingdee.com/questions/97264334077562624/answers/97264334195003136

7、参数配置

1、路径：费用查询/费用核算-商旅设置-商旅集成设置

根据业务的情况进行参数配置

trip_sync_orderbill_isverify_mustinput：设置为false。

同时需要注意如下4个参数的设置：

dtrip_orderbill_startdate

dtrip_orderbill_enddate

budget_center_id

dtrip_use_company_money

3、配置工具-参数设置-系统参数

需根据客户业务流程关注商旅设置参数，如下图

8、开票设置

路径：费用查询/费用核算-商旅设置-开票设置，配置滴滴开票信息（主要用于结算单获取时税额的计算，出差申请单关联生成报销单，带出订单税额的计算）

9、组织同步

1. 在[费用核算-服务商设置]功能中,选择服务商“滴滴出行”数据, 点击同步组织按钮.将组织信息分批次同步到滴滴系统.

2. 同步成功后, 将当前同步成功的时间写入在“滴滴出行”的服务商详情页面显示“最后差量同步组织时间戳”：

3. 可以通过调度任务，将组织同步至滴滴

4. 可通过商旅工具同步某一个组织给滴滴

5. 组织同步逻辑如下:

组织同步前，请注意参数“费用核算-商旅设置-商旅集成设置”中的参数budget_center_id，一般来说，参数设置为1即可。如果客户的核算组织不在行政组织中，并且需要按照核算组织出账单，那么该参数需要设置为3，组织同步时，也是同步核算组织

a) 组织新增

i. 组织同步时，从组织结构表中获取行政组织（或者核算组织），且创建时间大于服务商设置里的“最后差量同步组织时间戳”，且不封存的组织数据。

ii. 新增同步滴滴组织数据如下：

	序号	要求	字段名称“”	字段描述	数据类型	苍穹对应字段
1.	必填	name	组织名称	String	行政组织或核算组织的名称
2.	必填	out_budget_id	组织id	String	行政组织或核算组织的id

iii. 同步成功后，获取接收新增组织接口对应返回的滴滴侧组织ID，找到对应的组织关系，并将数据存储到商旅集成数据映射表中。

b) 组织修改

i. 从组织结构表中获取行政组织（或核算组织），且创建时间小于“最后差量同步组织时间戳”，修改时间大于“最后差量同步组织时间戳”，且不封存的组织数据

ii. 修改同步滴滴组织数据如下

	序号	要求	字段名称“”	字段描述	数据类型	苍穹对应字段
1.	必填	id	滴滴侧组织id	String	商旅集成数据映射表中滴滴组织的外部数据id
2.	选填	name	组织名称	String	行政组织的名称
3.	必填	out_budget_id	组织id	String	行政组织的id

10、人员同步

1、人员同步之前需要确保对应的组织已经同步

2、【应用-员工服务云-费用查询-商旅设置-服务商设置】，选择滴滴，点击人员同步

4、同步功能逻辑：

1、【费用核算-商旅设置-服务商设置】功能中,选择服务商“滴滴出行”数据时, 点击同步人员按钮.将人员信息分批次同步到滴滴系统.

2、同步成功后, 将当前同步成功的时间写入在“滴滴”的服务商详情页面显示“最后差量同步人员时间戳”.

3、调度计划可定时同步人员,频率每天23:00执行. 从人员差量表获取“当前时间戳-最后差量同步时间戳”的人员信息, 进行人员信息差量同步. 定时任务默认禁用。

5、人员同步的数据逻辑

人员新增接口：

• 首次从人员表中全量同步使用状态为启用的数据

• 差量同步时，从人员差量表中，获取变更类型是“1”新增, “5”启用时，且人员修改时间大于当前人员最后差量同步时间戳的数据

• 同步滴滴数据如下

	序号	要求	字段名称“”	字段描述	数据类型	苍穹对应字段
1.	必填	phone	员工手机号	String	手机号
2.	必填	realname	员工姓名	String	员工姓名
3.	选填	employee_number	员工工号）(最多32个字符)	String	员工工号
4.	必填	budget_center_id	员工所在部门id	bigint	商旅集成数据映射表中滴滴组织的外部数据id
5.	非必填	use_company_money	是否企业支付余额（0-否，1-是）	int	根据商旅集成参数控制传0或者1，如果开启月结，需要传1
6.	非必填	is_remark	叫车时备注信息是否必填(0-选填，1-必填，2-按制度填写)	Int	传2

同步成功后，获取接收新增人员接口对应返回的滴滴侧人员ID，找到对应的组织关系，并将数据存储到商旅集成数据映射表中。

人员修改接口

• 差量同步时，从人员差量表中，获取变更类型是“2”修改时，且人员修改时间大于当前人员最后差量同步时间戳的数据

• 同步滴滴数据如下：

	序号	要求	字段名称“”	字段描述	数据类型	苍穹对应字段
7.	必填	phone	员工手机号	String	手机号
8.	必填	realname	员工姓名	String	员工姓名
9.	选填	employee_number	员工工号）(最多32个字符)	String	员工工号
10.	必填	member_id	员工在滴滴企业的ID（同员工新增接口中返回的id）	bigint	商旅集成数据映射表中滴滴人员的外部数据id
11.	非必填	use_company_money	是否企业支付余额（0-否，1-是）	int	根据商旅集成参数控制传0或者1，如果开启月结，需要传1
12.	非必填	is_remark	叫车时备注信息是否必填(0-选填，1-必填，2-按制度填写)	Int	传2

人员删除接口

• 差量同步时，从人员差量表中，获取变更类型是“3”删除，“4”禁用时，且人员修改时间大于当前人员最后差量同步时间戳的数据

• 同步滴滴数据如下：

	序号	要求	字段名称“”	字段描述	数据类型	苍穹对应字段
1.	必填	member_id	员工在滴滴企业的ID（同员工新增接口中返回的id）	bigint	商旅集成数据映射表中滴滴人员的外部数据id

11、商旅城市获取

1、【费用核算/费用查询-商旅设置-商旅城市更新】点击“更新商旅城市信息”按钮。

2、根据滴滴侧城市接口中的地级市城市名称与行政区划中的城市名称匹配.匹配规则：

如果滴滴城市是以"市"结尾,则去掉市，且滴滴地级市名称等于行政区划名称且只有一条匹配数据，则匹配成功

如果滴滴城市是以"自治州"结尾,且滴滴城市名称包含行政区划名称且只有一条匹配数据，则匹配成功

如果以上二者都不是，且滴滴城市名称包含行政区划名称且只有一条匹配数据，则匹配成功，否则不进行匹配

12、出差制度获取

差旅用车制度，管理员需在滴滴后台系统事先配置好，且在滴滴后台进行人员与用车制度的匹配，与苍穹商旅系统和滴滴集成使用的客户沟通确认，用车制度只能配置差旅场景用车、行前审批-按次数、行前审批-按日期，且每位员工只能配置一条差旅用车制度、一条行前审批-按次数、一条行前审批-按日期的制度。出差申请单对应差旅用车制度，日常用车申请-公务出行场景对应行前审批-按次数，日常用车申请-节假日用车对应行前审批-按日期制度。

1．滴滴创建好用车制度后，【服务商设置-滴滴-进入配置页面】，点击更新用车制度，获取滴滴创建的用车制度

2．滴滴创建好用车制度后，【服务商设置-滴滴-进入配置页面】，点击查看用车制度，进入用车制度列表页面

13、出差申请单同步

1. 出差申请单审核通过出差单新增同步。如果存在商旅免审白名单，则在提交进行新增同步

a) 新增同步接口：https://api.es.xiaojukeji.com/river/Approval/create

b) 出差申请单新增同步字段如下:

2. 出差申请单审核不通过,反审核,撤销,废弃进行取消出差单同步. 如果存在商旅免审白名单，则在撤销、废弃进行取消同步

a) 取消同步接口：https://api.es.xiaojukeji.com/river/Approval/ cancel

b) 差申请单取消同步字段如下:

	序号	要求	字段名称“”	字段描述	数据类型	苍穹对应字段
1.	必填	approval_id	滴滴内部审批单ID	String	出差申请单外部系统id

14、行程管控

1、【费用查询-商旅设置-行程管控设置】可设置行程管控

2、行程管控可设置的范围：

（1）目前可支持设置行程起点是否包含市内用车，行程终点是否包含市内用车。

15、用车申请单

对于公务出行需要审批的场景，员工可进行用车申请，审核通过时，同步给滴滴，员工可在滴滴进行预订。

用车申请同步给滴滴的字段映射如下：

16、滴滴单点登录

1、移动端单点登录，单点直接跳转滴滴预订，也可以安装滴滴企业版进行预订。

17、滴滴订单获取

1、滴滴订单获取：

通过定时任务，自动获取滴滴订单。

18、结算单获取以及账单确认

1、通过月结账单列表，点击获取账单，选择服务商为“滴滴”以及期间，获取对应部门的账单，如果部门不填写，则获取所有部门的账单以及对应的结算明细。

2、财务人员确认数据无误后，点击账单确认按钮，进行账单确认。

19、出差申请单关联生成差旅费报销单

1、出差申请单关联生成差旅费报销单时，会校验订单的使用状态，只有出差申请单对应的订单都是已经实际完成了，才能进行报销。如果不符合条件不能进行报销。

2、出差申请单关联生成差旅费报销单已使用的判断标准：

服务类型	供应商	控制逻辑
用车	滴滴	（orderstatus）已成交、已取消、已退款、部分退款

3、出差申请单关联生成差旅费报销单，差旅明细展示订单的金额取值逻辑

用车车的税额：（订单总额-服务费）*开票设置（国内用车-票价）可抵扣税率/（1+可抵扣税率）+服务费*开票设置（国内用车-服务费）可抵扣税率/（1+可抵扣税率）。

4、差旅报销单提交时反写订单以及对应的结算单（如果结算单存在）是否报销状态为“是”，撤销、废弃、审批不通过、反审核需要撤回否报销状态为“否”。结算单和订单对平时，同步订单的“是否报销”字段给结算单。

5、差旅费报销单反写订单费用承担部门和费用承担公司。

---根据参数控制trip_org_writeback_order控制。当参数为“0”时，差旅费报销单提交、审核时不反写对应订单和结算单的费用承担部门和公司；订单和结算单对平时，订单的费用承担部门和公司不赋值给结算的费用承担部门和公司；当参数为“1”时，差旅费报销单提交、审核时反写对应订单和结算单的费用承担部门和公司，订单和结算单对平时，订单的费用承担部门和公司赋值给结算的费用承担部门和公司；当参数为“2”时，卡片式差旅报销单，行程分录的费用承担部门和公司反写订单和结算单的费用承担部门和公司，表格式差旅报销单，报销明细的费用承担部门和公司反写订单和结算单的费用承担部门和公司；订单和结算单对平时，订单的费用承担部门和公司赋值给结算的费用承担部门和公司；