> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Report

> Riconcilia il tuo saldo, esamina ogni commissione ed esporta pagamenti, rettifiche, payout e il registro del saldo in formato CSV o XLSX per qualsiasi intervallo di date.

## Introduzione

**Report** è il punto in cui monitori i movimenti di denaro e crei esportazioni. Vai su
**Impostazioni → Report**.

La pagina è composta da tre parti:

<CardGroup cols={3}>
  <Card title="Track Money Movement" icon="scale-balanced" href="#track-money-movement">
    Due viste dinamiche che spiegano a schermo il tuo saldo e le tue commissioni.
  </Card>

  <Card title="Download Reports" icon="file-csv" href="#download-reports">
    Quattro esportazioni che puoi creare per un intervallo di date, in formato CSV o XLSX.
  </Card>

  <Card title="Generated Reports" icon="clock-rotate-left" href="#generated-reports">
    Ogni report creato in precedenza, pronto per essere scaricato di nuovo.
  </Card>
</CardGroup>

<Frame caption="Settings → Reports: live views, custom exports, and your report history">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/reports-hub.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=5ca9b31a0a29106dba531c8e1c5a7f9d" alt="La scheda Reports nelle impostazioni, con Track Money Movement, Download Reports e Generated Reports" style={{ maxHeight: '500px', width: 'auto' }} width="1400" height="700" data-path="images/reports/reports-hub.png" />
</Frame>

<Note>
  I report sono disponibili sia in **Test Mode** sia in **Live Mode** e ciascuno legge
  solo i dati della relativa modalità. Cambia modalità nella barra laterale prima di creare un report.
</Note>

***

## Monitorare i movimenti di denaro

Due viste rispondono a una domanda direttamente a schermo, senza download. Ciascuna accetta un intervallo
di date e dispone di un pulsante **Export** che salva la stessa vista come file.

### Riepilogo saldo e payout

Questa vista riconcilia il tuo saldo per il periodo. È composta da tre sezioni.

<Frame caption="Balance and Payout Summary: starting balance, activity breakdown, and payout detail">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/balance-and-payout-summary.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=5b0cfd57bb38fde17a0978bdb6fb56e1" alt="Riepilogo saldo e payout con le sezioni Riepilogo del saldo e Variazione del saldo derivante dall'attività" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="798" data-path="images/reports/balance-and-payout-summary.png" />
</Frame>

**Riepilogo del saldo** mostra il periodo dall'inizio alla fine.

| Riga                                               | Significato                                             |
| -------------------------------------------------- | ------------------------------------------------------- |
| Saldo iniziale                                     | Il tuo saldo all'inizio del periodo.                    |
| Variazione netta del saldo derivante dall'attività | Tutto ciò che è accaduto nel periodo, esclusi i payout. |
| Payout totali                                      | Il denaro uscito tramite i payout.                      |
| Saldo finale                                       | Saldo iniziale + attività − payout.                     |

**Variazione del saldo derivante dall'attività** scompone la riga centrale nei suoi elementi.

| Riga                       | Cosa include                                                                                                                                                                                                                                  |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pagamenti ricevuti         | Pagamenti completati con successo.                                                                                                                                                                                                            |
| Rimborsi emessi            | Rimborsi e commissioni sui rimborsi, al netto di eventuali storni di entrambi.                                                                                                                                                                |
| Dispute perse              | Dispute e commissioni sulle dispute, al netto di eventuali storni delle dispute.                                                                                                                                                              |
| Commissioni detratte       | Commissioni sui pagamenti, commissioni sui payout, commissioni di dunning, commissioni sui tentativi di pagamento, commissioni BYOP, commissioni per il recupero dei carrelli abbandonati e commissioni Ethoca, al netto di eventuali storni. |
| Imposte detratte           | Imposte, al netto di eventuali storni delle imposte.                                                                                                                                                                                          |
| Altri movimenti            | Dodo Credits, rettifiche manuali e conversione valutaria.                                                                                                                                                                                     |
| Variazione netta del saldo | La somma delle righe precedenti.                                                                                                                                                                                                              |

