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 DTVM 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 DTVM. 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 DTVM:

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

Python

    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.

Arquivos exemplo

Todos os exemplos de relatórios estão em: relatórios

Tipos de relatórios

Modelo	Descrição	Formato do arquivo
admin_fee_calc	Calculo da taxa de administração	CSV
amortization	Histórico de amortizações no fundo	CSV
cash_account_demonstrative	Demonstrativo de caixa ao fim do dia	XLSX
cash_account_demonstrative_movements	Demonstrativo das movimentações caixa ao longo do dia	CSV
assets_wallet_composition	Todos os ativos que compõem o estoque em um dia	CSV
assignment_assets_wallet_composition	Todas as parcelas de uma cessão de direitos creditórios	CSV
credit_rights_acquisition_assets	Todas as operação de crédito adquiridas em um dia	CSV
credit_rights_acquisition_installments	Todas as parcelas de operações de crédito adquiridas em um dia	CSV
credit_rights_conciliation_assets	Todas as operação de crédito que foram pagas em um dia	CSV
credit_rights_conciliation_installments	Todas as parcelas de operações de crédito que foram pagas em um dia	CSV
discounted_credit_rights_acquisition_assets	Todos as duplicatas adquiridos em um dia	CSV
discounted_credit_rights_conciliation_assets	Todos as duplicatas que foram pagas em um dia	CSV
investor_position_csv	Relação de posição dos investidores no dia	CSV
pdd_calc	Cálculo de provisão de devedores duvidosos	CSV
pmts_reconciliation	Pagamentos realizados na data	XLSX
wallet_composition	Composição da carteira ao fim do dia	XLSX
wallet_composition_fund_quotas	Composição de cotas de fundo na carteira ao fim do dia	CSV