Skip to content

盖章规则与位置 ​

本章说明何时必须盖章、章放在哪里,以及 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% 处。章面尺寸由章类型决定。

普通章 ​

字段类型必填说明
pagenumber是页码,从 1 开始
xnumber是距页面左侧的比例
ynumber是距页面顶部的比例
sealTypestring是章类型,见下表
showTimeboolean否是否在章旁加签署时间,默认 false
acrossPagesboolean否普通章不传或为 false

page 小于 1 或大于 PDF 实际页数时返回 40001。

骑缝章 ​

字段类型必填说明
acrossPagesboolean是固定 true
ynumber是距页面顶部的比例
sealTypestring是章类型
page / x / showTime—否骑缝章不传;章贴在每页右侧

章类型 sealType ​

个人:

值说明
unspecified不指定
rect矩形章
handwriting手写签名
square方形章

企业:

值说明
unspecified不指定
official公章
finance财务专用章
legal法人章
contract合同专用章
invoice发票专用章
hr人事专用章

可在获取签章位置工具中估算坐标后再填入创建请求。

开放平台开发者中心