《听产品经理说》第246期·财务云特性：商旅字段映射，配置就能实现商旅对接的神器

小编推荐 

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

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

适用版本

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

一、业务场景

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

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

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

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

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

二、整体介绍

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

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

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

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

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

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

图 1 数据推送流程

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

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

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

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

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

图2 数据拉取流程

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

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

• 再次，获取到商旅平台接口json报文后，自动解析报文结构，系统同时解析星瀚目标存储数据源结构，并建立