Enviar Termo de Adesão Assinado

Introdução

Este recurso tem como objetivo nos enviar a comprovação de assinatura do termo de adesão de um investidor a uma série de emissão de um fundo.

Atenção

Este recurso está disponível apenas para integrações que exercem o papel de Distribuidor.

Input / Output:

Como input deve ser enviado o UUID da série de emissão do fundo que o investidor aderiu e tipo de assinatura e dependendo da assinatura o conteúdo necessário para validação. Segue abaixo exemplo.

Como output será entregue uma investor_adhesion_key. A investor_adhesion_key é utilizada para identificar a adesão do investidor. A adesão é criada já no status active.

Request

ENDPOINT

/investor_adhesion/investor/INVESTOR_KEY/signed_investor_adhesion

MÉTODO

POST

STATUS

201

Request body

Request Body

{
  "issuance_serie_key": "UUID",
  "signature_method": "opt_in",
  "opt_in_hash" : "OPT_IN_HASH"
}

Campo	Tipo	Descrição	Caracteres	Obrigatório
issuance_serie_key	string	Chave da série de emissão a qual o investidor aderiu	36	Sim
signature_method	string	Método de assinatura usado: opt_in ou external	até 100	Sim
opt_in_hash	string	Hash do opt-in. Obrigatório quando signature_method é opt_in	até 500	Não
document_b64	string	Termo assinado codificado em base64. Obrigatório quando signature_method é external	-	Não
signer_group_key	string	Chave do grupo de signatários do investidor. Se omitido, usa o grupo padrão do investidor	36	Não

Atenção

Durante o processo de integração será exigido um meio de autenticação da hash enviada.

Response

Response Body

{
    "investor_adhesion_key": "UUID"
}

Erros

Status	Código	Quando acontece
400	IAD000027	A classificação do investidor não permite aderir à série
400	IAD000037	signature_method é opt_in e opt_in_hash não foi enviado
400	IAD000038	signature_method é external e document_b64 não foi enviado
400	IAD000039	Já existe uma adesão do investidor para essa série de emissão
400	IAD000051	O investidor não possui grupo de signatários (ou o signer_group_key não existe)
400	IAD000054	O investidor está não operacional
400	QIT000011	A integração não é a distribuidora do investidor
404	IAD000012	Investidor não encontrado
404	IAD000018	Série de emissão não encontrada

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