Pular para o conteúdo principal

Assinar Documento


Introdução​

Este recurso confirma a assinatura de um documento gerado para a formalização do cadastro do investidor via método opt-in. Os tipos suportados são: ficha cadastral (pessoa física ou jurídica), termo de investidor qualificado e termo de investidor profissional.

Diferente de Enviar Documento Assinado (que faz upload do arquivo final assinado), este recurso apenas registra a comprovação da assinatura por meio do hash de opt-in coletado pelo distribuidor.

Atenção

Este recurso está disponível apenas para integrações que atuam como Distribuidor com document_signature configurado como opt-in. O documento deve estar com status generated.

Input / Output​

Como input envie o opt_in_hash que comprova a assinatura.

Como output, quando a confirmação finaliza o lote, é retornada a chave investor_document_key.

Request​

ENDPOINT
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/document_batch/{document_batch_key}/document/{investor_document_key}/sign_document
MÉTODO
PUT
STATUS
200

Request body​

Request Body
{
"opt_in_hash": "OPT_IN_HASH"
}

Body params​

CampoTipoDescriçãoObrigatório
opt_in_hashstringHash de verificação da assinatura opt-inSim
Atenção

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

Response​

Response Body
{
"investor_document_key": "UUID"
}

Erros​

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