跳转至

title: 最佳实践 - 第一部分:需求背景 {#第一部分需求背景 .unnumbered} created: 2026-04-19 updated: 2026-04-19 type: reference tags: [oa, best-practice, use-case] related: [oa/index.md] source: "泛微官方文档"


差旅服务之阿里商旅集成应用场景分享

第一部分:需求背景

客户是一家以阿里云云计算与大数据的咨询与服务的公司,业务遍布全国各地,企业中大量的人员需要频繁出差,出差时员工使用钉钉中集成的阿里商旅进行机票、住宿的预定。上线OA后出差需要通过OA进行在线审批,审批后再进行差旅的预定。为了避免员工在OA与阿里商旅的来回切换的繁琐以及确保两边数据一致故需要实现OA与阿里商旅的打通。

第二部分:需求分析

客户原先已经使用钉钉及阿里商旅,所以需要实现将OA中的出差申请流程中的信息与阿里商旅打通,实现出差申请审批后自动触发阿里商旅的预定,同时预定结果又能与差旅报销打通,作为报销的依据,所以本客户场景中核心的关键业务特征及需求是:

钉钉集成

用户使用钉钉,所以首先需要实现OA与钉钉的集成

阿里商旅集成

OA中发起差旅审批流程,审批通过后需要与阿里商旅进行集成

同时阿里商旅预订后产生的费用信息需要与OA打通,作为后续的报销凭证

第三部分:实现思路说明

通过流程引擎构建出差申请和差旅报销流程

具体流程的构建比较简单,在此场景中核心是需要解决流程中数据与阿里商旅数据的打通,具体业务逻辑如下:

员工通过OA提交出差申请单,经过领导审批,数据通过接口传输到阿里商旅。有了出差申请,员工可在阿里商旅上实现订票,订酒店,打车等。费用可根据企业设定是企业支付还是员工支付。此订单产生的数据费用实时回写。如下图所示

![](./media//open.taobao.com,使用淘宝账号登陆(为企业申请一个单独的淘宝账号,以企业名称命名,不要用员工个人的淘宝账号)

通过云桥完成人员与钉钉的同步工作

2、配置工作

阿里商旅的对接技术部门已经提供了标准的对接接口,大致配置步骤如下:

配置与阿里商旅对接的配置文件

![](./media//open.taobao.com/apitools/sessionPage.htm?spm=a219a.7629140.0.0.EuJZm1> 置与阿里商旅对接的配置文件

![](./media//open.taobao.com/apitools/sessionPage.htm?spm=a219a.7629140.0.0.EuJZm1>### 配置浏览按钮

表单中需要用到的浏览按钮需要提前配置,其中多数据来源于技术提供的升级包的脚本

通过配置浏览按钮确保后续传输给阿里商旅的值是可以匹配一致的

需配置的浏览按钮有:成本中心,发票抬头,出行方式,行程类别,城市

  • 成本中心:费用结算主体,支持一个公司有对个财务结算主体。如果固定一个可做节点前附加操作操作,给默认值。多个的话,需放到表单上选择。

  • 发票抬头:跟成本中心类似,后期阿里寄送发票时的抬头

  • 出行方式:汽车,火车,飞机等

  • 行政类别:单程,往返

  • 城市:分为出差城市,出发城市,目的城市。会根据出行方式不同,展示的数据不同。

注:以上所有的自定义浏览按钮均为OA新建实体表单,第一次批量执行脚本把数据写入对应表单,也就是说,自定义浏览出的信息均为OA中的字段。后续如新增字段可在建模中新建虚拟表单,通过建模新增。并非实时读取阿里的数据。

配置OA表单字段与阿里商旅参数之间的匹配关系

流程中的数据最终需要写入阿里接口,配置管控项的目的,就是把OA中的字段跟阿里接口中要求的字段对应起来。

实现方式:OA中搭建建模。把OA中的字段跟接口字段一一对应。

对照关系如下:

出差申请流程中的表单设计需要充分考虑如下两点要求:

1、表单中的预订信息字段需要与阿里商旅的字段一一匹配,例如:

出行方式(飞机、火车、酒店、其他)------浏览按钮 -> 自定义单选 -> 产品类型

行程类型(单程、往返)------流程按钮 -> 自定义单选 -> 行程类型

出差城市,出发城市,目的城市等都需要根据指定的方式来配置------浏览按钮 -> 自定义单选 -> 出差城市。

成本中心:浏览按钮 -> 自定义单选。接口字段,目的:费用归属不同公司

发票抬头:浏览按钮 -> 自定义单选。接口字段,目的:发票单据抬头

时间时间,结束时间,机票金额,火车票金额,酒店金额,打车金额等字段

PS:出差城市字段的数据与出行的方式有关的,因为有些地方,可能有火车站,但是没有机场,因此选择不同的出行方式,对应的可选城市数据是不同的,因此需要先选择出行的方式,再选择出差城市。

2、表单中需要预留一个空白行,配置阿里信息回写等信息。

配置方式:表单右键->属性-> ID和name配置:alitrip_order_list。如下图:

通过钉钉登录阿里商旅,已审批的出差申请流程会自动带入,预定时可看到审批信息

在阿里商旅中进行机票、火车、酒店的预订,预订后回写入OA的审批表单中