# Comprendere le Registrazioni Contabili in Beancount

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:

$$Attività = Passività + Patrimonio Netto$$

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è:

```beancount
2025-09-10 * "Coffee Bar" "Caffè per il team"
  Expenses:Food:Coffee          18.00 USD
  Assets:Bank:Checking         -18.00 USD
```

Nota 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:

```beancount
; 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 USD
```

Il 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à.

```beancount
2025-01-01 * "Socio" "Apporto di capitale iniziale"
  Assets:Bank:Checking        10000.00 USD
  Equity:Owner-Capital      -10000.00 USD
```

### Vendita in Contanti con IVA

Un cliente paga in contanti un prodotto, inclusa un'IVA dell'8% che dovrai successivamente versare allo Stato.

```beancount
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 USD
```

### Vendita a Credito (Fattura) e Incasso

Fornisci un servizio e fatturi il cliente, poi ricevi il pagamento in seguito.

```beancount
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 USD
```

### Spesa con Carta di Credito

Acquisti materiale per ufficio utilizzando una carta di credito aziendale.

```beancount
2025-01-12 * "OfficeMax" "Forniture su carta di credito"
  Expenses:Office:Supplies       75.00 USD
  Liabilities:CreditCard        -75.00 USD
```

### Buste 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.

```beancount
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 USD
```

### Ammortamento Mensile

Registri la quota di ammortamento mensile per un bene, come un portatile.

```beancount
2025-01-31 * "Ammortamento" "Portatile, a quote costanti"
  Expenses:Depreciation          100.00 USD
  Assets:Equipment:AccumDepr    -100.00 USD
```

### Costo Anticipato e Ammortamento Mensile

Paghi un anno intero di assicurazione in anticipo, poi riconosci la spesa per un mese.

```beancount
; 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 USD
```

### Ricavo Sospeso e Riconoscimento Mensile

Un cliente paga in anticipo un abbonamento trimestrale. Registri il contante e poi riconosci un mese di ricavo.

```beancount
; 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 USD
```

### Fondo Svalutazione Crediti e Cancellazione

Accantoni un fondo per fatture potenzialmente inesigibili e successivamente cancelli una specifica fattura inesigibile.

```beancount
; 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 USD
```

### Rettifica Periodica delle Rimanenze e del COGS

Alla fine di un periodo, calcoli il Costo del Venduto (COGS) rettificando il tuo conto magazzino.

```beancount
2025-03-31 * "Rettifica COGS" "Metodo inventario periodico"
  Expenses:COGS                4500.00 USD
  Assets:Inventory           -4500.00 USD
```

---

## Scritture 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.

```beancount
; 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 USD
```

_Nota: 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:

1.  Inizia con la **data** (AAAA-MM-GG) e un flag di transazione (`*`).
2.  Aggiungi un **beneficiario** e una **descrizione** esplicativa. Usa `#tag` e `^link` per la ricercabilità.
3.  Includi almeno **due righe di scrittura** che si bilancino a zero per ogni commodity.
4.  Usa **nomi di conto** appropriati tra i cinque tipi: `Assets`, `Liabilities`, `Equity`, `Income`, `Expenses`.
5.  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`, `Equity` e `Liabilities` aumentano 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 `^link` in 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.
