状态
合同有整体状态 status,每位签署方另有进度 signers[].status。列表、详情与状态回调均使用同一套枚举。
合同状态
| 值 | 说明 |
|---|---|
signing | 进行中 |
completed | 已完成 |
withdrawn | 已撤回 |
refused | 已拒签 |
voided | 已作废 |
expired | 已过截止时间且未完成 |
状态说明
| 变化 | 说明 |
|---|---|
作废 voided | 由企业端操作产生;开放接口不能将合同改为作废。查询与回调仍可能返回该状态 |
过期 expired | 到达 deadline 且合同仍为 signing 时,平台改为 expired 并发送一条状态回调。已完成的合同不会因截止时间再变为过期 |
拒签 refused | 任一须盖章的签署方拒签后:该方进度变为 refused,合同变为 refused;其余签署方保持拒签前进度、不再继续签署;链接立即失效。同一次变化只推送一条回调 |
撤回 withdrawn | 仅 signing 可撤回,见撤回合同。成功后链接立即失效并触发一条回调 |
签署方进度
| 值 | 说明 |
|---|---|
waiting | 待开始(顺序签署时尚未轮到) |
approving | 待审批(企业用印需内部审批时) |
pending | 待签署 |
signed | 已完成 |
refused | 已拒签 |
创建后的初始进度
同时签署(parallel,或存在仅填信息方时的固定同时签):
- 须盖章的签署方:
pending;企业用印需审批时为approving - 创建时已完成的仅填信息方:
signed
按顺序签署(sequence,且全部须盖章):
- 当前轮到的须盖章方:
pending或approving - 尚未轮到的:
waiting - 前一位完成后,下一位从
waiting变为pending或approving,并推送一条回调
存在仅填信息方时,签署顺序固定为同时签署,不适用顺序签的初始进度规则。
回调与查询
- 同一次业务变化只推送一条回调;报文中的
status与signers为变化后的完整快照。 - 创建合同时,仅填信息方被直接标为
signed的结果不单独产生回调,请以合同详情为准。 - 建议接入方以回调更新本地状态,并用合同详情做对账。验签与重试见状态回调。