Hledger – controle de dinheiros

Disclaimer: o código publicado aqui é de autoria minha, Anne Isabelle Macedo, e não contém propriedade intelectual da Nubank

Esse é um repo que facilita o controle financeiro usando hledger.

Com ele, é possível categorizar finanças de forma automatizada a partir de algumas regras.

YMMV (your mileage may vary) - esse repo foi feito com base no Nubank, iCloud e no macOS. Se quiser, pode fazer um fork ou abrir um PR adicionando outros formatos de bancos e etc.

Passos

0 – pegue o extrato do Nubank no app

Eu fiz a seguinte automação no app Shortcuts do meu iPhone pra copiar o extrato do Nubank automaticamente para meu drive do iCloud. Eu mantenho meus extratos no diretório ~/Documents/extrato_nu/

É possível também exportar a fatura do cartão de crédito (fechada) como CSV.

Por fim, fiz a seguinte automação no Shortcuts no iPhone.

1 – clone esse repo e rode o make init

make init

Isso vai criar o arquivo private.rules e instalar o Hledger usando Brew. Leia as instruções para o seu sistema operacional para instalar o Hledger.

2 – escreva regras

Abra o arquivo private.rules e escreva as regras que você precisa :)

Exemplos:

if OXXO
EXTRA
  comment mercado:
  account2 expenses:mercado

if UBER
  account2 expenses:transporte
  comment uber:
  
if NET SERVICOS
CLARO
  account2 expenses:servicos
  comment internet-telefonia:

Leia essa doc para mais regras. Aqui também tem mais informação.

3 – make import

make import

4 – confira o hledger para ajustar suas regras

hledger print | grep unknown -B 2

Hledger tips and tricks

Vendo payees – pra quem eu paguei ou de quem eu recebi

hledger payees

Vendo todas as transações feitas para a Uber

hledger print --pivot uber tag:uber

Organizando transações

Eu organizo minhas transações pessoais assim:

if NomeDaPsicologa
   comment cat:saude, kind:psicoterapia
   account2 expenses:saude

E assim eu posso filtrar:

hledger print --pivot cat tag:kind=psicoterapia

Eu tenho também uma regra em common.rules em que todas as transações são categorizadas como unknown, facilitando a conferência delas no hledger.

hledger print --pivot cat tag:cat=unknown