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）如果存在领导不需要出差申请单单控制预订，那么可以通过“商旅预订控制方式”来设置预订模式

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

（1） 商旅集成设置中有参数“order_status_control”控制订单的报销。    

order_status_control：出差申请单关联生成差旅费报销单时，商旅订单状态是否严控， 1为严控，严控时会校验订单的使用状态或者订单状态，0为不严控，不严控情况下如果订单状态满足条件或者订单的出发时间/离店时间/用车时间大于当前系统日期也能报销。

（2） 当“order_status_control”为1时，出差申请单关联生成差旅费报销单时，会校验订单的使用状态，只有出差申请单对应的订单都是已经实际完成了，才能进行报销。如果不符合条件不能进行报销。控制逻辑如下：

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

（3）当“order_status_control”为0时，订单状态满足条件或者订单的出发时间/离店时间/用车时间大于当前系统日期也能报销。（这种不强控的，有可能订单根本没使用就报销了，也有可能，订单退订了，退订的数据还没回来，就报销了，导致漏报）

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

机票的税额：（票价+燃油附加）*开票设置（行程单）可抵扣税率/（1+可抵扣税率）+服务费*开票设置（国内机票-服务费）可抵扣税率/（1+可抵扣税率）。

（order_status_control为1时：已退订的机票订单，原始单和退订单票价税额都为0）

（order_status_control为0时：已退订的机票订单，原始单的税额为正数退订单票价税额都为负数）

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

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

火车票：

当火车票订单状态为“已出票”、“已改签”、“已退票”时，火车票月结订单生成费用分录需要计算明细的可抵扣税额、税额。

a、 火车票税额/可抵扣税额=票面价格*开票设置（国内火车-票价）可抵扣税率/（1+可抵扣税率）+服务费*开票设置（国内火车-服务费）可抵扣税率/（1+可抵扣税率）。

b、报销金额=订单金额、不含税金额=订单金额-税额，税率为空

c、“是否可抵扣”只要票价或者服务费有一项可抵扣，则为可抵扣。

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

（6） 差旅费报销单审核通过时，反写订单和结算单的“是否审批通过”字段，结算单和订单对平时，将订单的“是否审批通过”赋值给结算单。

14、 开票、结算、付款

在结算数据确认之后，可以开票结算。根据目前正在使用的客户分析，开票有两种控制模式，A模式无须报销完毕，直接进行开票付款，B模式必须报销之后才进行开票付款，两种模式的优劣如下：

A.不论订单是否报销，直接开票付款

优点：结算流程非常清晰，每月与商旅平台的账单都能核对上缺点：在出差申请单就必须确认清楚费用承担公司，后续不支持修改

B.必须报销后，再进行开票和付款

优点：如果发起差旅报销时填写有误，可在开票付款时纠正费用承担公司，以费用承担公司为准。

缺点：必须报销完成之后才进行结算，每月的开票结算账单和商旅平台核对不上，

很容易造成数据的混乱，商旅平台一般也不接受先报销后开票付款的模式。

在A模式下，财务在商旅平台直接开票或线下开票：

结算单生成付款申请单，在付款申请单界面导入发票，审核后

生成凭证和付款单付款（费用在商旅付款申请单入账）。

商旅付款申请单生成凭证

借：费用

进项税

                 贷：其他应付款-商旅公司

付款单生成凭证：

借：其他应付款-商旅公司

                 贷：银行存款

费用在差旅费报销单入账：

 差旅费报销单生成凭证：

  借：费用

      待抵扣进项税（中转）

    贷：其他应付款-XX商旅平台-XX人员

商旅付款申请单生成凭证

借：待抵扣进项税—从发票取值

 贷：待抵扣进项税（中转）--从结算明细取值