滴滴实施指引

滴滴实施指引

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、对接的接口

2、实施步骤

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