> ## 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
**Reports** giải thích cách tiền di chuyển qua số dư của bạn và tạo các tệp xuất cho công tác kế toán. Để mở, hãy đi tới **Settings → Reports**.
Trang này có ba phần:
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.
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.
Mọi báo cáo bạn đã tạo trước đây, sẵn sàng để tải xuống lại.
Reports chỉ khả dụng trong **Live Mode**. Reports đọc sổ cái số dư trực tiếp, nơi hoạt động ở chế độ kiểm thử không được ghi nhận, vì vậy trong **Test Mode**, trang Reports sẽ hiển thị một thông báo thay vì các báo cáo. Bật công tắc **Live Mode** trong thanh bên trước khi tạo báo cáo.
## 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 đó dưới dạng tệp.
### Tóm tắt số dư và khoản chi trả
Chế độ xem này đối soát số dư của bạn trong kỳ. Chế độ xem gồm ba khối.
**Tóm tắt số dư** hiển thị kỳ 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ừ các khoản chi trả. |
| Tổng các khoản chi trả | Số tiền đã rời khỏi số dư qua các khoản chi trả. |
| Số dư cuối kỳ | Số dư đầu kỳ + hoạt động − các khoản chi trả. |
**Thay đổi số dư từ hoạt động** phân rã hàng ở giữa thành các phần cấu thành.
| Hàng | Nội dung bao gồm |
| - | - |
| Payments received | Các khoản thanh toán thành công. |
| Refunds issued | Refund và phí refund, trừ mọi khoản hoàn ngược tương ứng. |
| Disputes lost | Dispute, phí dispute và phí Visa RDR, trừ mọi khoản hoàn ngược của dispute hoặc phí dispute. |
| Fees deducted | Phí payment, phí payout, phí dunning, phí payment retry, phí BYOP, phí abandoned cart recovery, phí Ethoca, phí deflection và phí moderation, trừ mọi khoản hoàn ngược. |
| Tax deducted | Tax, trừ mọi khoản hoàn ngược của tax. |
| Other movements | Dodo Credits, điều chỉnh thủ công, chuyển đổi tiền tệ và các khoản giữ, giải phóng tiền dự trữ. |
| Net Balance Change | Tổng của các hàng bên trên. |
**Other movements** chứa các mục không phù hợp với bất kỳ hàng nào có tên ở trên: **Dodo Credits** (các khoản credit mà Dodo Payments áp dụng vào số dư của bạn), **điều chỉnh thủ công** (các khoản sửa đổi do đội ngũ Dodo Payments ghi nhận) và **chuyển đổi tiền tệ** (phần chênh lệch được ghi nhận khi số dư được chuyển đổi giữa các loại tiền tệ).
**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 gross, từng khoản khấu trừ và số tiền net đã payout.
Một payout nhận tất cả các mục ledger chưa được claim cho đến ngày cut-off của payout đó, không chỉ các payment trong kỳ. Vì vậy, Dodo Credits và các khoản điều chỉnh có thể cấp vốn cho một phần payout và xuất hiện dưới **Other**.
### Tất cả Fees
**All Fees** liệt kê mọi fee được trừ khỏi số dư của bạn trong kỳ, cùng với tổng số tiền và bảng phân tích theo từng transaction.
## Tải xuống Reports
Bốn report tạo một file cho bất kỳ khoảng thời gian nào. Mỗi report mở một panel để bạn chọn kỳ, định dạng và các filter cho report đó.
Mỗi report được export dưới dạng **CSV** hoặc **XLSX**. Bốn report bao gồm:
| Report | Nội dung |
| - | - |
| **Transactions Report** | Mọi payment đã được xử lý, cùng status của từng transaction. |
| **Adjustments Report** | Refund và dispute cùng nhau: mọi khoản khấu trừ khỏi số dư trong một file. |
| **Payout Report** | Bản tóm tắt các payout, cùng bảng phân tích đầy đủ về fee cho từng kỳ payout. |
| **Ledger Reconciliation Report** | Ledger số dư, mỗi movement trên một hàng, để đối soát với sao kê ngân hàng. |
### Transactions Report
Transactions Report có hai filter:
* **Payment Method**: Card, UPI, Wallet, Bank Transfer, Bank Redirect, Pay Later, Crypto hoặc Bank Debit. Chọn **All** để bao gồm mọi method.
* **Payment Status**: Succeeded, Failed hoặc Pending.
### Adjustments Report
Adjustments Report có bốn filter:
* **Adjustment Type**: All, Refunds hoặc Disputes.
* **Payment Method**: tám method giống như trong Transactions Report.
* **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. Report này không có filter nào khác.
### Ledger Reconciliation Report
Report này có hai mode. Để chọn một mode, sử dụng **Reconciliation by**.
**Period** export mọi movement trong ledger trong một khoảng thời gian.
**Payout ID** export các movement của một payout. Nhập reference của payout, ví dụ `pyt_kxncrebha`, để lấy chính xác các hàng mà payout đó đã settlement.
Payout ID không tồn tại sẽ trả về error, không phải file trống.
**Event Types** filter các hàng theo loại movement của số dư. Chọn **All** để giữ lại mọi type hoặc chọn trong các type sau:
| Nhóm | Tùy chọn |
| - | - |
| Tiền vào | Thanh toán, Dodo Credits, Điều chỉnh, Chuyển đổi tiền tệ |
| Khoản chi trả | Khoản chi trả, Đảo ngược khoản chi trả, Phí chi trả, Đảo ngược phí chi trả |
| Hoàn tiền | Hoàn tiền, Đảo ngược hoàn tiền, Phí hoàn tiền, Đảo ngược phí hoàn tiền |
| Tranh chấp | Tranh chấp, Phí tranh chấp, Đảo ngược tranh chấp, Đảo ngược phí tranh chấp, Phí Visa RDR |
| Phí | Phí thanh toán, Phí thử lại thanh toán, Phí nhắc nợ, Phí khôi phục giỏ hàng bị bỏ quên, Phí BYOP, Phí ngăn chuyển đổi, Đảo ngược phí ngăn chuyển đổi, Phí kiểm duyệt |
| Thuế | Thuế, Đảo ngược thuế |
Không phải type nào cũng có reversal. Chỉ Payout, Payout Fees, Refund, Refund Fees, Dispute, Dispute Fees, Deflection Fees và Tax có reversal.
Để trả lời câu hỏi "payout này gồm những gì?", hãy sử dụng mode **Payout ID**. Để đối soát sao kê ngân hàng theo từng dòng, hãy sử dụng **Period** với tất cả event type (**All**).
## Tạo và tải xuống Report
Để tạo report và tải xuống:
Đi đến **Settings → Reports** và chọn report bạn cần.
Chọn một khoảng thời gian. Chỉ dữ liệu trong khoảng thời gian này được đưa vào file.
Chọn **CSV** hoặc **XLSX**, sau đó thiết lập các filter cho report đó.
Chọn **Download Report**. File được tải xuống và report được thêm vào **Generated Reports**.
Tên file chứa report và khoảng thời gian, vì vậy bạn có thể xác định file đã tải xuống mà không cần mở. Ví dụ: `dodo_ledger_1Jun2026-30Jun2026.csv`.
Bản export 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à các hệ chữ không phải Latin.
### Giới hạn hàng
Một lần export có giới hạn số hàng, vì vậy bạn có thể cần chia nhỏ một kỳ lớn.
| Report | CSV | XLSX |
| - | - | - |
| Ledger Reconciliation | 500,000 hàng | 100,000 hàng |
| Mọi report khác | 100,000 hàng | 50,000 hàng |
Nếu khoảng thời gian vượt quá giới hạn, export sẽ bị từ chối kèm thông báo. Hãy thu hẹp khoảng thời gian hoặc thêm filter, sau đó tạo lại report.
Với một kỳ lớn, hãy chọn CSV. CSV có giới hạn số hàng cao hơn.
## Generated Reports
Mọi report 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. Bảng **Generated Reports** có các cột sau:
| Cột | Ý nghĩa |
| - | - |
| Report | Loại report. |
| Date Range | Kỳ mà report bao phủ. |
| Format | CSV hoặc XLSX. |
| Rows | Số hàng trong file. |
| Generated by | Thành viên trong đội ngũ đã tạo report. |
| Created At | Thời điểm report được tạo. |
| Status | **Completed** hoặc **Failed**. |
Link tải xuống có hiệu lực trong thời gian ngắn. Nếu file được lưu trữ đã hết hạn, Dodo Payments sẽ tạo lại file từ cùng các parameter và đánh dấu hàng đó là đã được tạo lại.
Một report được tạo lại có thể khác bản gốc vì dữ liệu đằng sau một khoảng thời gian vẫn tiếp tục thay đổi. Ví dụ, refund hoặc dispute được ghi nhận sau lần tạo đầu tiên sẽ xuất hiện trong bản tạo lại. Nếu cần giữ nguyên các số liệu như ban đầu, hãy lưu file đã tải xuống.
## Tôi cần Report nào?
Đối chiếu câu hỏi của bạn với report tương ứng:
| Câu hỏi | Report |
| - | - |
| Tại sao số dư của tôi lại có 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 fee nào? | All Fees |
| Tôi cần mọi payment cho kế toán. | Transactions Report |
| Refund và dispute đã 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** |
## Best Practices
* Trước tiên, hãy đối soát bằng **Balance and Payout Summary**. Chỉ tải report chi tiết khi cần giải thích một con số.
* Export **CSV** cho kỳ dài và chỉ dùng **XLSX** khi bạn dự định làm việc thủ công trong file.
* Lưu file đã tải xuống. Bản tạo lại có thể không giống file đó.
* Thêm filter trước khi mở rộng khoảng thời gian. Filter giúp export nằm dưới giới hạn số hàng.
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 filter. Nếu vẫn không đúng, hãy liên hệ support và cung cấp loại report cùng kỳ cần kiểm tra.
Gửi email đến [support@dodopayments.com](mailto:support@dodopayments.com) với loại report và kỳ cần kiểm tra.
## Bước tiếp theo
Theo dõi doanh thu, khách hàng, retention và tình trạng của transaction.
Tìm hiểu earnings, các khoản khấu trừ và chu kỳ payout của bạn.
Xem cách thức và thời điểm payout đến tài khoản ngân hàng của bạn.
Initiate và theo dõi refund.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.