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

# Báo cáo

> Đối soát số dư, xem lại từng khoản phí và xuất các khoản thanh toán, điều chỉnh, payout và sổ cái số dư dưới dạng CSV hoặc XLSX cho mọi khoảng thời gian.

## Giới thiệu

**Báo cáo** là nơi bạn theo dõi dòng tiền và tạo tệp xuất. Truy cập
**Settings → Reports**.

Trang này có ba phần:

<CardGroup cols={3}>
  <Card title="Track Money Movement" icon="scale-balanced" href="#track-money-movement">
    Hai chế độ xem trực tiếp giải thích số dư và các khoản phí của bạn trên màn hình.
  </Card>

  <Card title="Download Reports" icon="file-csv" href="#download-reports">
    Bốn tệp xuất bạn tạo cho một khoảng thời gian, dưới dạng CSV hoặc XLSX.
  </Card>

  <Card title="Generated Reports" icon="clock-rotate-left" href="#generated-reports">
    Mọi báo cáo bạn đã tạo trước đây, sẵn sàng để tải xuống lại.
  </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="The Reports tab in Settings, showing Track Money Movement, Download Reports, and Generated Reports" style={{ maxHeight: '500px', width: 'auto' }} width="1400" height="700" data-path="images/reports/reports-hub.png" />
</Frame>

<Note>
  Reports có sẵn trong cả **Test Mode** và **Live Mode**, và mỗi chế độ chỉ đọc
  dữ liệu của chính chế độ đó. Chuyển chế độ trong thanh bên trước khi tạo báo cáo.
</Note>

***

## Theo dõi dòng tiền

Hai chế độ xem trả lời một câu hỏi ngay trên màn hình mà không cần tải xuống. Mỗi chế độ nhận một khoảng thời gian và có nút **Export** để lưu cùng chế độ xem đó thành tệp.

### Tóm tắt số dư và payout

Chế độ xem này đối soát số dư của bạn trong kỳ. Chế độ xem có ba khối.

<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="Balance and Payout Summary showing the Balance Summary block and the Balance Change from Activity block" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="798" data-path="images/reports/balance-and-payout-summary.png" />
</Frame>

**Balance Summary** hiển thị toàn bộ khoảng thời gian từ đầu đến cuối.

| Hàng                             | Ý nghĩa                                           |
| -------------------------------- | ------------------------------------------------- |
| Số dư đầu kỳ                     | Số dư của bạn khi kỳ bắt đầu.                     |
| Thay đổi số dư ròng từ hoạt động | Mọi hoạt động diễn ra trong kỳ, ngoại trừ payout. |
| Tổng payout                      | Số tiền đã rời khỏi tài khoản qua các payout.     |
| Số dư cuối kỳ                    | Số dư đầu kỳ + hoạt động − payout.                |

**Balance Change from Activity** phân tách hàng ở giữa thành các phần cấu thành.

| Hàng               | Bao gồm                                                                                                                                            |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Payments received  | Các khoản thanh toán thành công.                                                                                                                   |
| Refunds issued     | Khoản hoàn tiền và phí hoàn tiền, trừ mọi khoản đảo ngược tương ứng.                                                                               |
| Disputes lost      | Tranh chấp và phí tranh chấp, trừ mọi khoản đảo ngược tranh chấp.                                                                                  |
| Fees deducted      | Phí thanh toán, phí payout, phí dunning, phí retry thanh toán, phí BYOP, phí khôi phục giỏ hàng bị bỏ quên và phí Ethoca, trừ mọi khoản đảo ngược. |
| Tax deducted       | Thuế, trừ mọi khoản đảo ngược thuế.                                                                                                                |
| Other movements    | Dodo Credits, điều chỉnh thủ công và chuyển đổi tiền tệ.                                                                                           |
| Net Balance Change | Tổng của các hàng bên trên.                                                                                                                        |

