Pular para o conteúdo principal

Relatórios

Nesta seção iremos apresentar os relatórios fornecidos aos fundos de investimento e o passo a passo que viabiliza o download dos relatórios.

Para ter acesso a esses relatórios, entre em contato com o time integracao.dtvm@qitech.com.br, para que sejam feitas as devidas liberações, em ambiente de Homologação (Sandbox) e posteriormente em ambiente produtivo.

Os relatórios disponibilizados pela QI CTVM incluem informações sobre a composição da carteira, movimentações de ativos, rentabilidade, posição dos investidores e movimentação de caixa. Esses relatórios permitem aos gestores tomar decisões informadas, manter e garantir a transparência e conformidade com as regulamentações.

Acesso via SFTP

O SFTP (Secure File Transfer Protocol) é o protocolo utilizado para disponibilizar os relatórios da QI CTVM. Para realizar a integração com o SFTP é recomendável o uso de bibliotecas e ferramentas que suportem o protocolo, como paramiko para Python ou clientes SFTP padrão.

Formato das credenciais

Para realizar a conexão com o SFTP serão necessárias as seguintes credenciais, que serão disponibilizadas pela QI CTVM:

  1. HOSTNAME: endereço do servidor SFTP
  2. PORT: porta de conexão (padrão 22)
  3. USERNAME: usuário para autenticação
  4. SSH PRIVATE KEY: chave privada no formato PEM para autenticação
Atenção

Essas credenciais dão acesso direto aos relatórios fornecidos e não devem ser compartilhadas.

Exemplo de código

Fazendo a conexão e download​

    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()

Fazendo o download

Após receber as credenciais, é possível realizar o download do arquivo dado o nome resumido do fundo, o modelo do relatório e a data de interesse no formato YYYY-MM-DD conforme o exemplo:

  • nome_exemplo_amortization_2024-01-01
Informação

O serviço de SFTP disponibilizado é exclusivamente para download de arquivos; não é permitido realizar upload.