跳到主要内容

报告

本节将介绍提供给投资基金的报告，以及实现报告下载的操作步骤。

要访问这些报告，请联系团队 integracao.dtvm@qitech.com.br，以便在同质化环境（Sandbox）和生产环境中完成相应的权限开放。

QI CTVM 提供的报告包含投资组合构成、资产变动、盈利能力、投资者持仓及现金流动等信息。这些报告使基金管理人能够做出知情决策，并确保透明度及符合监管要求。

通过 SFTP 访问

SFTP（安全文件传输协议）是 QI CTVM 用于发布报告的协议。要与 SFTP 集成，建议使用支持该协议的库和工具，例如 Python 的 paramiko 或标准 SFTP 客户端。

凭证格式

要连接 SFTP，需要以下凭证，这些凭证将由 QI CTVM 提供：

  1. HOSTNAME：SFTP 服务器地址
  2. PORT：连接端口（默认 22）
  3. USERNAME：认证用户名
  4. SSH PRIVATE KEY：PEM 格式的私钥，用于身份验证
注意

这些凭证可直接访问所提供的报告，不得与他人共享。

代码示例

建立连接并下载​

    import paramiko

    hostname = "sftp.exemplo.com"
    port = 22
    username = "usuario"
    key_file = "/caminho/para/sua_chave_privada.pem"

    # Carrega a chave privada
    key = paramiko.RSAKey.from_private_key_file(key_file)

    # Conecta ao servidor
    transport = paramiko.Transport((hostname, port))
    transport.connect(username=username, pkey=key)

    # Cria o cliente SFTP
    sftp = paramiko.SFTPClient.from_transport(transport)

    # Lista arquivos disponíveis
    files = sftp.listdir("/")
    for f in files:
        print(f)

    # Faz download de um arquivo
    sftp.get("remote_path/arquivo.csv", "local_path/arquivo.csv")

    sftp.close()
    transport.close()

执行下载

收到凭证后，可根据基金的简称、报告类型以及 YYYY-MM-DD 格式的所需日期下载文件，示例如下：

  • nome_exemplo_amortization_2024-01-01
说明

所提供的 SFTP 服务仅供下载文件使用；不允许进行上传。

示例文件​

所有报告示例均位于：报告

报告类型​

类型描述文件格式
admin_fee_calc管理费计算CSV
amortization基金历史摊销记录CSV
cash_account_demonstrative日末现金账户明细XLSX
cash_account_demonstrative_movements日内现金账户变动明细CSV
assets_wallet_composition某日所有持仓资产CSV
assignment_assets_wallet_composition某次信贷权利转让的所有分期CSV
credit_rights_acquisition_assets某日所有新增信贷操作CSV
credit_rights_acquisition_installments某日所有新增信贷操作的分期CSV
credit_rights_conciliation_assets某日已还款的所有信贷操作CSV
credit_rights_conciliation_installments某日已还款的所有信贷操作分期CSV
discounted_credit_rights_acquisition_assets某日所有新增应收账款CSV
discounted_credit_rights_conciliation_assets某日已还款的所有应收账款CSV
investor_position_csv当日投资者持仓明细CSV
pdd_calc坏账准备金计算CSV
pmts_reconciliation当日已完成付款XLSX
wallet_composition日末投资组合构成XLSX
wallet_composition_fund_quotas日末投资组合中的基金份额构成CSV