Title: | Reading Annual and Quarterly Financial Reports from B3 |
---|---|
Description: | Reads annual and quarterly financial reports from companies traded at B3, the Brazilian exchange <https://www.b3.com.br/>. All data is downloaded and imported from CVM's public ftp site <https://dados.cvm.gov.br/dados/CIA_ABERTA/>. |
Authors: | Marcelo Perlin [aut, cre], Guilherme Kirch [aut] |
Maintainer: | Marcelo Perlin <[email protected]> |
License: | GPL-2 |
Version: | 0.6.4 |
Built: | 2025-01-23 02:53:59 UTC |
Source: | https://github.com/msperlin/getdfpdata2 |
Export DFP/ITR data to a xlsx file
export_xlsx(l_dfp, f_xlsx = "GetDFPData-XLSX.xlsx")
export_xlsx(l_dfp, f_xlsx = "GetDFPData-XLSX.xlsx")
l_dfp |
A list from get_dfp_data or get_itr_data |
f_xlsx |
Path to xlsx file |
A dataframe with several information about B3 companies
## Not run: # keep cran check fast df_info <- get_info_companies() str(df_info) ## End(Not run)
## Not run: # keep cran check fast df_info <- get_info_companies() str(df_info) ## End(Not run)
The DFP (demonstrativos financeiros padronizados) is the annual reporting system of companies traded at B3. This function will access the CVM ftp and parse all available files according to user choices
get_dfp_data( companies_cvm_codes = NULL, first_year = 2010, last_year = lubridate::year(Sys.Date()), type_docs = c("BPA", "BPP", "DRE"), type_format = c("con", "ind"), clean_data = TRUE, use_memoise = FALSE, cache_folder = "gdfpd2_cache", do_shiny_progress = FALSE )
get_dfp_data( companies_cvm_codes = NULL, first_year = 2010, last_year = lubridate::year(Sys.Date()), type_docs = c("BPA", "BPP", "DRE"), type_format = c("con", "ind"), clean_data = TRUE, use_memoise = FALSE, cache_folder = "gdfpd2_cache", do_shiny_progress = FALSE )
companies_cvm_codes |
Numeric CVM code of companies. IF set to NULL (default), will return data for all available companies. |
first_year |
First year of selected data |
last_year |
Last year of selected data |
type_docs |
Type of financial documents. E.g. c('DRE', 'BPA'). Definitions: '*' = fetch all docs, 'BPA' = Assets (ativos), 'BPP' = Liabilities (passivo), 'DRE' = income statement (demonstrativo de resultados), 'DFC_MD' = cash flow by direct method (fluxo de caixa pelo metodo direto), 'DFC_MI' = cash flow by indirect method (fluxo de caixa pelo metodo indireto), 'DMPL' = statement of changes in equity (mutacoes do patrimonio liquido), 'DVA' = value added report (desmonstrativo de valor agregado) |
type_format |
Type of format of document (con = consolidated, ind = individual). Default = c('con', 'ind') |
clean_data |
Clean data or return raw data? See read_dfp|itr_csv() for details |
use_memoise |
Use memoise caching? If no (default), the function will read all .csv files. If yes, will use package memoise for caching results (execution speed increases significantly) |
cache_folder |
Path of cache folder to keep memoise and zip files |
do_shiny_progress |
Whether to use shiny progress indicator (default = FALSE) |
A list of tibbles containing all requested financial data. Each element of the list is a table from DFP.
## Not run: df_dfp <- get_dfp_data(companies_cvm_codes = NULL) ## End(Not run)
## Not run: df_dfp <- get_dfp_data(companies_cvm_codes = NULL) ## End(Not run)
Imports a dataset from cvm <https://dados.cvm.gov.br/>, containing up to date information about companies, active or not.
get_info_companies(cache_folder = "gdfpd2_cache")
get_info_companies(cache_folder = "gdfpd2_cache")
cache_folder |
Path of cache folder to keep memoise and zip files |
A dataframe with information about available companies in the database
## Not run: # keep cran check fast df_info <- get_info_companies() str(df_info) ## End(Not run)
## Not run: # keep cran check fast df_info <- get_info_companies() str(df_info) ## End(Not run)
Retrieves ticker information from <https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/FCA/DADOS/>.
get_tickers(year = lubridate::year(Sys.Date()))
get_tickers(year = lubridate::year(Sys.Date()))
year |
year of the data (2018 onwards) |
a dataframe with information about companies and tickers
Helps users search for a company
search_company(char_to_search, cache_folder = "gdfpd2_cache")
search_company(char_to_search, cache_folder = "gdfpd2_cache")
char_to_search |
Character for partial matching |
cache_folder |
Path of cache folder to keep memoise and zip files |
A dataframe with information about available companies in the CVM database
## Not run: # dontrun: keep cran check fast df <- search_company('petrobras') ## End(Not run)
## Not run: # dontrun: keep cran check fast df <- search_company('petrobras') ## End(Not run)