# Condividi o incorpora il tuo ledger Beancount.io

Beancount.io offre opzioni flessibili per condividere i tuoi dati finanziari. Puoi incorporare il tuo ledger in siti web per la visualizzazione pubblica o invitare collaboratori per aiutarti a modificare e gestire i tuoi conti.

## Incorporare il Tuo Ledger

L'incorporamento ti permette di visualizzare pubblicamente il tuo ledger su siti web, portfolio o documentazione. È perfetto per [rapporti di trasparenza](https://beancount.io/it/docs/Solutions/transparent-and-auditable), budget di progetti open-source o dimostrazioni educative.

![Dashboard del ledger pubblico Apple incorporata da beancount.io che mostra patrimonio netto e saldi dei conti](/img/ledger/overview-apple.webp)

*[Esplora il ledger live →](https://beancount.io/ledger/open_ledger/apple)*

### Prerequisiti: Rendi Pubblico il Tuo Ledger

**Importante:** Prima di poter incorporare il tuo ledger, devi prima impostarlo come pubblico.

1. Vai alla pagina delle impostazioni del tuo ledger: `https://beancount.io/ledger/{username}/{repo}/settings`
2. Cambia l'impostazione di visibilità da "Privato" a "Pubblico"
3. Salva le modifiche

:::warning Nota sulla Sicurezza
Rendi il tuo ledger pubblico solo se sei a tuo agio nel condividere tutti i dati finanziari con chiunque. I ledger pubblici possono essere visualizzati da chiunque su internet e saranno indicizzati e tracciati dai motori di ricerca. Se il tuo ledger contiene informazioni finanziarie personali o aziendali sensibili, mantienilo privato e utilizza invece le funzionalità di collaborazione.
:::

### Incorporamento con un iframe

Una volta che il tuo ledger è pubblico, puoi incorporarlo in qualsiasi sito web utilizzando un iframe HTML. Ecco un esempio che incorpora la pagina di panoramica:

<div style={{position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden', maxWidth: '100%', marginBottom: '2rem'}}>
  <iframe
    style={{position: 'absolute', top: 0, left: 0, width: '100%', height: '100%'}}
    src="https://beancount.io/ledger/open_ledger/example"
    title="Panoramica Ledger Beancount"
    frameBorder="0"
    allow="clipboard-write"
    loading="lazy">
  </iframe>
</div>

### Esempio di Codice iframe

```html
<div
  style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 2rem;"
>
  <iframe
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
    src="https://beancount.io/ledger/open_ledger/example"
    title="Panoramica Ledger Beancount"
    frameborder="0"
    allow="clipboard-write"
    loading="lazy"
  >
  </iframe>
</div>
```

### Personalizzare la Vista Incorporata

Puoi incorporare diverse pagine dal tuo ledger modificando il percorso URL:

- **Panoramica:** `/ledger/{username}/{repo}/overview`
- **Stato Patrimoniale:** `/ledger/{username}/{repo}/balance-sheet`
- **Conto Economico:** `/ledger/{username}/{repo}/income-statement`
- **Giornale:** `/ledger/{username}/{repo}/journal`
- **Statistiche:** `/ledger/{username}/{repo}/statistics`

Semplicemente sostituisci `{username}` con il tuo nome utente e `{repo}` con il nome del repository del tuo ledger.

## Condividere il Tuo Ledger per la Modifica

Se desideri che altri ti aiutino a modificare il tuo ledger (come un commercialista, un socio in affari o un membro del team), puoi invitarli come collaboratori. I collaboratori hanno accesso completo in lettura e scrittura al tuo ledger e possono effettuare commit tramite il flusso di lavoro basato su Git.

### Guida Passo Passo: Invita un Collaboratore

1. **Chiedi al collaboratore di registrarsi**
   Il tuo collaboratore deve prima creare un account gratuito su [https://beancount.io](https://beancount.io).

2. **Vai alla pagina dei collaboratori**
   Vai a `https://beancount.io/ledger/{username}/{repo}/collaborators` (sostituisci `{username}` e `{repo}` con i dettagli del tuo ledger).

3. **Invita il collaboratore**
   Clicca sul pulsante "Invita Collaboratore" e inserisci il nome utente o l'indirizzo email del tuo collaboratore.

### Cosa Possono Fare i Collaboratori

Una volta invitati e accettati, i collaboratori possono:

- Visualizzare tutte le transazioni e i dati finanziari
- Modificare direttamente i file del ledger tramite l'[interfaccia web](https://beancount.io/it/docs/Tips/ui-features)
- Effettuare commit Git e visualizzare la cronologia dei commit
- Caricare documenti e ricevute
- [Eseguire query](https://beancount.io/it/docs/Basics/beancount-query-language) e generare report
- Eseguire push e pull delle modifiche utilizzando i comandi Git (se si lavora in locale)

### Buone Pratiche di Collaborazione

- **Definisci chiaramente i ruoli:** Discutere chi è responsabile per quali conti o periodi di tempo
- **Usa messaggi di commit significativi:** Questo aiuta a tracciare chi ha fatto quali modifiche e perché
- **Comunicazione regolare:** Coordinarsi sulle modifiche importanti per evitare conflitti
- **Rivedere le modifiche insieme:** Utilizzare la cronologia Git per rivedere il lavoro degli altri
- **Esegui backup regolari:** Anche se Git fornisce il controllo di versione, mantieni i tuoi backup

:::tip Flusso di Lavoro Basato su Git
Beancount.io utilizza Git per il controllo di versione. I collaboratori con conoscenze di Git possono clonare il repository in locale, apportare modifiche con il loro editor di testo preferito e inviare gli aggiornamenti al server. Questo fornisce potenti funzionalità di controllo di versione per la gestione dei tuoi dati finanziari.
:::

## Considerazioni sulla Privacy

### Ledger Pubblici vs. Privati

- **Ledger Pubblici:**
  - Possono essere incorporati in siti web esterni
  - Visibili da chiunque abbia l'URL
  - Indicizzati e tracciati dai motori di ricerca
  - Ottimi per scopi di trasparenza e educativi

- **Ledger Privati (Predefinito):**
  - Accessibili solo a te e ai collaboratori invitati
  - Non possono essere incorporati esternamente
  - Raccomandati per finanze personali e aziendali

### Quando Usare Ogni Opzione

- **Usa Pubblico** per: Budget di progetti open-source, esempi educativi, rapporti di trasparenza, dimostrazioni in portfolio
- **Usa Privato** per: Finanze personali, contabilità aziendale, lavoro con clienti, dati finanziari sensibili

Puoi sempre modificare le impostazioni di visibilità in qualsiasi momento dalla pagina delle impostazioni del tuo ledger.