<Note>
  **Altri movimenti** include le registrazioni che non appartengono a nessuna delle righe precedenti:
  **Dodo Credits** (crediti che Dodo Payments applica al tuo saldo), **rettifiche
  manuali** (una correzione registrata dal nostro team) e **conversione valutaria**
  (la differenza registrata quando un saldo viene convertito tra valute).
</Note>

**Riconciliazione dei payout** elenca ogni payout del periodo in una riga separata, con
l'importo lordo, ogni detrazione e l'importo netto pagato.

<Frame caption="Payout Reconciliation: one row per payout, gross to net">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/payout-reconciliation.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=a6c50e1b10b010deae1cb020c1afa179" alt="Sezione Riconciliazione dei payout che elenca ogni payout con importo lordo, detrazioni e importo netto pagato" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="790" data-path="images/reports/payout-reconciliation.png" />
</Frame>

<Tip>
  Un payout include ogni registrazione del ledger non ancora reclamata fino alla relativa data limite, non solo
  i pagamenti del periodo. Dodo Credits e le rettifiche possono quindi finanziare
  parte di un payout e vengono visualizzati in **Altro**.
</Tip>

### Tutte le commissioni

Ogni commissione prelevata dal tuo saldo nel periodo, con un totale e una
suddivisione per transazione.

<Frame caption="All Fees: a total, then every fee itemized by transaction">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/all-fees.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=bae2394ff27670737555d6237e792462" alt="Pagina Tutte le commissioni con il totale del Riepilogo commissioni e la sezione Suddivisione delle commissioni per transazione" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="426" data-path="images/reports/all-fees.png" />
</Frame>

***

## Scaricare i report

Quattro report creano un file per qualsiasi intervallo di date. Ciascuno apre un pannello in cui
scegli il periodo, il formato e i filtri per quel report.

Ogni report viene esportato in formato **CSV** o **XLSX**.

| Report                                   | Cosa contiene                                                                                  |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Report delle transazioni**             | Ogni pagamento elaborato, con lo stato di ciascuna transazione.                                |
| **Report delle rettifiche**              | Rimborsi e dispute insieme: ogni detrazione dal saldo in un unico file.                        |
| **Report dei payout**                    | Un riepilogo dei payout, con la suddivisione completa delle commissioni per periodo di payout. |
| **Report di riconciliazione del ledger** | Il ledger del saldo, una riga per movimento, da riconciliare con l'estratto conto bancario.    |

### Report delle transazioni

<Frame caption="Create a Transactions Report">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/transactions-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=11c1cae00fcd638dd6e38098f3c91def" alt="Pannello Crea un report delle transazioni con filtri per periodo, formato, metodo di pagamento e stato del pagamento" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/transactions-report-modal.png" />
</Frame>

* **Metodo di pagamento** — Card, UPI, Wallet, Bank Transfer, Bank Redirect, Pay Later, Crypto o Bank Debit. Seleziona **All** per tutti i metodi.
* **Stato del pagamento** — Succeeded, Failed o Pending.

### Report delle rettifiche

<Frame caption="Create an Adjustment Report">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/adjustments-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=ab43d59e062dd154f6d190cfb733f75b" alt="Pannello Crea un report delle rettifiche con filtri per tipo di rettifica, metodo di pagamento, stato del rimborso e stato della disputa" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/adjustments-report-modal.png" />
</Frame>

* **Tipo di rettifica** — All, Refunds o Disputes.
* **Metodo di pagamento** — gli stessi otto metodi indicati sopra.
* **Stato del rimborso** — Succeeded, Failed o Pending.
* **Stato della disputa** — Opened, Challenged, Accepted, Lost, Won, Cancelled o Expired.

### Report dei payout

Scegli un periodo e un formato. Questo report non richiede altri filtri.

