Enviar Documento do Investidor

---

Introdução

Este recurso tem como objetivo fazer upload dos documentos obrigatórios do investidor.

Input / Output:

Como input deve ser enviado o documento em base64, o tipo do documento e a extensão do arquivo.

Como output será entregue uma document_key que identifica o documento enviado.

Atenção

Este endpoint deve ser chamado múltiplas vezes, uma vez para cada documento obrigatório. Os documentos obrigatórios variam de acordo com o tipo de investidor (pessoa física ou pessoa jurídica) e a categoria do investidor (varejo, qualificado ou profissional).

Request

ENDPOINT

/investor_registry/v2/investor/{investor_key}/investor_analysis/{investor_analysis_key}/document

MÉTODO

POST

STATUS

201

Request body

Exemplo: Documento de Identificação - Pessoa Física (CNH)

Request Body

{
    "type": "cnh",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf",
    "document_data": {
        "document_type": "CNH",
        "issuer_entity": "DETRAN"
    }
}

Exemplo: Documento de Identificação - Pessoa Física (RG)

Request Body - Frente

{
    "type": "rg_front",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf",
    "document_data": {
        "document_type": "RG",
        "issuer_entity": "SSP",
        "document_number": "20.932.206-8"
    }
}

Request Body - Verso

{
    "type": "rg_back",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}

Exemplo: Cartão CNPJ - Pessoa Jurídica

Request Body

{
    "type": "cnpj_card",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf",
    "document_data": {
        "document_type": "CNPJ",
        "issuer_entity": "RFB"
    }
}

Exemplo: Demonstrações Financeiras - Pessoa Jurídica

Request Body

{
    "type": "financial_statements",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}

Exemplo: Comprovante de Residência

Request Body

{
    "type": "proof_of_residence",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
type	string	Tipo de documento de identificação	1 - 50	Sim
document_b64	string	Base 64 do documento	-	Sim
file_extension	string	Extensão do arquivo (pdf, png, jpeg)	1 - 10	Sim
document_data	object	Objeto que contém as informações de identificação do documento	-	Não

Document Type

Enumerador	Descrição	Extensões Suportadas
cnh	CNH	pdf, jpeg
rg	RG	pdf, jpeg
rg_back	Verso do RG	pdf, jpeg
rg_front	Frente do RG	pdf, jpeg
proof_of_residence	Comprovante de residência	pdf, jpeg
cnpj_card	Cartão CNPJ	pdf, jpeg
social_contract	Contrato Social	pdf, jpeg
company_statute	Estatuto	pdf, jpeg
board_election_record	Ata de Eleição Estatutária	pdf, jpeg
financial_statements	Demonstrações Financeiras	pdf, jpeg
investor_qualification_proof	Comprovação de Qualificação	pdf, jpeg
power_of_attorney	Procuração	pdf, jpeg
billing_statement	Fatura/Extrato	pdf, jpeg
fund_prospectus	Regulamento do Fundo de Investimento	pdf, jpeg

Documentos Obrigatórios

Pessoa Física (Natural Person)

Documento	Descrição	Obrigatório Para
cnh ou (rg_front + rg_back) ou rg	Documento de identificação do investidor	Todos os investidores pessoa física
proof_of_residence	Comprovante de residência	Todos os investidores pessoa física

Pessoa Jurídica - Regular (Legal Person - Regular)

Documento	Descrição	Obrigatório Para
financial_statements	Demonstrações financeiras da empresa	Todos
social_contract	Contrato social da empresa	Quando aplicável
company_statute	Estatuto	Quando aplicável
board_of_election_records	Ata de Eleição	Quando aplicável
investor_qualification_proof	Comprovação de qualificação como investidor qualificado	Investidor qualificado

Pessoa Jurídica - Fundo de Investimento (Legal Person - Fund Class)

Documento	Descrição	Obrigatório Para
cnpj_card	Documento que comprova a existência do fundo	Todos
financial_statements	Demonstrações financeiras	Todos
fund_prospectus	Regulamento do Fundo de Investimento	Todos

Response

Response Body

{
    "document_key": "UUID"
}