# Il Ciclo Contabile, Stile Beancount

I bilanci non appaiono per magia. Sono il prodotto finale di un processo strutturato e ripetibile noto come **ciclo contabile**. Sebbene i principi siano universali, gli strumenti che utilizzi possono cambiare radicalmente l'esperienza. Questa guida ti accompagna attraverso il ciclo contabile con un focus su **Beancount**, il potente strumento di contabilità in testo semplice.

Vedremo come l'approccio basato sul testo di Beancount elimini passaggi noiosi, cosa dovresti automatizzare e quali report ti offrono la visione più chiara della tua salute finanziaria. 🧑‍💻

---

## TL;DR: Il Flusso di Lavoro di Beancount

- **Registrazione & Giornale:** Registra ogni transazione come una registrazione a partita doppia pulita nel tuo file di testo `.beancount`.
- **Validazione & Riconciliazione:** Usa le asserzioni `balance` per confermare che la tua contabilità corrisponda agli estratti conto bancari ed esegui `bean-check` per individuare errori.
- **Revisione:** Genera un bilancio di verifica non rettificato per un rapido controllo di coerenza.
- **Rettifica:** Registra scritture per ratei, risconti, ammortamenti e altre voci di fine periodo.
- **Nuova revisione:** Controlla il bilancio di verifica rettificato per assicurarti che tutto sia corretto.
- **Pubblicazione & Chiusura:** Genera il tuo Conto Economico, Stato Patrimoniale e Rendiconto Finanziario. La chiusura dei conti è facoltativa in Beancount, poiché i report sono sensibili alla data.

Questo flusso può essere visualizzato così:

```mermaid
graph TD
  A[Dati grezzi - esportazioni bancarie, ricevute, fatture] --> B[File Giornale Beancount .beancount]
  B --> C[Validazione & Riconciliazione<br/><code>balance</code> asserzioni · <code>bean-check</code>]
  C --> D[Bilancio di Verifica Non Rettificato<br/><code>bean-query</code> · Fava]
  D --> E[Scritture di Rettifica<br/>ratei · risconti · tasse]
  E --> F[Bilancio di Verifica Rettificato]
  F --> G[Bilanci Civilistici<br/>C.E. · Stato Patrimoniale · Rendiconto Finanziario]
  G --> H[Chiusura - Utile Portato a Nuovo]
  H -- nuovo periodo --> B
```

---

## Passo 1: Registrare e Registrare le Transazioni

Questo è il passo fondamentale. Ogni evento finanziario—una vendita, un acquisto, una commissione bancaria—deve essere registrato. In Beancount, lo fai creando transazioni in un semplice file di testo, solitamente chiamato `main.beancount` o organizzato in più file per anno.

Ogni transazione deve seguire le regole della contabilità a partita doppia, il che significa che la somma di tutte le registrazioni deve essere zero. Beancount lo impone per te.

```beancount
2025-08-10 * "Walmart" "Acquisto forniture per ufficio"
  Expenses:Office:Supplies      45.67 USD
  Assets:Bank:Checking         -45.67 USD
```

- **Consiglio da Esperto:** Usa tag come `#project-phoenix` o `#client-acme` per aggiungere dimensioni ai tuoi dati. Questo rende le interrogazioni e i report estremamente flessibili in seguito.

### Igiene della Riconciliazione ✅

La funzionalità più potente per garantire l'accuratezza è l'**asserzione di saldo**. Alla fine di un periodo di rendiconto (es. fine mese), dichiari quale _dovrebbe_ essere il saldo di un conto.

```beancount
2025-08-31 balance Assets:Bank:Checking  12345.67 USD
```

Se la somma di tutte le transazioni che interessano `Assets:Bank:Checking` fino a quella data non è uguale a `12345.67 USD`, Beancount genererà un errore. Questa semplice direttiva trasforma la tua contabilità in un documento auto-verificante.

Per chi ricostruisce dati storici, la direttiva `pad` può creare automaticamente una transazione di bilanciamento per far corrispondere i saldi di apertura con la tua prima asserzione.

---

## Passo 2: "Registrare nella Contabilità" (Un Vantaggio Gratuito!)

Nei sistemi contabili tradizionali, si scrivono prima le scritture in un "giornale", e poi un passaggio separato di "registrazione" copia quei valori nella "contabilità generale".

Con Beancount, **il tuo file `.beancount` è sia il giornale che la contabilità generale.** Quando scrivi e salvi una transazione, l'hai già registrata. Non esiste un passaggio separato. Questa immediatezza è un vantaggio fondamentale della contabilità in testo semplice: ciò che vedi è ciò che ottieni.