<Frame caption="Create a Payout Report">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/payout-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=ffbf9e7d57956c0172ecbad5460afab8" alt="Pannello Crea un report dei payout con opzioni per periodo e formato" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/payout-report-modal.png" />
</Frame>

### Report di riconciliazione del ledger

Questo report ha due modalità. Usa **Reconciliation by** per sceglierne una.

<Frame caption="Create a Ledger Reconciliation Report, by period">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/ledger-report-modal.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=1a7eee33cfbb2115ec66236bf670bd70" alt="Pannello Crea un report di riconciliazione del ledger impostato su Period, con l'elenco dei filtri per tipo di evento" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-modal.png" />
</Frame>

**Period** esporta ogni movimento del ledger in un intervallo di date.

**Payout ID** esporta i movimenti di un singolo payout. Inserisci il riferimento del payout
(ad esempio `pyt_kxncrebha`) per ottenere le righe esatte regolate da quel payout.

<Frame caption="Look up one payout by its reference ID">
  <img src="https://mintcdn.com/dodopayments/wcp2oXUYABdJitHh/images/reports/ledger-report-by-payout-id.png?fit=max&auto=format&n=wcp2oXUYABdJitHh&q=85&s=48f49419884ae9d949ed7ad5425bb30e" alt="Lo stesso pannello impostato su Payout ID, con il campo che accetta un riferimento di payout" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-by-payout-id.png" />
</Frame>

<Note>
  Un Payout ID inesistente restituisce un errore. Non restituisce un file vuoto.
</Note>

**Tipi di evento** filtra le righe in base al tipo di movimento del saldo. Seleziona
**All** per mantenere ogni tipo oppure scegli tra questi:

| Gruppo      | Opzioni                                                                              |
| ----------- | ------------------------------------------------------------------------------------ |
| Entrate     | Payment, Dodo Credits, Adjustment, Currency Conversion                               |
| Payout      | Payout, Payout Reversal, Payout Fees, Payout Fees Reversal                           |
| Rimborsi    | Refund, Refund Reversal, Refund Fees, Refund Fees Reversal                           |
| Dispute     | Dispute, Dispute Fees, Dispute Reversal                                              |
| Commissioni | Payment Fees, Payment Retry Fee, Dunning Fees, Abandoned Cart Recovery Fee, BYOP Fee |
| Imposte     | Tax, Tax Reversal                                                                    |

Non tutti i tipi hanno uno storno. Solo Payout, Payout Fees, Refund, Refund Fees,
Dispute e Tax lo prevedono.

<Tip>
  Usa la modalità **Payout ID** per rispondere alla domanda "cosa c'era in questo payout?". Usa **Period**
  con i tipi di evento **All** per riconciliare un estratto conto bancario riga per riga.
</Tip>

***

## Creare e scaricare un report

<Steps>
  <Step title="Open the report">
    Vai su **Impostazioni → Report** e seleziona il report che ti serve.
  </Step>

  <Step title="Choose the period">
    Scegli un intervallo di date. Nel file entrano solo i dati compresi in questo intervallo.
  </Step>

  <Step title="Choose the format and filters">
    Seleziona **CSV** o **XLSX**, quindi imposta i filtri per quel report.
  </Step>

  <Step title="Download">
    Seleziona **Download Report**. Il file viene scaricato e il report viene aggiunto a
    **Generated Reports**.
  </Step>
</Steps>

Il nome del file contiene il report e l'intervallo di date, quindi un download
è identificabile senza aprirlo, ad esempio
`dodo_ledger_2026-06-01_to_2026-06-30.csv`.

<Note>
  Un'esportazione CSV inizia con un byte order mark UTF-8, così Excel apre correttamente
  i caratteri accentati e gli alfabeti non latini.
</Note>

### Limiti delle righe

Una singola esportazione è soggetta a un limite, quindi potrebbe essere necessario suddividere un periodo ampio.