<Note>
  **Other movements** chứa các mục không thuộc bất kỳ hàng có tên nào bên trên:
  **Dodo Credits** (credit mà Dodo Payments áp dụng vào số dư của bạn), **điều chỉnh
  thủ công** (khoản hiệu chỉnh do đội ngũ của chúng tôi ghi nhận) và **chuyển đổi tiền tệ**
  (chênh lệch được ghi nhận khi số dư được chuyển đổi giữa các loại tiền tệ).
</Note>

**Payout Reconciliation** liệt kê từng payout trong kỳ trên một hàng riêng, cùng
với số tiền gộp, từng khoản khấu trừ và số tiền ròng đã payout.

<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="Payout Reconciliation section listing each payout with its gross amount, deductions, and net paid out" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="790" data-path="images/reports/payout-reconciliation.png" />
</Frame>

<Tip>
  Một payout yêu cầu mọi mục trong sổ cái chưa được yêu cầu đến ngày chốt của payout,
  không chỉ các khoản thanh toán trong kỳ. Vì vậy, Dodo Credits và các khoản điều chỉnh
  có thể tài trợ một phần payout và được hiển thị trong **Other**.
</Tip>

### Tất cả khoản phí

Mọi khoản phí được trừ khỏi số dư của bạn trong kỳ, cùng với tổng phí và
phân tích theo từng giao dịch.

<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="All Fees page showing the Fee Summary total and the Fee Breakdown by Transaction section" style={{ maxHeight: '500px', width: 'auto' }} width="1120" height="426" data-path="images/reports/all-fees.png" />
</Frame>

***

## Tải xuống báo cáo

Bốn báo cáo tạo tệp cho mọi khoảng thời gian. Mỗi báo cáo mở một bảng điều khiển để bạn
chọn kỳ, định dạng và bộ lọc cho báo cáo đó.

Mọi báo cáo đều được xuất dưới dạng **CSV** hoặc **XLSX**.

| Báo cáo                          | Nội dung                                                                              |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| **Transactions Report**          | Mọi khoản thanh toán đã xử lý, cùng trạng thái của từng giao dịch.                    |
| **Adjustments Report**           | Các khoản hoàn tiền và tranh chấp — mọi khoản khấu trừ số dư trong một tệp.           |
| **Payout Report**                | Tóm tắt payout, cùng phân tích đầy đủ các khoản phí cho từng kỳ payout.               |
| **Ledger Reconciliation Report** | Sổ cái số dư, mỗi dòng tương ứng với một biến động, để đối soát với sao kê ngân hàng. |

### Transactions Report

<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="Create a Transactions Report panel with time period, format, payment method, and payment status filters" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/transactions-report-modal.png" />
</Frame>

* **Payment Method** — Card, UPI, Wallet, Bank Transfer, Bank Redirect, Pay Later, Crypto hoặc Bank Debit. Chọn **All** để chọn mọi phương thức.
* **Payment Status** — Succeeded, Failed hoặc Pending.

### Adjustments Report

<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="Create an Adjustment Report panel with adjustment type, payment method, refund status, and dispute status filters" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/adjustments-report-modal.png" />
</Frame>

* **Adjustment Type** — All, Refunds hoặc Disputes.
* **Payment Method** — tám phương thức giống như trên.
* **Refund Status** — Succeeded, Failed hoặc Pending.
* **Dispute Status** — Opened, Challenged, Accepted, Lost, Won, Cancelled hoặc Expired.

### Payout Report

Chọn một kỳ và một định dạng. Báo cáo này không cần bộ lọc nào khác.

<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="Create a Payout Report panel with time period and format options" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/payout-report-modal.png" />
</Frame>

### Ledger Reconciliation Report

Báo cáo này có hai chế độ. Sử dụng **Reconciliation by** để chọn một chế độ.

<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="Create a Ledger Reconciliation Report panel set to Period, showing the event type filter list" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-modal.png" />
</Frame>

**Period** xuất mọi biến động trong sổ cái trong một khoảng thời gian.

