为什么要把电子合同嵌入业务系统
用户在 OA 审批通过后，希望一键发起合同并在同一入口查看签署进度；ERP 出库或采购流程完成后，需要自动生成对应用印文件并回写状态。若电子签与业务系统割裂，会出现重复录入、状态不同步与审计链断裂。
苏心签提供 OpenAPI 与 Webhook 回调，支持从业务系统发起合同、查询状态、下载已签文件，并在签署完成时主动通知您的服务。
常见集成模式
根据集成深度，可组合以下方式：
- 深度嵌入：在 OA/ERP 页面内嵌签署入口或 iframe，用户无感跳转
- 流程编排：审批节点完成后调用 API 创建合同并指定签署方
- 状态同步：Webhook 推送签署进度，业务系统更新单据状态
- 单点登录：对接企业统一身份，免二次登录进入签署页
- 档案归档：已签 PDF 回写至档案系统或对象存储
接口能力概览
核心能力包括：创建签署任务、上传或引用模板、添加签署方、发起签署、查询详情、下载文件、作废与撤回等。回调事件可覆盖签署完成、拒签、过期等节点。
完整接口说明见 API 文档站；站内提供导读与目录索引，便于与架构师、开发同事对齐范围。
- RESTful OpenAPI，支持服务端调用
- Webhook 签名验证，保障回调可信
- 沙箱 / 演示环境用于联调与验收
落地步骤建议
建议从单一场景试点：例如「采购合同审批通过后自动发起签署」，验证 API 链路、回调幂等与异常重试，再扩展到多合同类型与高并发场景。
- 梳理业务触发点与状态机（待签 / 签署中 / 已完成 / 已作废）
- 确定身份来源：统一 SSO 或独立签署链接
- 定义回调处理与日志留存策略
- 联调验收后纳入运维监控与版本升级计划
私有化场景下的集成注意点
私有化部署时，API 与回调地址通常位于内网或 DMZ；需提前规划防火墙、证书与负载均衡。商业版交付包含联调支持，可与您的 OA/ERP 厂商协同排期。
常见问题
电子合同如何与 OA/ERP 系统集成？
通过 OpenAPI 从业务系统创建签署任务，Webhook 回写状态，并可对接 SSO 实现单点登录与待办嵌入。
OpenAPI 与 Webhook 分别承担什么角色？
OpenAPI 用于主动发起、查询与下载；Webhook 在签署完成、拒签等节点主动推送事件，保障业务状态同步。
集成试点建议从哪个场景开始？
建议从单一场景切入，如采购审批通过后自动发起签署，验证 API 链路、回调幂等与异常重试后再扩展。