Le registrazioni contabili sono la spina dorsale della contabilità a partita doppia, e in Beancount, ogni transazione * che scrivi è una registrazione contabile. Questa guida spiega gli elementi essenziali—debiti e crediti, scritture di rettifica e scritture di storno—e mostra come si mappano in modo pulito sulla sintassi in testo semplice di Beancount. Imparerai come tenere libri contabili precisi con il minimo sforzo.
Un Breve Ripasso: Cos'è una Registrazione Contabile?
Una registrazione contabile è un documento formale e datato di una transazione finanziaria. È espressa in termini di debiti e crediti che mantengono in equilibrio l'equazione contabile fondamentale:
In un sistema a partita doppia, ogni transazione interessa almeno due conti, e il totale dei debiti deve essere uguale al totale dei crediti. Questa semplice regola è ciò che rende affidabili e accurati i report finanziari derivati come il Conto Economico e lo Stato Patrimoniale.
Debiti e Crediti in un Minuto
I concetti di debito e credito possono essere inizialmente confusi, ma si riducono a poche semplici regole. Pensala in questo modo: "da dove è venuto il valore?" (credito) e "dove è andato il valore?" (debito).
Ecco un promemoria su come aumentano i cinque tipi di conto principali:
| Tipo di Conto | Aumenta con |
|---|---|
| Attività | Debito |
| Costi | Debito |
| Passività | Credito |
| Patrimonio Netto | Credito |
| Ricavi | Credito |
Come Appare una Registrazione Contabile in Beancount
Beancount utilizza direttive di testo semplici e leggibili dall'uomo per registrare le transazioni. Ogni transazione deve bilanciare a zero per ogni commodity (es. USD, EUR, azioni AAPL). Beancount genererà un errore se non lo fa.
Ecco una transazione di base per l'acquisto di un caffè:
2025-09-10 * "Coffee Bar" "Caffè per il team"
Expenses:Food:Coffee 18.00 USD
Assets:Bank:Checking -18.00 USDNota come le due scritture (righe con i conti) sommano a zero: $18.00 + (-$18.00) = 0.
Puoi aggiungere un contesto potente direttamente nella descrizione usando tag (come #clienteX) per filtrare e link (come ^FATT-2025-001) per collegare registrazioni correlate.
Ad esempio, ecco come collegare una fattura al suo pagamento:
; Prima, registra la fattura che hai inviato al cliente
2025-09-15 * "Acme Corp" "Fattura 2025-001 #clienteX ^FATT-2025-001"
Assets:AccountsReceivable 1000.00 USD
Income:Consulting -1000.00 USD
; Successivamente, registra il pagamento e collegalo alla fattura originale
2025-09-28 * "Acme Corp" "Pagamento su ^FATT-2025-001"
Assets:Bank:Checking 1000.00 USD
Assets:AccountsReceivable -1000.00 USDIl tag #clienteX ti permette di filtrare facilmente tutte le transazioni per questo cliente, e il link ^FATT-2025-001 crea una connessione tra le due registrazioni che puoi seguire nei report.
Registrazioni Contabili Comuni (Pronte da Copiare)
Ecco diverse transazioni aziendali comuni formattate per Beancount.
Il Socio Investe Denaro Contante
Un socio conferisce fondi personali per avviare l'attività.
2025-01-01 * "Socio" "Apporto di capitale iniziale"
Assets:Bank:Checking 10000.00 USD
Equity:Owner-Capital -10000.00 USDVendita in Contanti con IVA
Un cliente paga in contanti un prodotto, inclusa un'IVA dell'8% che dovrai successivamente versare allo Stato.
2025-01-05 * "Cliente Occasionale" "Vendita in contanti con IVA 8%"
Assets:Cash 108.00 USD
Income:Sales -100.00 USD
Liabilities:Tax:Sales -8.00 USDVendita a Credito (Fattura) e Incasso
Fornisci un servizio e fatturi il cliente, poi ricevi il pagamento in seguito.
2025-01-10 * "Acme Corp" "Fattura consulenza ^FATT-2025-002"
Assets:AccountsReceivable 2500.00 USD
Income:Consulting -2500.00 USD
2025-01-30 * "Acme Corp" "Pagamento su ^FATT-2025-002"
Assets:Bank:Checking 2500.00 USD
Assets:AccountsReceivable -2500.00 USDSpesa con Carta di Credito
Acquisti materiale per ufficio utilizzando una carta di credito aziendale.
2025-01-12 * "OfficeMax" "Forniture su carta di credito"
Expenses:Office:Supplies 75.00 USD
Liabilities:CreditCard -75.00 USDBuste Paga (Modello Semplice)
Esegui il libro paga, registrando il costo salariale lordo, le ritenute fiscali del dipendente e il pagamento netto dal tuo conto corrente.
2025-01-31 * "Buste Paga" "Salari e ritenute di gennaio"
Expenses:Payroll:Wages 2000.00 USD
Liabilities:Taxes:Withheld -400.00 USD
Assets:Bank:Checking -1600.00 USDAmmortamento Mensile
Registri la quota di ammortamento mensile per un bene, come un portatile.
2025-01-31 * "Ammortamento" "Portatile, a quote costanti"
Expenses:Depreciation 100.00 USD
Assets:Equipment:AccumDepr -100.00 USDCosto Anticipato e Ammortamento Mensile
Paghi un anno intero di assicurazione in anticipo, poi riconosci la spesa per un mese.
; 1. Paga la polizza annuale
2025-01-01 * "InsureCo" "Premio assicurativo annuale"
Assets:Prepaid:Insurance 1200.00 USD
Assets:Bank:Checking -1200.00 USD
; 2. Riconosci un mese di spesa alla fine di gennaio
2025-01-31 * "InsureCo" "Ammortizza 1/12 dell'assicurazione"
Expenses:Insurance 100.00 USD
Assets:Prepaid:Insurance -100.00 USDRicavo Sospeso e Riconoscimento Mensile
Un cliente paga in anticipo un abbonamento trimestrale. Registri il contante e poi riconosci un mese di ricavo.
; 1. Il cliente paga in anticipo il servizio
2025-02-01 * "Abbonato" "Piano trimestrale prepagato"
Assets:Bank:Checking 300.00 USD
Liabilities:Unearned:Subs -300.00 USD
; 2. Riconosci un mese di ricavo dopo aver erogato il servizio
2025-02-28 * "Riconoscimento" "Riconosci mese 1 di 3"
Liabilities:Unearned:Subs 100.00 USD
Income:Subscriptions -100.00 USDFondo Svalutazione Crediti e Cancellazione
Accantoni un fondo per fatture potenzialmente inesigibili e successivamente cancelli una specifica fattura inesigibile.
; 1. Crea un accantonamento basato sul 2% dei Crediti Commerciali
2025-03-31 * "Accantonamento" "2% dei crediti per crediti dubbi"
Expenses:BadDebt 200.00 USD
Assets:AllowanceForDoubtful -200.00 USD
; 2. Cancella una fattura specifica che sai non verrà pagata
2025-04-15 * "Cancellazione" "Fattura cliente XYZ"
Assets:AllowanceForDoubtful 150.00 USD
Assets:AccountsReceivable -150.00 USDRettifica Periodica delle Rimanenze e del COGS
Alla fine di un periodo, calcoli il Costo del Venduto (COGS) rettificando il tuo conto magazzino.
2025-03-31 * "Rettifica COGS" "Metodo inventario periodico"
Expenses:COGS 4500.00 USD
Assets:Inventory -4500.00 USDScritture di Rettifica vs. Scritture di Storno
Le scritture di rettifica vengono registrate alla fine di un periodo contabile (come un mese o un trimestre) per allineare correttamente ricavi e costi al periodo in cui sono stati effettivamente guadagnati o sostenuti. Ciò include ratei, risconti e stime come l'ammortamento.
Le scritture di storno sono scritture opzionali effettuate il primo giorno di un nuovo periodo che annullano esattamente una specifica scrittura di rettifica del periodo precedente. Il loro scopo è semplificare la contabilità. Stornando un rateo, puoi registrare la successiva transazione in contanti in modo standard senza dover ricordare di suddividerla rispetto al conto passivo.
Esempio: Rateo e Storno delle Utenze
Supponiamo che tu debba registrare la spesa per le utenze di gennaio, ma la bolletta arriverà a febbraio.
; 1. Rateizza la spesa stimata alla fine di gennaio
2025-01-31 * "Rateo" "Stima spese utenze gennaio"
Expenses:Utilities 500.00 USD
Liabilities:Accrued:Utilities -500.00 USD
; 2. (Opzionale) Storna il rateo il primo giorno del periodo successivo
2025-02-01 * "Storno" "Annulla rateo utenze gennaio"
Liabilities:Accrued:Utilities 500.00 USD
Expenses:Utilities -500.00 USD
; 3. Registra il pagamento della bolletta effettiva quando arriva a febbraio
; La bolletta effettiva è di 520 USD. Grazie allo storno, puoi
; registrare l'intero importo sul conto spese senza problemi.
; La spesa netta per febbraio sarà 520 USD - 500 USD = 20 USD.
2025-02-10 * "Utenze Comunali" "Pagamento bolletta gennaio"
Expenses:Utilities 520.00 USD
Assets:Bank:Checking -520.00 USDNota: L'esempio nello schema mostra la suddivisione del pagamento finale. Il metodo della scrittura di storno è un'alternativa che semplifica la registrazione del pagamento finale.
Una Checklist per Ogni Registrazione Contabile in Beancount
Segui questi passaggi per garantire che le tue registrazioni siano pulite e corrette:
- Inizia con la data (AAAA-MM-GG) e un flag di transazione (
*). - Aggiungi un beneficiario e una descrizione esplicativa. Usa
#tage^linkper la ricercabilità. - Includi almeno due righe di scrittura che si bilancino a zero per ogni commodity.
- Usa nomi di conto appropriati tra i cinque tipi:
Assets,Liabilities,Equity,Income,Expenses. - Facoltativamente, aggiungi metadati come
document: "invoices/INV-2025-001.pdf"per la tracciabilità.
Errori Comuni (e Come Beancount Aiuta)
- Scritture Non Bilanciate: Se i tuoi debiti e crediti non sommano a zero, Beancount rifiuterà la registrazione. Questa è una caratteristica fondamentale che previene errori. Puoi anche lasciare vuoto l'importo di una scrittura, e Beancount lo calcolerà automaticamente per te.
- Segno Sbagliato su un Conto: È facile dimenticare che
Income,EquityeLiabilitiesaumentano con i crediti (che in Beancount sono tipicamente numeri negativi). Se sbagli, i tuoi report appariranno strani, ma la regola del bilanciamento offre comunque una rete di sicurezza. - Mancanza di Collegamenti tra le Registrazioni: Dimenticare di collegare una fattura al suo pagamento rende più difficile tracciare ciò che è in sospeso. Usare
^linkin modo coerente risolve questo problema creando una traccia verificabile.
Dove Andare Dopo
- Linguaggio e Regole di Bilanciamento di Beancount: Approfondisci la documentazione ufficiale.
- Cheat Sheet della Sintassi: Un comodo riferimento per tutte le direttive di Beancount.
- Primer su Debiti/Crediti: Un ottimo punto di partenza se sei nuovo alle regole contabili.
- Scritture di Rettifica/Storno: Articoli più dettagliati sulla teoria contabile.
Appendice: Linguaggio Contabile → Mappa Beancount
Questa guida di traduzione rapida può aiutarti a mappare le istruzioni contabili nella sintassi di Beancount.
| Istruzione Contabile | Azione in Beancount |
|---|---|
| Addebitare un costo | Importo positivo su un conto Expenses: |
| Accreditare una passività | Importo negativo su un conto Liabilities: |
| Rateizzare un ricavo | Assets:AccountsReceivable + <br> Income:* - |
| Sospendere un ricavo | Assets:Bank:* + <br> Liabilities:Unearned:* - |
| Riconoscere un ricavo sospeso | Liabilities:Unearned:* + <br> Income:* - |
Con questi schemi ed esempi, puoi modellare in modo pulito quasi qualsiasi evento aziendale in Beancount, assicurando che i tuoi report finanziari siano allineati senza sorprese.