OA 系统对接电子签：模板填充、静默盖章与文件回传的接口设计

OA 里审批通过的合同，为什么还要人工发一遍

很多企业的 OA 系统里已经有完整的合同审批流，审批通过之后，流程就断了。接下来要做的事全靠人工：把合同内容整理成文件、发给相对方、等对方签完、下载回来、上传到系统归档。审批做得再规范，签署这一段接不上，前面省下的时间又还回去了。

要把这段接上，靠的是 OA 与电子签平台之间的几个接口配合。看起来复杂，拆开来其实是四个动作的串联。

动作一：模板填充，用数据生成待签文件

签署的起点是文件。传统做法是把合同内容填进 Word，导出 PDF，再上传。系统化的做法是模板填充：在电子签平台上预先维护好合同模板，模板里预留字段占位符；OA 审批通过后，调用模板填充接口，把业务数据作为参数传进去，平台自动生成一份填好内容的 PDF。

这条路的三个好处是格式统一、字段可控、模板变更集中管理。业务侧不需要关心排版，只需要把字段值准备好；法务要改条款时，改一处模板，所有后续合同同步生效。

接口设计上要注意两点。一是字段映射要和 OA 里的业务字段一一对应，改动任何一侧都要同步；二是模板匹配规则要清晰，不同业务类型对应不同模板，匹配逻辑建议放在平台侧配置，而不是散落在各个业务系统的代码里。

动作二：创建外部用户与机构

相对方往往不在企业自己的系统里，也不一定有电子签平台的账号。发起签署之前，需要为对方在平台上建立身份档案，这一步由创建外部用户及外部机构接口完成。

这个动作的实质是把线下的「对方是谁」转化为系统里的一个可核验主体。对方的经办人需要完成实名认证，企业需要完成企业认证，认证通过后平台为其生成数字证书和电子印章。认证方式按前面讲的路径选择，可以是法人本人认证、法人授权认证或对公打款认证。

设计上的建议是：把建档案和发起签署分开，不要等发起时才发现对方没认证。对于长期合作的供应商和加盟商，可以在首次合作时完成认证，后续签署直接复用。

动作三：审批后触发签署，外部先签内部静默盖章

审批在 OA 里走完，触发电子签流程。这一步决定了两件事：签署顺序和签署方式。

签署顺序通常是外部相对方先签，内部公司后盖章。这个顺序符合业务逻辑：对方签完，我方的盖章才是对一份已确定内容的确认。也有企业选择先内部盖章再发给对方，适用于我方主导的格式合同。

签署方式上，外部相对方走正常的在线签署流程：通过短信链接跳转到签署界面，完成实名认证、查看合同内容、提交签署。内部公司的盖章则可以走静默盖章：不用人工点盖章按钮，系统调用接口用指定印章直接完成加盖。

静默盖章成立的前提是这枚章的使用已经被授权。在 OA 审批流里，审批通过即视为对本次用印的授权，这个授权关系在流程配置里已经确定，系统只是执行。反过来说，如果某类合同不在授权规则内，就不应该走静默，保留人工用印确认更稳妥。有些企业会在接口里加一道校验：检查合同类型是否在静默盖章白名单内，不在的直接转人工。

动作四：签署完成后下载回传归档

所有签署方完成签署后，OA 系统调用下载文件接口，把签署完成的合同拉回本系统，供业务系统审核和归档使用。

这一步看似简单，实际是两个系统之间的交接点。回传的内容一般包括签署完成的文件本身，以及签署状态、签署时间、签署人等元数据。文件回传后，OA 里对应的合同记录需要更新状态，这条更新通过状态查询或回调接口完成。

设计上值得注意的几点：文件回传要有重试机制，网络异常时不能丢；回传的文件要按合同编号或业务单据号建立对应关系，避免人工配对；元数据建议一并回写，让 OA 里的合同详情页能显示签署时间而不只是一份附件。

案例：中通供应链的 OA 对接链路

中通供应链管理有限公司成立于 2016 年，注册于浙江省杭州市桐庐县，是中通集团旗下重要板块，提供供应链管理、企业管理、普通货物仓储等一体化服务，员工人数超过 1000 人。

快递物流行业的加盟商合同签署，是这个行业最典型的数字化痛点。加盟商分布在全国各地，纸质合同需要线下打印、邮寄、来回确认，签约周期长；合同容易丢失或篡改，签字不规范、印章使用不当都会影响法律效力；大量纸质合同需要专门空间存储并投入人力整理检索；加盟政策调整或条款变更时，难以快速把新版本传递给所有加盟商；异地加盟商面对面签署不便，特殊时期远程签约需求强烈；各加盟商之间的合同条款差异也不利于总部统一管理。

2023 年 12 月，中通供应链管理有限公司采购 e签宝服务，交付天印 6.0，对接自研 OA 系统和 PS 系统，应用在加盟商合同签署和劳动合同签署两个场景，年签署量 10 万份。

它的接口链路正好对应前面说的四个动作：自研 OA 系统调用模板填充文件接口生成 PDF 文件；调用创建外部用户及外部机构接口完成人员信息创建；OA 对流程文件进行审批，审批后触发电子签流程；外部用户先签署，签署后内部公司静默盖章；OA 系统调用下载文件接口完成合同下载。

签署环节的用户体验也做了细化：外部相对方通过短信链接跳转到签署界面，完成实名认证后签署；待所有人员签署完成后，OA 调用下载接口把文件取回 OA 系统内，供业务系统审核使用。整套链路里，业务人员不需要离开 OA 去操作电子签平台，签署任务由审批通过这个动作自动触发。

对于加盟商网络这种「主体分散、合同标准化、签署频次高」的场景，这套设计的价值不只是省人工，更重要的是把合同条款版本统一到了总部——模板集中维护，加盟商拿到的永远是当前有效版本。

接口链路的三个易错点

接口开发完成之后，容易出问题的往往是这几个地方。

一是模板填充的字段校验。业务数据不完整或格式不对时，生成的 PDF 会带着空白或错误内容发出去，而签署流程已经触发，撤回成本很高。建议在生成前做一次必填字段校验，不通过就不允许发起。

二是签署顺序的硬编码。有些实现把所有场景都写死成「外部先签、内部后盖」，遇到需要我方先盖章的场景就绕不过去。建议把签署顺序做成配置项。

三是状态回写的一致性。签署可能是多方的，第一方签完、第二方签完、全部完成，这些状态都需要准确反映到业务系统里。e签宝提供签署状态回调和状态查询接口，配合业务系统的状态机使用，才能保证流程不会卡在中间状态。

中通供应链这个项目的落点，是让 OA 成为唯一的业务操作入口，电子签能力通过接口隐藏在流程后面。这也是集成类项目的基本判断标准：用户感知不到对接的存在，只感觉到流程变短了。