# QI Tech — Investment-as-a-Service › Cadastro do Investidor Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 97 página(s). Índice: - Início (/documentation/iaas/investidor/cadastro_investidor/inicio) - atualizacao_cadastral (/documentation/iaas/investidor/cadastro/atualizacao_cadastral) - atualizar_status_grupo_assinantes (/documentation/iaas/investidor/cadastro/atualizar_status_grupo_assinantes) - busca_informacoes_de_uma_analise_cadastral_do_investidor (/documentation/iaas/investidor/cadastro/busca_informacoes_de_uma_analise_cadastral_do_investidor) - busca_informacoes_do_investidor (/documentation/iaas/investidor/cadastro/busca_informacoes_do_investidor) - buscar_documentos_para_assinatura (/documentation/iaas/investidor/cadastro/buscar_documentos_para_assinatura) - Buscar Dados de investidores paginado (/documentation/iaas/investidor/cadastro/buscar_investidores_paginado) - consultar_analise_em_andamento (/documentation/iaas/investidor/cadastro/consultar_analise_em_andamento) - atualizar_status_conta_bancaria (/documentation/iaas/investidor/cadastro/contas_bancarias/atualizar_status_conta_bancaria) - definir_conta_principal (/documentation/iaas/investidor/cadastro/contas_bancarias/definir_conta_principal) - enviar_contas_bancarias (/documentation/iaas/investidor/cadastro/contas_bancarias/enviar_contas_bancarias) - Criar investidor (/documentation/iaas/investidor/cadastro/criar_investidor) - definir_grupo_assinantes_padrao (/documentation/iaas/investidor/cadastro/definir_grupo_assinantes_padrao) - enviar_cadastro_para_analise (/documentation/iaas/investidor/cadastro/enviar_cadastro_para_analise) - enviar_dados_cadastrais (/documentation/iaas/investidor/cadastro/enviar_dados_cadastrais) - enviar_endereco (/documentation/iaas/investidor/cadastro/enviar_endereco) - enviar_grupos_assinantes (/documentation/iaas/investidor/cadastro/enviar_grupos_assinantes) - enviar_investor_document (/documentation/iaas/investidor/cadastro/enviar_investor_document) - enviar_patrimonio (/documentation/iaas/investidor/cadastro/enviar_patrimonio) - consultar_feedback (/documentation/iaas/investidor/cadastro/feedback/consultar_feedback) - enviar_mensagem_feedback (/documentation/iaas/investidor/cadastro/feedback/enviar_mensagem_feedback) - listar_feedbacks (/documentation/iaas/investidor/cadastro/feedback/listar_feedbacks) - Introdução (/documentation/iaas/investidor/cadastro/introducao) - criar_parte_relacionada (/documentation/iaas/investidor/cadastro/related_party/criar_parte_relacionada) - enviar_documento_parte_relacionada (/documentation/iaas/investidor/cadastro/related_party/enviar_documento_parte_relacionada) - consultar_formulario_suitability (/documentation/iaas/investidor/cadastro/suitability/consultar_formulario_suitability) - enviar_suitability (/documentation/iaas/investidor/cadastro/suitability/enviar_suitability) - atualizacao_cadastral (/documentation/iaas/investidor/carteira_administrada/atualizacao_cadastral) - atualizar_status_grupo_assinantes (/documentation/iaas/investidor/carteira_administrada/atualizar_status_grupo_assinantes) - busca_informacoes_de_uma_analise_cadastral_do_investidor (/documentation/iaas/investidor/carteira_administrada/busca_informacoes_de_uma_analise_cadastral_do_investidor) - busca_informacoes_do_investidor (/documentation/iaas/investidor/carteira_administrada/busca_informacoes_do_investidor) - buscar_documentos_para_assinatura (/documentation/iaas/investidor/carteira_administrada/buscar_documentos_para_assinatura) - consultar_analise_em_andamento (/documentation/iaas/investidor/carteira_administrada/consultar_analise_em_andamento) - atualizar_status_conta_bancaria (/documentation/iaas/investidor/carteira_administrada/contas_bancarias/atualizar_status_conta_bancaria) - definir_conta_principal (/documentation/iaas/investidor/carteira_administrada/contas_bancarias/definir_conta_principal) - enviar_contas_bancarias (/documentation/iaas/investidor/carteira_administrada/contas_bancarias/enviar_contas_bancarias) - Criar investidor (/documentation/iaas/investidor/carteira_administrada/criar_investidor) - definir_grupo_assinantes_padrao (/documentation/iaas/investidor/carteira_administrada/definir_grupo_assinantes_padrao) - enviar_cadastro_para_analise (/documentation/iaas/investidor/carteira_administrada/enviar_cadastro_para_analise) - enviar_dados_cadastrais (/documentation/iaas/investidor/carteira_administrada/enviar_dados_cadastrais) - enviar_endereco (/documentation/iaas/investidor/carteira_administrada/enviar_endereco) - enviar_grupos_assinantes (/documentation/iaas/investidor/carteira_administrada/enviar_grupos_assinantes) - enviar_investor_document (/documentation/iaas/investidor/carteira_administrada/enviar_investor_document) - enviar_patrimonio (/documentation/iaas/investidor/carteira_administrada/enviar_patrimonio) - consultar_feedback (/documentation/iaas/investidor/carteira_administrada/feedback/consultar_feedback) - enviar_mensagem_feedback (/documentation/iaas/investidor/carteira_administrada/feedback/enviar_mensagem_feedback) - listar_feedbacks (/documentation/iaas/investidor/carteira_administrada/feedback/listar_feedbacks) - Introdução (/documentation/iaas/investidor/carteira_administrada/introducao) - enviar_documento_investor_owner (/documentation/iaas/investidor/carteira_administrada/investor_owner/enviar_documento_investor_owner) - criar_parte_relacionada (/documentation/iaas/investidor/carteira_administrada/related_party/criar_parte_relacionada) - enviar_documento_parte_relacionada (/documentation/iaas/investidor/carteira_administrada/related_party/enviar_documento_parte_relacionada) - consultar_formulario_suitability (/documentation/iaas/investidor/carteira_administrada/suitability/consultar_formulario_suitability) - enviar_suitability (/documentation/iaas/investidor/carteira_administrada/suitability/enviar_suitability) - assinar_documento (/documentation/iaas/investidor/distribuicao_externa/assinar_documento) - atualizacao_cadastral (/documentation/iaas/investidor/distribuicao_externa/atualizacao_cadastral) - atualizar_status_grupo_assinantes (/documentation/iaas/investidor/distribuicao_externa/atualizar_status_grupo_assinantes) - busca_informacoes_de_uma_analise_cadastral_do_investidor (/documentation/iaas/investidor/distribuicao_externa/busca_informacoes_de_uma_analise_cadastral_do_investidor) - busca_informacoes_do_investidor (/documentation/iaas/investidor/distribuicao_externa/busca_informacoes_do_investidor) - buscar_documentos_para_assinatura (/documentation/iaas/investidor/distribuicao_externa/buscar_documentos_para_assinatura) - consultar_analise_em_andamento (/documentation/iaas/investidor/distribuicao_externa/consultar_analise_em_andamento) - atualizar_status_conta_bancaria (/documentation/iaas/investidor/distribuicao_externa/contas_bancarias/atualizar_status_conta_bancaria) - definir_conta_principal (/documentation/iaas/investidor/distribuicao_externa/contas_bancarias/definir_conta_principal) - enviar_contas_bancarias (/documentation/iaas/investidor/distribuicao_externa/contas_bancarias/enviar_contas_bancarias) - Criar investidor (/documentation/iaas/investidor/distribuicao_externa/criar_investidor) - definir_grupo_assinantes_padrao (/documentation/iaas/investidor/distribuicao_externa/definir_grupo_assinantes_padrao) - enviar_cadastro_para_analise (/documentation/iaas/investidor/distribuicao_externa/enviar_cadastro_para_analise) - Enviar Dados Cadastrais do Investidor (/documentation/iaas/investidor/distribuicao_externa/enviar_dados_cadastrais) - enviar_documento_assinado (/documentation/iaas/investidor/distribuicao_externa/enviar_documento_assinado) - enviar_endereco (/documentation/iaas/investidor/distribuicao_externa/enviar_endereco) - enviar_grupos_assinantes (/documentation/iaas/investidor/distribuicao_externa/enviar_grupos_assinantes) - Enviar Documento do Investidor (/documentation/iaas/investidor/distribuicao_externa/enviar_investor_document) - enviar_patrimonio (/documentation/iaas/investidor/distribuicao_externa/enviar_patrimonio) - Enviar Resposta Suitability (/documentation/iaas/investidor/distribuicao_externa/enviar_suitability) - consultar_feedback (/documentation/iaas/investidor/distribuicao_externa/feedback/consultar_feedback) - enviar_mensagem_feedback (/documentation/iaas/investidor/distribuicao_externa/feedback/enviar_mensagem_feedback) - listar_feedbacks (/documentation/iaas/investidor/distribuicao_externa/feedback/listar_feedbacks) - Introdução (/documentation/iaas/investidor/distribuicao_externa/introducao) - criar_investor_owner (/documentation/iaas/investidor/distribuicao_externa/investor_owner/criar_investor_owner) - enviar_documento_investor_owner (/documentation/iaas/investidor/distribuicao_externa/investor_owner/enviar_documento_investor_owner) - criar_parte_relacionada (/documentation/iaas/investidor/distribuicao_externa/related_party/criar_parte_relacionada) - enviar_documento_parte_relacionada (/documentation/iaas/investidor/distribuicao_externa/related_party/enviar_documento_parte_relacionada) - atualizacao_cadastral (/documentation/iaas/investidor/fundo_de_investimento/atualizacao_cadastral) - busca_informacoes_de_uma_analise_cadastral_do_investidor (/documentation/iaas/investidor/fundo_de_investimento/busca_informacoes_de_uma_analise_cadastral_do_investidor) - busca_informacoes_do_investidor (/documentation/iaas/investidor/fundo_de_investimento/busca_informacoes_do_investidor) - buscar_documentos_para_assinatura (/documentation/iaas/investidor/fundo_de_investimento/buscar_documentos_para_assinatura) - atualizar_status_conta_bancaria (/documentation/iaas/investidor/fundo_de_investimento/contas_bancarias/atualizar_status_conta_bancaria) - definir_conta_principal (/documentation/iaas/investidor/fundo_de_investimento/contas_bancarias/definir_conta_principal) - enviar_contas_bancarias (/documentation/iaas/investidor/fundo_de_investimento/contas_bancarias/enviar_contas_bancarias) - Criar investidor (/documentation/iaas/investidor/fundo_de_investimento/criar_investidor) - enviar_cadastro_para_analise (/documentation/iaas/investidor/fundo_de_investimento/enviar_cadastro_para_analise) - Enviar Dados Cadastrais do Investidor (/documentation/iaas/investidor/fundo_de_investimento/enviar_dados_cadastrais) - consultar_feedback (/documentation/iaas/investidor/fundo_de_investimento/feedback/consultar_feedback) - enviar_mensagem_feedback (/documentation/iaas/investidor/fundo_de_investimento/feedback/enviar_mensagem_feedback) - listar_feedbacks (/documentation/iaas/investidor/fundo_de_investimento/feedback/listar_feedbacks) - Introdução (/documentation/iaas/investidor/fundo_de_investimento/introducao) - criar_parte_relacionada (/documentation/iaas/investidor/fundo_de_investimento/related_party/criar_parte_relacionada) - enviar_documento_parte_relacionada (/documentation/iaas/investidor/fundo_de_investimento/related_party/enviar_documento_parte_relacionada) --- # Início URL: /documentation/iaas/investidor/cadastro_investidor/inicio Esta seção descreve o processo geral de **cadastro de investidores** na plataforma QI Tech. O cadastro é o passo inicial obrigatório antes que qualquer investidor possa participar de uma oferta, subscrever cotas ou movimentar recursos. Ao final do fluxo, a QI Tech executa uma **análise cadastral** que valida os dados, documentos e enquadramento do investidor frente às exigências regulatórias. ### Como o cadastro está estruturado O cadastro de investidor é dividido em quatro fluxos, organizados de acordo com o tipo de investidor e o canal pelo qual ele será integrado. Cada fluxo é descrito em detalhes em sua respectiva subseção. Carteira Administrada carteiras geridas profissionalmente em nome de um titular econômico (investor owner) `investor-integration` Fundo de Investimento veículos com CNPJ próprio (FIMs, FIAs, FIDCs e demais classes) que aplicam recursos em nome de seus cotistas `investor-integration` Distribuição Externa investidores cadastrados por conta e ordem por meio de distribuidores parceiros `distributor-integration` Cadastrar como Gestor / Consultor gestores (`manager-integration`) e consultores (`consultant-integration`) fazem o cadastro de seus cotistas ### Conceitos comuns a todos os fluxos Apesar das particularidades de cada tipo, todos os fluxos compartilham um conjunto de conceitos e recursos: - **Investor / Investor Analysis** — cada investidor possui um identificador único (`investor_key`) e, a cada ciclo de cadastro, uma nova análise cadastral (`investor_analysis_key`). É a análise que recebe os dados, documentos e o resultado final da validação. - **Feedbacks** — durante e após a análise, a QI Tech pode solicitar correções ou complementos por meio de feedbacks, que ficam disponíveis na própria análise cadastral. - **Etapas cadastrais** — os fluxos cadastrais seguem linearmente os seguintes passos: - Criação do investidor (primeiro cadastro) ou análise (atualização) - **Cliente**; - Envio de dados cadastrais e documentos necessários - **Cliente**; - Envio do cadastro para análise - **Cliente**; - Aprovação do cadastro ou retorno para preenchimento com feedbacks - **QI Tech**; - Assinatura de documentos - **Cliente**. Uma vez que o cliente assinar os documentos enviados após a análise, o investidor estará apto a interagir com o resto do sistema, como geração de termos de adesão, boletins de subscrição e boletagem de aportes. --- # atualizacao_cadastral URL: /documentation/iaas/investidor/cadastro/atualizacao_cadastral --- # atualizar_status_grupo_assinantes URL: /documentation/iaas/investidor/cadastro/atualizar_status_grupo_assinantes --- # busca_informacoes_de_uma_analise_cadastral_do_investidor URL: /documentation/iaas/investidor/cadastro/busca_informacoes_de_uma_analise_cadastral_do_investidor --- # busca_informacoes_do_investidor URL: /documentation/iaas/investidor/cadastro/busca_informacoes_do_investidor --- # buscar_documentos_para_assinatura URL: /documentation/iaas/investidor/cadastro/buscar_documentos_para_assinatura --- # Buscar Dados de investidores paginado URL: /documentation/iaas/investidor/cadastro/buscar_investidores_paginado --- ### Introdução Este recurso permite listar investidores aplicando filtros opcionais (documento, status e nome), com paginação. ### Input / Output Não há corpo de requisição. Os filtros são passados via *query string*, todos opcionais. Como ***output*** será retornada a lista de investidores que atendem aos filtros informados. ### Request ENDPOINT `/investor_registry/investors` MÉTODO `GET` STATUS `200` ### Query Params Todos os parâmetros são **opcionais**. | Param | Tipo | Default | Descrição | |-------------------|--------|:-------:|--------------------------------------------------------------| | `document_number` | string | `None` | Filtro por documento completo | | `status` | string | `None` | Filtro por status | | `name` | string | `None` | Filtro por nome | | `limit` | int | `100` | Itens por página (mín. `0`, máx. `500`) | | `page` | int | `0` | Página; o offset é calculado como `page * limit` | ### Response ```json title='Response Body' { "data": [ { "name": "investidor 1", "status": "approved", "person_type": "natural_person", "investor_key": "UUID v4", "email": "investidor1@exemplo.com", "phone": "11999990001", "distributor": { "distributor_key": "UUID v4", "name": "Distribuidora XYZ", "document_number": "00000000000191", "registry_configuration": {} } }, { "name": "investidor 2", "status": "pending", "person_type": "natural_person", "investor_key": "UUID v4", "email": "investidor2@exemplo.com", "phone": "11999990002", "distributor": { "distributor_key": "UUID v4", "name": "Distribuidora XYZ", "document_number": "00000000000191", "registry_configuration": {} } } ], "limit": 50, "page": 0, "is_last_page": true } ``` ### Response Params | Campo | Tipo | Descrição | |----------------|---------|--------------------------------------------------------------------| | `data` | array | Lista de objetos de **[Investor](#investor)** | | `limit` | int | Quantidade de itens por página utilizada na consulta | | `page` | int | Página retornada | | `is_last_page` | boolean | Indica se esta é a última página de resultados | ### Investor {#investor} | Campo | Tipo | Descrição | |-----------------|--------|----------------------------------------------------| | `investor_key` | string | Chave única de identificação do investidor | | `name` | string | Nome (ou razão social) do investidor | | `status` | string | Status atual do investidor | | `person_type` | string | Tipo de pessoa (`natural_person` ou `legal_person`) | | `email` | string | E-mail de contato do investidor | | `phone` | string | Telefone de contato do investidor | | `distributor` | object | Objeto de **Distributor** | ### Distributor {#distributor} | Campo | Tipo | Descrição | |--------------------------|--------|--------------------------------------------------| | `distributor_key` | string | Chave única do distribuidor | | `name` | string | Nome do distribuidor | | `document_number` | string | CNPJ do distribuidor | | `registry_configuration` | object | Configurações de cadastro do distribuidor | --- # consultar_analise_em_andamento URL: /documentation/iaas/investidor/cadastro/consultar_analise_em_andamento --- # atualizar_status_conta_bancaria URL: /documentation/iaas/investidor/cadastro/contas_bancarias/atualizar_status_conta_bancaria --- # definir_conta_principal URL: /documentation/iaas/investidor/cadastro/contas_bancarias/definir_conta_principal --- # enviar_contas_bancarias URL: /documentation/iaas/investidor/cadastro/contas_bancarias/enviar_contas_bancarias --- # Criar investidor URL: /documentation/iaas/investidor/cadastro/criar_investidor --- ### Introdução Este recurso tem como objetivo nos informar dados básicos para iniciar o cadastro de um **investidor**. A criação de um investidor já dispara, em conjunto, a abertura de uma primeira **análise cadastral** vinculada a ele. Por isso, ao final desta chamada são retornadas duas chaves: ***investor_key*** (identifica o investidor) e ***investor_analysis_key*** (identifica a análise cadastral em andamento). Existem 2 tipos principais de investidor, definidos pelo campo **`person_type`**: **pessoa física** (`natural_person`) e **pessoa jurídica** (`legal_person`). :::info Informação No ambiente de Homologação, temos a seguinte regra para aprovações: CPF/CNPJ com início **1**: reprovação automática; CPF/CNPJ com início **8**: pendente de validação manual; o restante é aprovado automaticamente. ::: :::info Informação Para a integração de `gestores` ou `consultores` é possível determinar se o investidor irá preencher os dados através da plataforma, ou não. Caso o investidor vá preencher o próprio cadastro, basta passar o query param `create_investor_user = true` ::: ### Input / Output Como ***input*** envie os dados básicos do investidor. Os campos obrigatórios variam de acordo com **`person_type`** e **`investor_sub_type`**. Como ***output*** serão retornadas a ***investor_key*** e a ***investor_analysis_key***. A ***investor_key*** identifica o investidor; a ***investor_analysis_key*** identifica a análise cadastral aberta junto com a criação. Um mesmo investidor pode possuir mais de uma análise cadastral ao longo do tempo (renovações, atualizações). ### Request ENDPOINT `/investor_registry/investor` MÉTODO `POST` STATUS `201` ### Request body Caso 01: Pessoa Física ```json title='Request Body' { "name": "João da Silva", "document_number": "123.456.789-00", "person_type": "natural_person", "email": "joao.silva@example.com", "phone": { "international_dial_code": "55", "area_code": "11", "number": "987654321" } } ``` Caso 02: Pessoa Jurídica ```json title='Request Body' { "name": "Empresa XPTO Ltda", "document_number": "12.345.678/0001-90", "person_type": "legal_person", "investor_sub_type": "default", "registry_user": { "name": "José da Silva", "document_number": "123.456.789-00", "email": "jose.silva@example.com", "phone": { "international_dial_code": "55", "area_code": "11", "number": "987654321" } } } ``` :::warning Atenção Os campos obrigatórios mudam de acordo com o **`person_type`**: - **`natural_person`**: `name`, `document_number`, `person_type` (`email` e `phone` recomendados para criação de usuário) - **`legal_person`**: `name`, `document_number`, `person_type`, `investor_sub_type` e `registry_user` ::: :::info Sobre o `registry_user` O **`registry_user`** representa o usuário (pessoa física) responsável por preencher os dados cadastrais do investidor. Para **pessoa física**, normalmente este usuário é o próprio investidor e o campo pode ser omitido. Para **pessoa jurídica**, é o representante que responderá pelo preenchimento. ::: ### Body params | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------------------------|----------|---------------------------------------------------------------------------------------------|--------------|-------------| | `name` | string | Nome (ou razão social) do investidor | 1 - 255 | Sim | | `person_type` | string | Enumerador de **[Person Type](#person-type)** | - | Sim | | `document_number` | string | CPF (`XXX.XXX.XXX-XX`) ou CNPJ (`XX.XXX.XXX/XXXX-XX`) | 14 ou 18 | Sim* | | `investor_sub_type` | string | Enumerador de **[Investor Sub Type](#investor-sub-type)** | - | Não | | `email` | string | E-mail do investidor | 1 - 255 | Não | | `phone` | object | Objeto de **[Phone](#phone)** | - | Não | | `registry_user` | object | Objeto de **[Registry User](#registry-user)** | - | Não | ### Phone | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------------------------|----------|---------------------------------------------------------------------------------------------|--------------|-------------| | `international_dial_code` | string | Código internacional (ex.: `55`) | 1 - 3 | Sim | | `area_code` | string | DDD | 2 | Sim | | `number` | string | Número do telefone | 8 - 9 | Sim | ### Registry User | Campo | Tipo | Descrição | Caracteres | Obrigatório | |---------------------|----------|------------------------------------------------------|--------------|-------------| | `name` | string | Nome do usuário cadastrador | 1 - 255 | Sim | | `document_number` | string | CPF do usuário (formato `XXX.XXX.XXX-XX`) | 14 | Sim | | `email` | string | E-mail do usuário | 1 - 255 | Sim | | `phone` | object | Objeto de **[Phone](#phone)** | - | Sim | ### Person Type {#person-type} | Enumerador | Descrição | |---------------------|------------------------------------------------------| | `natural_person` | Pessoa física | | `legal_person` | Pessoa jurídica | ### Investor Sub Type {#investor-sub-type} | Enumerador | Descrição | |--------------------------|--------------------------------------------------------------------------------------------| | `default` | Pessoa jurídica regular (default quando o campo não é informado) | ### Response ```json title='Response Body' { "investor_key": "UUID", "investor_analysis_key": "UUID" } ``` --- # definir_grupo_assinantes_padrao URL: /documentation/iaas/investidor/cadastro/definir_grupo_assinantes_padrao --- # enviar_cadastro_para_analise URL: /documentation/iaas/investidor/cadastro/enviar_cadastro_para_analise --- # enviar_dados_cadastrais URL: /documentation/iaas/investidor/cadastro/enviar_dados_cadastrais --- # enviar_endereco URL: /documentation/iaas/investidor/cadastro/enviar_endereco --- # enviar_grupos_assinantes URL: /documentation/iaas/investidor/cadastro/enviar_grupos_assinantes --- # enviar_investor_document URL: /documentation/iaas/investidor/cadastro/enviar_investor_document --- # enviar_patrimonio URL: /documentation/iaas/investidor/cadastro/enviar_patrimonio --- # consultar_feedback URL: /documentation/iaas/investidor/cadastro/feedback/consultar_feedback --- # enviar_mensagem_feedback URL: /documentation/iaas/investidor/cadastro/feedback/enviar_mensagem_feedback --- # listar_feedbacks URL: /documentation/iaas/investidor/cadastro/feedback/listar_feedbacks --- # Introdução URL: /documentation/iaas/investidor/cadastro/introducao Esta seção reúne os fluxos de cadastro de investidores que não se enquadram nas categorias específicas — **Carteira Administrada**, **Fundo de Investimento** ou **Distribuição Externa** —, cobrindo pessoas físicas e jurídicas em geral, como é o caso de um consultor (`consultant-integration`) ou gestor (`manager-integration`) estar cadastrando um investidor. O cadastro contempla o envio de dados cadastrais, endereço, patrimônio, contas bancárias, suitability, grupos de assinantes, partes relacionadas e, quando aplicável, *investor owner*, até o disparo da análise cadastral pela QI Tech. Importante ressaltar que nesses casos a assinatura é sempre executada exclusivamente pelo investidor ou representante legal identificado durante a análise. ### Fluxo de Cadastro 1. Criar Investidor criação inicial do investidor e abertura da primeira análise cadastral ↓ 2. Enviar Dados Cadastrais dados específicos da pessoa física ou jurídica ↓ 3. Enviar Endereço informações de endereço ↓ 4. Enviar Patrimônio informações de patrimônio e enquadramento ↓ 5. Enviar Contas Bancárias contas para movimentação ↓ 6. Enviar Suitability questionário de adequação ao perfil (não exigido para fundos de investimento) ↓ 7. Enviar Grupos de Assinantes definição de quem deve assinar os documentos ↓ 8. Enviar Documentos do Investidor upload de documentos obrigatórios ↓ 9. Criar Partes Relacionadas sócios, diretores, beneficiários finais ↓ 10. Enviar Documentos das Partes Relacionadas documentos de cada parte relacionada ↓ 11. Enviar para Análise submissão da análise cadastral para validação ↓ 12. Assinar Documentos assinatura dos documentos gerados após aprovação Nas subseções a seguir veremos cada uma das etapas necessárias para concluir esses cadastros. --- # criar_parte_relacionada URL: /documentation/iaas/investidor/cadastro/related_party/criar_parte_relacionada --- # enviar_documento_parte_relacionada URL: /documentation/iaas/investidor/cadastro/related_party/enviar_documento_parte_relacionada --- # consultar_formulario_suitability URL: /documentation/iaas/investidor/cadastro/suitability/consultar_formulario_suitability --- # enviar_suitability URL: /documentation/iaas/investidor/cadastro/suitability/enviar_suitability --- # atualizacao_cadastral URL: /documentation/iaas/investidor/carteira_administrada/atualizacao_cadastral --- # atualizar_status_grupo_assinantes URL: /documentation/iaas/investidor/carteira_administrada/atualizar_status_grupo_assinantes --- # busca_informacoes_de_uma_analise_cadastral_do_investidor URL: /documentation/iaas/investidor/carteira_administrada/busca_informacoes_de_uma_analise_cadastral_do_investidor --- # busca_informacoes_do_investidor URL: /documentation/iaas/investidor/carteira_administrada/busca_informacoes_do_investidor --- # buscar_documentos_para_assinatura URL: /documentation/iaas/investidor/carteira_administrada/buscar_documentos_para_assinatura --- # consultar_analise_em_andamento URL: /documentation/iaas/investidor/carteira_administrada/consultar_analise_em_andamento --- # atualizar_status_conta_bancaria URL: /documentation/iaas/investidor/carteira_administrada/contas_bancarias/atualizar_status_conta_bancaria --- # definir_conta_principal URL: /documentation/iaas/investidor/carteira_administrada/contas_bancarias/definir_conta_principal --- # enviar_contas_bancarias URL: /documentation/iaas/investidor/carteira_administrada/contas_bancarias/enviar_contas_bancarias --- # Criar investidor URL: /documentation/iaas/investidor/carteira_administrada/criar_investidor --- ### Introdução Este recurso tem como objetivo nos informar dados básicos para iniciar o cadastro de um **investidor**. A criação de um investidor já dispara, em conjunto, a abertura de uma primeira **análise cadastral** vinculada a ele. Por isso, ao final desta chamada são retornadas duas chaves: ***investor_key*** (identifica o investidor) e ***investor_analysis_key*** (identifica a análise cadastral em andamento). :::info Informação No ambiente de Homologação, temos a seguinte regra para aprovações: CPF/CNPJ com início **1**: reprovação automática; CPF/CNPJ com início **8**: pendente de validação manual; o restante é aprovado automaticamente. ::: ### Input / Output Como ***input*** envie os dados básicos do investidor. Os campos obrigatórios variam de acordo com **`person_type`** e **`investor_sub_type`**. Como ***output*** serão retornadas a ***investor_key*** e a ***investor_analysis_key***. A ***investor_key*** identifica o investidor; a ***investor_analysis_key*** identifica a análise cadastral aberta junto com a criação. Um mesmo investidor pode possuir mais de uma análise cadastral ao longo do tempo (renovações, atualizações). ### Request ENDPOINT `/investor_registry/investor` MÉTODO `POST` STATUS `201` ### Request body Caso 01: Pessoa Física ```json title='Request Body' { "name": "João da Silva", "document_number": "123.456.789-00", "person_type": "natural_person", "email": "joao.silva@example.com", "phone": { "international_dial_code": "55", "area_code": "11", "number": "987654321" } } ``` Caso 02: Pessoa Jurídica ```json title='Request Body' { "name": "Empresa XPTO Ltda", "document_number": "12.345.678/0001-90", "person_type": "legal_person", "investor_sub_type": "default" } ``` :::warning Atenção Os campos obrigatórios mudam de acordo com o **`person_type`**: - **`natural_person`**: `name`, `document_number`, `person_type` (`email` e `phone` recomendados para criação de usuário) - **`legal_person`**: `name`, `document_number`, `person_type`, `investor_sub_type` ::: ### Body params | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------------------------|----------|---------------------------------------------------------------------------------------------|--------------|-------------| | `name` | string | Nome (ou razão social) do investidor | 1 - 255 | Sim | | `person_type` | string | Enumerador de **[Person Type](#person-type)** | - | Sim | | `document_number` | string | CPF (`XXX.XXX.XXX-XX`) ou CNPJ (`XX.XXX.XXX/XXXX-XX`) | 14 ou 18 | Sim* | | `investor_sub_type` | string | Enumerador de **[Investor Sub Type](#investor-sub-type)** | - | Não | | `email` | string | E-mail do investidor | 1 - 255 | Não | | `phone` | object | Objeto de **[Phone](#phone)** | - | Não | | `investor_owner_type` | string | Tipo de relação de propriedade - Enumerador de **[Investor Owner Type](#investor-owner-type)** | 1 - 255 | Não | ### Phone | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------------------------|----------|---------------------------------------------------------------------------------------------|--------------|-------------| | `international_dial_code` | string | Código internacional (ex.: `55`) | 1 - 3 | Sim | | `area_code` | string | DDD | 2 | Sim | | `number` | string | Número do telefone | 8 - 9 | Sim | ### Person Type {#person-type} | Enumerador | Descrição | |---------------------|------------------------------------------------------| | `natural_person` | Pessoa física | | `legal_person` | Pessoa jurídica | ### Investor Sub Type {#investor-sub-type} | Enumerador | Descrição | |--------------------------|--------------------------------------------------------------------------------------------| | `default` | Pessoa jurídica regular (default quando o campo não é informado) | ### Investor Owner Type {#investor-owner-type} | Enumerador | Descrição | |--------------------------|--------------------------------------------------------------------------------------------| | `wallet_manager` | Gestor de Carteira ### Response ```json title='Response Body' { "investor_key": "UUID", "investor_analysis_key": "UUID" } ``` --- # definir_grupo_assinantes_padrao URL: /documentation/iaas/investidor/carteira_administrada/definir_grupo_assinantes_padrao --- # enviar_cadastro_para_analise URL: /documentation/iaas/investidor/carteira_administrada/enviar_cadastro_para_analise --- # enviar_dados_cadastrais URL: /documentation/iaas/investidor/carteira_administrada/enviar_dados_cadastrais --- # enviar_endereco URL: /documentation/iaas/investidor/carteira_administrada/enviar_endereco --- # enviar_grupos_assinantes URL: /documentation/iaas/investidor/carteira_administrada/enviar_grupos_assinantes --- # enviar_investor_document URL: /documentation/iaas/investidor/carteira_administrada/enviar_investor_document --- # enviar_patrimonio URL: /documentation/iaas/investidor/carteira_administrada/enviar_patrimonio --- # consultar_feedback URL: /documentation/iaas/investidor/carteira_administrada/feedback/consultar_feedback --- # enviar_mensagem_feedback URL: /documentation/iaas/investidor/carteira_administrada/feedback/enviar_mensagem_feedback --- # listar_feedbacks URL: /documentation/iaas/investidor/carteira_administrada/feedback/listar_feedbacks --- # Introdução URL: /documentation/iaas/investidor/carteira_administrada/introducao Esta seção descreve o fluxo de cadastro de investidores do tipo **Carteira Administrada** — carteiras geridas profissionalmente em nome de um titular econômico (o *investor owner*). Diferente do cadastro de uma pessoa física ou jurídica padrão, aqui o investidor é a própria carteira, e o cadastro precisa contemplar tanto os dados da carteira quanto os dados do titular que detém os recursos investidos por meio dela. O tipo de integração utilizada para esse tipo de cadastro de investidor é a `investor-integration`, descrita na seção de introdução da documentação. Para cadastrar um investidor através de uma gestora de carteiras é necessário que o cadastro da gestora esteja atualizado, o que pode ser garantido e mantido através da mesma integração de investidor. Dessa forma, a gestora pode realizar sua atualização cadastral através da API de cadastro de investidores, bem como a manutenção de seus próprios investidores. Um ponto muito importante é que apenas gestoras que estiverem com seus cadastros atualizados podem realizar o cadastro de investidores de carteira administrada. Portanto, é necessário realizar essa manutenção cadastral. ### Fluxo de Cadastro 1. Criar Investidor criação inicial do investidor e abertura da primeira análise cadastral ↓ 2. Enviar Dados Cadastrais dados específicos da pessoa física ou jurídica ↓ 3. Enviar Endereço informações de endereço ↓ 4. Enviar Patrimônio informações de patrimônio e enquadramento ↓ 5. Enviar Contas Bancárias contas para movimentação ↓ 6. Enviar Suitability questionário de adequação ao perfil ↓ 7. Enviar Grupos de Assinantes definição de quem deve assinar os documentos ↓ 8. Enviar Documentos do Investidor upload de documentos obrigatórios ↓ 9. Criar Partes Relacionadas sócios, diretores, beneficiários finais ↓ 10. Enviar Documentos das Partes Relacionadas documentos de cada parte relacionada ↓ 11. Enviar Contrato de Carteira Administrada documento que atesta representação legal ↓ 12. Enviar para Análise submissão da análise cadastral para validação ↓ 13. Assinar Documentos assinatura dos documentos gerados após aprovação Nas subseções a seguir veremos cada uma das etapas necessárias para concluir o cadastro de uma Carteira Administrada e disparar a análise cadastral pela QI Tech. --- # enviar_documento_investor_owner URL: /documentation/iaas/investidor/carteira_administrada/investor_owner/enviar_documento_investor_owner --- # criar_parte_relacionada URL: /documentation/iaas/investidor/carteira_administrada/related_party/criar_parte_relacionada --- # enviar_documento_parte_relacionada URL: /documentation/iaas/investidor/carteira_administrada/related_party/enviar_documento_parte_relacionada --- # consultar_formulario_suitability URL: /documentation/iaas/investidor/carteira_administrada/suitability/consultar_formulario_suitability --- # enviar_suitability URL: /documentation/iaas/investidor/carteira_administrada/suitability/enviar_suitability --- # assinar_documento URL: /documentation/iaas/investidor/distribuicao_externa/assinar_documento --- # atualizacao_cadastral URL: /documentation/iaas/investidor/distribuicao_externa/atualizacao_cadastral --- # atualizar_status_grupo_assinantes URL: /documentation/iaas/investidor/distribuicao_externa/atualizar_status_grupo_assinantes --- # busca_informacoes_de_uma_analise_cadastral_do_investidor URL: /documentation/iaas/investidor/distribuicao_externa/busca_informacoes_de_uma_analise_cadastral_do_investidor --- # busca_informacoes_do_investidor URL: /documentation/iaas/investidor/distribuicao_externa/busca_informacoes_do_investidor --- # buscar_documentos_para_assinatura URL: /documentation/iaas/investidor/distribuicao_externa/buscar_documentos_para_assinatura --- # consultar_analise_em_andamento URL: /documentation/iaas/investidor/distribuicao_externa/consultar_analise_em_andamento --- # atualizar_status_conta_bancaria URL: /documentation/iaas/investidor/distribuicao_externa/contas_bancarias/atualizar_status_conta_bancaria --- # definir_conta_principal URL: /documentation/iaas/investidor/distribuicao_externa/contas_bancarias/definir_conta_principal --- # enviar_contas_bancarias URL: /documentation/iaas/investidor/distribuicao_externa/contas_bancarias/enviar_contas_bancarias --- # Criar investidor URL: /documentation/iaas/investidor/distribuicao_externa/criar_investidor --- ### Introdução Este recurso tem como objetivo nos informar dados básicos para iniciar o cadastro de um **investidor**. A criação de um investidor já dispara, em conjunto, a abertura de uma primeira **análise cadastral** vinculada a ele. Por isso, ao final desta chamada são retornadas duas chaves: ***investor_key*** (identifica o investidor) e ***investor_analysis_key*** (identifica a análise cadastral em andamento). Existem 3 tipos principais de investidor, definidos pelo campo **`person_type`**: **pessoa física** (`natural_person`), **pessoa jurídica** (`legal_person`) e **PCO** ('nominee'). Para pessoas jurídicas, o campo **`investor_sub_type`** distingue subtipos como **fundo de investimento** (`fund_class`), que possuem regras próprias ao longo do fluxo de cadastro. :::warning Atenção Para os casos de investidores distribuídos por conta e ordem (PCO | `nominee`) não existe uma esteira cadastral e portanto, apenas o `POST` de criação é necessário para torná-lo apto em todo o sistema. ::: :::info Informação No ambiente de Homologação, temos a seguinte regra para aprovações: CPF/CNPJ com início **1**: reprovação automática; CPF/CNPJ com início **8**: pendente de validação manual; o restante é aprovado automaticamente. ::: ### Input / Output Como ***input*** envie os dados básicos do investidor. Os campos obrigatórios variam de acordo com **`person_type`** e **`investor_sub_type`**. Como ***output*** serão retornadas a ***investor_key*** e a ***investor_analysis_key***. A ***investor_key*** identifica o investidor; a ***investor_analysis_key*** identifica a análise cadastral aberta junto com a criação. Um mesmo investidor pode possuir mais de uma análise cadastral ao longo do tempo (renovações, atualizações). ### Request ENDPOINT `/investor_registry/v2/investor` MÉTODO `POST` STATUS `201` ### Request body Caso 01: Pessoa Física ```json title='Request Body' { "name": "João da Silva", "document_number": "123.456.789-00", "person_type": "natural_person", "email": "joao.silva@example.com", "phone": { "international_dial_code": "55", "area_code": "11", "number": "987654321" } } ``` Caso 02: Pessoa Jurídica ```json title='Request Body' { "name": "Empresa XPTO Ltda", "document_number": "12.345.678/0001-90", "person_type": "legal_person", "investor_sub_type": "default", "registry_user": { "name": "José da Silva", "document_number": "123.456.789-00", "email": "jose.silva@example.com", "phone": { "international_dial_code": "55", "area_code": "11", "number": "987654321" } } } ``` Caso 03: Pessoa Jurídica — Fundo de Investimento ( fund_class ) ```json title='Request Body' { "name": "Fundo XPTO Multimercado", "document_number": "12.345.678/0001-90", "person_type": "legal_person", "investor_sub_type": "fund_class" } ``` Caso 04: Nominee (PCO) ```json title='Request Body' { "name": "Nominee XPTO", "person_type": "nominee", "external_distribution_key": "ID-DISTRIBUICAO-001" } ``` :::warning Atenção Os campos obrigatórios mudam de acordo com o **`person_type`**: - **`natural_person`**: `name`, `document_number`, `person_type` (`email` e `phone` recomendados para criação de usuário) - **`legal_person`**: `name`, `document_number`, `person_type`, `investor_sub_type` e `registry_user` - **`nominee`**: `name`, `person_type`, `external_distribution_key` ::: :::info Sobre o `registry_user` O **`registry_user`** representa o usuário (pessoa física) responsável por preencher os dados cadastrais do investidor. Para **pessoa física**, normalmente este usuário é o próprio investidor e o campo pode ser omitido. Para **pessoa jurídica**, é o representante que responderá pelo preenchimento. ::: :::info Investidores `fund_class` Para fundos de investimento (`investor_sub_type: "fund_class"`), parte dos dados cadastrais é preenchida automaticamente a partir da base da CVM no momento do envio para análise — incluindo razão social, data de constituição, patrimônio e vínculos com administrador, gestor e (quando aplicável) investidor exclusivo. Veja o documento **Criar Investor Owner** para o cadastro de relações de propriedade adicionais. ::: ### Body params | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------------------------|----------|---------------------------------------------------------------------------------------------|--------------|-------------| | `name` | string | Nome (ou razão social) do investidor | 1 - 255 | Sim | | `person_type` | string | Enumerador de **[Person Type](#person-type)** | - | Sim | | `document_number` | string | CPF (`XXX.XXX.XXX-XX`) ou CNPJ (`XX.XXX.XXX/XXXX-XX`) | 14 ou 18 | Sim* | | `investor_sub_type` | string | Enumerador de **[Investor Sub Type](#investor-sub-type)** | - | Não | | `external_distribution_key` | string | Identificador externo da distribuição (uso típico para `nominee`) | 1 - 100 | Não | | `email` | string | E-mail do investidor | 1 - 255 | Não | | `phone` | object | Objeto de **[Phone](#phone)** | - | Não | | `investor_owner_type` | string | Tipo de relação de propriedade (utilizado em integrações específicas, ex. fund class) | 1 - 255 | Não | | `registry_user` | object | Objeto de **[Registry User](#registry-user)** | - | Não | \* `document_number` não deve ser enviado para `person_type: nominee`. ### Phone | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------------------------|----------|---------------------------------------------------------------------------------------------|--------------|-------------| | `international_dial_code` | string | Código internacional (ex.: `55`) | 1 - 3 | Sim | | `area_code` | string | DDD | 2 | Sim | | `number` | string | Número do telefone | 8 - 9 | Sim | ### Registry User | Campo | Tipo | Descrição | Caracteres | Obrigatório | |---------------------|----------|------------------------------------------------------|--------------|-------------| | `name` | string | Nome do usuário cadastrador | 1 - 255 | Sim | | `document_number` | string | CPF do usuário (formato `XXX.XXX.XXX-XX`) | 14 | Sim | | `email` | string | E-mail do usuário | 1 - 255 | Sim | | `phone` | object | Objeto de **[Phone](#phone)** | - | Sim | ### Person Type {#person-type} | Enumerador | Descrição | |---------------------|------------------------------------------------------| | `natural_person` | Pessoa física | | `legal_person` | Pessoa jurídica | | `nominee` | Nominee / PCO (sem documento obrigatório) | ### Investor Sub Type {#investor-sub-type} | Enumerador | Descrição | |--------------------------|--------------------------------------------------------------------------------------------| | `default` | Pessoa jurídica regular (default quando o campo não é informado) | | `fund_class` | Fundo de investimento — dispara enriquecimento automático com dados públicos da CVM | ### Response ```json title='Response Body' { "investor_key": "UUID", "investor_analysis_key": "UUID" } ``` --- # definir_grupo_assinantes_padrao URL: /documentation/iaas/investidor/distribuicao_externa/definir_grupo_assinantes_padrao --- # enviar_cadastro_para_analise URL: /documentation/iaas/investidor/distribuicao_externa/enviar_cadastro_para_analise --- # Enviar Dados Cadastrais do Investidor URL: /documentation/iaas/investidor/distribuicao_externa/enviar_dados_cadastrais --- ### Introdução Este recurso tem como objetivo enviar os dados cadastrais específicos da pessoa que compõe a **análise cadastral** de um investidor. O corpo enviado deve conter **um** dos blocos `natural_person` ou `legal_person`, coerente com o `person_type` informado na criação do investidor. ### Input / Output Como ***input*** envie os dados cadastrais específicos do tipo de investidor. Como ***output*** será retornada a representação atualizada da análise cadastral. As chaves ***investor_key*** e ***investor_analysis_key*** identificam o investidor e a análise atualizada. :::info Investidor `fund_class` Para fundos de investimento (`investor_sub_type: "fund_class"`), as informações da pessoa jurídica (razão social, data de constituição, etc.) são preenchidas **automaticamente** a partir da base da CVM ao enviar a análise para validação. Esta etapa não é necessária para esse subtipo. ::: ### Request ENDPOINT `/investor_registry/v2/investor/{investor_key}/investor_analysis/{investor_analysis_key}/registry_data` MÉTODO `PUT` STATUS `202` ### Request body Exemplo: Pessoa Física ```json title='Request Body' { "name": "João da Silva", "email": "joao.silva@example.com", "phone": { "international_dial_code": "55", "area_code": "11", "number": "987654321" }, "natural_person": { "birthdate": "1990-05-15", "gender": "male", "mother_name": "Maria da Silva", "nationality": "BRA", "place_of_birth": { "country": "BRA", "uf": "SP", "city": "São Paulo" }, "marital_status": "single", "spouse": { "name": "Maria Santos", "document_number": "123.456.789-00" }, "profession": "Engenheiro", "occupation": "Engenheiro de Software", "occupation_company": { "name": "Empresa XYZ Ltda", "document_number": "12.345.678/0001-90" } } } ``` Exemplo: Pessoa Jurídica ```json title='Request Body' { "name": "Empresa XPTO Ltda", "email": "contato@empresaxpto.com.br", "phone": { "international_dial_code": "55", "area_code": "11", "number": "1234567890" }, "legal_person": { "legal_name": "Empresa XPTO Limitada", "constitution_date": "2020-01-15" } } ``` Exemplo: Pessoa Jurídica (`fund_class`) ```json title='Request Body' { "name": "Empresa XPTO Ltda", "email": "contato@empresaxpto.com.br", "phone": { "international_dial_code": "55", "area_code": "11", "number": "1234567890" }, "legal_person": { "giin_number": "XXXXXX.XXXXX.XX.XXX", } } ``` ### Body params | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-------------------|----------|--------------------------------------------------------------------------------------|------------|-------------| | `name` | string | Nome (ou razão social) do investidor | 1 - 255 | Não | | `email` | string | E-mail de contato | 1 - 255 | Não | | `phone` | object | Objeto de **[Phone](#phone)** | - | Não | | `natural_person` | object | Objeto de **[Natural Person](#natural-person)** — obrigatório para pessoa física | - | Sim* | | `legal_person` | object | Objeto de **[Legal Person](#legal-person)** — obrigatório para pessoa jurídica | - | Sim* | \* É obrigatório enviar **exatamente um** entre `natural_person` ou `legal_person`, de acordo com o `person_type` do investidor. ### Natural Person {#natural-person} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |------------------------|--------|-----------------------------------------------------------------|------------|-------------| | `birthdate` | string | Data de nascimento (`YYYY-MM-DD`) | 10 | Sim | | `mother_name` | string | Nome completo da mãe | 1 - 255 | Sim | | `nationality` | string | Nacionalidade — código ISO de 3 letras (ex.: `BRA`) | 3 | Sim | | `place_of_birth` | object | Objeto de **[Place of Birth](#place-of-birth)** | - | Sim | | `marital_status` | string | Enumerador de **[Marital Status](#marital-status)** | - | Sim | | `profession` | string | Profissão | 1 - 255 | Sim | | `occupation` | string | Ocupação | 1 - 255 | Sim | | `gender` | string | Enumerador de **[Gender](#gender)** | - | Não | | `spouse` | object | Objeto de **[Spouse](#spouse)** | - | Não | | `occupation_company` | object | Objeto de **[Occupation Company](#occupation-company)** | - | Não | ### Gender {#gender} | Enumerador | Descrição | |------------|--------------| | `male` | Masculino | | `female` | Feminino | ### Marital Status {#marital-status} | Enumerador | Descrição | |---------------------------------------------|-------------------------------------------------| | `single` | Solteiro(a) | | `married` | Casado(a) | | `civil_union` | União estável | | `divorced` | Divorciado(a) | | `widowed` | Viúvo(a) | | `married_with_partial_community_property` | Casado(a) em comunhão parcial de bens | ### Place of Birth {#place-of-birth} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------|--------|----------------------------------------------------|------------|-------------| | `country` | string | Código ISO do país (3 letras, ex.: `BRA`) | 3 | Não | | `uf` | string | Estado (UF) | - | Não | | `city` | string | Cidade | - | Não | ### Spouse {#spouse} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-------------------|--------|----------------------------------------------------------------------|------------|-------------| | `name` | string | Nome completo do cônjuge | 1 - 255 | Sim | | `document_number` | string | CPF do cônjuge (`XXX.XXX.XXX-XX`) | 14 | Sim | ### Occupation Company {#occupation-company} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-------------------|--------|------------------------------------------------------------|------------|-------------| | `name` | string | Nome da empresa | 1 - 255 | Sim | | `document_number` | string | CNPJ da empresa (`XX.XXX.XXX/XXXX-XX`) | 18 | Sim | ### Legal Person {#legal-person} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |---------------------|--------|--------------------------------------------------------------------------|------------|-------------| | `legal_name` | string | Razão social da empresa | 1 - 255 | Não | | `constitution_date` | string | Data de constituição (`YYYY-MM-DD`) | 10 | Não | | `giin_number` | string | GIIN (`Global Intermediary Identification Number`), quando aplicável | 1 - 20 | Não | ### Phone {#phone} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |---------------------------|--------|------------------------|------------|-------------| | `international_dial_code` | string | Código internacional | 1 - 3 | Sim | | `area_code` | string | DDD | 2 | Sim | | `number` | string | Número de telefone | 8 - 9 | Sim | ### Response A análise cadastral atualizada é retornada no corpo da resposta. Para o formato completo, consulte **Busca informações de uma análise cadastral do investidor**. --- --- # enviar_documento_assinado URL: /documentation/iaas/investidor/distribuicao_externa/enviar_documento_assinado --- # enviar_endereco URL: /documentation/iaas/investidor/distribuicao_externa/enviar_endereco --- # enviar_grupos_assinantes URL: /documentation/iaas/investidor/distribuicao_externa/enviar_grupos_assinantes --- # Enviar Documento do Investidor URL: /documentation/iaas/investidor/distribuicao_externa/enviar_investor_document --- ### 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). :::warning 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) ```json title='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) ```json title='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" } } ``` ```json title='Request Body — Verso' { "type": "rg_back", "document_b64": "base64_encoded_document_content", "file_extension": "jpeg" } ``` Exemplo: Cartão CNPJ (Pessoa Jurídica) ```json title='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](#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 {#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`). --- # enviar_patrimonio URL: /documentation/iaas/investidor/distribuicao_externa/enviar_patrimonio --- # Enviar Resposta Suitability URL: /documentation/iaas/investidor/distribuicao_externa/enviar_suitability --- ### Introdução Este recurso tem como objetivo enviar a categoria suitability definida para o investidor. ### Input / Output: Os dados cadastrais mudam de acordo com os dados passados na etapa de **Criar investidor**. Segue abaixo exemplos de quais dados devem ser enviados para cada variação. Como ***output*** será entregue uma ***investor_key*** e uma ***investor_analysis_key***. A ***investor_analysis_key*** é utilizada para identificar a **análise cadastral** atualizada. A ***investor_key*** é utilizada para identificar o **investidor** ao qual a **análise cadastral** pertence. :::warning Atenção O envio do `suitability` é **opcional** para investidores que sejam Pessoa Jurídica enquadradas como qualificadas ou profissionais. ::: ### Request ENDPOINT `/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/suitability` MÉTODO `PUT` STATUS `202` Exemplo ```json title='Request Body' { "profile": "bold" } ``` ### Body Params | Campo | Tipo | Descrição | Caracteres | Obrigatório | |---------------------|----------|------------------------------------------------------|--------------|-------------| | `profile` | string | **[categoria suitability cadastrador](#profile)** | 1 - 255 | Sim | ### Profile {#profile} | Enumerador | Descrição | |---------------------|------------------------------------------------------| | `bold` | Arrojado | | `moderate` | Moderado | | `conservative` | Conservador | ### Response A análise cadastral atualizada é retornada no corpo da resposta. --- # consultar_feedback URL: /documentation/iaas/investidor/distribuicao_externa/feedback/consultar_feedback --- # enviar_mensagem_feedback URL: /documentation/iaas/investidor/distribuicao_externa/feedback/enviar_mensagem_feedback --- # listar_feedbacks URL: /documentation/iaas/investidor/distribuicao_externa/feedback/listar_feedbacks --- # Introdução URL: /documentation/iaas/investidor/distribuicao_externa/introducao Esta seção descreve o fluxo de cadastro de investidores no contexto de **Distribuição Externa** — quando os investidores são captados por um distribuidor externo e aportam em produtos da QI Tech por meio dele — através da integração de distribuição externa (`distributor-integration`). Embora o esqueleto do cadastro seja semelhante ao de um investidor padrão (dados cadastrais, contas bancárias, suitability, grupos de assinantes, partes relacionadas e investor owner quando aplicável), o vínculo com o distribuidor responsável é o que diferencia este fluxo dos demais. Além disso, existem duas formas diferentes de criar investidores distribuídos externamente: uma com identificação do investidor e outra **PCO** (Por Conta e Ordem). Para o caso de investidores PCO, é necessário apenas o `POST` de criação do investidor e ele já estará apto a investir em todo o sistema. :::warning Investor Owner O sistema de cadastro de investidor trabalha com o conceito de investor-owner, que nada mais é do que um investidor que é "dono" de outro investidor. Os casos de uso para isso são investidores cadastrados como carteira administrada e fundos de investimento. Portanto, para fundos de investimento e investidores de carteira administrada é necessário que os gestores/administrador estejam devidamente identificados e atualizados dentro do sistema. ::: ### Fluxo de Cadastro — Investidor Identificado 1. Criar Investidor criação inicial do investidor e abertura da primeira análise cadastral ↓ 2. Enviar Dados Cadastrais dados específicos da pessoa física ou jurídica ↓ 3. Enviar Endereço informações de endereço ↓ 4. Enviar Patrimônio informações de patrimônio e enquadramento ↓ 5. Enviar Contas Bancárias contas para movimentação ↓ 6. Enviar Suitability questionário de adequação ao perfil ↓ 7. Enviar Grupos de Assinantes definição de quem deve assinar os documentos ↓ 8. Enviar Documentos do Investidor upload de documentos obrigatórios ↓ 9. Criar Partes Relacionadas sócios, diretores, beneficiários finais ↓ 10. Enviar Documentos das Partes Relacionadas documentos de cada parte relacionada ↓ 11. Enviar para Análise submissão da análise cadastral para validação ↓ 12. Assinar Documentos assinatura dos documentos gerados após aprovação ### Fluxo de Cadastro — Por Conta e Ordem (PCO) 1. Criar Investidor criação inicial do investidor — não há esteira cadastral adicional para PCO Nas subseções a seguir veremos cada uma das etapas necessárias para concluir o cadastro de um investidor via Distribuição Externa e disparar a análise cadastral pela QI Tech. --- # criar_investor_owner URL: /documentation/iaas/investidor/distribuicao_externa/investor_owner/criar_investor_owner --- # enviar_documento_investor_owner URL: /documentation/iaas/investidor/distribuicao_externa/investor_owner/enviar_documento_investor_owner --- # criar_parte_relacionada URL: /documentation/iaas/investidor/distribuicao_externa/related_party/criar_parte_relacionada --- # enviar_documento_parte_relacionada URL: /documentation/iaas/investidor/distribuicao_externa/related_party/enviar_documento_parte_relacionada --- # atualizacao_cadastral URL: /documentation/iaas/investidor/fundo_de_investimento/atualizacao_cadastral --- # busca_informacoes_de_uma_analise_cadastral_do_investidor URL: /documentation/iaas/investidor/fundo_de_investimento/busca_informacoes_de_uma_analise_cadastral_do_investidor --- # busca_informacoes_do_investidor URL: /documentation/iaas/investidor/fundo_de_investimento/busca_informacoes_do_investidor --- # buscar_documentos_para_assinatura URL: /documentation/iaas/investidor/fundo_de_investimento/buscar_documentos_para_assinatura --- # atualizar_status_conta_bancaria URL: /documentation/iaas/investidor/fundo_de_investimento/contas_bancarias/atualizar_status_conta_bancaria --- # definir_conta_principal URL: /documentation/iaas/investidor/fundo_de_investimento/contas_bancarias/definir_conta_principal --- # enviar_contas_bancarias URL: /documentation/iaas/investidor/fundo_de_investimento/contas_bancarias/enviar_contas_bancarias --- # Criar investidor URL: /documentation/iaas/investidor/fundo_de_investimento/criar_investidor --- ### Introdução Este recurso tem como objetivo nos informar dados básicos para iniciar o cadastro de um **investidor**. A criação de um investidor já dispara, em conjunto, a abertura de uma primeira **análise cadastral** vinculada a ele. Por isso, ao final desta chamada são retornadas duas chaves: ***investor_key*** (identifica o investidor) e ***investor_analysis_key*** (identifica a análise cadastral em andamento). :::info Informação No ambiente de Homologação, temos a seguinte regra para aprovações: CNPJ com início **1**: reprovação automática; CNPJ com início **8**: pendente de validação manual; o restante é aprovado automaticamente. ::: ### Input / Output Como ***input*** envie os dados básicos do investidor. Como ***output*** serão retornadas a ***investor_key*** e a ***investor_analysis_key***. A ***investor_key*** identifica o investidor; a ***investor_analysis_key*** identifica a análise cadastral aberta junto com a criação. Um mesmo investidor pode possuir mais de uma análise cadastral ao longo do tempo (renovações, atualizações). ### Request ENDPOINT `/investor_registry/investor` MÉTODO `POST` STATUS `201` ### Request body Caso 03: Pessoa Jurídica — Fundo de Investimento ( fund_class ) ```json title='Request Body' { "name": "Fundo XPTO Multimercado", "document_number": "12.345.678/0001-90", "person_type": "legal_person", "investor_sub_type": "fund_class" } ``` :::info Investidores `fund_class` Para fundos de investimento (`investor_sub_type: "fund_class"`), parte dos dados cadastrais é preenchida automaticamente a partir da base da CVM no momento do envio para análise — incluindo razão social, data de constituição, patrimônio e vínculos com administrador, gestor e (quando aplicável) investidor exclusivo. ::: ### Body params | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-----------------------------|----------|---------------------------------------------------------------------------------------------|--------------|-------------| | `name` | string | Nome (ou razão social) do investidor | 1 - 255 | Sim | | `person_type` | string | Enumerador de **[Person Type](#person-type)** | - | Sim | | `document_number` | string | CNPJ (`XX.XXX.XXX/XXXX-XX`) | 18 | Sim* | | `investor_sub_type` | string | Enumerador de **[Investor Sub Type](#investor-sub-type)** | - | Não | ### Person Type {#person-type} | Enumerador | Descrição | |---------------------|------------------------------------------------------| | `legal_person` | Pessoa jurídica | ### Investor Sub Type {#investor-sub-type} | Enumerador | Descrição | |--------------------------|--------------------------------------------------------------------------------------------| | `fund_class` | Fundo de investimento — dispara enriquecimento automático com dados públicos da CVM | ### Response ```json title='Response Body' { "investor_key": "UUID", "investor_analysis_key": "UUID" } ``` --- # enviar_cadastro_para_analise URL: /documentation/iaas/investidor/fundo_de_investimento/enviar_cadastro_para_analise --- # Enviar Dados Cadastrais do Investidor URL: /documentation/iaas/investidor/fundo_de_investimento/enviar_dados_cadastrais --- ### Introdução Este recurso tem como objetivo enviar os dados cadastrais específicos da pessoa que compõe a **análise cadastral** de um investidor. ### Input / Output Como ***input*** envie os dados cadastrais específicos do tipo de investidor. Como ***output*** será retornada a representação atualizada da análise cadastral. As chaves ***investor_key*** e ***investor_analysis_key*** identificam o investidor e a análise atualizada. ### Request ENDPOINT `/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/registry_data` MÉTODO `PUT` STATUS `202` ### Request body Exemplo: ```json title='Request Body' { "name": "Empresa XPTO Ltda", "email": "contato@empresaxpto.com.br", "phone": { "international_dial_code": "55", "area_code": "11", "number": "1234567890" }, "legal_person": { "giin_number": "XXXXXX.XXXXX.XX.XXX", } } ``` ### Body params | Campo | Tipo | Descrição | Caracteres | Obrigatório | |-------------------|----------|--------------------------------------------------------------------------------------|------------|-------------| | `name` | string | Nome (ou razão social) do investidor | 1 - 255 | Não | | `email` | string | E-mail de contato | 1 - 255 | Não | | `phone` | object | Objeto de **[Phone](#phone)** | - | Não | | `legal_person` | object | Objeto de **[Legal Person](#legal-person)** — obrigatório para pessoa jurídica | - | Sim* | ### Legal Person {#legal-person} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |---------------------|--------|--------------------------------------------------------------------------|------------|-------------| | `giin_number` | string | GIIN (`Global Intermediary Identification Number`), quando aplicável | 1 - 20 | Não | ### Phone {#phone} | Campo | Tipo | Descrição | Caracteres | Obrigatório | |---------------------------|--------|------------------------|------------|-------------| | `international_dial_code` | string | Código internacional | 1 - 3 | Sim | | `area_code` | string | DDD | 2 | Sim | | `number` | string | Número de telefone | 8 - 9 | Sim | ### Response A análise cadastral atualizada é retornada no corpo da resposta. Para o formato completo, consulte **Busca informações de uma análise cadastral do investidor**. --- --- # consultar_feedback URL: /documentation/iaas/investidor/fundo_de_investimento/feedback/consultar_feedback --- # enviar_mensagem_feedback URL: /documentation/iaas/investidor/fundo_de_investimento/feedback/enviar_mensagem_feedback --- # listar_feedbacks URL: /documentation/iaas/investidor/fundo_de_investimento/feedback/listar_feedbacks --- # Introdução URL: /documentation/iaas/investidor/fundo_de_investimento/introducao Esta seção descreve o fluxo de cadastro de investidores do tipo **Fundo de Investimento** — veículos com CNPJ próprio (FIMs, FIAs, FIDCs e demais classes) que aplicam recursos em nome de seus cotistas. Por se tratar de um veículo, o cadastro contempla os dados do fundo, do seu *investor owner* (administrador/gestor responsável) e das demais entidades exigidas pela análise cadastral. O envio de `suitability` **não** é necessário para este tipo de investidor. O tipo de integração utilizada para esse tipo de cadastro de investidor é a `investor-integration`, descrita na seção de introdução da documentação. Para cadastrar um investidor através de uma gestora ou administradora é necessário que o cadastro da gestora esteja atualizado, o que pode ser garantido e mantido através da mesma integração de investidor. Dessa forma, a gestora pode realizar sua atualização cadastral através da API de cadastro de investidores, bem como a manutenção de seus próprios fundos enquanto investidores. Um ponto muito importante é que apenas gestoras e administradoras que estiverem com seus cadastros atualizados podem realizar o cadastro de fundos de investimento. Portanto, é necessário realizar essa manutenção cadastral. ### Fluxo de Cadastro 1. Criar Investidor criação inicial do investidor e abertura da primeira análise cadastral ↓ 2. Enviar Dados Cadastrais dados específicos do fundo de investimento ↓ 3. Enviar Contas Bancárias contas para movimentação ↓ 4. Criar Partes Relacionadas investidores exclusivos (quando aplicável) ↓ 5. Enviar Documentos das Partes Relacionadas documentos de cada investidor exclusivo ↓ 6. Enviar para Análise submissão da análise cadastral para validação ↓ 7. Assinar Documentos assinatura dos documentos gerados após aprovação Nas subseções a seguir veremos cada uma das etapas necessárias para concluir o cadastro de um Fundo de Investimento e disparar a análise cadastral pela QI Tech. --- # criar_parte_relacionada URL: /documentation/iaas/investidor/fundo_de_investimento/related_party/criar_parte_relacionada --- # enviar_documento_parte_relacionada URL: /documentation/iaas/investidor/fundo_de_investimento/related_party/enviar_documento_parte_relacionada