Enviar Grupo de Assinantes

---

Introdução

Este recurso cadastra um grupo de assinantes que será responsável por assinar os documentos gerados na análise cadastral do investidor. Cada grupo deve ser enviado em uma requisição independente — para cadastrar mais de um grupo, chame o endpoint múltiplas vezes.

Atenção

Cada signatário enviado neste recurso será validado contra os representantes legais declarados em Criar Parte Relacionada. Portanto, todo signer deve também ser cadastrado previamente como parte relacionada com legal_representative: true (e, quando aplicável, direct_beneficiary: true). Signatários que não constarem entre os representantes legais da análise cadastral terão o cadastro recusado.

Input / Output

Como input envie a definição de um único grupo de assinantes.

Como output será retornada a representação do grupo criado.

Request

ENDPOINT

/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/signer_group

MÉTODO

POST

STATUS

201

Request body

Exemplo

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

Campo	Tipo	Descrição	Obrigatório
is_default	boolean	Indica se este é o grupo padrão da análise	Sim
minimum_required_signers	number	Número mínimo de assinaturas necessárias (>= 1)	Sim
signers	array	Lista de objetos de Signers	Sim
expiration_date	string	Data de expiração do grupo (YYYY-MM-DD)	Não

Signers

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome do signatário	1 - 255	Sim
document_number	string	CPF ou CNPJ do signatário	14 ou 18	Sim
email	string	E-mail do signatário	-	Sim
is_required_signer	boolean	Indica se o signatário é obrigatório para considerar o grupo completo	-	Sim

Informação

• Apenas um grupo pode estar marcado como is_default: true por análise.
• minimum_required_signers deve ser menor ou igual ao total de signatários da lista.
• Pelo menos um signatário deve ter is_required_signer: true.
• Após expiration_date, o grupo não poderá mais ser utilizado para assinatura de documentos.

Response

O grupo de assinantes criado é retornado no corpo da resposta, incluindo a chave external_signer_group_key.

---