跳到主要内容

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.

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"
}

Investor Adhesion

CampoTipoDescriçãoCaracteresObrigatório
issuance_serie_keystringChave da série de emissão a qual o investidor está aderindo36Sim
signature_methodstringEnumerador do método de assinatura a ser utilizado nos documentosaté 255Não

Signature Method

EnumeradorDescrição
certifiqiAssinatura via CertifiQi (Certificado Digital)
qi_signAssinatura via QI Sign (Assinatura Eletrônica)

Response

Response Body
{
"investor_adhesion_key": "UUID"
}
Fluxo da adesão

Após solicitar uma nova adesão, podemos seguir dois caminhos:

  • Investidor NÃO tinha uma adesão ativa: a adesão é criada no status pending_documents e permanece assim até que todos os documentos exigidos sejam gerados e assinados.
  • Investidor já tinha uma adesão ativa: a requisição é rejeitada.