Skip to content

合同可选项 ​

创建合同时,除签署方与正文来源(fileUrl 或 templateId)外,还可配置名称、截止时间、签署顺序、水印与补充附件。文件创建与模板创建均可使用下表字段(必填规则见说明)。完整请求见创建合同。

字段一览 ​

字段类型必填说明
contractNamestring条件合同名称。文件方式必填;模板方式省略时使用模板名称
deadlinestring是签署截止时间,yyyy-MM-dd HH:mm:ss,须晚于请求时刻
signOrderstring否签署顺序,默认 parallel
watermarkstring否水印类型,默认 none
watermarkTextstring条件watermark 为 custom 时必填,最多 30 个字
attachmentsfile否补充附件,不进入签署正文,最多 9 个,单个不超过 50MB

签署顺序 signOrder ​

值说明
parallel同时签署(默认)
sequence按 signers 数组顺序依次签署

注意:合同中存在 needSeal 为 false 的仅填信息方时,签署顺序固定为同时签署,此时传入的 signOrder 不生效。进度表现见状态。

建议 deadline 不要晚于创建后 30 天:签署链接失效时刻取「创建后 30 天 / 截止时间 / 合同离开进行中」三者最早者。若截止时间更晚,链接可能先失效,而合同在截止前仍为 signing,签署方将无法继续通过该链接签署。

水印 watermark ​

值说明
none无水印(默认)
visitor访问者信息水印
custom自定义文字,须同时传 watermarkText(最多 30 字)

补充附件 attachments ​

  • 用途:随合同一并提供给签署方查看的补充材料,不进入签署 PDF 正文。
  • 数量:最多 9 个;单个不超过 50MB。
  • 有附件时,创建请求使用 multipart/form-data:业务 JSON 放入表单字段 data,文件放入 attachments。
  • 无附件时,可直接使用 Content-Type: application/json。

允许的扩展名:

pdf、doc、docx、xls、xlsx、ppt、pptx、jpg、jpeg、png、zip

类型或大小不符合时返回 40002。

开放平台开发者中心