3 postagens marcado com "accounting"

A versão 3 do Beancount, lançada em meados de 2024, marca uma evolução arquitetônica significativa para a popular ferramenta de contabilidade em texto simples. Embora mantenha a compatibilidade retroativa para os arquivos de livro-razão do usuário, a estrutura subjacente e as ferramentas que a acompanham passaram por mudanças substanciais. Aqui está um resumo das novidades no Beancount v3.

Uma Arquitetura Mais Modular e Otimizada​

A mudança mais significativa no Beancount v3 é a transição para um ecossistema mais modular. Várias funcionalidades-chave que antes eram agrupadas com o núcleo foram desmembradas em projetos separados e independentes. Isso torna o núcleo do Beancount mais enxuto e permite um desenvolvimento mais focado em componentes individuais.

Os principais componentes que agora são pacotes separados incluem:

• beanquery: A poderosa ferramenta de consulta semelhante a SQL para seus arquivos de livro-razão agora está em seu próprio pacote.
• beangulp: Este é o novo lar para o framework de importação de dados, substituindo o antigo módulo beancount.ingest.
• beanprice: Uma ferramenta dedicada para buscar preços de commodities e ações.

Essa separação significa que os usuários precisarão instalar esses pacotes além do próprio beancount para reter a funcionalidade completa à qual estavam acostumados na versão 2.

Mudanças nas Ferramentas de Linha de Comando e Fluxos de Trabalho​

Refletindo a nova arquitetura modular, há algumas mudanças notáveis nas ferramentas de linha de comando:

• bean-report foi removido: Esta ferramenta foi removida. Os usuários agora são encorajados a usar bean-query (do pacote beanquery) para suas necessidades de relatórios.
• Novo Fluxo de Trabalho de Importador: Os comandos bean-extract e bean-identify foram removidos do núcleo. A nova abordagem com beangulp é baseada em scripts. Os usuários agora criarão seus próprios scripts Python para lidar com a importação de dados de fontes externas, como extratos bancários.

Melhorias de Sintaxe e Recursos​

Embora os princípios contábeis centrais permaneçam os mesmos, o Beancount v3 introduz alguma flexibilidade bem-vinda à sua sintaxe:

• Códigos de Moeda Mais Flexíveis: As restrições anteriores sobre o comprimento e os caracteres para nomes de moedas foram relaxadas. Símbolos de moeda de um único caractere agora são suportados.
• Sinalizadores de Transação Expandidos: Os usuários agora podem usar qualquer letra maiúscula de A a Z como um sinalizador para transações, permitindo uma categorização mais granular.

É importante ressaltar que essas mudanças são compatíveis com versões anteriores, então seus arquivos de livro-razão Beancount v2 existentes funcionarão sem modificações.

A Reescrita em C++ e Desempenho​

Um dos objetivos de longo prazo para o Beancount tem sido a reescrita de seus componentes críticos de desempenho em C++. Embora este trabalho esteja em andamento, o lançamento inicial do Beancount v3 não inclui o núcleo baseado em C++. Isso significa que, por enquanto, o desempenho do v3 é comparável ao do v2. O código C++ permanece em um branch de desenvolvimento separado para integração futura.

Migrando de v2 para v3​

Para a maioria dos usuários, a migração do Beancount v2 para o v3 é relativamente simples:

1. Arquivos de Livro-Razão: Nenhuma alteração é necessária para seus arquivos .beancount.
2. Instalação: Você precisará instalar os novos pacotes separados, como beanquery e beangulp, usando pip.
3. Scripts de Importação: Se você tiver importadores personalizados, precisará atualizá-los para usar a nova API beangulp. Isso envolve principalmente a alteração da classe base da qual seus importadores herdam e o ajuste de algumas assinaturas de método.
4. Fava: A popular interface web para Beancount, Fava, foi atualizada para ser compatível com o v3. Certifique-se de ter a versão mais recente do Fava para uma experiência perfeita.

Em essência, o Beancount v3 é um lançamento fundamental que otimiza a arquitetura do projeto, tornando-o mais modular e fácil de manter e estender a longo prazo. Embora exija alguns ajustes nos fluxos de trabalho do usuário, especialmente em torno da importação de dados, ele prepara o terreno para o desenvolvimento futuro desta poderosa ferramenta de contabilidade.

Por que o humilde orçamento se transforma em tesouraria multi-moeda à medida que uma organização cresce

Aplicativos de finanças pessoais prometem sete tarefas principais: ver tudo em um só lugar, orçamentar, acompanhar receitas e despesas, pagar dívidas, economizar para grandes compras, gerenciar dinheiro com um parceiro e monitorar investimentos. As mesmas necessidades reaparecem nos negócios — e se multiplicam à medida que o número de funcionários, reguladores e investidores entram em cena.

Micro e pequenas empresas (fundador solo → ±50 funcionários)​

Tarefas extras exclusivas para pequenas empresas

• Conformidade com folha de pagamento e benefícios (declarações precisas e pontuais).
• Coleta e remessa de imposto sobre vendas / IVA entre estados ou países.
• Cobertura básica de risco (seguro de responsabilidade, cibernético, de pessoa-chave).

Empresas de médio e grande porte (≈ 50 – 500 funcionários, frequentemente multi-entidades)​

