盖章规则与位置
本章说明何时必须盖章、章放在哪里,以及 sealType / willAuth 的取值。坐标与章类型仅用于文件创建;模板创建的章位置以模板配置为准。
盖章规则
| 场景 | 规则 |
|---|---|
| 合同整体 | 同一合同至少有一名签署方 needSeal 为 true |
needSeal = true | 必须提供盖章位置:文件创建传 seals;模板创建使用模板中已配置的位置。模板中该签署方没有章位置时,创建失败 |
needSeal = false | 该签署方只填信息。文件创建不传 seals;模板中若已配置签章控件,创建失败 |
| 仅填信息方存在时 | 签署顺序固定为同时签署,signOrder 不再生效 |
| 章类型 | sealType 须与签署方类型一致:个人只能用个人章,企业只能用企业章,否则返回 40001 |
仅填信息方进度:
- 没有待填内容时,创建完成后即为
signed。 - 仍有待填内容时,打开链接填写完毕后记为
signed。 - 用文件地址创建的合同没有填写控件,
needSeal为false的签署方在创建完成时即为signed。创建成功本身不发送回调,该进度以合同详情为准。
意愿认证 willAuth
| 值 | 说明 |
|---|---|
none | 不指定(默认) |
face | 人脸 |
sms | 短信 |
盖章位置(仅文件创建)
由接入方在对应签署方的 seals 中传入,至少 1 个。
坐标系:以当前页为基准的比例坐标,原点在页面左上角,x 向右、y 向下,取值 0~1。例如 x = 0.70、y = 0.80 表示章的左上角约在该页宽度 70%、高度 80% 处。章面尺寸由章类型决定。
普通章
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
page | number | 是 | 页码,从 1 开始 |
x | number | 是 | 距页面左侧的比例 |
y | number | 是 | 距页面顶部的比例 |
sealType | string | 是 | 章类型,见下表 |
showTime | boolean | 否 | 是否在章旁加签署时间,默认 false |
acrossPages | boolean | 否 | 普通章不传或为 false |
page 小于 1 或大于 PDF 实际页数时返回 40001。
骑缝章
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
acrossPages | boolean | 是 | 固定 true |
y | number | 是 | 距页面顶部的比例 |
sealType | string | 是 | 章类型 |
page / x / showTime | — | 否 | 骑缝章不传;章贴在每页右侧 |
章类型 sealType
个人:
| 值 | 说明 |
|---|---|
unspecified | 不指定 |
rect | 矩形章 |
handwriting | 手写签名 |
square | 方形章 |
企业:
| 值 | 说明 |
|---|---|
unspecified | 不指定 |
official | 公章 |
finance | 财务专用章 |
legal | 法人章 |
contract | 合同专用章 |
invoice | 发票专用章 |
hr | 人事专用章 |
可在获取签章位置工具中估算坐标后再填入创建请求。