**Payout ID** xuất các biến động của một payout. Nhập mã tham chiếu payout
(ví dụ `pyt_kxncrebha`) để lấy chính xác các dòng mà payout đó đã thanh toán.

<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="The same panel set to Payout ID, showing the field that takes a payout reference" style={{ maxHeight: '500px', width: 'auto' }} width="390" height="786" data-path="images/reports/ledger-report-by-payout-id.png" />
</Frame>

<Note>
  Payout ID không tồn tại sẽ trả về lỗi. Hệ thống không trả về tệp trống.
</Note>

**Event Types** lọc các dòng theo loại biến động số dư. Chọn **All** để giữ
mọi loại hoặc chọn trong các loại sau:

| Nhóm       | Tùy chọn                                                                             |
| ---------- | ------------------------------------------------------------------------------------ |
| Tiền vào   | Payment, Dodo Credits, Adjustment, Currency Conversion                               |
| Payout     | Payout, Payout Reversal, Payout Fees, Payout Fees Reversal                           |
| Hoàn tiền  | Refund, Refund Reversal, Refund Fees, Refund Fees Reversal                           |
| Tranh chấp | Dispute, Dispute Fees, Dispute Reversal                                              |
| Phí        | Payment Fees, Payment Retry Fee, Dunning Fees, Abandoned Cart Recovery Fee, BYOP Fee |
| Thuế       | Tax, Tax Reversal                                                                    |

Không phải loại nào cũng có khoản đảo ngược. Chỉ Payout, Payout Fees, Refund, Refund Fees,
Dispute và Tax có khoản đảo ngược.

<Tip>
  Sử dụng chế độ **Payout ID** để trả lời câu hỏi "payout này gồm những gì?". Sử dụng **Period**
  với loại sự kiện **All** để đối soát sao kê ngân hàng theo từng dòng.
</Tip>

***

## Tạo và tải xuống báo cáo

<Steps>
  <Step title="Open the report">
    Truy cập **Settings → Reports** và chọn báo cáo bạn cần.
  </Step>

  <Step title="Choose the period">
    Chọn một khoảng thời gian. Chỉ dữ liệu trong khoảng thời gian này mới được đưa vào tệp.
  </Step>

  <Step title="Choose the format and filters">
    Chọn **CSV** hoặc **XLSX**, sau đó thiết lập các bộ lọc cho báo cáo đó.
  </Step>

  <Step title="Download">
    Chọn **Download Report**. Tệp sẽ được tải xuống và báo cáo được thêm vào
    **Generated Reports**.
  </Step>
</Steps>

Tên tệp chứa tên báo cáo và khoảng thời gian, vì vậy bạn có thể nhận diện tệp tải xuống
mà không cần mở — ví dụ `dodo_ledger_2026-06-01_to_2026-06-30.csv`.

<Note>
  Tệp xuất CSV bắt đầu bằng byte order mark UTF-8, vì vậy Excel hiển thị chính xác
  các ký tự có dấu và những hệ chữ không phải Latin.
</Note>

### Giới hạn số dòng

Mỗi tệp xuất đều có giới hạn, vì vậy một kỳ dài có thể cần được chia nhỏ.

| Báo cáo               | CSV          | XLSX         |
| --------------------- | ------------ | ------------ |
| Ledger Reconciliation | 500,000 dòng | 100,000 dòng |
| Mọi báo cáo khác      | 100,000 dòng | 50,000 dòng  |

Nếu khoảng thời gian vượt quá giới hạn, quá trình xuất sẽ bị từ chối kèm thông báo.
Thu hẹp khoảng thời gian hoặc thêm bộ lọc, sau đó tạo lại báo cáo.

<Tip>
  Chọn CSV cho một kỳ dài. CSV có giới hạn số dòng cao hơn.
</Tip>

***

## Generated Reports

Mọi báo cáo bạn tạo đều được ghi lại, vì vậy bạn có thể tải xuống lần nữa mà không cần
tạo lại.

