> For the complete documentation index, see [llms.txt](https://docs.xcloud.wms.delfi.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xcloud.wms.delfi.vn/docs/features/reports/report-center.md).
# Trung tâm báo cáo
### TỔNG QUAN
**Mục đích sử dụng:** Là cổng thông tin tập trung (Hub) giúp người dùng truy xuất, xem trước và trích xuất các loại báo cáo kho. Hệ thống sử dụng cơ chế xử lý Bất đồng bộ (Async), cho phép xuất các tệp dữ liệu lớn dưới nền mà không gây treo máy hoặc gián đoạn công việc hiện tại.
**Đối tượng sử dụng:** Quản lý kho, Kế toán kho và Nhân viên kho (theo phạm vi kho được phân quyền).
**Thời điểm thực hiện:** Khi cần đối soát tồn kho, theo dõi luồng hàng hóa nhập - xuất theo khoảng thời gian hoặc trích xuất dữ liệu để phục vụ công tác kiểm toán, báo cáo định kỳ.
***
### DỮ LIỆU CẦN CHUẨN BỊ TRƯỚC
Phân quyền module: Tài khoản phải có quyền truy cập vào phân hệ "Báo cáo".
Phạm vi dữ liệu: Đảm bảo tài khoản đã được cấu hình quyền quản lý tại các kho hàng cần truy xuất dữ liệu (Permission Context).
***
### MÔ TẢ GIAO DIỆN
Giao diện được chia thành các khu vực chức năng trực quan:
* Banner thông tin: Tóm tắt mục đích của Trung tâm báo cáo kèm theo các nút thao tác nhanh: Bắt đầu với Tổng quan tồn kho, Mở lịch sử tiến trình và Mẫu PDF.
* Khu vực cơ chế xử lý (Khối màu):
* Bất đồng bộ: Giải thích về luồng xuất báo cáo chạy nền.
* Thời gian thực: Theo dõi các thay đổi dữ liệu tức thì.
* Mẫu v1: Quản lý các định dạng báo cáo tiêu chuẩn.
* Các thẻ báo cáo chi tiết: Mỗi loại báo cáo (Tổng quan tồn kho, Biến động tồn kho,...) được đặt trong một thẻ riêng với nút \[Xem] để kiểm tra số liệu tại chỗ và nút \[Xuất] để tải tệp.
* Thanh công cụ "Nhập nhanh" (Footer): Chứa các lối tắt truy cập nhanh vào Lịch sử, Mẫu báo cáo và nút xuất báo cáo tổng quan.
***
### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN
{% stepper %}
{% step %}
**Lựa chọn hình thức kiểm tra dữ liệu**
* Xem trực tiếp: Nhấn nút \[Xem] trên thẻ báo cáo để mở bảng dữ liệu live. Cách này phù hợp khi cần tra cứu nhanh thông tin mà không cần lưu trữ file.
* Xuất file báo cáo: Nhấn nút \[Xuất] để bắt đầu quy trình tạo tệp dữ liệu.
{% endstep %}
{% step %}
**Cấu hình tham số xuất báo cáo**
Khi Form cấu hình xuất hiện bên phải màn hình:
* Kiểm tra thông tin lọc (Kho, Sản phẩm, Thời gian).
* Chọn Định dạng mong muốn (mặc định là XLSX).
* Nhập Tiêu đề file và Ghi chú (nếu cần) để dễ dàng phân biệt trong danh sách lịch sử.
* Nhấn \[Tạo file xuất]. Hệ thống sẽ thông báo lệnh đã được ghi nhận.
{% endstep %}
{% step %}
**Theo dõi tiến trình xử lý (Job)**
Nhấn nút \[Mở lịch sử tiến trình] trên header. Tại màn hình này:
* Quan sát cột Tiến độ: Khi thanh trạng thái chạy đến 100% và cột Trạng thái hiển thị "Hoàn tất" (màu xanh), file đã sẵn sàng.
* Bạn có thể thực hiện các tác vụ khác và quay lại màn hình này bất cứ lúc nào.
{% endstep %}
{% step %}
**Tải báo cáo và lưu trữ**
Tại cột Hành động trong màn hình Lịch sử:
* Nhấn \[Tải xuống] để lưu file về máy tính.
* Nhấn \[Chạy lại] nếu muốn xuất lại báo cáo đó với các tham số cũ mà không cần thiết lập lại từ đầu.
{% endstep %}
{% endstepper %}
***
### VÍ DỤ THỰC TẾ
Giả sử Kế toán cần xuất báo cáo "Tổng quan tồn kho" của toàn bộ chi nhánh để đối soát cuối ngày:
1. Thao tác: Kế toán nhấn nút \[Xuất] trên thẻ Tổng quan tồn kho.
2. Cấu hình: Tại form bên phải, Kế toán đặt tên file là "Bao\_cao\_ton\_kho\_12052026", chọn mẫu "default" và nhấn \[Tạo file xuất].
3. Trong lúc chờ: Kế toán chuyển sang tab "Vận hành kho" để duyệt phiếu xuất.
4. Kết quả: Sau 2 phút, Kế toán quay lại Lịch sử báo cáo, thấy dòng tiến trình đã Hoàn tất và nhấn \[Tải xuống] để nhận file Excel.
***
### LƯU Ý CHUNG KHI SỬ DỤNG
| Tình huống / Lỗi | Cách xử lý |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Bấm "Xuất" nhưng không thấy tải file về ngay | Hệ thống chạy chế độ Bất đồng bộ. Vui lòng vào Lịch sử báo cáo để tải file khi trạng thái chuyển sang "Hoàn tất". |
| Trạng thái Job hiển thị "Thất bại" | Có thể do lượng dữ liệu quá lớn vượt ngưỡng hoặc lỗi kết nối. Hãy thử nhấn nút \[Chạy lại] hoặc thu hẹp khoảng thời gian lọc. |
| File báo cáo bị hết hạn | Hệ thống hỗ trợ lưu trữ tệp trong vòng 30 ngày. Sau thời gian này, nút Tải xuống sẽ bị ẩn, bạn cần thực hiện xuất lại báo cáo. |
| Dữ liệu trong báo cáo bị trống (Blank) | Kiểm tra lại bộ lọc thời gian hoặc phân quyền kho. Nếu bạn không được quyền xem kho đó, báo cáo sẽ không có dữ liệu. |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.xcloud.wms.delfi.vn/docs/features/reports/report-center.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.