Introdução
A QI DTVM é uma instituição financeira que presta os serviços de Administração e Custódia de Fundos de Investimento. Nós temos uma série de serviços, utilizando REST APIs que viabilizam uma nova experiência em toda a operação, visando facilidades, automações e uma total transparência para os envolvidos.
Essa documentação tem como objetivo descrever os fluxos, endpoints e estruturas de dados necessárias para operar quaisquer Fundos de Investimentos.
Obs.: Em caso de dúvidas em qualquer etapa do processo favor entre em contato com integracao.dtvm@qitech.com.br detalhando seu problema/dúvida que te auxiliaremos.
Perfis de Acesso
No nosso sistema nós reconhecemos o usuário pelo perfil que ele assume dentro da estrutura da QI DTVM. Possuímos 6 perfis:
- Gestores;
- Consultores;
- Originadores;
- Cedentes;
- Investidores;
- Distribuidores.
Cada perfil tem um host próprio, com as rotas liberadas para ele — veja Ambientes (Hosts).
Para criarmos um Perfil de Acesso para utilização das nossas APIs é necessário que se entre em contato com nosso time através do e-mail integracao.dtvm@qitech.com.br.
Gestoras e consultorias solicitam apenas o nome, e-mail e CPF do usuário master responsável e, a partir daí, criam a integração e cadastram a chave pública pelo próprio portal — sem enviar chaves por e-mail. Veja Integração pelo portal.
Por onde começar
- Crie a integração: Integração pelo portal (gestoras e consultorias) ou Troca de chaves (demais perfis).
- Faça a primeira chamada: Teste de autenticação.
- Saiba ler os erros e reenviar com segurança: Erros da API.
Ambientes (Hosts)
A QI DTVM possui dois ambientes, SANDBOX e PRODUÇÃO. Ambos os ambientes possuem código e comportamento completamente idênticos, porém, o ambiente de SANDBOX apresenta valores monetários totalmente fictícios, e o ambiente de Produção realiza transações financeiras válidas.
O ambiente Sandbox foi criado para os desenvolvedores realizarem suas integrações, e quando estiverem prontos para entrada em produção, atualizarem apenas as variáveis de ambiente com os parâmetros de Produção.
Cada perfil tem o próprio host. A chave de API só é reconhecida no host do perfil para o qual foi emitida: a chave de uma gestora enviada para o host de cedentes é recusada como Invalid API Key, mesmo com a assinatura correta.
| Seu perfil | Sandbox | Produção |
|---|---|---|
| Gestor (gestora de fundos) | https://manager-api.sandbox.qidtvm.com.br | https://manager-api.qidtvm.com.br |
| Consultor (consultoria) | https://consultant-api.sandbox.qidtvm.com.br | https://consultant-api.qidtvm.com.br |
| Cedente | https://assignor-api.sandbox.qidtvm.com.br | https://assignor-api.qidtvm.com.br |
| Originador | https://originator-api.sandbox.qidtvm.com.br | Informado pelo time de integração |
| Investidor | https://investor-api.sandbox.qidtvm.com.br | https://investor-api.qidtvm.com.br |
| Distribuidor | https://distributor-api.sandbox.qidtvm.com.br | https://distributor-api.qidtvm.com.br |
Use o perfil informado pela QI quando a integração foi criada — ou, se você criou a integração pelo portal, o perfil do portal em que ela foi cadastrada. A chave de API de sandbox não funciona em produção, e vice-versa.
Além dos hosts por perfil, há um host público em produção, https://api.qidtvm.com.br.
Não devem ser usados dados reais de pessoas físicas e/ou jurídicas nos ambientes de Sandbox da QI Tech.