金蝶对接企业微信-开发实现企业微信审批申请生成金蝶单据和凭证

目录

企业微信配置

企微接口封装

金蝶插件开发

企业微信是腾讯微信团队为企业打造的专业办公管理工具，与微信一致的沟通体验，丰富免费的OA应用，以及连接微信生态的能力，助力企业高效办公和管理。

目前，很多金蝶客户也都接入了企业微信，除了与客户、供应商、员工进行信息沟通外，也会使用一些表单审批类的OA应用，比如员工在企业微信中进行费用报销申请和业务员进行供应商付款申请等，作为移动应用，非常方便。但这些表单审批通过后，一般都需要财务人员在金蝶系统中进行账务处理，这就导致财务人员要在金蝶系统再次手工录入，造成重复工作。

依据客户真实需求，员工费用报销申请和供应商付款申请在企业微信进行审批，审批通过后希望将员工报销申请传递到金蝶自定义BOS单据-报销申请单，将供应商付款申请传递到金蝶系统本身单据-付款申请单。

系统由三部分组成，一、在企业微信端，自建应用，通过这个应用实现对企业微信基础应用-审批的接口调用；二、对企业微信API接口进行封装，部署在客户具有外网IP的服务器或者云服务器上，实现企业微信接口的统一调用，实际上就是封装了一个企业微信接口的中转站；三、在金蝶客户端开发插件，通过封装的中转接口实现企业微信审批数据传递到金蝶系统，生成金蝶单据和凭证。

企业微信配置

在企业微信后台管理-应用管理里面新建自定义应用：金蝶接口。

并在此应用详情的开发者接口中设置可信任域名和配置企业可信IP。

在企业微信审批应用详情中，设置可调用接口的应用，选择自建应用-金蝶接口。

企微接口封装

由于企业微信对其API接口的调用设备有IP地址限制，设置为可信任的外网IP地址才可以调用其API接口，而客户使用的金蝶系统客户端一般都是在局域网内，没有固定的外网IP地址，为解决这种情况，对企业微信API接口进行封装，封装为新的API接口，部署在客户具有外网IP的电脑或者云服务器上，供金蝶系统各客户端调用，这样只需购买一个云服务器或外网IP即可。

封装除了解决调用企业微信API接口需要外网IP地址的限制外，也对接口返回结果的JSon进行整理，以方便金蝶插件调用处理。

金蝶插件开发

在金蝶系统里面，进行主控台插件实现，主控台外挂菜单实现数据下载和单据生成功能。

打开菜单，功能包括“查询本地数据”、“下载微信数据”、“下载微信附件”和“生成单据”以及“上传附件”。

点击“查询本地数据”，可查询过滤时间段内的已经下载到金蝶数据库的企业微信表单数据，包括生成单据和未生成单据的所有数据。

点击“下载微信数据”，通过接口下载此时间段内的企业微信表单数据到金蝶数据库并显示。

点击“下载微信附件”，把企业微信表单关联的附件下载到本地电脑。

“生成单据”按钮实现把下载到金蝶数据库的表单数据生成金蝶BOS单据-报销申请单，“上传附件”按钮把下载到本地的企业微信表单附件上传到生成的报销申请单附件里。双击单据编号字段，可以查看生成的金蝶报销申请单。

查看上传到单据的企业微信附件（采用数据库存储方式）。

查看单据生成的金蝶凭证（单据设置凭证模板，根据设置的凭证模板生成对应的金蝶凭证）。

可以查看企业微信API接口的执行日志。

可以查看操作执行的SQL语句及数据处理日志。

上面是实现企业微信报销审批表单生成金蝶自定义BOS单据报销申请单，针对金蝶系统本身的付款申请单，实现逻辑和操作过程也一样。

项目以客户需求为例在金蝶KIS旗舰版上开发，可实现生成或同步其他单据，也可迁移到商贸版、专业版和K3 WISE版。