对接e签宝合同API流程整理

408 阅读3分钟

前言

在公司接手了一个合同管理的项目,需求就是能定制化开发自己的合同管理,只需要大致的去调用e签宝的模板、认证以及一些签署即可。

刚拿到这个需求的时候非常的懵逼,没有一点思路,都说懂业务的程序员才是好程序员,于是我从一个签合同只知道打印合同然后两个人去签字的小白,一步一步的理解签合同流程最后到e签宝如何去将这一简单的流程与实际的场景应用从中得到了什么启发给整理下来。

需求开发

对接需求

鉴于公司没有产品,于是一切业务只能靠自己的脑袋去想,试着去理解别的公司是如何去对接这个产品的,于是我们去官网找到了这些与e签宝有过合作的商家。

对接平台 然后使用他们的服务,从中取其精华,加入我们平台的需求,最后在我们脑子里面就大致有一套需要的原型图了,这种看似简单,实则也需要强大的功底。

接着我们就能进入到下一步项目搭建了。

开源大法

因为这个项目是独立于其他的平台的,所以也算一个合同中台项目,需要从0去搭建这个项目,但是既然是对接大品牌,那么在我们的宝库中一定有前人的脚印让我们跟着走,再加上我们程序员个个都有开源精神于是我们不费力气的找到了有过对接的项目

俗话说项目从0到1要比从1到10难100倍。

在这里当然也有考虑过使用e签宝推荐的sdk了,这里就不得不吐槽一嘴了,虽然有代码但是代码已经是几年前的了,而且耦合有点高,对于现在我们的使用的技术栈来说挺难兼容的。所以只能去找别的开源项目了。

文档对接

好在业务文档还是挺顺心的,有配套的使用流程,基本能满足我们需求,链接放到下面
open.esign.cn/tools/helpe… 《这里有个坑后面再说》

其实如果我们只使用e签宝的一些简单功能,就是我们这边去发起一个合同,然后让另一边去接收其实只需要去关注两个核心流程即可:签署流程、认证流程。

  • 如果我们是通过使用文件一步一步发起合同那就需要去经历

——>上传文件——>制定模板——>生成底稿文件——>选择文件发起 这几步

  • 如果我们想通过在官网制作模板,然后在我们在通过api去获取模板发起

对不起没有(这里就是我踩坑的地儿)

  • 但是我们可以通过另外一种流程去接入这个流程(使用流程模板签署

这是一种比较新的接入方式,但是没有放到上面的配套流程使用里面,可能导致我们开发者没有及时的去看到这个流程
——>获取创建流程模板——>通过流程模板去发起这个签署流程 这种方式比上面的发起流程签署都简单一些(推荐使用)

业务整合

最后我们再结合自己的业务去开发对应的接口,在需要做认证的地方去做认证,去需要获取盖章的地方去调用盖章信息等。
其实作为国内最大的合同签署平台e签宝提供的接口都是非常人性化的

心得体会

最后写程序就是对业务的编写,在开发中有百分之60的时间都是在理解业务的前提下开发的,所以我认为开发对于理解的要求是非常高的,作为一个初级程序员以后的路还任重道远。