---

## Passo 3: Preparare un Bilancio di Verifica Non Rettificato

Prima di iniziare a fare rettifiche, hai bisogno di un rapido controllo "torna tutto?". Un **bilancio di verifica** è un semplice report che elenca ogni conto e il suo saldo totale. Il totale complessivo di tutti i saldi dare deve essere uguale al totale complessivo di tutti i saldi avere.

Puoi generarlo con una semplice interrogazione:

```bash
bean-query main.beancount \
  "SELECT account, sum(position) GROUP BY 1 ORDER BY 1"
```

Oppure, per un approccio più visivo, apri la tua contabilità in **Fava** (l'interfaccia web per Beancount) e naviga al report "Bilancio di Verifica". Cerca qualsiasi cosa insolita—un conto patrimoniale con saldo avere, o un conto economico con un valore strano.

---

## Passo 4: Registrare le Scritture di Rettifica

Le scritture di rettifica sono fondamentali per una rendicontazione accurata secondo il **principio di competenza economica**. Assicurano che i ricavi siano riconosciuti quando maturati e i costi quando sostenuti, indipendentemente da quando avviene lo scambio di denaro.

Le rettifiche comuni includono:

- **Ratei:** Registrare ricavi che hai maturato ma non hai ancora fatturato, o un costo che hai sostenuto ma non hai ancora pagato.
- **Risconti:** Gestire i pagamenti anticipati. Se un cliente ti paga per un anno di servizio in anticipo, lo registri come passività (`Liabilities:UnearnedRevenue`) e riconosci 1/12 come ricavo ogni mese.
- **Voci Non Monetarie:** Registrare elementi come l'ammortamento dei beni.
- **Correzioni:** Correggere errori o contabilizzare elementi mancanti dai flussi bancari, come un piccolo pagamento di interessi.

#### **Esempio: Rateo Attivo**

Hai completato un progetto il 31 agosto ma non invierai la fattura fino a settembre. Per riconoscere il ricavo nel periodo corretto (agosto), effettui una scrittura di rettifica:

```beancount
2025-08-31 * "Rateo attivo per progetto cliente #1042"
  Assets:AccountsReceivable      3000.00 USD
  Income:Consulting             -3000.00 USD
```

#### **Esempio: Registrazione Ammortamento**

La tua azienda ha un piano di ammortamento per i suoi beni. Alla fine del periodo, registri il costo:

```beancount
2025-12-31 * "Ammortamento annuale attrezzature informatiche"
  Expenses:Depreciation                  4800.00 USD
  Assets:Fixed:AccumulatedDepreciation  -4800.00 USD
```

---

## Passo 5: Eseguire un Bilancio di Verifica Rettificato e Validare

Una volta inserite le scritture di rettifica, esegui di nuovo il report del bilancio di verifica. Questo è il tuo **Bilancio di Verifica Rettificato**. Fornisce la serie finale di numeri che verranno utilizzati per creare i bilanci.

Questo è anche il momento perfetto per eseguire il controllo di coerenza integrato di Beancount:

```bash
bean-check main.beancount
```

Questo comando verifica tutta la sintassi, le regole di bilanciamento e le asserzioni. Se viene eseguito senza alcun output, la tua contabilità è meccanicamente corretta.

---

## Passo 6: Pubblicare i Bilanci 📊

Questa è la ricompensa. Utilizzando i numeri del tuo bilancio di verifica rettificato, puoi ora generare i report finanziari chiave. Fava è il modo più semplice per farlo, poiché fornisce report interattivi e dettagliati pronti all'uso.

- **Conto Economico (Profitti e Perdite):** Mostra i tuoi ricavi e costi in un periodo, risultando nel tuo utile o perdita netta.
- **Stato Patrimoniale:** Un'istantanea di ciò che possiedi (Attività) e ciò che devi (Passività), oltre al tuo patrimonio netto (Capitale Proprio), a una data specifica.
- **Rendiconto Finanziario:** Concilia la tua liquidità iniziale con quella finale mostrando da dove è arrivato il denaro e dove è andato.

Per report personalizzati, puoi utilizzare il linguaggio di interrogazione Beancount (BQL). Ecco un'interrogazione per un conto economico mensile:

```sql
-- C.E. per agosto 2025
SELECT account, sum(position)
WHERE account ~ '^(Income|Expenses)'
  AND date >= 2025-08-01 AND date <= 2025-08-31
GROUP BY account ORDER BY account;
```

---

## Passo 7: Chiusura dei Conti (Facoltativa)

Nella contabilità tradizionale, il processo di "chiusura" comporta la creazione di scritture contabili per azzerare tutti i conti temporanei (Ricavi e Costi) e trasferire l'utile netto in un conto di patrimonio netto chiamato **Utile Portato a Nuovo**. Questo resetta formalmente i conti temporanei per l'anno successivo.

**In Beancount, questo passaggio è solitamente inutile.** I report di Fava sono sensibili alla data; se richiedi un C.E. per il 2025, utilizzerà solo i dati del 2025. I saldi non "si accumulano". La maggior parte degli utenti lascia semplicemente i saldi così come sono.

Tuttavia, se devi effettuare una chiusura formale per conformità o rendicontazione agli azionisti, puoi farlo con una semplice transazione di fine anno che sposta il totale dei saldi di ricavi e costi in `Equity:Retained-Earnings`.

---

## Una Checklist Pratica per la Chiusura Mensile

Ecco una checklist ripetibile per chiudere i tuoi conti ogni mese utilizzando Beancount.

```mermaid
flowchart TD
  cap[Registra Transazioni] --> rec[Riconcilia Conti]
  rec --> review[Revisione Non Rettificata]
  review --> adj[Registra Rettifiche]
  adj --> atb[Revisione Rettificata & Validazione]
  atb --> pub[Pubblica Report]
  pub --> wrap[Finalizzazione & Archiviazione]
  wrap --> cap
```

- [ ] **Registrazione:** Importa tutte le transazioni bancarie e delle carte di credito. Inserisci manualmente eventuali spese in contanti o voci extra.
- [ ] **Riconciliazione:** Aggiungi asserzioni `balance` per tutti i conti correnti, carte di credito e conti prestiti, abbinandoli ai tuoi estratti conto.
- [ ] **Revisione:** Esamina il bilancio di verifica non rettificato in Fava. Indaga su eventuali saldi strani o inaspettati. Controlla le fatture non pagate scadute (`Assets:AccountsReceivable`) o le bollette (`Liabilities:AccountsPayable`).
- [ ] **Rettifica:** Registra scritture per ricavi/costi rateali, ricavi riscontati e eventuali correzioni necessarie.
- [ ] **Validazione:** Esegui `bean-check`. Rivedi il bilancio di verifica rettificato finale.
- [ ] **Pubblicazione:** Genera il C.E. e lo Stato Patrimoniale. Inviali agli stakeholder o salvali per i tuoi archivi.
- [ ] **Finalizzazione:** Facoltativamente, esegui una scrittura di chiusura se la tua azienda lo richiede. Archivia una copia dei tuoi file `.beancount` per il periodo.

---

## Perché Beancount Eccelle nel Ciclo Contabile

- **Trasparenza e Verificabilità:** La tua contabilità è un file di testo. Puoi usare `git` per il controllo versione della tua storia finanziaria, rivedere le modifiche con `diff` e collaborare con il tuo commercialista in un formato chiaro e inequivocabile.
- **Controllo Totale:** Definisci tu il tuo piano dei conti. Non sei vincolato alla struttura di un fornitore di software. I tuoi dati sono tuoi, per sempre, in un formato aperto.
- **Potenza Ineguagliabile:** La combinazione di interrogazioni simili a SQL (BQL) e una ricca interfaccia web (Fava) ti offre un potere senza pari per sezionare, analizzare e comprendere i tuoi dati finanziari.

### Frammenti Copia-Incolla per Iniziare

**Piano dei Conti Semplice:**

```beancount
option "title" "La Mia Contabilità Personale"
option "operating_currency" "USD"

;; --- Conti ---
1970-01-01 open Assets:Bank:Checking
1970-01-01 open Assets:AccountsReceivable
1970-01-01 open Liabilities:CreditCard
1970-01-01 open Liabilities:UnearnedRevenue
1970-01-01 open Equity:Owner:Capital
1970-01-01 open Equity:Retained-Earnings
1970-01-01 open Income:Consulting
1970-01-01 open Expenses:Office:Supplies
1970-01-01 open Expenses:Software
1970-01-01 open Expenses:Depreciation
```

**Interrogazione BQL Utile:**

```sql
-- Trova tutti i clienti con un saldo insoluto
SELECT payee, sum(position)
WHERE account = 'Assets:AccountsReceivable'
GROUP BY payee
HAVING sum(position) > 0
ORDER BY sum(position) DESC;
```

Mappando l'atemporale ciclo contabile sui moderni strumenti basati su testo di Beancount, ottieni un sistema robusto, trasparente e costruito per durare. Buona contabilità!