| Cột          | Ý nghĩa                               |
| ------------ | ------------------------------------- |
| Report       | Loại báo cáo.                         |
| Date Range   | Khoảng thời gian mà báo cáo bao quát. |
| Format       | CSV hoặc XLSX.                        |
| Rows         | Số dòng trong tệp.                    |
| Generated by | Thành viên nhóm đã tạo báo cáo.       |
| Created At   | Thời điểm báo cáo được tạo.           |
| Status       | **Completed** hoặc **Failed**.        |

Liên kết tải xuống chỉ có hiệu lực trong thời gian ngắn. Nếu tệp đã lưu hết hạn, Dodo
Payments sẽ tạo lại tệp bằng cùng các tham số và đánh dấu dòng là đã
tạo lại.

<Warning>
  Báo cáo được tạo lại có thể khác bản gốc. Dữ liệu phía sau một khoảng thời gian
  luôn tiếp tục thay đổi — khoản hoàn tiền hoặc tranh chấp được ghi nhận sau lần tạo đầu tiên
  sẽ xuất hiện trong bản tạo lại. Hãy giữ tệp đã tải xuống nếu bạn cần các số liệu chính xác
  như tại thời điểm đó.
</Warning>

***

## Tôi cần báo cáo nào?

| Câu hỏi                                                       | Báo cáo                                   |
| ------------------------------------------------------------- | ----------------------------------------- |
| Tại sao số dư của tôi lại là con số này?                      | Balance and Payout Summary                |
| Payout này gồm những gì?                                      | Ledger Reconciliation, theo **Payout ID** |
| Tôi đã trả những khoản phí nào?                               | All Fees                                  |
| Tôi cần mọi khoản thanh toán cho kế toán.                     | Transactions Report                       |
| Các khoản hoàn tiền và tranh chấp đã khiến tôi mất bao nhiêu? | Adjustments Report                        |
| Tôi cần đối chiếu với sao kê ngân hàng.                       | Ledger Reconciliation, theo **Period**    |

***

## Thực tiễn tốt nhất

<Tip>
  * Trước tiên, hãy đối soát bằng **Balance and Payout Summary**. Chỉ tải báo cáo chi tiết khi cần giải thích một con số.
  * Xuất **CSV** cho một kỳ dài và chỉ chọn **XLSX** khi bạn sẽ thao tác thủ công trên tệp.
  * Giữ lại tệp đã tải xuống. Không đảm bảo bản tạo lại sẽ khớp với tệp đó.
  * Lọc trước khi mở rộng khoảng thời gian. Bộ lọc giúp tệp xuất nằm dưới giới hạn số dòng.
</Tip>

<Warning>
  Nếu một con số có vẻ không đúng, trước tiên hãy kiểm tra khoảng thời gian và các bộ lọc. Nếu vẫn
  không đúng, hãy liên hệ <a href="mailto:support@dodopayments.com">[support@dodopayments.com](mailto:support@dodopayments.com)</a>
  với loại báo cáo và khoảng thời gian.
</Warning>

## Bước tiếp theo

<CardGroup cols={2}>
  <Card title="Dashboard Analytics" icon="chart-line" href="/features/analytics-and-reporting">
    Theo dõi doanh thu, khách hàng, tỷ lệ giữ chân và tình trạng giao dịch.
  </Card>

  <Card title="Account Summary & Payout Wallet" icon="wallet" href="/features/account-summary-payout-wallet">
    Tìm hiểu thu nhập, các khoản khấu trừ và chu kỳ payout của bạn.
  </Card>

  <Card title="Payout Structure" icon="money-bill-transfer" href="/features/payouts/payout-structure">
    Xem cách thức và thời điểm payout đến tài khoản ngân hàng của bạn.
  </Card>

  <Card title="Refunds" icon="rotate-left" href="/features/transactions/refunds">
    Khởi tạo và theo dõi các khoản hoàn tiền.
  </Card>
</CardGroup>
