【实施指导方案】美亚实施指引

1、 美亚商旅对接流程

• 业务流程一

• 业务流程二

2、 星瀚与美亚商旅功能对接的模式

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

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

4、 开放第三方应用

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

5、 星瀚与美亚集成的服务商配置

（1） 路径：

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

（2） 配置字段的说明：

• 如果美亚只提供一套公司账号，那么美亚服务商设置界面的“多公司账号”不开启，美亚提供的“企业id”，“统一key”、接口专用账号的真实工号、真实姓名分别填入到服务商设置的“公司id”、“接入appkey”、“自定义字段1”和“自定义字段2”中，如下图：

• 如果美亚只提供一套公司账号，那么美亚服务商设置界面的“多公司账号”需要开启，美亚提供的“企业id”，“统一key”、接口专用账号的真实工号、真实姓名分别填入到服务商设置的商旅账户设置中的“公司id”、“秘钥”、“接口对接工号”和“真实姓名”中，同时需要选择与该账号对应的核算组织，可以支持多个核算组织映射美亚的一套公司秘钥，如下图：

• 美亚提供信息示意截图

• 服务商设置相关字段说明
  

（3） 美亚提供信息的样式如下：

（4） 美亚服务商设置截图样例

6、 防火墙配置

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

7、 网络检查

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

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

8、 试点单位维护

商旅上线时，如果只需要某几个部门或者某几家公司先上线运行，可以在【应用-员工服务云-费用查询-报销设置-试点单位维护】功能里面进行设置某些公司和部门先试点。

9、 美亚商旅人员同步

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

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

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

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

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

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

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

（6） 人员同步的字段映射逻辑

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

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

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

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

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

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

10、 出差申请单同步

出差申请单同步逻辑

• 如果申请人在白名单中，提交时，将通过新增接口同步给美亚，撤销、审批不通过时，通过“出差申请单撤销、关闭接口”接口同步给美亚（状态为取消），（判断美亚商旅存不存在订单，存在不允许撤销）

• 审核通过新增接口同步给美亚（白名单人员在提交时已经同步过，不能再同步，否则会报错），关闭时同步“出差申请单撤销、关闭接口”同步给美亚时（状态为结束），反关闭时通过“出差申请单撤销、关闭接口”同步给美亚（状态为生效）

• 反审核、变更时先判断出差申请单是否存在美亚订单，存在则提示已存在订单不能进行反审核或者变更操作。如果不存在美亚订单，则通过 “出差申请单撤销、关闭接口”同步取消状态，撤销变更则同步生效状态

• 出差申请单通过新增接口将数据同步给美亚后，美亚将返回美亚的出差申请单号，需在“商旅集成关联数据映射”表中存入一条数据，存入的字段有商旅服务商：美亚商旅、数据类型：出差申请单、内部数据编号：本系统出差申请单号、外部数据id：美亚返回的出差申请单号、创建时间、修改时间（覆盖）

• 由于美亚的出差申请单同步接口有两个，一个是“新增接口”，一个是“出差申请单撤销、关闭接口”，并且同步过的数据还不能反复同步，因此目前商旅集成工具只支持已提交和审核通过的单据同步

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

字段映射逻辑：

11、 开票设置

检查美亚的开票设置，一般设置如下，具体需要跟美亚顾问进行沟通

12、 美亚单点登录

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

（2）移动端单点登录

（3）如果存在领