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

# Relatórios

> Reconcilie seu saldo, revise cada tarifa e exporte pagamentos, ajustes, repasses e o livro-razão do saldo como CSV ou XLSX para qualquer intervalo de datas.

## Introdução

**Relatórios** é onde você acompanha a movimentação de dinheiro e cria exportações. Acesse
**Configurações → Relatórios**.

A página tem três partes:

<CardGroup cols={3}>
  <Card title="Track Money Movement" icon="scale-balanced" href="#track-money-movement">
    Duas visualizações dinâmicas que explicam seu saldo e suas tarifas na tela.
  </Card>

  <Card title="Download Reports" icon="file-csv" href="#download-reports">
    Quatro exportações que você cria para um intervalo de datas, como CSV ou XLSX.
  </Card>

  <Card title="Generated Reports" icon="clock-rotate-left" href="#generated-reports">
    Todos os relatórios que você criou anteriormente, prontos para serem baixados novamente.
  </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="A aba Relatórios em Configurações, mostrando Acompanhar movimentação de dinheiro, Baixar relatórios e Relatórios gerados" style={{ maxHeight: '500px', width: 'auto' }} width="1400" height="700" data-path="images/reports/reports-hub.png" />
</Frame>

<Note>
  Os relatórios estão disponíveis tanto no **Test Mode** quanto no **Live Mode**, e cada um lê
  somente os dados desse modo. Troque o modo na barra lateral antes de criar um relatório.
</Note>

***

## Acompanhar a movimentação de dinheiro

Duas visualizações respondem a uma pergunta na tela, sem exigir download. Cada uma aceita um intervalo
de datas e tem um botão **Exportar** que salva a mesma visualização como arquivo.

### Resumo do saldo e dos repasses

Esta visualização reconcilia seu saldo no período. Ela tem três blocos.

<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="Resumo do saldo e dos repasses mostrando o bloco Resumo do saldo e o bloco Alteração do saldo por atividade" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="798" data-path="images/reports/balance-and-payout-summary.png" />
</Frame>

**Resumo do saldo** mostra o período de ponta a ponta.

| Linha                                    | Significado                                          |
| ---------------------------------------- | ---------------------------------------------------- |
| Saldo inicial                            | Seu saldo quando o período começou.                  |
| Alteração líquida do saldo por atividade | Tudo o que aconteceu no período, exceto os repasses. |
| Total de repasses                        | O dinheiro que saiu por meio de repasses.            |
| Saldo final                              | Saldo inicial + atividade − repasses.                |

**Alteração do saldo por atividade** divide a linha do meio em suas partes.

| Linha                      | O que inclui                                                                                                                                                                                                             |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Pagamentos recebidos       | Pagamentos bem-sucedidos.                                                                                                                                                                                                |
| Reembolsos emitidos        | Reembolsos e tarifas de reembolso, menos qualquer reversão de um deles.                                                                                                                                                  |
| Disputas perdidas          | Disputas e tarifas de disputa, menos qualquer reversão de disputa.                                                                                                                                                       |
| Tarifas deduzidas          | Tarifas de pagamento, tarifas de repasse, tarifas de cobrança, tarifas de tentativa novamente de pagamento, tarifas de BYOP, tarifas de recuperação de carrinho abandonado e tarifas da Ethoca, menos qualquer reversão. |
| Imposto deduzido           | Imposto, menos qualquer reversão de imposto.                                                                                                                                                                             |
| Outras movimentações       | Dodo Credits, ajustes manuais e conversão de moeda.                                                                                                                                                                      |
| Alteração líquida do saldo | A soma das linhas acima.                                                                                                                                                                                                 |

<Note>
  **Outras movimentações** contém os lançamentos que não pertencem a nenhuma linha nomeada acima:
  **Dodo Credits** (créditos que Dodo Payments aplica ao seu saldo), **ajustes
  manuais** (uma correção registrada pela nossa equipe) e **conversão de moeda**
  (a diferença registrada quando um saldo é convertido entre moedas).
</Note>

**Reconciliação de repasses** lista cada repasse do período em sua própria linha, com
o valor bruto, cada dedução e o valor líquido repassado.

<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="Seção Reconciliação de repasses listando cada repasse com seu valor bruto, deduções e valor líquido repassado" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="790" data-path="images/reports/payout-reconciliation.png" />
</Frame>

<Tip>
  Um repasse reivindica cada lançamento do livro-razão ainda não reivindicado até sua data de corte, não apenas
  os pagamentos do período. Portanto, Dodo Credits e ajustes podem financiar
  parte de um repasse e aparecem em **Outros**.
</Tip>

