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） 出差申请单关联生成差旅费报销单时，会校验订单的使用状态，只有出差申请单对应的订单都是已经实际完成了，才能进行报销。如果不符合条件不能进行报销。

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

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

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

（已退订的机票订单，原始单和退订单票价税额都为0

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

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

火车票：

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

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

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

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

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

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

14、 开票、结算、付款

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

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

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

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

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

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

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

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

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

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

商旅付款申请单生成凭证

借：费用

     进项税

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

付款单生成凭证：

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

       贷：银行存款

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

 差旅费报销单生成凭证：

  借：费用

        待抵扣进项税（中转）

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

商旅付款申请单生成凭证

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

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

     费用科目-通过凭证的试算平衡产生金额

付款单生成凭证：

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

      贷：银行存款