Enviar Documento do Investidor

Introdução

Este recurso faz o upload de um documento que compõe a análise cadastral do investidor. Os documentos obrigatórios variam conforme o person_type e o investor_sub_type do investidor, bem como sua categoria (varejo, qualificado, profissional).

Atenção

Este endpoint deve ser chamado uma vez para cada documento obrigatório.

Input / Output

Como input envie o conteúdo do arquivo em base64, o tipo do documento e a extensão.

Como output será retornada a representação do documento criado, com sua document_key (também referida como external_investor_analysis_document_key).

Request

ENDPOINT

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

MÉTODO

POST

STATUS

201

Query params

Campo	Tipo	Descrição	Obrigatório
`force`	boolean	Se `true`, força o envio mesmo quando há validação prévia falha. O documento entra obrigatoriamente em análise manual.	Não

Request body

Exemplo: CNH (Pessoa Física)

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

Exemplo: RG (frente e verso)

Request Body — Frente
{
    "type": "rg_front",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "jpeg",
    "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": "jpeg"
}

Exemplo: Cartão CNPJ (Pessoa Jurídica)

Request Body
{
    "type": "cnpj_card",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
`type`	string	Enumerador de Document Type	-	Sim
`document_b64`	string	Conteúdo do arquivo codificado em base64	-	Sim
`file_extension`	string	Extensão do arquivo. Valores aceitos: `pdf`, `jpeg`	-	Sim
`document_data`	object	Metadados livres do documento (ex.: número, órgão emissor)	-	Não
`observation`	string	Observação livre sobre o documento	até 500	Não

Document Type

Enumerador	Descrição	Extensões
`cnh`	CNH	`pdf`, `jpeg`
`rg`	RG (frente e verso em arquivo único)	`pdf`, `jpeg`
`rg_front`	RG — frente	`pdf`, `jpeg`
`rg_back`	RG — verso	`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
`cnh` ou (`rg_front` + `rg_back`) ou `rg`	Documento de identificação
`proof_of_residence`	Comprovante de residência

Pessoa Jurídica regular (`legal_person` / `investor_sub_type: default`)

Documento	Quando enviar
`financial_statements`	Todos
`social_contract`	Quando aplicável
`company_statute`	Quando aplicável
`board_election_record`	Quando aplicável
`investor_qualification_proof`	Investidor qualificado / profissional

Pessoa Jurídica — Fundo de Investimento (`investor_sub_type: fund_class`)

Documento	Descrição
`cnpj_card`	Cartão CNPJ do fundo
`financial_statements`	Demonstrações financeiras
`fund_prospectus`	Regulamento do fundo

Response

O documento criado é retornado no corpo da resposta, incluindo a chave document_key (também referenciada como external_investor_analysis_document_key) e o status inicial (valid, invalid ou in_manual_analysis).

Introdução​

Input / Output​

Request​

Query params​

Request body​

Body params​

Document Type​

Documentos Obrigatórios​

Pessoa Física (natural_person)​

Pessoa Jurídica regular (legal_person / investor_sub_type: default)​

Pessoa Jurídica — Fundo de Investimento (investor_sub_type: fund_class)​

Response​