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, "Categoria" ou "Conta").

tipo

Um parâmetro do tipo character que indica a estrutura do data frame. Deve ser "agregado" quando os dados estão organizados por categorias (ex: ACO, ANC, PL etc.), ou outro valor (ex: "detalhado") quando as contas individuais estão identificadas por uma coluna chamada "Conta".

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 data.frame com colunas representando anos (valores numericos) e uma coluna chamada Categoria, contendo os rotulos padronizados das contas contabeis agregadas.

Details

As categorias devem seguir os seguintes significados:

Indicadores calculados:

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 data.frame contendo o balanco patrimonial. A primeira coluna deve conter os nomes das contas, e as colunas seguintes devem conter valores financeiros em formato de texto (ex: "(1.234,56)").

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 coluna Categoria.

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