Introdução
Esta seção reúne os cadastros feitos por uma gestora (manager-api) ou consultoria (consultant-api) 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.
O que cada perfil executa
A gestora (manager-api) e a consultoria (consultant-api) não expõem as mesmas rotas. Antes de planejar a integração, confira o que o seu perfil executa:
| Etapa | Gestora | Consultoria |
|---|---|---|
| 1. Criar Investidor | ✅ | ✅ |
| 2. Enviar Dados Cadastrais | ✅ | ✅ |
| 3. Enviar Endereço | ✅ | ✅ |
| 4. Enviar Patrimônio | ✅ | ✅ |
| 5. Enviar Contas Bancárias (e definir principal, alterar status) | — | ✅ |
| 6. Enviar Suitability | ✅ | ✅ |
| 7. Enviar Grupos de Assinantes (e definir padrão, alterar status) | — | ✅ |
| 8. Enviar Documentos do Investidor | ✅ | ✅ |
| 9. Criar Partes Relacionadas (e alterar status) | ✅ | ✅ |
| 10. Enviar Documentos das Partes Relacionadas | ✅ | ✅ |
| 11. Enviar para Análise | ✅ | ✅ |
| Listar investidores | ✅ | ✅ |
| Consultar investidor, análise cadastral, análise em andamento e lotes de documentos | — | ✅ |
| Listar feedbacks | — | ✅ |
- Só classes de fundo próprias. Pela gestora, as etapas de preenchimento (dados cadastrais, endereço, patrimônio, suitability, documentos, partes relacionadas) e o envio para análise só são aceitos para classes de fundo das quais ela é a gestora vinculada ao cadastro. Para os demais investidores, a chamada é recusada com
QIT000011. - Sem contas bancárias e grupos de assinantes. O
manager-apinão tem rota funcional para essas etapas. Como o envio para análise exige ao menos uma conta bancária ativa (IVR000178), a gestora não conclui sozinha o primeiro cadastro de uma classe de fundo: fale com o time de integração antes de começar. Na atualização de uma classe já cadastrada, as contas da análise anterior são aproveitadas.
Se o seu fluxo como gestora depende de algo fora disso, fale com o time de integração em integracao.dtvm@qitech.com.br antes de planejar o cadastro.
Pela gestora (manager-api), a criação de uma classe de fundo só é aceita se o CNPJ da gestora constar na CVM como gestora ou administradora da classe; caso contrário, a chamada é recusada com IVR000260.
Além disso, a administradora e a gestora da classe (conforme a CVM) precisam estar cadastradas como investidoras na QI Tech; sem isso, o cadastro da classe não avança. Se for o seu caso, fale com integracao.dtvm@qitech.com.br.
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 sandbox, utilize um CNPJ de classe efetivamente registrada e em funcionamento.
Fluxo de Cadastro
Quais etapas se aplicam a cada 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. Assinatura dos Documentos | ✅ | ✅ | ✅ |
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.
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 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.