差旅壹号实施指引

1、 星瀚差旅壹号配置

路径：

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

配置字段的说明：

截图

2、 星瀚与差旅壹号功能对接的模式

3、 差旅壹号推送地址的配置

 苍穹实施人员在【应用-开发服务云-开发平台-第三方应用】配置开放接口，并将地址给差旅壹号实施人员进行配置，如下图：

如果需要差旅壹号的发票能推送至星瀚平台，则需要配置，如不需线上开票功能，则不需要配置

4、 防火墙配置

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

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

5、 网络检查

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

6、 组织同步的内容

备注：如果是测试环境，请修改组织同步的时间戳，只同步1-2个组织进行测试

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

2、差旅壹号组织同步：

差旅壹号同步的组织是行政组织

同步组织的逻辑：

先从组织变更T_ORG_Structure查询

（1）组织的创建时间大于上次同步时间& 启用状态为是  调用新增接口

（2）组织的创建时间大于上次同步时间& 启用状态为否  调用新增接口+禁用接口

（3）组织的修改时间大于上次同步时间 & 创建时间小于上次同步时间 &启用状态为是   调用修改+启用接口

（4）组织的修改时间大于上次同步时间 & 创建时间小于上次同步时间 &启用状态为否   调用修改+禁用

2、组织同步：将苍穹行政组织同步到商旅服务商

1.查询组织架构表中的行政组织

select FORGID,FCREATETIME,FMODIFYTIME,FFULLNAME from t_org_structure where FVIEWID = '1' order by FMODIFYTIME desc;

2.查询服务商设置表中的最后差量同步组织时间戳

select FNUMBER,FLASTSYNCORGTAMP from t_er_biz_info;

3.将从t_er_biz_info表中查询出的FLASTSYNCORGTAMP与从t_org_structure表中查询出的FCREATETIME,FMODIFYTIME进行对比

（1）当FLASTSYNCORGTAMP<=FCREATETIME时，调用组织新增接口

（2）当FMODIFYTIME>=FLASTSYNCORGTAMP>FCREATETIME时，调用组织修改接口

（3）当FLASTSYNCORGTAMP>FMODIFYTIME时，不调用组织同步

3、差旅壹号组织同步调用的接口如下

新增组织接口：

https://openapi.517la.com/api/organizationmagmt/adddept

修改组织接口：

https://openapi.517la.com/api/organizationmagmt/modifydept

禁用组织接口：

https://openapi.517la.com/api/organizationmagmt/disabledept

启用组织接口：

https://openapi.517la.com/api/organizationmagmt/enabledept

4、同步的字段包括

部门编码

部门名称

上级部门编码

是否启用

5、同步的入参报文：

请求报文：

{

    "access_token":"d6549485-d566-4751-8bbf-e2bf46615176",

    "data":[

        {

            "deptName":"金蝶互联网科技有限公司",

            "companyID":"20200728095128591150",

            "companyName":"金蝶测试",

            "superDeptNO":"100000",

            "deptNO":878705596373679104,

            "status":1

        },

        {

            "deptName":"测试部",

            "companyID":"20200728095128591150",

            "companyName":"金蝶测试",

            "superDeptNO":"878705596373679104",

            "deptNO":878706400899906560,

            "status":1

        }

    ]

}

响应报文：

{

    "errcode":"0",

    "data":[],

    "requestid":null,

    "errmsg":"操作成功",

    "successful":true

}

7、 差旅壹号人员同步：

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

2、同步的字段包括：员工工号、姓名、手机号、性别、报销级别、部门ID、部门名称。

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

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

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

（3）当ftype=1时，调用人员新增接口 当ftype=2时，调用人员修改接口 当ftype=3时，调用人员禁用接口 当ftype=4时，调用人员禁用接口 当ftype=5时，调用人员启用接口

（4）人员修改、启用、禁用存在多条数据时，按照修改时间排序，只取最后一次数据，同步给差旅壹号

（5）调用差旅壹号接口逻辑

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

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

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

5、人员同步不过去的原因分析

（1）组织没有同步成功，差旅壹号在组织同步的时候，会判断成本中心组织编码和名称是否重复，只要有一个重复，就