> 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/stock-movement.md).
# Stock Movement
### TỔNG QUAN
**Mục đích:** Cung cấp cái nhìn tổng quan về biến động hàng hóa bao gồm: Tồn Đầu Kỳ, Nhập Trong Kỳ, Xuất Trong Kỳ và Tồn Cuối Kỳ trong một khoảng thời gian cụ thể.
**Đối tượng sử dụng:** Quản lý kho, Kế toán kho (toàn quyền) và Nhân viên kho (giới hạn theo phạm vi phụ trách).
**Thời điểm thực hiện:** Khi cần đối soát lượng hàng luân chuyển cuối kỳ, làm dữ liệu kiểm toán hoặc theo dõi chi tiết các chứng từ nhập/xuất phát sinh.
***
### DỮ LIỆU CẦN CHUẨN BỊ TRƯỚC
Phân quyền truy cập: Tài khoản người dùng phải được cấp quyền vào module Báo cáo.
Phân quyền kho: Nhân viên phải được gán quyền quản lý các kho hàng cụ thể để dữ liệu hiển thị đúng phạm vi trách nhiệm.
***
### MÔ TẢ GIAO DIỆN
Giao diện Stock Movement có các nội dung:
* Thanh điều hướng tác vụ: Chứa các nút \[Làm mới], \[Xuất báo cáo] và \[Lịch sử xuất báo cáo].
* Bộ lọc thông minh (Filters): Cho phép lọc theo thời gian nhanh (7d, 30d, 90d), tùy chỉnh ngày, chọn Kho, Sản phẩm và tìm kiếm theo từ khóa.
* Thẻ chỉ số tổng hợp (KPI Cards): Hiển thị nhanh tổng số dòng dữ liệu, tổng lượng Tồn đầu, Nhập, Xuất và Tồn cuối của kỳ báo cáo đang chọn.
* Biểu đồ Xu hướng nhập - xuất - tồn: Trực quan hóa dữ liệu biến động của các sản phẩm (Closing, Issue, Opening, Receipt) để dễ dàng so sánh.
* Bảng xem trước dữ liệu (Live Preview): Lưới chi tiết hiển thị Mã sản phẩm, Tên sản phẩm, Đơn vị tính và các cột số liệu biến động kèm danh sách phiếu nhập/xuất tương ứng.
* Khối Bộ lọc & Trạng thái: Hiển thị trạng thái xử lý dữ liệu realtime và các tùy chọn xuất file.
***
### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN
{% stepper %}
{% step %}
**Thiết lập tham số báo cáo**
Tại khối bộ lọc, chọn khoảng thời gian cần đối soát (ví dụ: 30D) và chọn Kho hàng hoặc Sản phẩm cụ thể.
{% endstep %}
{% step %}
**Làm mới dữ liệu xem trước**
Nhấn nút \[Làm mới preview] hoặc nút \[Xuất] (màu xanh dương) cạnh bộ lọc để hệ thống tính toán số liệu và hiển thị lên lưới dữ liệu.
{% endstep %}
{% step %}
**Kiểm tra biến động qua biểu đồ**
Quan sát mục "Xu hướng nhập - xuất - tồn" để nhận diện nhanh các sản phẩm có tần suất luân chuyển cao hoặc bất thường trong kỳ.
{% endstep %}
{% step %}
**Xuất báo cáo xử lý ngầm**
Đối với nhu cầu lưu trữ file, nhấn nút \[Xuất báo cáo]. Hệ thống sẽ đẩy tác vụ xuống chạy ngầm để không ảnh hưởng đến thao tác khác.
{% endstep %}
{% step %}
**Tải file báo cáo hoàn thiện**
Truy cập \[Lịch sử export] trên Header, theo dõi Thanh tiến trình (Progress Bar) đạt 100% và nhấn tải file về máy.
{% endstep %}
{% endstepper %}
***
### VÍ DỤ THỰC TẾ
Vào ngày cuối tháng, Kế toán kho thực hiện đối soát lượng hàng hóa luân chuyển tại "Kho Tân Bình":
* Truy cập màn hình Báo cáo Xuất nhập tồn, chọn khoảng thời gian lọc là "30d" và chọn đích danh "Kho Tân Bình".
* Kế toán quyết định nhấn ngay nút \[Xuất báo cáo].
* Thanh tiến trình hiện lên chạy ngầm và báo hoàn thành 100% sau vài giây. Kế toán tải file Excel về để hoàn thiện hồ sơ kiểm toán.
***
### LƯU Ý CHUNG KHI SỬ DỤNG
| Tình huống / Lỗi | Cách xử lý |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Dữ liệu truy vấn quá lớn (trên 3000 dòng) | Hệ thống báo "Dữ liệu lớn" màu xanh dương; nên sử dụng tính năng xuất file thay vì xem trước để tránh làm chậm trình duyệt. |
| Quá trình xuất file bị lỗi (Timeout) | Do tệp dữ liệu vượt ngưỡng 50MB. Nên thu hẹp phạm vi thời gian (theo tuần) hoặc lọc theo từng kho cụ thể. |
| Số liệu Tồn cuối không khớp | Kiểm tra lại công thức: Tồn cuối = Tồn đầu + Nhập - Xuất. Kiểm tra chi tiết tại cột "Phiếu nhập" và "Phiếu xuất" để tìm chứng từ sai lệch. |
| Dữ liệu hiển thị trống | Kiểm tra lại bộ lọc "Kỳ báo cáo" hoặc xác nhận quyền truy cập kho của tài khoản. |
---
# 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/stock-movement.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.