小编推荐 

在商旅集成项目的实施过程中，接口的映射逻辑让人无比茫然？想增加、删除相关字段比登天还难？客户提出对接标准产品不包含的商旅平台时，抓耳挠腮无从下手？

不用怕啦！金蝶云•星瀚财务云提供了【商旅字段映射】这一商旅平台对接工具，只需配置就能轻松搞定各商旅平台的接口对接。快和小编往下了解详细内容吧！

适用版本

金蝶云·星瀚V6.0.1及以上           

一、业务场景

在商旅集成项目的实施过程中，你是否也有以下痛点呢？

• 每个接口具体字段的取值规则没有在前端界面进行展示，不方便了解映射逻辑，在与商旅平台沟通上线时被动茫然。

• 费用报销与商旅平台集成时，映射的字段以及字段取值都是通过代码写死的，每当客户想要增加、删除字段，都需要进行二次开发处理，实施难度大、成本高。

• 在客户提出对接标准产品不包含的第三方商旅平台时，抓耳挠腮、无从下手。

为此，金蝶云•星瀚财务云提供了【商旅字段映射】这一商旅平台对接工具，只需配置就能轻松搞定各商旅平台的接口对接。不仅大大降低了商旅集成项目实施的难度和成本，并且让接口对接更加标准化，减少对接过程中诸多错误的发生。

二、整体介绍

【商旅字段映射】功能，聚焦商旅平台接口特点，全流程模拟代码实现接口的方式，通过配置化的形式实现接口的对接，最终达到动态解析json报文、自动生成json报文、暴露映射逻辑、映射规则可扩展、插件可复用的效果。

商旅平台接口通常分为两种方式：

第一种为接口推送：比如组织、人员、出差申请单、用车申请单一般都是星瀚主动将数据推送给商旅平台。

第二种为接口拉取：比如订单、月结账单及其结算明细等一般都是星瀚通过定时任务的方式将数据从商旅平台获取回来。

针对这两种方式，我们分别设计不同的实现流程。

1、 星瀚推送数据给商旅平台（即接口推送）时，实现原理如图1：

图 1 数据推送流程

• 首先，确定数据源，通过配置过滤条件过滤出符合条件的数据；

• 其次，导入接口json报文示例，系统自动解析json报文结构；

• 再次，配置json报文字段和数据源字段的映射关系，支持源单字段取值、常量取值、条件取值、插件取值以及方案编码取值。系统中预制很多通用的插件，可以满足申请单公司、部门、费用承担公司、部门等字段的取值；

• 最后，系统根据数据源、目标报文格式、映射规则，自动生成目标报文并传递给商旅平台接收地址，并能解析结构返回值。

2、 星瀚从商旅平台接口拉取数据（即接口拉取）时，实现原理如图2：

图2 数据拉取流程

• 首先，导入商旅平台接口入参报文示例，系统自动解析json报文结构；

• 其次，选择json解析报文字段，设置入参字段的值，并自动形成入参报文，传入商旅平台接口；

• 再次，获取到商旅平台接口json报文后，自动解析报文结构，系统同时解析星瀚目标存储数据源结构，并建立映射关系。映射关系配置支持源单字段取值、常量取值、条件取值、插件取值以及方案编码取值等。系统中预制很多通用的插件，可以满足申请单公司、部门、费用承担公司、部门等字段的取值。

• 最后，根据获取到的数据，映射关系自动生成星瀚数据，并自动保存进入系统。

三、 案例解析

下面将以“人员同步”为例，介绍整个接口的对接过程。

1、 填写基本信息

打开商旅字段映射功能，填写基本信息，确定星瀚推送数据的数据源功能，以及商旅平台数据的接收地址，接口入参报文示例和返参报文示例。

图 3 基本信息

2、 录入查询条件

输入查询条件，过滤符合条件的数据。

图 4 查询条件

3、 通过字段映射，建立星瀚功能字段和入参报文字段之间的映射关系，并自动形成入参报文，可进行预览。

图 5 字段映射配置

图 6 报文预览

4、 将入参报文推送给商旅平台，并根据可忽略的异常”来判断商旅平台的返回结果。

图 7 可忽略异常配置

5、 完成配置后，通过调试按钮进行调试是否成功。

图 8 调试

6、 创建调度作业，配置调度计划执行字段映射方案（比如组织同步、人员同步、订单获取、结算获取等功能适用） 。

备注：调度作业中的执行程序固定为kd.fi.er.business.trip.v2.task.TripIntegrationTask，自定义参数的参数名称为“number”，参数类型为“文本”，值设置为商旅字段映射方案的编码

图 10 调度作业