具体的文档更新地址为：

https://shimo.im/docs/tjqVwW9Tch9RCy3x

一、商旅服务商设置

1.1 服务商设置

1、系统已预置三家服务商：中兴e路通、携程、差旅壹号

2、以下为服务商配置相应字段说明

1.3 防火墙配置

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

例如：服务商为差旅壹号，【自定义字段2：https://openapi.517la.com】，【自定义字段3：http://sso.517la.com】两个接口地址对应的ip，需要加入到防火墙白名单

二、同步组织

1、 费用全局配置：

路径：开发平台_财务云_人人差旅_首页_费用全局配置_差旅壹号每次同步组织和人员的数量(ttrip_sync_org_user_size)

由于差旅壹号会对数量进行控制，因此建议数量小于10即可

ttrip_is_sync_rootorg--差旅壹号同步组织时，是否同步星瀚根组织。默认为 false，即不同步。差旅壹号测试账套只存在唯一一个根组织，无法新增，此时需要将参数改为true，进行根组织同步，星瀚根组织的上级即为差旅壹号根组织。

建发生产环境同步时，该参数改为false

2、全量同步：

选中差旅壹号服务商，点击同步组织，即将行政组织同步给差旅壹号

3、x量同步：

路径：系统云_系统管理_调度计划：

实施时，请启用对应服务的调度计划

启用对应服务的调度作业

调度计划：费用商旅同步组织到差旅壹号- em_ChaiLvYiHaoSyncDept_SKDP_S  需要开启

调度作业：费用商旅同步组织到差旅壹号em_ChaiLvYiHaoSyncDept_SKDJ_S  需要启用

三、同步人员

1、费用全局配置：

路径：开发平台_财务云_人人差旅_首页_费用全局配置_差旅壹号每次同步组织和人员的数量(ttrip_sync_org_user_size)

由于差旅壹号会对数量进行控制，因此建议数量小于10即可

2、全量同步：

先维护好人员基础资料（包括工号、姓名、手机号）及报销级别设置（人员对应的报销级别），选中相应的服务商，点击【人员同步】，即将系统中全部人员的以上信息同步到对应服务商系统

3、X量同步：

路径：系统云_系统管理_调度计划：

实施时，请启用对应服务的调度计划

启用对应服务的调度作业

调度计划：费用商旅同步人员到差旅壹号- em_ChaiLvYiHaoSyncUser_SKDP_S  需要开启

调度作业：费用商旅同步人员到差旅壹号em_ChaiLvYiHaoSyncUser_SKDJ_S  需要启用

注意：人员x量同步调度计划，要谨慎开启，人员同步后，差旅壹号会向员工发送已开通短信

四、商旅组织试点维护

商旅预订在客户使用时，如需先试点几个组织，可通过费用核算_其他基础设置_试点单位维护，最小单位为部门

1、去掉原服务商设置里是否启用各种预订服务功能；

2、如果需要启用某一个或某几个服务商的某些预订服务，可以先把该服务商设置为可用，然后在到试点单位维护里维护具体的预订功能及对应组织的白名单或黑名单。

影响点：

1、已上线客户，如果设置了商旅白名单，更新补丁后，实施人员需要重新维护试点单位；

2、如果客户基于白名单做了二次开发，更新补丁后，二开人员需要针对扩展内容进行调整（例如建发）

五、开票设置

1、 与商旅公司商务合同确认后，准备上线生产环境时，需要与商旅公司确定开票明细，比如机票开具行程单还是普票，酒店开具纸质发票还是电子发票（暂未提供）

2、 明确合同后，可在费用核算_商旅设置_开票设置维护开票明细，该设置影响生成开票申请单及相应的可抵扣税额计算

六、消费明细（订单）接收

1、ttrip_sync_orderbill_size-差旅壹号每次同步订单的数量

建议数量为500

2、ttrip_is_sync_rootorg-商旅同步订单是否进行必填校验，默认为true。true：进行必填校验，false：不进行必填校验

需调整为false