签署方

创建合同时通过 signers 传入签署方，至少 1 个。支持个人与企业两种类型，由 type 区分。字段细则亦见创建合同。

通用说明

规则	说明
最少人数	同一合同至少 1 名签署方
盖章要求	至少一名签署方 needSeal 为 true，详见盖章规则与位置
模板创建	每个签署方须携带 templateSignatoryId，且与模板签署方一一对应
文件创建	不传 templateSignatoryId；needSeal 为 true 时须传 seals
意愿认证	willAuth：none 不指定（默认）、face 人脸、sms 短信

个人签署方

type 固定为 person。

字段	类型	必填	说明
type	string	是	固定 person
name	string	是	姓名
mobile	string	是	手机号
needSeal	boolean	否	是否须盖章，默认 true
willAuth	string	否	意愿认证方式，默认 none
seals	array	条件	仅文件发起且 needSeal 为 true 时必填，至少 1 个；模板发起不传
templateSignatoryId	string	条件	仅模板发起必填

企业签署方

type 固定为 company。由经办人打开签署链接完成操作。

字段	类型	必填	说明
type	string	是	固定 company
companyName	string	是	企业名称
creditCode	string	是	统一社会信用代码
agentName	string	是	经办人姓名
agentMobile	string	是	经办人手机号
needSeal	boolean	否	是否须盖章，默认 true
willAuth	string	否	意愿认证方式，默认 none
seals	array	条件	仅文件发起且 needSeal 为 true 时必填，至少 1 个；模板发起不传
templateSignatoryId	string	条件	仅模板发起必填

模板签署方对齐

使用模板创建时：

1. 先调模板详情取得各签署方的 templateSignatoryId 与默认 type。
2. 请求中的 signers 须覆盖模板全部签署方：每个 templateSignatoryId 出现一次，不能缺少，也不能多出。
3. 模板详情里 type 已是 person 或 company 时，请求中的 type 必须相同；type 为空时由本次请求指定。
4. 不符合上述规则时返回 40001。

仅填信息方

needSeal 为 false 时，该签署方只填写信息、不盖章：

• 文件创建：不传 seals；用文件地址创建的合同没有填写控件，创建完成时该方进度即为 signed。
• 模板创建：模板中该签署方不得已配置签章控件，否则创建失败。
• 合同中存在仅填信息方时，签署顺序固定为同时签署，signOrder 不再生效。详见状态。