跳到主要内容

发送签署人组


简介

本资源旨在定义负责签署投资者文件的签署人组。

输入/输出:

作为输入,需发送签署人组数组,每组包含签署人和所需的最少签署人数。

作为输出,将返回 investor_keyinvestor_analysis_key

Request

ENDPOINT
/investor_registry/v2/investor/{investor_key}/investor_analysis/{investor_analysis_key}/signer_groups
MÉTODO
PUT
STATUS
202

Request 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_defaultboolean定义是否为默认组-
minimum_required_signersnumber所需最少签署人数-
expiration_datestring签署人组的过期日期(格式:YYYY-MM-DD)10
signersarray签署人列表-

Signers

字段类型描述字符数必填
namestring签署人姓名1-255
document_numberstring签署人 CPF 或 CNPJ14-18
emailstring签署人电子邮件1-512
is_required_signerboolean定义签署人是否为必须签署人-
信息
  • is_default 参数定义此组是否为默认签署人组。只能有一个组被标记为默认。
  • minimum_required_signers 必须小于或等于组中签署人的总数。
  • is_required_signer 表示签署人在组内是否为必须。至少一个签署人必须有 is_required_signer: true
  • expiration_date 为可选项,定义签署人组的过期日期。超过此日期后,该组将不再能用于文件签署。

Response

Response Body
{
"investor_key": "UUID",
"investor_analysis_key": "UUID"
}