合同可选项
创建合同时,除签署方与正文来源(fileUrl 或 templateId)外,还可配置名称、截止时间、签署顺序、水印与补充附件。文件创建与模板创建均可使用下表字段(必填规则见说明)。完整请求见创建合同。
字段一览
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
contractName | string | 条件 | 合同名称。文件方式必填;模板方式省略时使用模板名称 |
deadline | string | 是 | 签署截止时间,yyyy-MM-dd HH:mm:ss,须晚于请求时刻 |
signOrder | string | 否 | 签署顺序,默认 parallel |
watermark | string | 否 | 水印类型,默认 none |
watermarkText | string | 条件 | watermark 为 custom 时必填,最多 30 个字 |
attachments | file | 否 | 补充附件,不进入签署正文,最多 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。