【实施指导方案】阿里商旅实施指引

1、 阿里商旅对接流程

• 流程一：
  

• 流程二：

2、 星瀚与阿里商旅功能对接的模式

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

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

4、 开放第三方应用

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

5、 星瀚与阿里集成的服务商配置

•  路径：

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

• 配置字段的说明：

•  截图

6、 防火墙配置

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

7、 网络检查

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

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

8、 组织同步

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

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

（3） 商旅集成工具，选择具体的核算主体，可同步组织

（4） 阿里商旅组织同步：

阿里的组织同步接口，目前只能支持新增，不支持修改（后续阿里考虑该接口支持修改），对于具体项目可以通过商旅工具的组织同步对应的核算主体过去即可（核算主体数量一般比较少）。

（5）阿里商旅同步的组织是核算主体

先从业务单元表里面查询核算实体数据，判断组织的创建时间，如果创建时间大于等于时间戳则同步，创建时间戳小于时间戳则不同步 。商旅工具中-选择组织同步不判断时间戳，只要能选择到的数据，即可同步

接口字段映射如下：

9、 阿里人员同步

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

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

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

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

（5） 阿里商旅接口字段的内容如下：

（6） 星瀚同步人员至阿里商旅的映射关系如下：

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

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

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

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

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

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

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

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

atrip_personnel_rank:参数值默认为2。为1时：进行阿里人员同步时，其职级传员工部门所在的申请人公司的“组织编码+报销级别”，如报销级别为空，则不进行传值；为2时：进行阿里人员同步时，只传“报销级别”，如报销级别为空，则不进行传值；为3时：进行阿里人员同步时，其职级传员工部门所在的申请人公司的“组织编码+报销级别”，如报销级别为空，则默认传员工部门所在的申请人公司的“组织编码+普通员工”给阿里；为4时：进行阿里人员同步时，只传“报销级别”，如报销级别为空，则默认传“普通员工”值给阿里；为5时：进行阿里人员同步时，其职级传员工部门所在的申请人公司的“组织编码+报销级别”，如职报销级别为空，则默认只传“普通员工”给到阿里。

10、 出差申请单同步

（1） 出差申请单同步逻辑

• 出差申请单同步阿里逻辑： ：如果申请人在白名单中，提交时，将审批单同步给阿里（状态为已同意），撤销时，同步给阿里（状态为撤销），审批不通过，同步给阿里（状态为已撤销）

• 审核通过同步给阿里时（状态为已同意），关闭时同步给阿里时（状态为撤销），反关闭同步给阿里时（状态为已同意）

• 变更时同步给阿里状态为已撤销，撤销变更，同步给阿里，状态为已同意

（2） 同步逻辑以及映射：

11、 开票设置

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

12、 阿里单点登录

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

（2）移动端单点登录

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

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

（1） 出差申请单关联生成差旅费报销单时，会校验订单的使用状态，只有出差申请单对应的订单都是已经实际完成了，才能