• Orçamentos em nível de departamento, além de previsões contínuas para FP&A.
• Previsão de fluxo de caixa de 13 semanas e 12 meses para proteger a margem de segurança dos convênios ([eventusag.com][3]).
• Gestão de portfólio de dívida e capital próprio (empréstimos a prazo, dívida de risco, diluição da tabela de capital).
• Consolidação multi-entidades — eliminações intercompanhias e reavaliação de câmbio em tempo real ([picus-capital.medium.com][4]).
• Controles internos e prontidão para auditoria (segregação de funções, SOX-lite).
• Aquisição de fornecedores e monitoramento do ciclo de vida de contratos.
• Painéis de KPI para investidores e credores (EBITDA, ARR, DSO, dias de capital de giro).

Grandes empresas e grupos globais (500 + funcionários)​

Principais conclusões para desenvolvedores de produtos​

• Mesmos instintos, palco maior – “mostre-me tudo” evolui de um painel estilo Mint para consolidação multi-contábil e visões de tesouraria.
• O caixa é rei em todos os níveis – mas as ferramentas saltam de planilhas para motores de previsão dedicados.
• A conformidade aumenta – folha de pagamento, impostos, auditoria e ESG aparecem apenas em contextos de negócios e dominam as cargas de trabalho empresariais.
• Partes interessadas se multiplicam – indivíduos coordenam com um parceiro; empresas lidam com funcionários, fornecedores, banqueiros, investidores e reguladores.

Compreender onde um cliente se encaixa nesta curva de crescimento permite priorizar recursos que fazem a diferença — seja a visibilidade instantânea do fluxo de caixa para o proprietário de um café ou o cash pooling transfronteiriço para uma multinacional.

Na postagem de blog de hoje, vamos desvendar um livro contábil Beancount para empresas, o que o ajudará a entender as complexidades deste sistema de contabilidade de dupla entrada em texto simples.

Vamos começar com o código primeiro:

1970-01-01 open Assets:Bank:Mercury
1970-01-01 open Assets:Crypto

1970-01-01 open Equity:Bank:Chase

1970-01-01 open Income:Stripe
1970-01-01 open Income:Crypto:ETH

1970-01-01 open Expenses:COGS
1970-01-01 open Expenses:COGS:Contabo
1970-01-01 open Expenses:COGS:AmazonWebServices

1970-01-01 open Expenses:BusinessExpenses
1970-01-01 open Expenses:BusinessExpenses:ChatGPT

2023-05-14 * "CONTABO.COM" "Mercury Checking ••1234"
  Expenses:COGS:Contabo                               17.49 USD
  Assets:Bank:Mercury                                -17.49 USD

2023-05-11 * "Amazon Web Services" "Mercury Checking ••1234"
  Expenses:COGS:AmazonWebServices                  14490.33 USD
  Assets:Bank:Mercury                             -14490.33 USD

2023-03-01 * "STRIPE" "Mercury Checking ••1234"
  Income:Stripe                                   -21230.75 USD
  Assets:Bank:Mercury                              21230.75 USD

2023-05-18 * "customer_182734" "0x5190E84918FD67706A9DFDb337d5744dF4EE5f3f"
  Assets:Crypto                                         -19 ETH {1,856.20 USD}
  Income:Crypto:ETH                                      19 ETH @@ 35267.8 USD

Entendendo o Código​

1. Abertura de Contas: O código começa abrindo uma série de contas em 01-01-1970. Estas incluem uma mistura de contas de ativo (Assets:Bank:Mercury e Assets:Crypto), uma conta de patrimônio líquido (Equity:Bank:Chase), contas de receita (Income:Stripe e Income:Crypto:ETH), e contas de despesa (Expenses:COGS, Expenses:COGS:AmazonWebServices, Expenses:BusinessExpenses e Expenses:BusinessExpenses:ChatGPT).

2. Transações: Em seguida, ele prossegue para registrar uma série de transações entre 01-03-2023 e 18-05-2023.

   • A transação de 14-05-2023 representa um pagamento de $17.49 para CONTABO.COM da conta Mercury Checking ••1234. Isso é registrado como uma despesa (Expenses:COGS:Contabo) e uma dedução correspondente da conta Assets:Bank:Mercury.

   • Da mesma forma, a transação de 11-05-2023 representa um pagamento de $14490.33 para Amazon Web Services da mesma conta bancária. Isso é registrado em Expenses:COGS:AmazonWebServices.

   • A transação de 01-03-2023 mostra a receita da STRIPE sendo depositada na conta Mercury Checking ••1234, totalizando $21230.75. Isso é registrado como receita (Income:Stripe) e uma adição à conta bancária (Assets:Bank:Mercury).

   • A última transação de 18-05-2023 representa uma transação de criptomoeda envolvendo 19 ETH de um cliente. Isso é rastreado em Assets:Crypto e Income:Crypto:ETH. O {1,856.20 USD} mostra o preço do ETH no momento da transação, enquanto o @@ 35267.8 USD especifica o valor total da transação de 19 ETH.

Em todas as transações, o princípio da contabilidade de dupla entrada é mantido, garantindo que a equação Ativos = Passivos + Patrimônio Líquido seja sempre verdadeira.

Considerações Finais​

Este livro contábil Beancount oferece um sistema simples, porém robusto, para rastrear transações financeiras. Como visto na transação final, o Beancount é flexível o suficiente para contabilizar ativos não tradicionais, como criptomoedas, o que é um testemunho de sua utilidade em nosso cenário financeiro cada vez mais digital.

Esperamos que esta análise o ajude a entender melhor a estrutura e os recursos do Beancount, seja você um contador experiente ou um iniciante tentando controlar suas finanças pessoais. Fique atento à nossa próxima postagem de blog, onde nos aprofundaremos em operações avançadas do Beancount.