Solicitar Termo de Adesão

Introdução

Este recurso tem como objetivo criar uma solicitação de termo de adesão de um investidor a uma série de emissão de um fundo. A partir desta solicitação, são gerados os documentos necessários para a formalização da adesão, de acordo com as configurações da série de emissão.

Input / Output:

Como input deve ser enviado o UUID da série de emissão em que o investidor está aderindo e, opcionalmente, o método de assinatura que será utilizado para os documentos gerados.

Como output será entregue uma investor_adhesion_key. A investor_adhesion_key é utilizada para identificar a adesão do investidor.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Criar Adesões

A série de emissão precisa ser de um fundo da gestora (ou, para a consultoria, de um fundo em que ela tenha essa permissão).

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/investor_adhesion/investor/INVESTOR_KEY/investor_adhesion

MÉTODO

POST

STATUS

201

Request body

Request Body

{
  "issuance_serie_key": "UUID",
  "signature_method": "qi_sign",
  "signer_group_key": "UUID"
}

Investor Adhesion

Campo	Tipo	Descrição	Caracteres	Obrigatório
issuance_serie_key	string	Chave da série de emissão a qual o investidor está aderindo	36	Sim
signature_method	string	Enumerador do método de assinatura a ser utilizado nos documentos. Se omitido: qi_sign para pessoa física e certifiqi para pessoa jurídica	-	Não
signer_group_key	string	Chave do grupo de signatários do investidor. Se omitido, usa o grupo de signatários padrão do investidor	36	Não

Signature Method

Enumerador	Descrição
certifiqi	Assinatura via CertifiQi (Certificado Digital)
qi_sign	Assinatura via QI Sign (Assinatura Eletrônica)

Response

Response Body

{
    "investor_adhesion_key": "UUID"
}

Fluxo da adesão

• Se todos os documentos exigidos pela série já existirem e estiverem vigentes, a adesão é criada direto no status active.
• Caso contrário, a adesão é criada no status pending_documents e permanece assim até que os documentos exigidos sejam gerados e assinados.
• Se o investidor já tiver uma adesão active, pending_documents ou pending_batch_close para a mesma série de emissão, a requisição é rejeitada com IAD000014.

Erros

Status	Código	Quando acontece
400	IAD000027	A classificação do investidor (geral, qualificado, profissional) não permite aderir à série
400	IAD000042	O cadastro do investidor está pendente de atualização
400	IAD000045	O investidor não possui suitability ativo
400	IAD000051	O investidor não possui grupo de signatários (ou o signer_group_key informado não existe)
400	IAD000054	O investidor está não operacional
400	QIT000011	A série de emissão não pertence a um fundo da gestora
403	IAD000049	A consultoria não tem a permissão de criar adesões no fundo da série
404	IAD000012	Investidor não encontrado (na manager-api, hoje a resposta vem como IAD000010)
404	IAD000018	Série de emissão não encontrada
404	IAD000040	signature_method não encontrado
409	IAD000014	O investidor já tem adesão ativa ou aguardando assinatura para essa série de emissão
409	IAD000057	O investidor já possui um vínculo com essa série de emissão

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