# 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 90 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) - ciclo_de_vida_da_analise (/documentation/iaas/investidor/cadastro/ciclo_de_vida_da_analise) - 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) - atualizar_parte_relacionada (/documentation/iaas/investidor/cadastro/related_party/atualizar_parte_relacionada) - atualizar_status_parte_relacionada (/documentation/iaas/investidor/cadastro/related_party/atualizar_status_parte_relacionada) - 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) - ciclo_de_vida_da_analise (/documentation/iaas/investidor/carteira_administrada/ciclo_de_vida_da_analise) - 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) - atualizar_parte_relacionada (/documentation/iaas/investidor/carteira_administrada/related_party/atualizar_parte_relacionada) - atualizar_status_parte_relacionada (/documentation/iaas/investidor/carteira_administrada/related_party/atualizar_status_parte_relacionada) - 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) - ciclo_de_vida_da_analise (/documentation/iaas/investidor/distribuicao_externa/ciclo_de_vida_da_analise) - 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 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) - atualizar_parte_relacionada (/documentation/iaas/investidor/distribuicao_externa/related_party/atualizar_parte_relacionada) - atualizar_status_parte_relacionada (/documentation/iaas/investidor/distribuicao_externa/related_party/atualizar_status_parte_relacionada) - 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) --- # 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 três fluxos, organizados de acordo com o canal pelo qual o investidor 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` 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`) cadastram seus cotistas — **pessoa física, pessoa jurídica ou classe de fundo de investimento** :::info Classes de fundo de investimento O cadastro de **classes de fundo** (FIMs, FIAs, FIDCs e demais) faz parte do fluxo **Cadastrar como Gestor / Consultor** — é lá que estão todas as etapas, já com as diferenças de PF, PJ e fundo indicadas em cada página. Apenas a **gestora** ou a **administradora** da classe pode realizar esse cadastro. ::: ### 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 | --- # ciclo_de_vida_da_analise URL: /documentation/iaas/investidor/cadastro/ciclo_de_vida_da_analise --- # 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). O campo **`person_type`** define se o investidor é **pessoa física** (`natural_person`) ou **pessoa jurídica** (`legal_person`). Dentro de pessoa jurídica, o campo **`investor_sub_type`** distingue uma empresa comum (`default`) de uma **classe de fundo de investimento** (`fund_class`), que segue regras próprias ao longo de todo o fluxo. :::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" } } } ``` Caso 03: Classe de 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" } ``` :::warning Atenção Os campos obrigatórios mudam de acordo com o **`person_type`** e o **`investor_sub_type`**: - **`natural_person`**: `name`, `document_number`, `person_type` (`email` e `phone` recomendados para criação de usuário) - **`legal_person`** / `default`: `name`, `document_number`, `person_type`, `investor_sub_type` e `registry_user` - **`legal_person`** / `fund_class`: `name`, `document_number`, `person_type` e `investor_sub_type` — **sem `registry_user`**, já que a representação é feita pelos *investor owners* (administrador e gestora) ::: :::warning Classes de fundo: só o gestor ou o administrador cadastra Apenas a **gestora** ou a **administradora** do fundo pode criar um investidor `fund_class`, e somente se o seu próprio cadastro estiver atualizado. Veja **[Introdução](./introducao)** para o detalhamento dessa exigência. ::: :::warning Apenas classes em funcionamento Somente classes **operacionais** na CVM podem ser cadastradas. Classes pré-operacionais, encerradas, canceladas ou incorporadas são recusadas na análise. Se o CNPJ não constar na base da CVM, o `submit` é recusado com `IVR000068`. ::: :::info O que a CVM preenche por você Para `fund_class`, parte dos dados cadastrais é preenchida **automaticamente** a partir da base pública da CVM no momento do envio para análise — incluindo razão social, data de constituição, patrimônio e os vínculos com administrador, gestora e (quando aplicável) investidor exclusivo. Como consequência, **endereço, patrimônio, suitability, grupos de assinantes e documentos do investidor não são enviados** para esse subtipo. Consulte **[Quais etapas se aplicam a cada tipo](./introducao#etapas-por-tipo)**. ::: :::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`). Para `fund_class`, o CNPJ da classe registrada na CVM | 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) | | `fund_class` | Classe de fundo de investimento — dispara o enriquecimento automático com os dados públicos da CVM e segue regras próprias de etapas, partes relacionadas e investor owners | ### 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 cadastros feitos por um gestor (`manager-integration`) ou consultor (`consultant-integration`) em nome de seus cotistas, cobrindo os **três tipos de investidor** que essa integração pode cadastrar: | Tipo | `person_type` / `investor_sub_type` | O que é | |------|--------------------------------------|---------| | **Pessoa Física (PF)** | `natural_person` | Investidor pessoa física | | **Pessoa Jurídica (PJ)** | `legal_person` + `investor_sub_type: default` | Empresa investidora — inclui `financial_institution` | | **Fundo de Investimento** | `legal_person` + `investor_sub_type: fund_class` | Classe de fundo com CNPJ próprio (FIMs, FIAs, FIDCs e demais), que aplica recursos em nome de seus cotistas | O cadastro contempla o envio de dados cadastrais, endereço, patrimônio, contas bancárias, suitability, grupos de assinantes, documentos, partes relacionadas e, quando aplicável, *investor owner*, até o disparo da análise cadastral pela QI Tech. **As etapas exigidas variam conforme o tipo** — cada página adiante indica o que se aplica a PF, a PJ e a fundo. Importante ressaltar que, para PF e PJ, a assinatura é sempre executada exclusivamente pelo investidor ou representante legal identificado durante a análise. :::warning Fundos: só o gestor ou o administrador cadastra O cadastro de uma classe de fundo **só pode ser feito pela gestora ou pela administradora** do próprio fundo. Não há outro papel autorizado a abrir esse cadastro. Além disso, **o cadastro de quem cadastra precisa estar em dia**: apenas gestoras e administradoras com o próprio cadastro atualizado conseguem cadastrar classes de fundo. Essa manutenção é feita pela mesma API — a gestora ou administradora atualiza o próprio cadastro por **[Atualização Cadastral](./atualizacao_cadastral)** e, na sequência, mantém as suas classes de fundo enquanto investidores. ::: :::warning Apenas classes de fundo em funcionamento Somente classes **em funcionamento (operacionais)** na CVM podem ser cadastradas. Classes em fase pré-operacional, encerradas, canceladas, incorporadas ou de qualquer forma não operacionais são recusadas na análise. O enquadramento é lido da base pública da CVM a partir do CNPJ informado na criação do investidor. Se o CNPJ não constar na base da CVM, o campo fica indefinido e o `submit` é recusado com `IVR000068` — em Homologação, utilize um CNPJ de classe efetivamente registrada e em funcionamento. ::: ### Fluxo de Cadastro 1. Criar Investidor criação inicial do investidor e abertura da primeira análise cadastral ↓ 2. Enviar Dados Cadastrais PF, PJ e fundo — dados específicos da pessoa física ou jurídica ↓ 3. Enviar Endereço PF e PJ — informações de endereço. Fundo: etapa pulada ↓ 4. Enviar Patrimônio PF e PJ — patrimônio e enquadramento. Fundo: etapa pulada ↓ 5. Enviar Contas Bancárias PF, PJ e fundo — contas para movimentação ↓ 6. Enviar Suitability PF e PJ — questionário de adequação ao perfil. Fundo: etapa pulada ↓ 7. Enviar Grupos de Assinantes PF e PJ — quem deve assinar os documentos. Fundo: etapa pulada ↓ 8. Enviar Documentos do Investidor PF e PJ — upload dos documentos obrigatórios. Fundo: etapa pulada ↓ 9. Criar Partes Relacionadas PJ — sócios, diretores, beneficiários finais. Fundo: só se for exclusivo na CVM ↓ 10. Enviar Documentos das Partes Relacionadas documentos de cada parte relacionada. Fundo: só se for exclusivo na CVM ↓ 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 ### Quais etapas se aplicam a cada tipo {#etapas-por-tipo} | Etapa | PF | PJ | Classe de fundo | |-------|:--:|:--:|:----------------| | 1. Criar Investidor | ✅ | ✅ | ✅ | | 2. Enviar Dados Cadastrais | ✅ | ✅ | ✅ *(razão social, data de constituição e patrimônio vêm da CVM)* | | 3. Enviar Endereço | ✅ | ✅ | ⏭️ **pulado** | | 4. Enviar Patrimônio | ✅ | ✅ | ⏭️ **pulado** | | 5. Enviar Contas Bancárias | ✅ | ✅ | ✅ | | 6. Enviar Suitability | ✅ | ✅ *(obrigatório em `retail`)* | ⏭️ **pulado** | | 7. Enviar Grupos de Assinantes | ✅ | ✅ | ⏭️ **pulado** | | 8. Enviar Documentos do Investidor | ✅ | ✅ | ⏭️ **pulado** | | 9. Criar Partes Relacionadas | opcional | ✅ obrigatório | ⚠️ **só se exclusivo** | | 10. Documentos das Partes Relacionadas | opcional | ✅ obrigatório | ⚠️ **só se exclusivo** | | 11. Enviar para Análise | ✅ | ✅ | ✅ | | 12. Assinar Documentos | ✅ | ✅ | ✅ | :::info O que uma classe de fundo **não** envia Endereço, patrimônio, suitability, grupos de assinantes e documentos do investidor **não fazem parte do cadastro de uma classe de fundo** — nenhum deles é exigido no `submit`, e as etapas correspondentes podem ser puladas por completo. Os dados que sustentam a análise vêm de outra fonte: razão social, data de constituição, patrimônio e os vínculos com **administrador** e **gestora** são preenchidos automaticamente a partir da base pública da CVM no envio para análise. A representação do fundo se dá por esses *investor owners*, e não por representantes legais. ::: :::warning Partes relacionadas: apenas em classe exclusiva Partes relacionadas e seus documentos são exigidos **quando, e somente quando, a classe é exclusiva na CVM**. Nesse caso é obrigatória ao menos uma parte relacionada do tipo `exclusive_investor`, e a participação somada precisa fechar **exatamente 100%**. Para uma classe **não exclusiva**, pule as etapas 9 e 10 — nenhuma parte relacionada é necessária. O caráter exclusivo (`exclusive_fund_class`) é derivado automaticamente da classe CVM na criação do investidor; consulte **[Criar Parte Relacionada — Exigências por tipo de investidor](./related_party/criar_parte_relacionada#exigencias)** para a matriz completa. ::: Nas subseções a seguir veremos cada uma das etapas necessárias para concluir esses cadastros, com as diferenças de PF, PJ e classe de fundo indicadas em cada página. --- # atualizar_parte_relacionada URL: /documentation/iaas/investidor/cadastro/related_party/atualizar_parte_relacionada --- # atualizar_status_parte_relacionada URL: /documentation/iaas/investidor/cadastro/related_party/atualizar_status_parte_relacionada --- # 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 --- # ciclo_de_vida_da_analise URL: /documentation/iaas/investidor/carteira_administrada/ciclo_de_vida_da_analise --- # 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 --- # atualizar_parte_relacionada URL: /documentation/iaas/investidor/carteira_administrada/related_party/atualizar_parte_relacionada --- # atualizar_status_parte_relacionada URL: /documentation/iaas/investidor/carteira_administrada/related_party/atualizar_status_parte_relacionada --- # 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 --- # ciclo_de_vida_da_analise URL: /documentation/iaas/investidor/distribuicao_externa/ciclo_de_vida_da_analise --- # 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 Campos obrigatórios por `person_type` Os campos obrigatórios mudam de acordo com o **`person_type`**. A ausência de qualquer um deles é recusada com `IVR000009`, cuja mensagem lista a relação completa exigida. - **`natural_person`**: `name`, `document_number`, `person_type`, **`investor_sub_type`** - **`legal_person`**: `name`, `document_number`, `person_type`, **`investor_sub_type`** - **`nominee`**: `name`, `person_type`, `external_distribution_key` **`investor_sub_type` é obrigatório também para pessoa física** — envie `default` quando não houver subtipo específico. `email` e `phone` são opcionais para um distribuidor, mas recomendados: sem `email`, nenhum usuário de acesso é criado para o investidor. ::: :::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. Quando enviado, o objeto exige `name`, `document_number` e `email`. Se omitido em pessoa física, o usuário é derivado do `email` do próprio investidor — e, se o investidor também não tiver `email`, nenhum usuário é criado. ::: :::warning `investor_owner_type` não é aceito de distribuidores Apesar de existir no schema, `investor_owner_type` é **recusado** quando o investidor é criado por uma integração de distribuidor com `person_type` `natural_person` ou `legal_person`. Vínculos de carteira administrada e de fundo são estabelecidos pelo endpoint **Criar Investor Owner**, dentro da análise cadastral. ::: ### Investidor não residente {#nao-residente} A residência é definida **na criação do investidor** e é imutável depois disso. Ela é controlada pelo campo `resident`. ```json title='Request Body — pessoa física não residente' { "name": "Maria Fernandes", "document_number": "123.456.789-00", "person_type": "natural_person", "investor_sub_type": "default", "resident": false, "non_resident_type": "third_party_representation", "investor_owners": [ { "type": "non_resident_representative", "name": "Representante Legal Brasil Ltda", "document_number": "12.345.678/0001-90" } ] } ``` | Campo | Tipo | Descrição | Obrigatório | |----------------------|---------|-----------------------------------------------------------------------------------------------------|-------------| | `resident` | boolean | Define a residência da análise cadastral. Default `true` | Não | | `non_resident_type` | string | `self_representation` ou `third_party_representation`. Obrigatório quando `resident: false` (`IVR000222`) | Condicional | | `investor_owners` | array | Representante legal residente no Brasil, com `type: "non_resident_representative"` | Não | #### Tipos de representação {#non-resident-type} `non_resident_type` declara **como o investidor não residente é representado no Brasil**. É essa escolha que determina quais entidades você precisa cadastrar e quais documentos serão exigidos no envio para análise. | Enumerador | Tipo de conta | Significado | |------------------------------|--------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------| | `third_party_representation` | Conta **4373** | O INR opera por meio de terceiros: existe um **custodiante**, responsável pela guarda dos ativos, e um **representante legal brasileiro**, responsável por representá-lo no país. Na prática, costumam ser a mesma entidade. | | `self_representation` | Conta **CNR** (autocustódia / representação tributária) | O investidor é seu próprio custodiante e representante. **Não** existe custodiante nem representante terceiro. | O que muda entre os dois: | | `third_party_representation` | `self_representation` | |------------------------------|-----------------------------------------------------------------------------------------------|--------------------------------| | **Custodiante** | Parte relacionada do tipo `asset_custodian` | Não existe | | **Representante** | Investor owner do tipo `non_resident_representative` — sempre **residente**, com CPF/CNPJ | Não existe | | **Documentos de representação** | `custody_contract` (no custodiante) **e** `representation_contract` (no representante) — **ou** uma única `simplified_declaration` na análise | Nenhum | :::warning Como a exigência documental é verificada Em `third_party_representation`, o `custody_contract` só é reconhecido quando enviado em uma parte relacionada **ativa** do tipo `asset_custodian`, e o `representation_contract` só é reconhecido quando enviado em um investor owner **ativo** do tipo `non_resident_representative`. Enviar os dois contratos como documentos da análise cadastral não satisfaz a regra. Se a combinação não for encontrada no `submit`, a resposta é `IVR000029`. ::: Regras que valem para **os dois** tipos: - `nif_number` é **obrigatório** no envio dos dados cadastrais (`IVR000224`); - parte relacionada estrangeira sem CPF/CNPJ precisa de `passport` ou `foreign_id`; - pessoa física nascida no Brasil (`natural_person.place_of_birth.country: "BRA"`) precisa de `final_departure_tax_return`. :::info `non_resident_type` é imutável O valor é fixado na criação do investidor. Você pode reenviá-lo nos dados cadastrais, mas apenas com o **mesmo** valor — divergência, ou envio em um cadastro residente, resulta em `IVR000225`. ::: :::warning Residência e endereço precisam concordar Com `resident: true` (default), o endereço enviado na Etapa 3 precisa ter `country: "BRA"`, senão `IVR000227`. Com `resident: false`, o `country` **não** pode ser `BRA`, senão `IVR000226`. `postal_code` e `uf` não têm validação de formato, então códigos postais estrangeiros são aceitos como estão. Use `EX` em `uf` para endereços no exterior. ::: :::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 | | `investor_sub_type` | string | Enumerador de **[Investor Sub Type](#investor-sub-type)**. Exigido para `natural_person` e `legal_person` | - | Sim | | `document_number` | string | CPF (`XXX.XXX.XXX-XX`) ou CNPJ (`XX.XXX.XXX/XXXX-XX`) | 14 ou 18 | Sim* | | `external_distribution_key` | string | Identificador externo da distribuição (obrigatório para `nominee`) | 1 - 100 | Sim* | | `resident` | boolean | Residência da análise cadastral. Default `true`. Veja [Investidor não residente](#nao-residente) | - | Não | | `non_resident_type` | string | `self_representation` ou `third_party_representation`. Exigido quando `resident: false` | - | Condicional | | `investor_owners` | array | Representante legal residente, para investidor não residente | - | 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 | | `external_id` | string | Identificador do investidor no seu sistema | 1 - 50 | Não | \* `document_number` não deve ser enviado para `person_type: nominee`. `external_distribution_key` é exigido apenas para `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` | Investidor regular, pessoa física ou jurídica | | `fund_class` | Fundo de investimento — dispara enriquecimento automático com dados públicos da CVM | | `financial_institution` | Instituição financeira. Segue as mesmas regras de `default` | | `non_resident` | Subtipo de classificação. **Não** define a residência da análise — para isso use `resident` | ### 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 - A análise cadastral precisa estar no status `pending_registry_data`. Em outro status, a chamada é recusada com `IVR000026` - Um mesmo `type` só aceita um envio bem-sucedido: veja [Reenvio e documento duplicado](#duplicado) ::: ### 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, identificado por `investor_analysis_document_key`, acompanhada da representação completa da análise cadastral à qual ele pertence. ### 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} #### Identificação e comprovantes de pessoa física | Enumerador | Descrição | Extensões | |--------------------------------|------------------------------------------------------|----------------| | `cnh` | CNH | `pdf`, `jpeg` | | `rg_front` | RG — frente | `pdf`, `jpeg` | | `rg_back` | RG — verso | `pdf`, `jpeg` | | `passport` | Passaporte (identificação de estrangeiro) | `pdf`, `jpeg` | | `foreign_id` | Documento de identidade estrangeiro (ex.: RNE) | `pdf`, `jpeg` | | `proof_of_residence` | Comprovante de residência | `pdf`, `jpeg` | | `billing_statement` | Fatura / extrato | `pdf`, `jpeg` | #### Documentos societários de pessoa jurídica | Enumerador | Descrição | Extensões | |--------------------------------|------------------------------------------------------|----------------| | `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` | | `organizational_chart` | Organograma societário | `pdf`, `jpeg` | #### Representação, qualificação e contratos | Enumerador | Descrição | Extensões | |--------------------------------|------------------------------------------------------|----------------| | `power_of_attorney` | Procuração | `pdf`, `jpeg` | | `investor_qualification_proof` | Comprovação de qualificação / enquadramento | `pdf`, `jpeg` | | `wallet_manager_contract` | Contrato de carteira administrada / intermediação | `pdf`, `jpeg` | | `extra_document` | Documento avulso, sem tipo específico | `pdf`, `jpeg` | #### Investidor não residente | Enumerador | Descrição | Extensões | |--------------------------------|------------------------------------------------------|----------------| | `custody_contract` | Contrato de custódia | `pdf`, `jpeg` | | `representation_contract` | Contrato de representação | `pdf`, `jpeg` | | `simplified_declaration` | Declaração simplificada | `pdf`, `jpeg` | | `final_departure_tax_return` | Declaração final de saída definitiva do país | `pdf`, `jpeg` | :::warning Tipos gerados pela QI Tech Os tipos `qualified_investor_term`, `professional_investor_term`, `natural_person_registry_form`, `legal_person_registry_form`, `investor_suitability_form` e `adhesion_term` aparecem na consulta do investidor, mas são **gerados pela QI Tech** para assinatura — não devem ser enviados por este endpoint. ::: ### Documentos Obrigatórios {#documentos-obrigatorios} As combinações abaixo são conjuntos alternativos: basta satisfazer **uma** das opções de cada lista. A validação roda no envio para análise (`submit`) e recusa com `IVR000029`, devolvendo na mensagem a matriz exata que faltou. #### Pessoa Física (`natural_person`) Uma das opções: | Opção | Documentos | |-------|---------------------------------------------------| | 1 | `cnh` **+** `proof_of_residence` | | 2 | `rg_front` **+** `rg_back` **+** `proof_of_residence` | #### Pessoa Jurídica (`legal_person` / `investor_sub_type: default`, `financial_institution`) Uma das opções — sempre **ao menos um** documento societário **e** as demonstrações financeiras: | Opção | Documentos | |-------|--------------------------------------------------------| | 1 | `board_election_record` **+** `financial_statements` | | 2 | `company_statute` **+** `financial_statements` | | 3 | `social_contract` **+** `financial_statements` | O documento societário exigido depende do tipo jurídico da empresa — daí as três opções. Não é possível enviar apenas `financial_statements`. :::warning Documentos obrigatórios Embora esses documentos sejam o mínimo para envio de uma análise, caso, por exemplo, somente o `company_statute` não seja suficiente para definir firmas e poderes do cotista, a análise pode ser recusada exigindo também o `board_election_record`. ::: #### Pessoa Jurídica — Fundo de Investimento (`investor_sub_type: fund_class`) **Nenhum documento é exigido.** Os dados do fundo são obtidos por enriquecimento na base da CVM, e a representação é feita pelos investor owners (administrador e gestora). ### Reenvio e documento duplicado {#duplicado} Um tipo de documento é considerado **satisfeito** assim que existe, para aquela análise, um documento daquele tipo com status `valid` ou `in_manual_analysis`. A partir daí, novos envios do mesmo tipo são recusados: ```json HTTP 409 { "title": "Already exists valid document for investor analysis.", "code": "IVR000023" } ``` Enquanto **todos** os documentos de um tipo estiverem `invalid`, novos envios daquele tipo continuam sendo aceitos — é assim que se corrige um arquivo ilegível. O tipo `extra_document` é a única exceção: aceita múltiplos envios sempre. ### Validação automática e `status` do documento {#validacao} Documentos dos tipos `cnh`, `rg_front`, `rg_back` e `proof_of_residence` passam por validação automática (OCR) e voltam com um dos status abaixo. Os demais tipos entram diretamente em `in_manual_analysis`. | Status | Significado | |---------------------|------------------------------------------------------------------------------| | `valid` | Validado automaticamente | | `in_manual_analysis`| Encaminhado para conferência humana | | `invalid` | Reprovado na validação automática — reenvie, ou use `force=true` | `force=true` pula o efeito da reprovação automática: o documento é registrado como `in_manual_analysis` e passa a satisfazer a exigência do tipo. :::info Sobre `investor_qualification_proof` Este documento **não integra a matriz de obrigatórios** e sua ausência nunca bloqueia o `submit`. Ele atua depois: se o `total_financial_applications` declarado estiver abaixo do piso da categoria informada — R$ 1.000.000 para `qualified`, R$ 10.000.000 para `professional` — ele é utilizado para a validação. Investidores `fund_class` são isentos dessa verificação. ::: ### Response ```json title='Response Body' { "investor_analysis_document_key": "UUID", "type": "cnh", "status": "in_manual_analysis", "observation": "Documento emitido em 2019, legibilidade reduzida no verso.", "data": { "type": "cnh", "file_extension": "pdf", "document_data": { "document_type": "CNH", "issuer_entity": "DETRAN" } }, "investor_analysis": { } } ``` | Campo | Tipo | Descrição | |----------------------------------|--------|------------------------------------------------------------------------------| | `investor_analysis_document_key` | string | Identificador do documento. É a chave usada nas demais rotas de documento | | `type` | string | Enumerador de **[Document Type](#document-type)** | | `status` | string | `valid`, `invalid` ou `in_manual_analysis` — veja [Validação automática](#validacao) | | `observation` | string | Observação enviada na requisição. `null` quando não informada | | `data` | object | Eco dos campos enviados, sem o conteúdo em base64 | | `investor_analysis` | object | Representação completa da análise cadastral — mesmo formato de **Busca informações de uma análise cadastral do investidor** | --- # enviar_patrimonio URL: /documentation/iaas/investidor/distribuicao_externa/enviar_patrimonio --- # Enviar Suitability URL: /documentation/iaas/investidor/distribuicao_externa/enviar_suitability --- ### Introdução Este recurso registra o **perfil de suitability** do investidor na análise cadastral. :::info Na distribuição externa você envia o perfil, não as respostas Diferente das demais superfícies, a integração de distribuição externa **não** responde ao questionário de suitability pela API — não há endpoint de formulário e não se enviam respostas numeradas. Você aplica o suitability no seu próprio canal e informa aqui apenas o **resultado**: `conservative`, `moderate` ou `bold`. ::: ### Request ENDPOINT `/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/suitability` MÉTODO `PUT` STATUS `202` ### Request body ```json title='Request Body' { "profile": "bold" } ``` ### Body params | Campo | Tipo | Descrição | Obrigatório | |-----------|--------|--------------------------------------------------|-------------| | `profile` | string | Enumerador de **[Profile](#profile)** | Sim | `profile` é o **único** campo aceito. Qualquer outra propriedade no corpo é recusada com `QIT000001`. ### Profile {#profile} | Enumerador | Descrição | |------------------|--------------------------------------------------------------------------------| | `conservative` | Conservador | | `moderate` | Moderado | | `bold` | Arrojado | | `not_applicable` | O suitability não se aplica a este investidor — ver **[Suitability não aplicável](#not-applicable)** | ### Response A resposta devolve os **dados cadastrais da análise** já atualizados, com o objeto `suitability` preenchido: ```json title='Response Body' { "natural_person": { "...": "..." }, "address": { "...": "..." }, "net_worth": { "...": "..." }, "suitability": { "profile": "bold" } } ``` --- ### Quando o envio é obrigatório | Investidor | Suitability | |---------------------------------------------------|--------------------------------------------------------------------| | **Pessoa física** | **Obrigatório** — sem ele o `submit` falha com `IVR000150` | | **Pessoa jurídica** enquadrada como `retail` | **Obrigatório** — sem ele o `submit` falha com `IVR000133` | | **Pessoa jurídica** `qualified` ou `professional` | **Opcional** — simplesmente não chame este endpoint | ### Suitability não aplicável {#not-applicable} Quando o suitability não se aplica ao investidor, envie `profile: "not_applicable"` neste mesmo endpoint: ```json title='Request Body' { "profile": "not_applicable" } ``` A análise passa a registrar `suitability: {"profile": "not_applicable"}`. :::info `not_applicable` é exclusivo da distribuição externa Este valor só é aceito de integrações de distribuição externa. Nas superfícies internas da QI Tech a declaração é recusada com `IVR000244`. ::: ### Pré-condições e erros | Código | HTTP | Quando ocorre | |-------------|------|----------------------------------------------------------------------------------------| | `IVR000018` | 400 | A análise não está em `pending_registry_data` | | `QIT000001` | 400 | `profile` ausente, fora do enumerador, ou corpo com propriedade extra | | `IVR000008` | 404 | Investidor não encontrado para as credenciais utilizadas | | `IVR000133` | 400 | *(no `submit`)* pessoa jurídica `retail` sem suitability | | `IVR000150` | 400 | *(no `submit`)* pessoa física sem suitability | O envio pode ser repetido enquanto a análise estiver em `pending_registry_data` — o último perfil enviado substitui o anterior. --- # 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 --- # atualizar_parte_relacionada URL: /documentation/iaas/investidor/distribuicao_externa/related_party/atualizar_parte_relacionada --- # atualizar_status_parte_relacionada URL: /documentation/iaas/investidor/distribuicao_externa/related_party/atualizar_status_parte_relacionada --- # 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