### Todas as tarifas

Todas as tarifas retiradas do seu saldo no período, com um total e uma
análise detalhada por transação.

<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="Página Todas as tarifas mostrando o total do Resumo das tarifas e a seção Detalhamento das tarifas por transação" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="426" data-path="images/reports/all-fees.png" />
</Frame>

***

## Baixar relatórios

Quatro relatórios criam um arquivo para qualquer intervalo de datas. Cada um abre um painel onde você
escolhe o período, o formato e os filtros desse relatório.

Todo relatório é exportado como **CSV** ou **XLSX**.

| Relatório                                     | O que contém                                                                                   |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Relatório de transações**                   | Todos os pagamentos processados, com o status de cada transação.                               |
| **Relatório de ajustes**                      | Reembolsos e disputas juntos — cada dedução do saldo em um único arquivo.                      |
| **Relatório de repasses**                     | Um resumo dos repasses, com o detalhamento completo das tarifas por período de repasse.        |
| **Relatório de reconciliação do livro-razão** | O livro-razão do saldo, uma linha por movimentação, para reconciliar com seu extrato bancário. |

### Relatório de transações

<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="Painel Criar um relatório de transações com filtros de período, formato, método de pagamento e status do pagamento" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/transactions-report-modal.png" />
</Frame>

* **Método de pagamento** — Card, UPI, Wallet, Bank Transfer, Bank Redirect, Pay Later, Crypto ou Bank Debit. Selecione **All** para todos os métodos.
* **Status do pagamento** — Succeeded, Failed ou Pending.

### Relatório de ajustes

<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="Painel Criar um relatório de ajustes com filtros de tipo de ajuste, método de pagamento, status do reembolso e status da disputa" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/adjustments-report-modal.png" />
</Frame>

* **Tipo de ajuste** — All, Refunds ou Disputes.
* **Método de pagamento** — os mesmos oito métodos acima.
* **Status do reembolso** — Succeeded, Failed ou Pending.
* **Status da disputa** — Opened, Challenged, Accepted, Lost, Won, Cancelled ou Expired.

### Relatório de repasses

Escolha um período e um formato. Este relatório não precisa de outro filtro.

<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="Painel Criar um relatório de repasses com opções de período e formato" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/payout-report-modal.png" />
</Frame>

### Relatório de reconciliação do livro-razão

Este relatório tem dois modos. Use **Reconciliation by** para escolher um.

<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="Painel Criar um relatório de reconciliação do livro-razão definido como Period, mostrando a lista de filtros de tipo de evento" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-modal.png" />
</Frame>

**Period** exporta todas as movimentações do livro-razão em um intervalo de datas.

**Payout ID** exporta as movimentações de um repasse. Insira a referência do repasse
(por exemplo, `pyt_kxncrebha`) para obter as linhas exatas liquidadas por esse repasse.

<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="O mesmo painel definido como Payout ID, mostrando o campo que recebe uma referência de repasse" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-by-payout-id.png" />
</Frame>

<Note>
  Um ID de repasse que não existe retorna um erro. Ele não retorna um arquivo
  vazio.
</Note>

**Tipos de evento** filtra as linhas pelo tipo de movimentação do saldo. Selecione
**All** para manter todos os tipos ou escolha entre estes:

| Grupo      | Opções                                                                               |
| ---------- | ------------------------------------------------------------------------------------ |
| Entradas   | Payment, Dodo Credits, Adjustment, Currency Conversion                               |
| Repasses   | Payout, Payout Reversal, Payout Fees, Payout Fees Reversal                           |
| Reembolsos | Refund, Refund Reversal, Refund Fees, Refund Fees Reversal                           |
| Disputas   | Dispute, Dispute Fees, Dispute Reversal                                              |
| Tarifas    | Payment Fees, Payment Retry Fee, Dunning Fees, Abandoned Cart Recovery Fee, BYOP Fee |
| Imposto    | Tax, Tax Reversal                                                                    |

Nem todo tipo tem uma reversão. Apenas Payout, Payout Fees, Refund, Refund Fees,
Dispute e Tax têm.

<Tip>
  Use o modo **Payout ID** para responder "o que havia neste repasse?". Use **Period**
  com **All** tipos de evento para reconciliar um extrato bancário linha por linha.
</Tip>

***

## Criar e baixar um relatório

<Steps>
  <Step title="Open the report">
    Acesse **Configurações → Relatórios** e selecione o relatório de que precisa.
  </Step>

  <Step title="Choose the period">
    Escolha um intervalo de datas. Somente os dados dentro desse intervalo entram no arquivo.
  </Step>

  <Step title="Choose the format and filters">
    Selecione **CSV** ou **XLSX** e defina os filtros desse relatório.
  </Step>

  <Step title="Download">
    Selecione **Download Report**. O arquivo será baixado e o relatório será adicionado a
    **Generated Reports**.
  </Step>
