Contabilidade em Texto Plano (Plain Text Accounting, PTA)

Plain Text Accounting (PTA)

Introdução ao Plain Text Accounting

• Plain Text Accounting (PTA) é uma forma de realizar contabilidade e escrituração usando arquivos de texto e softwares amigáveis à linha de comando
• As principais ferramentas incluem Ledger, hledger e Beancount
• Este site reúne ferramentas, documentação e práticas da comunidade PTA, e é mantido por Simon Michael e colaboradores

Mapa do site

• Oferece diversos recursos, como visão geral do PTA, notícias e discussões, vídeos, slides, documentação, FAQ, livro de receitas e software

Notícias e discussões

• Discussões relacionadas a PTA acontecem em várias plataformas, como fóruns, salas de chat, blogs e artigos, Reddit, Lemmy, Hacker News, Mastodon, Twitter e Stack Exchange

Vídeos

• Oferece vídeos com apresentações de diversos palestrantes sobre temas como Ledger CLI, gestão de finanças pessoais, acompanhamento de gastos com Obsidian e as vantagens do Plain Text Accounting

Slides

• Oferece slides sobre diversos temas, como um tour pela arquitetura do hledger, introdução ao Plain Text Accounting e gestão de finanças pessoais puramente funcional

Documentação

• Oferece diversos documentos, como fundamentos de contabilidade, documentação de apps PTA, comparações, introduções, cheat sheets, livro de receitas e FAQ

Software

• Oferece diversos softwares, como apps PTA, plugins de editor, importação/conversão de dados, captura de preços, geração de dados, fluxo de trabalho, formatação, geração de relatórios, registro de tempo e UI

Apps PTA

• Apresenta vários apps PTA, como Ledger, hledger e Beancount, e compara quando cada app começou, último lançamento, código, número de committers, estrelas, tamanho da lista de e-mails, tamanho do chat e proporção de issues

Plugins de editor

• Oferece plugins para diversos editores, como Atom, Emacs, IntelliJ, Nano, Sublime, TextMate, VIM e VS Code

Importação/conversão de dados

• Oferece diversas ferramentas de importação e conversão de dados, como conversão de CSV e ferramentas que convertem dados de vários formatos para Beancount

Captura de preços

• Mostra como obter preços de mercado usando várias ferramentas, como Beancount, hledger e Ledger

Geração de dados

• Oferece diversas ferramentas de geração de dados, como geração de transações de preço, geração de transações de depreciação e geração de itens de juros

Fluxo de trabalho

• Oferece diversas ferramentas de workflow, como sistemas baseados em Docker, geração de journals do hledger a partir de arquivos CSV e sistemas para freelancers alemães

Formatação

• Oferece diversas ferramentas de formatação, como formatador de arquivos Beancount e formatador baseado na web

Geração de relatórios

• Oferece diversas ferramentas de geração de relatórios, como relatórios de orçamento, apps de análise de patrimônio pessoal e ferramentas para gerar gráficos do hledger

Registro de tempo

• Oferece ferramentas de registro e relatórios de tempo usando org2tc, taskwarrior e hledger

UI, console

• Oferece diversas ferramentas de UI de console, como ferramenta interativa de entrada de transações e gerador de transações

UI, curses

• Oferece diversas ferramentas de UI curses, como hledger-iadd, hledger-ui e ledger-add

UI, GUI

• Oferece diversas ferramentas GUI, como Ledgerble e Prudent

UI, web

• Oferece diversas ferramentas de UI web, como fava, hledger-web e Paisa

UI, mobile

• Oferece diversas ferramentas de UI mobile, como app móvel do Beancount e NanoLedger

Bibliotecas

• Oferece diversas bibliotecas, como parser do Beancount e extensões do Beancount

Utilitários

• Oferece diversos utilitários, como ferramentas de linha de comando do Beancount e hledger-lib

API

• Oferece diversas APIs, como gledger, hledger-lib e BeanHub API

Resumo do GN⁺

• Plain Text Accounting é uma forma de fazer contabilidade com arquivos de texto e ferramentas de linha de comando, usando ferramentas como Ledger, hledger e Beancount
• Há discussões sobre PTA em várias plataformas, e o site oferece diversos recursos, como vídeos, slides e documentação
• O site também oferece vários apps PTA, plugins de editor, ferramentas de importação/conversão de dados e ferramentas de captura de preços, ajudando usuários a realizar tarefas contábeis com mais facilidade
• Este artigo é útil para quem tem interesse em PTA, especialmente desenvolvedores que preferem ferramentas de linha de comando
• Projetos com funcionalidades semelhantes incluem GnuCash e QuickBooks

