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.

Bucket S3

O Bucket S3 é um serviço de armazenamento de arquivos hospedado na AWS que é utilizado para o armazenamento dos relatórios disponibilizados pela QI DTVM. Para realizar a integração com o serviço Bucket S3 é extremamente recomendável que seja utilizado o serviço de integração AWS SDK que possui suporte para diversas linguagens de programação como C++, .NET, Java e Python. No código exemplo utilizaremos a biblioteca Boto3 para realizar a conexão com o Bucket S3.

Formato das credenciais

Para realizar a conexão com o Bucket S3 serão necessárias 4 credenciais que serão disponibilizadas pela QI DTVM em um arquivo json da seguinte maneira.

1. BUCKET_NAME: "nome-exemplo-integration-files-bucket-sandbox"
2. AWS_ACCESS_KEY_ID: "U2GOMBKAKIL3FTBHQAXD"
3. AWS_SECRET_ACCESS_KEY: "0sd5SLRsvzE4obPGIQRxeaL+ebyQy0K3TdatqI75",
4. REGION_NAME: "US-EAST-1"

Atenção

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

Exemplo de código

Importando bibliotecas e credenciais

Aqui, importamos as bibliotecas necessárias ao longo do processo de download.

Python

  import boto3
  import json
  import os.path

Inicializando o arquivo das credenciais

Python

  with open("aws_credentials.json", 'r') as arquivo_json:
    credentials_dict = json.load(arquivo_json)

Fazendo a conexão e download

Python

    s3_client = boto3.client(
        service_name="s3",
        aws_access_key_id=credentials_dict["AWS_ACCESS_KEY_ID"],
        aws_secret_access_key=credentials_dict["AWS_SECRET_ACCESS_KEY"],
        region_name=credentials_dict["REGION_NAME"]
    )

    s3_client.download_file(bucket_name, file_name, local_file_path)

Fazendo o download

Por fim, após serem recebidas 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

É importante ressaltar que os serviços de bucket fornecidos não comportam o serviço de 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
all_assignment_installments	Todas as parcelas de uma cessão de direitos creditórios	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
credit_rights_acquisition_assets	Todos os ativos adquiridos em um dia	CSV
credit_rights_acquisition_installments	Todas as parcelas adquiridas em um dia	CSV
credit_rights_composition_assets	Todos os ativos que compõem a carteira em um dia	CSV
credit_rights_composition_installments	Todas as parcelas que compõem a carteira em um dia	CSV
credit_rights_conciliation_assets	Todos os ativos que foram pagos em um dia	CSV
credit_rights_conciliation_installments	Todas as parcelas 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_credit_operations	Composição de operações de crédito na carteira ao fim do dia	CSV
wallet_composition_fund_quotas	Composição de cotas de fundo na carteira ao fim do dia	CSV
wallet_composition	Composição da carteira ao fim do dia	XLSX