</Steps>

O nome do arquivo contém o relatório e o intervalo de datas, portanto um download pode ser
identificado sem ser aberto — por exemplo,
`dodo_ledger_2026-06-01_to_2026-06-30.csv`.

<Note>
  Uma exportação CSV começa com uma marca de ordem de bytes UTF-8, para que o Excel abra
  corretamente caracteres acentuados e scripts não latinos.
</Note>

### Limites de linhas

Uma única exportação tem um limite, portanto um período extenso pode precisar ser dividido.

| Relatório                    | CSV            | XLSX           |
| ---------------------------- | -------------- | -------------- |
| Reconciliação do livro-razão | 500.000 linhas | 100.000 linhas |
| Todos os outros relatórios   | 100.000 linhas | 50.000 linhas  |

Se o intervalo de datas ultrapassar o limite, a exportação será recusada com uma mensagem.
Reduza o intervalo ou adicione um filtro e crie o relatório novamente.

<Tip>
  Escolha CSV para um período extenso. O limite de linhas é maior.
</Tip>

***

## Relatórios gerados

Cada relatório criado por você é registrado, para que possa baixá-lo novamente sem
precisar recriá-lo.

| Coluna             | Significado                         |
| ------------------ | ----------------------------------- |
| Relatório          | O tipo de relatório.                |
| Intervalo de datas | O período abrangido pelo relatório. |
| Formato            | CSV ou XLSX.                        |
| Linhas             | Quantas linhas o arquivo contém.    |
| Gerado por         | O membro da equipe que o criou.     |
| Criado em          | Quando foi criado.                  |
| Status             | **Completed** ou **Failed**.        |

Um link de download é válido por pouco tempo. Se o arquivo armazenado tiver expirado, Dodo
Payments o recriará usando os mesmos parâmetros e a linha será marcada como
regenerada.

<Warning>
  Um relatório recriado pode ser diferente do original. Os dados por trás de um intervalo de datas
  continuam mudando — um reembolso ou uma disputa registrados após a primeira criação aparecem
  na recriação. Mantenha o arquivo baixado se precisar dos valores exatamente como estavam.
</Warning>

***

## De qual relatório preciso?

| Pergunta                                          | Relatório                                       |
| ------------------------------------------------- | ----------------------------------------------- |
| Por que meu saldo tem este valor?                 | Resumo do saldo e dos repasses                  |
| O que havia neste repasse?                        | Reconciliação do livro-razão, por **Payout ID** |
| Quais tarifas paguei?                             | Todas as tarifas                                |
| Preciso de todos os pagamentos para meu contador. | Relatório de transações                         |
| Quanto me custaram os reembolsos e as disputas?   | Relatório de ajustes                            |
| Preciso comparar com meu extrato bancário.        | Reconciliação do livro-razão, por **Period**    |

***

## Boas práticas

<Tip>
  * Comece a reconciliação com o **Resumo do saldo e dos repasses**. Baixe um relatório detalhado somente quando um valor precisar ser explicado.
  * Exporte **CSV** para um período longo e **XLSX** somente quando for trabalhar manualmente no arquivo.
  * Mantenha o arquivo baixado. Não há garantia de que uma recriação coincida com ele.
  * Filtre antes de ampliar o intervalo de datas. Um filtro mantém a exportação abaixo do limite de linhas.
</Tip>

<Warning>
  Se um valor parecer incorreto, verifique primeiro o intervalo de datas e os filtros. Se ainda estiver
  incorreto, entre em contato com <a href="mailto:support@dodopayments.com">[support@dodopayments.com](mailto:support@dodopayments.com)</a>
  com o tipo de relatório e o período.
</Warning>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Dashboard Analytics" icon="chart-line" href="/features/analytics-and-reporting">
    Acompanhe a receita, os clientes, a retenção e a saúde das transações.
  </Card>

  <Card title="Account Summary & Payout Wallet" icon="wallet" href="/features/account-summary-payout-wallet">
    Entenda seus ganhos, deduções e ciclos de repasse.
  </Card>

  <Card title="Payout Structure" icon="money-bill-transfer" href="/features/payouts/payout-structure">
    Veja como e quando os repasses chegam à sua conta bancária.
  </Card>

  <Card title="Refunds" icon="rotate-left" href="/features/transactions/refunds">
    Inicie e monitore reembolsos.
  </Card>
</CardGroup>
