Skip to main content

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.

  import boto3
import json
import os.path

Inicializando o arquivo das credenciais

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

Fazendo a conexão e download

    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

ModeloDescriçãoFormato do arquivo
admin_fee_calcCalculo da taxa de administraçãoCSV
all_assignment_installmentsTodas as parcelas de uma cessão de direitos creditóriosCSV
amortizationHistórico de amortizações no fundoCSV
cash_account_demonstrativeDemonstrativo de caixa ao fim do diaXLSX
cash_account_demonstrative_movementsDemonstrativo das movimentações caixa ao longo do diaCSV
credit_rights_acquisition_assetsTodos os ativos adquiridos em um diaCSV
credit_rights_acquisition_installmentsTodas as parcelas adquiridas em um diaCSV
credit_rights_composition_assetsTodos os ativos que compõem a carteira em um diaCSV
credit_rights_composition_installmentsTodas as parcelas que compõem a carteira em um diaCSV
credit_rights_conciliation_assetsTodos os ativos que foram pagos em um diaCSV
credit_rights_conciliation_installmentsTodas as parcelas que foram pagas em um diaCSV
investor_position_csvRelação de posição dos investidores no diaCSV
pdd_calcCálculo de provisão de devedores duvidososCSV
pmts_reconciliationPagamentos realizados na dataXLSX
wallet_composition_credit_operationsComposição de operações de crédito na carteira ao fim do diaCSV
wallet_composition_fund_quotasComposição de cotas de fundo na carteira ao fim do diaCSV
wallet_compositionComposição da carteira ao fim do diaXLSX