Pular para o conteúdo principal

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:

  1. Gestores;
  2. Consultores;
  3. Originadores;
  4. Cedentes;
  5. Investidores;
  6. 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​

  1. Crie a integração: Integração pelo portal (gestoras e consultorias) ou Troca de chaves (demais perfis).
  2. Faça a primeira chamada: Teste de autenticação.
  3. 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 perfilSandboxProdução
Gestor (gestora de fundos)https://manager-api.sandbox.qidtvm.com.brhttps://manager-api.qidtvm.com.br
Consultor (consultoria)https://consultant-api.sandbox.qidtvm.com.brhttps://consultant-api.qidtvm.com.br
Cedentehttps://assignor-api.sandbox.qidtvm.com.brhttps://assignor-api.qidtvm.com.br
Originadorhttps://originator-api.sandbox.qidtvm.com.brInformado pelo time de integração
Investidorhttps://investor-api.sandbox.qidtvm.com.brhttps://investor-api.qidtvm.com.br
Distribuidorhttps://distributor-api.sandbox.qidtvm.com.brhttps://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.

Aviso Importante!

Não devem ser usados dados reais de pessoas físicas e/ou jurídicas nos ambientes de Sandbox da QI Tech.