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.

Classe de fundo (fund_class) — etapa pulada

Classes de fundo não enviam grupos de assinantes. A representação se dá pelos investor owners (administrador e gestora), e não por representantes legais — não há signatários a declarar. Pule esta etapa.

Input / Output

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

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

Disponível em

Perfil	Host	Permissão exigida
Consultoria	consultant-api	Liberada pelo time de integração

URL base de cada host: Ambientes (Hosts).

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": "969.698.790-03",
            "email": "joao.silva@example.com",
            "is_required_signer": true
        },
        {
            "name": "Maria Santos",
            "document_number": "444.555.666-19",
            "email": "maria.santos@example.com",
            "is_required_signer": true
        },
        {
            "name": "Pedro Oliveira",
            "document_number": "222.333.444-05",
            "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.

---

Erros

Status	Código	Quando acontece
400	IVR000018	A análise não está mais em pending_registry_data (já foi enviada ou encerrada)
400	IVR000205	Um signatário não é representante legal ativo nem o próprio investidor
409	IVR000055	Menos signatários que minimum_required_signers
409	IVR000189	minimum_required_signers menor que o número de signatários obrigatórios
409	IVR000132	Já existe um grupo idêntico

Erros de autenticação, permissão e host: veja Erros da API.