[GN⁺]

Opiniões no Hacker News

• Uso o ledger-cli há 20 anos. Não é perfeito, mas estou muito satisfeito. Como tudo é texto puro, é fácil criar scripts, ler no VIM e extrair dados. Atualmente, um dos arquivos do ledger de uma das minhas empresas é um texto puro de 2 MB contendo o histórico de transações desde 2016

  • Não vi muito valor nas várias "contas" (categorias), mas elas foram essenciais para rastrear tudo
  • Aprender contabilidade de partidas dobradas foi divertido e é uma habilidade útil para a vida toda

• Um sistema de categorização rígido e imediato não funciona para algumas pessoas. Na empresa, usávamos uma abordagem em duas etapas

  • A pessoa escrevia uma nota no app Notas do iPhone, e depois um script fazia o parsing da data, detectava palavras-chave e criava um template de partidas dobradas
  • O script detectava "agentes" externos e análises internas, e adicionava o texto original como comentário. Itens não detectados precisavam ser categorizados manualmente e adicionados ao script
  • O script usava listas editáveis em vez de valores hardcoded, e isso era configurado de forma diferente para cada pessoa

• Graças aos LLMs, a contabilidade em texto puro ficou muito mais fácil. Dá para importar extratos bancários para o hledger e evitar lançamentos manuais

  • Uso um arquivo JSON para mapear lançamentos bancários para contas do hledger. Para novas transações, executo um script em Python e peço ao Claude para fazer o mapeamento
  • O Claude retorna lançamentos de diário do hledger com base nesse mapeamento, e isso pode ser revisado rapidamente
  • Outro script gera os lançamentos de diário do hledger para as transações bancárias daquele mês

• Tenho usado o Beancount, e foi prazeroso escrever ferramentas de importação de dados e vivenciar a contabilidade na prática. Mas faz quase um ano que não importo dados. Eu pretendia fazer isso todo mês, mas leva de 30 a 60 minutos e acaba sendo incômodo

• Contabilidade em texto puro é incrível, mas um grande obstáculo é conseguir que as pessoas baixem dados bancários em formatos padrão

  • Os bancos não oferecem nada além de arquivos CSV ou Excel. Várias plataformas de agregação de dados, como yodlee e plaid, não são amigáveis para usuários de código aberto ou hobbyistas
  • No passado, uma empresa chamada Wesabe fazia sincronização bancária no desktop, mas o Mint.com a tirou do mercado. Parece algo que poderia ser aplicado ao open source

• Escrevi uma série prática de "receitas" sobre como usar o Ledger de forma eficaz

  • link

• Estou procurando uma solução em texto puro que entenda estoque (quantidade, FIFO, custo médio em dólares) e faturas/POs (AP/AR)

  • Gostaria que usasse palavras como "débito" e "crédito". A notação +/− dificulta a tradução para relatórios em texto puro a partir de documentos ou cenários financeiros reais

• Gostaria de ouvir como outras pessoas usam diferentes ferramentas de contabilidade em texto puro

  • Tenho curiosidade se usam isso para entender hábitos de consumo e tomar medidas corretivas, se usam apenas para rastrear despesas, receitas, patrimônio líquido etc., ou se é simplesmente pelo processo em si
  • Sempre que penso em contabilidade em texto puro, sinto ou um impulso de mergulhar completamente nisso, ou culpa por não ter sido consistente nas tentativas anteriores. No momento, é mais culpa mesmo

• Sou um grande fã do Ledger e, nos últimos 8 anos, administro toda a minha vida contábil com hledger

  • É melhor não dividir várias contas em arquivos demais; prefiro manter um arquivo por ano para cada conta
  • O GitHub Copilot é muito útil para trabalhar com arquivos do ledger. Ele faz quase perfeitamente os cálculos de adicionar/subtrair saldos
  • Quando preciso inserir um novo lançamento manualmente, muitas vezes basta digitar um comentário de uma linha como atalho, e ele preenche o lançamento completo