Version: | 1.0.4 |
Title: | Accounting Analysis |
Description: | Provides methods for processing corporate balance sheets with a focus on the Brazilian reporting format. Includes data standardization, classification by accounting categories, and aggregation of values. Supports accounting and financial analyses of companies, improving efficiency and ensuring reproducibility of empirical studies. |
License: | MIT + file LICENSE |
URL: | https://github.com/LissandroSousa/adcontabil.R |
BugReports: | https://github.com/LissandroSousa/adcontabil.R/issues |
Imports: | dplyr, magrittr, stringi, data.table |
Encoding: | UTF-8 |
RoxygenNote: | 7.3.3 |
NeedsCompilation: | no |
Depends: | R (≥ 4.1.0) |
Packaged: | 2025-09-26 22:39:29 UTC; USER |
Author: | Lissandro Costa de Sousa [cre, aut], Francisco Gildemir Ferreira da Silva [ths, aut] |
Maintainer: | Lissandro Costa de Sousa <lisandrosousa54@gmail.com> |
Repository: | CRAN |
Date/Publication: | 2025-10-03 13:10:02 UTC |
Calcular Análise Vertical e Horizontal com projeção
Description
Esta função realiza a Análise Vertical (AV) e Análise Horizontal (AH) com base em dados contábeis de empresas, podendo ser aplicada tanto a dados agregados quanto a dados detalhados (ex: Balanço Patrimonial individualizado). Além disso, gera uma projeção para o ano seguinte, assumindo um crescimento de 5
Usage
calcular_AV_AH(df, tipo)
Arguments
df |
Um data frame contendo os dados contábeis. Deve conter colunas com valores numéricos para diferentes anos, além de uma coluna identificadora da natureza das contas (por exemplo, |
tipo |
Um parâmetro do tipo |
Details
A Análise Vertical (AV) expressa cada item patrimonial como uma proporção do total do ativo ou passivo correspondente no mesmo ano.
A Análise Horizontal (AH) compara a evolução dos valores ao longo dos anos, em relação ao primeiro ano da base de dados (ano base).
A função ainda projeta valores para o ano seguinte com base em um crescimento linear de 5
Value
Uma lista com dois data frames:
AV_AH
Data frame contendo os valores originais, os resultados da Análise Vertical (com sufixo
_AV
) e da Análise Horizontal (com sufixo_AH
).Projecao
Data frame contendo a projeção de valores para o ano seguinte, com base em um crescimento de 5%.
Examples
# Criando dados agregados de exemplo
df <- data.frame(
Conta = c("Ativo Circulante", "Passivo Circulante"),
X2022 = c(1000, 800),
X2023 = c(1200, 900)
)
resultado <- padronizar_balanco(df)
# Calculando análise vertical e horizontal
av_ah <- calcular_AV_AH(resultado$agregado, tipo = "agregado")
head(av_ah$AV_AH)
head(av_ah$Projecao)
Lista de categorias contabeis utilizadas internamente
Description
Este objeto lista, em formato de 'list', as categorias contabeis utilizadas para classificacao de contas em funcoes internas do pacote.
Usage
categorias
Format
Uma lista nomeada com vetores de caracteres.
Details
As chaves representam os grupos (por exemplo, ACF = Ativo Circulante Financeiro), e os vetores associados contem os nomes das contas que pertencem a cada grupo.
Classifica contas contabeis de acordo com categorias predefinidas
Description
A funcao recebe o nome de uma conta e retorna sua categoria contabil conforme a lista 'categorias'.
Usage
classificar_conta(conta)
Arguments
conta |
Um vetor de caracteres com o(s) nome(s) da(s) conta(s) a classificar. |
Value
Um vetor de caracteres com a categoria correspondente ou NA
se nao classificada.
Converte texto contabil brasileiro para numero negativo quando necessario
Description
Esta funcao transforma strings representando valores contabeis no formato brasileiro (com virgula decimal, ponto como separador de milhar e uso de parenteses para indicar valor negativo) em valores numericos padrao do R.
Usage
conv_br_numeric(vetor)
Arguments
vetor |
Vetor de caracteres contendo os valores a serem convertidos. |
Value
Vetor numerico com os valores convertidos.
Calcula indicadores financeiros de liquidez e endividamento
Description
Esta funcao recebe um data frame resultante da agregacao de contas contabeis por categoria
(geralmente produzido pela funcao processar_balanco
) e calcula indicadores classicos de
liquidez e endividamento com base nas categorias padronizadas: ACO
, ACF
, PCO
,
PCF
, ANC
, PNC
e PL
.
Usage
indicadores(df)
Arguments
df |
Um |
Details
As categorias devem seguir os seguintes significados:
-
ACO
: Ativo Circulante Operacional -
ACF
: Ativo Circulante Financeiro -
PCO
: Passivo Circulante Operacional -
PCF
: Passivo Circulante Financeiro -
ANC
: Ativo Nao Circulante -
PNC
: Passivo Nao Circulante -
PL
: Patrimonio Liquido
Indicadores calculados:
-
Liquidez Corrente: (ACO + ACF) / (PCO + PCF)
-
Liquidez Seca: ACO / (PCO + PCF)
-
Liquidez Imediata: ACF / (PCO + PCF)
-
Endividamento Geral: (PCO + PCF + PNC) / (ACO + ACF + ANC)
-
Composicao do Endividamento: (PCO + PCF) / (PCO + PCF + PNC)
-
Imobilizacao do PL: ANC / PL
Value
Um data.frame
onde cada linha representa um indicador financeiro e cada coluna subsequente
representa o valor do indicador para um determinado ano.
Examples
# Criando um data frame de balanço com todas as categorias essenciais
df <- data.frame(
Categoria = c("ACO", "ACF", "PCO", "PCF", "ANC", "PNC", "PL"),
X2022 = c(1000, 500, 600, 400, 2000, 1500, 2000),
X2023 = c(1200, 600, 700, 500, 2200, 1600, 2300)
)
# Calculando os indicadores
indicadores(df)
Normaliza texto removendo acentos e cedilha
Description
Esta funcao converte o texto para minusculas, normaliza para Unicode NFC e remove todos os acentos, cedilhas e marcas diacriticas, retornando apenas caracteres ASCII basicos.
Usage
normalizar_texto(x)
Arguments
x |
Vetor de caracteres a ser normalizado. |
Value
Vetor de caracteres normalizado.
Examples
normalizar_texto(c("Ção", "Ótimo", "maçã", "PÃO"))
# [1] "cao" "otimo" "maca" "pao"
Processa e agrega um balanco patrimonial em categorias contabeis
Description
Esta funcao realiza o pre-processamento de um data frame contendo contas do balanco patrimonial, convertendo os valores numericos no formato brasileiro para formato numerico padrao do R, classificando as contas em categorias contabeis predefinidas e agregando os valores por categoria.
Usage
padronizar_balanco(df)
Arguments
df |
Um |
Details
A primeira coluna do data frame deve conter os nomes das contas, enquanto as demais colunas devem conter os valores financeiros em formato textual brasileiro (com ponto como separador de milhar e virgula decimal).
Value
Uma lista com dois objetos:
agregado
Um
data.frame
com os valores agregados por categoria contabil.original
O
data.frame
original com os valores convertidos e a nova colunaCategoria
.
Examples
df <- data.frame(
Conta = c("Caixa e equivalentes de caixa", "Fornecedores"),
X2022 = c("1.000,00", "(500,00)"),
X2023 = c("1.200,00", "(600,00)")
)
# Padronizando o balanço
resultado <- padronizar_balanco(df)
resultado$agregado