跳到主要内容

简介

QI DTVM 是一家提供投资基金行政管理和托管服务的金融机构。我们基于 REST API 提供一系列服务，为整个运营流程带来全新体验，以简化操作、实现自动化，并为所有相关方提供完全透明的信息。

本文档旨在描述运营任意投资基金所需的流程、端点和数据结构。

注：如在流程的任何环节有疑问，请发送邮件至 integracao.dtvm@qitech.com.br 并详细说明您的问题，我们将为您提供协助。

访问角色​

在我们的系统中，用户通过其在 QI DTVM 结构中所承担的角色进行识别。共有 6 种角色：

  1. 管理人；
  2. 顾问；
  3. 发起人；
  4. 转让方；
  5. 投资者；
  6. 分销商。

每种角色都有专属的主机，并开放该角色可调用的路由——参见环境（主机）。

如需创建访问角色以使用我们的 API，请通过邮箱 integracao.dtvm@qitech.com.br 联系我们的团队。

管理人和顾问只需提供主用户（master）的姓名、邮箱和 CPF，之后即可在门户中自行创建集成并注册公钥——无需通过邮件发送密钥。参见通过门户集成。

从哪里开始​

  1. 创建集成：通过门户集成（管理人和顾问）或密钥交换（其他角色）。
  2. 发起第一次调用：认证测试。
  3. 了解如何解读错误并安全地重发请求：API 错误。

环境（主机）​

QI DTVM 提供两种环境：SANDBOX 和生产环境。两种环境的代码和行为完全相同，但 SANDBOX 环境中的金额完全是虚拟的，而生产环境会执行真实有效的金融交易。

Sandbox 环境供开发者完成集成；准备上线时，只需将环境变量更新为生产环境的参数即可。

每种角色都有自己的主机。API key 只在其签发角色对应的主机上有效：管理人的 API key 发送到转让方的主机会被拒绝并返回 Invalid API Key，即使签名正确也是如此。

您的角色Sandbox生产环境
管理人（基金管理机构）https://manager-api.sandbox.qidtvm.com.brhttps://manager-api.qidtvm.com.br
顾问（顾问机构）https://consultant-api.sandbox.qidtvm.com.brhttps://consultant-api.qidtvm.com.br
转让方https://assignor-api.sandbox.qidtvm.com.brhttps://assignor-api.qidtvm.com.br
发起人https://originator-api.sandbox.qidtvm.com.br由集成团队提供
投资者https://investor-api.sandbox.qidtvm.com.brhttps://investor-api.qidtvm.com.br
分销商https://distributor-api.sandbox.qidtvm.com.brhttps://distributor-api.qidtvm.com.br

请使用创建集成时 QI 告知的角色；如果您是通过门户创建的集成，则使用注册该集成的门户所对应的角色。Sandbox 的 API key 在生产环境中无效，反之亦然。

除各角色的主机外，生产环境还有一个公开主机：https://api.qidtvm.com.br。

重要提示！

不得在 QI Tech 的 Sandbox 环境中使用真实的自然人和/或法人数据。