携程实施指引

1  星瀚与携程集成的服务商配置

 路径：

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

 配置字段的说明：

 截图

2、 星瀚与携程功能对接的模式

3、 携程推送地址的配置

联系商旅服务商实施人员，知会他们配置订单状态同步的接口地址。

以苍穹分支环境为例，苍穹地址为https://ierp.kingdee.com:2024/devbiz / ，账套 ID12365489756423 

那么配置的地址如下：

https://ierp.kingdee.com:2024/devbiz / api/ tripsi /syncOrder.do ? portal=12365489756423 & service= XIECHENG

4、 防火墙配置

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

2、 需要将服务商将苍穹的ip地址加入到白名单中

5、 网络检查

在配置完成之后，需要用wget命令检查携程地址的网络是否有问题。 具体的方法见云社区文档：https://vip.kingdee.com/questions/97264334077562624/answers/97264334195003136

6、 主子账户配置

1、corpID、主账户、子账户、关联组织说明

举例：如下图一个集团的层级结构，从集团的层级对应一个CorpID,就是携程为租户提供的唯一性标识，也就是服务商设置中的systemID。集团层级下有子公司A、子公司B、子公司C,可以多个子公司对应一个主账户，也可以一个子公司对应一个主账户，用于客户与携程进行结算和开票。子账户是携程用于员工使用流程控制的账户，比如有些员工是必须有出差申请才能预订，有些员工可以无申请预订等，目前只支持必须要有出差申请才能预订。

2、【应用-员工服务云-费用查询-商旅设置-服务商设置】点击预置的携程的数据，点击主/子账户设置

（2）主子账户设置的界面如下：

（3） 子账户生成逻辑：

比如星瀚的组织结构如下：

携程与客户方定的主账户与组织、子账户的关系如下：

在生成时，系统会按照第1条设置将集团及以下所有节点上的人员的子账户设置为审批预订01，然后再按照第2条设置将子公司A及以下所有节点上的人员的子账户设置为审批预订02，然后再按照第3条设置将子公司C及以下所有节点上的人员的子账户设置为审批预订03. 在逻辑下子公司A的一个人，在第1条设置下的子账户会被设置为审批预订01,在第2条设置执行，会被设置为审批预订02，因此在进行主子账户设置时，请一定要保证层次结构在上组织其顺序也在前，可以通过分录左上角的上移、下移调整顺序

（4） 子账户修改：

在生成人员子账户后，如果需要对单独的几个进行修改，可通过职员名称链接打开，修改子账户，保存

备注

1、由携程实施与客户确定主账户、关联组织（行政组织）、子账户的关联关系。

2、与对应客户的携程实施沟通，确定关联关系表，维护进主/子账户设置表中

3、点击生成携程子账户，即可查询生成的携程子账户与人员绑定是否正确

7、 携程人员同步（人员同步前需先设置主子账户）：

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

2、同步的字段包括：员工工号、姓名、手机号、邮箱、子账户、报销级别、部门名称，是否在职（Valid）。

{

    "AuthenticationInfoList":[

        {

            "Authentication":{

                "Dept1":"市场部",

                "Email":"",

                "Valid":"A",

                "SubAccountName":"nonxxx_提前审批_提前审批",

                "EmployeeID":"2016100030",

                "RankName":"其他员工",

                "MobilePhone":"18320903365",

                "Name":"张春"

            },

            "Sequence":202108202300143370

        }

    ],

    "Ticket":"611fc37d1c47b0e415d6a9ae9",

    "Language":null,

    "CorporationID":"xxxxx",

    "Appkey":"xxxxxx"

}

3、逻辑：从人员变更（t_sec_userchange）表里面取数

（1）先从员工差量表里面获取数据

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

（3）如果变动类型ftype=1为新增，ftype=2为修改，type=3为删除，ftype=4为禁用，fype=5为启用，当type=1、2、5，将人员同步接口中的valid设置为A,ftype =3、4，valid设置为I离职。

（4）携程方人事信息批量更新接如下：

生产环境服务地址:https://ct.ctrip.com/corpservice/CorpCustService/SaveCorpCustInfoList

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

由于最后差量同步人员时间超为1900-01-01，因此从服务商设置，第一次点击人员同步时，会是全员同步，如果只想同步一两个人员进行测试，可扩展时“最后差量同步人员时间戳”，使其能进行编辑，然后修改时间为当前时间，再到“人员”功能里面保存下人员数据，点击同步，即可只同步一个人员。

5、同步的数据只要有一条失败，就不更新同步时间（但其数据会同步过去），导致后续的新增、修改判断逻辑出错，调用接口会报错，这样同步时间会一直不更新。

比如：（1）在系统记录的同步时间之后产生的数据，有可能已经同步给差旅壹号，此时再调用新增接口，会报错，但是数据本身也同步过去了，也不会有问题。

对于修改的数据，会没有问题，只是会导致数据累积会越来越多，因为人员同步时间一直没有更新

8、 出差申请单同步

1、携程：出差申请单审核通过之后， 将出差申请单同步至携程（Status 默认为1