| Report                     | CSV           | XLSX          |
| -------------------------- | ------------- | ------------- |
| Riconciliazione del ledger | 500.000 righe | 100.000 righe |
| Ogni altro report          | 100.000 righe | 50.000 righe  |

Se l'intervallo di date supera il limite, l'esportazione viene rifiutata con un messaggio.
Riduci l'intervallo o aggiungi un filtro, quindi ricreala.

<Tip>
  Scegli CSV per un periodo ampio. Il limite di righe è maggiore.
</Tip>

***

## Report generati

Ogni report creato viene registrato, così puoi scaricarlo di nuovo senza
ricrearlo.

| Colonna            | Significato                            |
| ------------------ | -------------------------------------- |
| Report             | Il tipo di report.                     |
| Intervallo di date | Il periodo coperto dal report.         |
| Formato            | CSV o XLSX.                            |
| Righe              | Il numero di righe contenute nel file. |
| Generato da        | Il membro del team che lo ha creato.   |
| Creato il          | Quando è stato creato.                 |
| Stato              | **Completato** o **Non riuscito**.     |

Un link per il download è valido per un breve periodo. Se il file memorizzato è scaduto, Dodo
Payments lo ricrea usando gli stessi parametri e la riga viene contrassegnata come
rigenerata.

<Warning>
  Un report ricreato può differire dall'originale. I dati alla base di un intervallo di date
  continuano a cambiare: un rimborso o una disputa registrati dopo la prima creazione
  appaiono nella ricreazione. Conserva il file scaricato se ti servono i dati esattamente
  come erano in precedenza.
</Warning>

***

## Quale report mi serve?

| Domanda                                                 | Report                                        |
| ------------------------------------------------------- | --------------------------------------------- |
| Perché il mio saldo è questo?                           | Riepilogo saldo e payout                      |
| Cosa c'era in questo payout?                            | Riconciliazione del ledger, per **Payout ID** |
| Quali commissioni ho pagato?                            | Tutte le commissioni                          |
| Mi servono tutti i pagamenti per il mio commercialista. | Report delle transazioni                      |
| Quanto mi sono costati rimborsi e dispute?              | Report delle rettifiche                       |
| Devo confrontare il mio estratto conto bancario.        | Riconciliazione del ledger, per **Period**    |

***

## Buone pratiche

<Tip>
  * Inizia la riconciliazione con **Riepilogo saldo e payout**. Scarica un report dettagliato solo quando devi spiegare un dato.
  * Esporta in **CSV** per un periodo lungo e usa **XLSX** solo quando lavorerai manualmente nel file.
  * Conserva il file scaricato. Non è garantito che una ricreazione corrisponda all'originale.
  * Applica i filtri prima di ampliare l'intervallo di date. Un filtro mantiene l'esportazione entro il limite di righe.
</Tip>

<Warning>
  Se un dato sembra errato, controlla prima l'intervallo di date e i filtri. Se è
  ancora errato, contatta <a href="mailto:support@dodopayments.com">[support@dodopayments.com](mailto:support@dodopayments.com)</a>
  indicando il tipo di report e il periodo.
</Warning>

## Prossimi passaggi

<CardGroup cols={2}>
  <Card title="Dashboard Analytics" icon="chart-line" href="/features/analytics-and-reporting">
    Monitora ricavi, clienti, fidelizzazione e stato delle transazioni.
  </Card>

  <Card title="Account Summary & Payout Wallet" icon="wallet" href="/features/account-summary-payout-wallet">
    Comprendi i tuoi guadagni, le detrazioni e i cicli dei payout.
  </Card>

  <Card title="Payout Structure" icon="money-bill-transfer" href="/features/payouts/payout-structure">
    Scopri come e quando i payout raggiungono il tuo conto bancario.
  </Card>

  <Card title="Refunds" icon="rotate-left" href="/features/transactions/refunds">
    Avvia e monitora i rimborsi.
  </Card>
</CardGroup>
