【实施指导方案】同程商旅实施指引

1、 同程商旅对接流程

• 业务流程一
  

• 业务流程二

2、 星瀚与同程商旅功能对接的模式

3、 配置同程商旅推送订单、结算单、月结账单的推送地址

 路径：开放服务云-OpenAPI- API文档，在左树“财务云-费用核算-未命名”路径下打开“费用-商旅集成（预置）”文档，将该文档上的“请求URL”地址提供给商旅平台，该地址为商旅平台推送订单、结算、月结账单的地址。

4、 开放第三方应用

路径：开放服务云-OpenAPI-安全策略-第三方应用，新增一个第三方应用，需要启用代理用户控制，创建完成后，将系统编码，代理用户工号、秘钥给到商旅平台。（注意每个商旅平台需要单独创建）

5、 星瀚与同程集成的服务商配置

（1） 路径：

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

（2）配置字段的说明：

（3）同程提供信息的样式如下：

（4） 同程服务商设置截图样例

6、 防火墙配置

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

7、 网络检查

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

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

8、 同程商旅人员同步

（1）人员同步支持管理员统一同步和员工授权同步。管理员统一同步的模式需要再实施阶段先统一同步人员，或许再通过调度计划或者服务商设置中的“同步人员”按钮，同步增量人员。员工授权同步，需要在服务商设置中，开启“员工授权再同步人员”，并编写“员工授权界面内容”，该模式的好处，不需要管理员统一同步人员

（2）【应用-员工服务云-费用查询-商旅设置-服务商设置】点击人员同步

（3） 【应用-系统服务云-调度中心-调度计划】执行调度计划，可同步人员

（4） 商旅集成工具，选择具体的人员，可同步人员

（5） 取数逻辑：从人员表里面取数

• 先从员工表里面获取数据，员工类型是“职员”才同步，非职员不同步；

• 判断人员的最后修改时间是否大于最后人员同步时间，如果大于则同步，小于则不同步

（6） 如果只想同步一两个人员进行测试怎么处理？

费用核算-商旅设置-商旅集成工具中可选择一个或者多个人员同步

（7）如果只想同步某几个部门的人员怎么处理。

服务商设置中，人员同步方式选择“部分组织人员同步”，“人员同步组织”信息块，添加具体的部门

（8）同程人员同步直接需要关注商旅集成设置中的参数dttrip_personnel_rank （职级是阿里设置差标的关键字段，需要和同程确认好之后设置）

dttrip_personnel_rank:参数值默认为4。为1时：进行同程人员同步时，其职级名称“positionLevelName”默认传“员工主职位所在的申请人公司的组织编码-对应的报销级别编码”，如报销级别为空，则职级名称传值为空。为2时：人员同步时，其职级名称“positionLevelName”默认传“员工在主职位所在公司的报销级别的编码”，如报销级别为空，则职级名称传值为空。为3时：人员同步时，其职级名称“positionLevelName”默认传“员工主职位所在的申请人公司的组织编码-对应的报销级别编码”，如报销级别为空，则默认传“员工主职位所在的申请人公司的组织编码-普通员工对应的编码”。为4时：人员同步时，其职级名称“positionLevelName”默认传“员工在主职位所在公司的报销级别的编码”，如报销级别为空，则默认传“普通员工对应的编码”。为5时：人员同步时，其职级名称“positionLevelName”默认传“员工主职位所在的申请人公司的组织编码-对应的报销级别编码”，如报销级别为空，则默认传“普通员工对应的编码”。

9、 出差申请单同步

出差申请单同步逻辑

• 如果申请人在白名单中，则提交后将出差申请单同步给同程（入参“差旅单状态”=“通过”），废弃、撤销或审核未通过时，需再次调用该接口同步给同程（入参“差旅单状态”=“作废”）。

• 出差申请单审核通过后同步给同程（入参“差旅单状态”=“通过”），反审核、关闭或变更行程成功后，需再次调用该接口同步给同程（入参“差旅单状态”=“作废”）。

• 如需只有某几个部门/公司同步出差申请单，可在服务商设置中进行配置。（如只有A公司同步出差申请单，可在“申请单同步方式”中添加一条数据，组织为公司即可）

10、 用车申请单同步

用车申请单同步逻辑

• 如果系统参数“用车审批单在提交时同步商旅平台”为“是”，则提交后将用车申请单同步至同程（入参“差旅单状态”=“通过”），撤销、或审核未通过时，需再次调用该接口同步给同程（入参“差旅单状态”=“作废”）。

• 如果系统参数“用车审批单在提交时同步商旅平台”为“否”，则用车申请单审核通过后同步给同程（入参“差旅单状态”=“通过”），反审核成功后，需再次调用该接口同步给同程（入参“差旅单状态”=“作废”）。

• 如需只有某几个部门/公司同步用车申请单，可在服务商设置中进行配置。（如只有A公司同步用车申请单，可在“申请单同步方式”中添加一条数据，组织为公司即可）

11、 开票设置

检查同程的开票设置，一般设置如下，具体需要跟同程进行沟通

12、 同程单点登录

（1）PC端单点登录，【应用-员工服务云-人人差旅-我的单据-出差申请单】

（2）移动端单点登录

（3）如果存在领导不需要出差申请单单控制预订，那么可以通过“商旅预订控制方式”来设置预订模式

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

（1） 出差申请单关联生成差旅费报