# Registrazioni Contabili Beancount: Guida, Definizioni ed Esempi

Ogni transazione finanziaria della tua attività deve essere registrata – e nel mondo della contabilità in testo semplice, tutto inizia con le **registrazioni contabili**. Se utilizzi [Beancount](https://beancount.io), comprendere le registrazioni contabili è fondamentale per costruire registri finanziari accurati, verificabili e puliti.

Questa guida ti accompagnerà attraverso:

- Cos'è una registrazione contabile
- Perché le registrazioni contabili sono importanti
- Come scriverle con la sintassi di Beancount
- Come usarle efficacemente
- Esempi di transazioni reali (pagamenti clienti, acquisti, prestiti, ecc.)

## 🧾 Cos'è una Registrazione Contabile in Beancount?

In Beancount, una **registrazione contabile** è una transazione datata scritta in un formato di testo semplice e leggibile dall'uomo. Ogni registrazione segue i principi della **contabilità a partita doppia** – registri da dove proviene il denaro (credito) e dove va (debito), assicurando che i tuoi libri contabili siano sempre in pareggio.

**Esempio:**

```bean
2024-06-01 * "Pagamento cliente per fattura #123"
  Assets:Bank:Checking     600.00 USD
  Income:Sales
```

- `*` indica una transazione contabilizzata.
- La descrizione fornisce il contesto per la registrazione.
- `Assets:Bank:Checking` viene addebitato.
- `Income:Sales` viene accreditato (valore implicito).

Ogni registrazione risiede all'interno di un file `.beancount` – semplicemente un file di testo che puoi versionare, fare backup e persino modificare in Vim o VSCode.

## 📒 Perché le Registrazioni Contabili sono Importanti

Le registrazioni contabili sono l'unità atomica del tuo libro mastro.

Esse:

- Alimentano il tuo **Libro Mastro Generale** e i **Saldi dei Conti**
- Determinano tutti i report: _Conto Economico, Stato Patrimoniale, Flussi di Cassa_
- Ti permettono di tracciare ogni singolo dollaro, riga per riga, fino alla sua origine

Con gli strumenti giusti, vedrai queste transazioni renderizzate in un'interfaccia utente – categorizzate, ricercabili e filtrabili. Ma tutto inizia con quella semplice registrazione in testo semplice.

## 📚 Come Funziona la Partita Doppia in Beancount

Beancount impone la **contabilità a partita doppia**. Ogni transazione deve essere in pareggio: il totale dei debiti deve essere uguale al totale dei crediti.

Regola rapida:

- **Addebita** attività e spese (ottieni _contanti_ o sostieni un costo)
- **Accredita** ricavi e passività (guadagni _denaro_ o contrai un debito)

**Esempio – Acquisto di forniture per ufficio:**

```bean
2024-06-02 * "Acquistato inchiostro per stampante"
  Expenses:OfficeSupplies   100.00 USD
  Assets:Bank:Checking
```

## 🧠 Visualizzare le Registrazioni

Una volta salvato, nella barra di navigazione sinistra di https://beancount.io/ledger/0/income_statement/ vedrai...

- **Vista Registrazioni**: Visualizza le transazioni con ricerca, tag e filtri
- **Menu a Tendina Filtro Conti**: Visualizza i saldi correnti e le registrazioni per conto
- **Conto Economico**: Somma dei tuoi conti `Income:*` e `Expenses:*`
- **Stato Patrimoniale**: Le tue attività meno le passività

Fava aiuta a trasformare le tue registrazioni Beancount grezze in report utilizzabili – senza alcuna configurazione di database.

## 💡 Esempi Comuni di Registrazioni Contabili

### ✅ Ricevi un pagamento da un cliente

```bean
2024-06-05 * "Pagamento per fattura #456"
  Assets:Bank:Checking     1,200.00 USD
  Income:Consulting
```

Opzionale: Se utilizzi i Crediti verso Clienti:

```bean
2024-05-20 * "Fattura #456 emessa"
  Assets:AccountsReceivable   1,200.00 USD
  Income:Consulting

2024-06-05 * "Pagamento per fattura #456"
  Assets:Bank:Checking        1,200.00 USD
  Assets:AccountsReceivable  -1,200.00 USD
```

### 🖨️ Acquisti forniture per ufficio

```bean
2024-06-07 * "Acquisto in cartoleria"
  Expenses:OfficeSupplies     85.00 USD
  Assets:Bank:Checking
```

### 🏦 Effettui un pagamento di un prestito

Supponiamo che tu paghi \$1.000, con \$200 di interessi e \$800 a capitale:

```bean
2024-06-10 * "Loan repayment"
  Liabilities:Loan            800.00 USD
  Expenses:LoanInterest       200.00 USD
  Assets:Bank:Checking      -1,000.00 USD
```

## 🔒 Registrazioni di Chiusura a Fine Anno

Per "chiudere i libri contabili", di solito si trasferiscono tutti i conti `Income` e `Expenses` in `Equity`.

```bean
2024-01-01 open Income:Consulting
2024-01-01 open Expenses:OfficeSupplies
2024-12-31 close Income:Consulting
2024-12-31 close Expenses:OfficeSupplies
```

Oppure, manualmente:

```bean
2024-12-31 * "Chiusura libri"
  Equity:RetainedEarnings     45,000.00 USD
  Income:Consulting          -45,000.00 USD
```

## 🛠️ Registrazioni di Rettifica

Se stai effettuando una **contabilità per competenza**, vorrai aggiungere **registrazioni di rettifica** – per risconti attivi, ratei attivi, ecc.

Esempio: Abbonamento software mensile di \$100 pagato annualmente

```bean
2024-01-01 * "Pagamento software annuale"
  Assets:Prepaid             1,200.00 USD
  Assets:Bank:Checking      -1,200.00 USD

2024-01-31 * "Ammortamento mensile"
  Expenses:Software           100.00 USD
  Assets:Prepaid             -100.00 USD
```

Automatizza con script o strumenti Beancount disponibili.

## 🧰 Beancount: Leggero, Verificabile, Potente

Beancount non è solo uno strumento contabile – è un'idea: **una verità finanziaria trasparente e in testo semplice.** È un sistema di registrazione moderno che è:

- Facile da versionare (Git!)
- Completamente portabile (nessun database proprietario)
- Ottimo per sviluppatori, freelancer e piccole imprese

## Pronto per Iniziare?

Inizia il tuo file Beancount con:

```bean
option "title" "Libro Mastro della Mia Attività"
option "operating_currency" "USD"

2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Income:Sales USD
2024-01-01 open Expenses:OfficeSupplies USD
2024-01-01 open Equity:OpeningBalances USD

2024-01-01 * "Saldo iniziale"
  Assets:Bank:Checking     10,000.00 USD
  Equity:OpeningBalances
```

Poi carica il tuo file con il tuo strumento di visualizzazione preferito per vedere la magia.

Vuoi un inizio più facile? Prova template, importatori o strumenti della community come `bean-extract`.

Con Beancount, i tuoi libri contabili sono finalmente _tuoi_ – semplici, scriptabili e a prova di audit.

Fammi sapere se desideri una versione PDF scaricabile o varianti specifiche per piccole imprese degli esempi.
