发送签署人组
简介
本资源旨在定义负责签署投资者文件的签署人组。
输入/输出:
作为输入,需发送签署人组数组,每组包含签署人和所需的最少签署人数。
作为输出,将返回 investor_key 和 investor_analysis_key。
Request
ENDPOINT
/investor_registry/v2/investor/{investor_key}/investor_analysis/{investor_analysis_key}/signer_groupsMÉTODO
PUTSTATUS
202Request body
示例
Request Body
[
{
"is_default": true,
"minimum_required_signers": 2,
"expiration_date": "2025-12-31",
"signers": [
{
"name": "João Silva",
"document_number": "123.456.789-00",
"email": "joao.silva@example.com",
"is_required_signer": true
},
{
"name": "Maria Santos",
"document_number": "987.654.321-00",
"email": "maria.santos@example.com",
"is_required_signer": true
},
{
"name": "Pedro Oliveira",
"document_number": "456.789.123-00",
"email": "pedro.oliveira@example.com",
"is_required_signer": false
}
]
}
]
Body params
| 字段 | 类型 | 描述 | 字符数 | 必填 |
|---|---|---|---|---|
is_default | boolean | 定义是否为默 认组 | - | 是 |
minimum_required_signers | number | 所需最少签署人数 | - | 是 |
expiration_date | string | 签署人组的过期日期(格式:YYYY-MM-DD) | 10 | 否 |
signers | array | 签署人列表 | - | 是 |
Signers
| 字段 | 类型 | 描述 | 字符数 | 必填 |
|---|---|---|---|---|
name | string | 签署人姓名 | 1-255 | 是 |
document_number | string | 签署人 CPF 或 CNPJ | 14-18 | 是 |
email | string | 签署人电子邮件 | 1-512 | 是 |
is_required_signer | boolean | 定义签署人是否为必须签署人 | - | 是 |
信息
is_default参数定义此组是否为默认签署人组。只能有一个组被标记为默认。minimum_required_signers必须小于或等于组中签署人的总数。is_required_signer表示签署人在组内是否为必须。至少一个签署人必须有is_required_signer: true。expiration_date为可选项,定义签署人组的过期日期。超过此日期后,该组将不再能用于文件签署。
Response
Response Body
{
"investor_key": "UUID",
"investor_analysis_key": "UUID"
}