> 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/scanner/features/count.md).

# Kiểm kê (Scanner)

### TỔNG QUAN

**Mục đích sử dụng:** Giúp nhân viên quét mã tại kho thực hiện ghi nhận số lượng hàng hóa thực tế (đếm thực tế) bằng cách quét mã vạch/mã QR hoặc nhập liệu trực tiếp trên thiết bị Scanner cầm tay, làm cơ sở đối soát dữ liệu với hệ thống Web quản lý nhằm xử lý sai lệch (thừa/thiếu hàng).

**Đối tượng sử dụng:** Nhân viên kho phụ trách quét mã (Scanner), nhân viên kiểm kê trực tiếp tại mặt bằng kho.

**Thời điểm thực hiện:** Khi nhận được chỉ định kiểm kê định kỳ (tháng/quý) hoặc kiểm kê đột xuất từ bộ phận Quản lý (Admin tạo phiếu trên Web và phân công cho tài khoản Scanner).

***

### DỮ LIỆU CẦN CHUẨN BỊ TRƯỚC

Tài khoản Scanner đã đăng nhập thành công vào ứng dụng và được Admin phân công quyền phụ trách trong phiếu kiểm kê tương ứng.

Thiết bị Scanner (hoặc điện thoại) đảm bảo kết nối mạng (Wi-Fi/4G) ổn định (trạng thái hiển thị "Tốt").

Hàng hóa tại khu vực kiểm kê đã được sắp xếp gọn gàng, tem mã vạch (Barcode/QR Code) của sản phẩm hoặc tem lô (Lot) rõ ràng, không bị che khuất.

***

### MÔ TẢ GIAO DIỆN

*Giao diện làm việc của chức năng Kiểm kê trên App Scanner gồm 3 màn hình chính tương ứng theo luồng nghiệp vụ:*

**Màn hình Danh sách Phiếu Kiểm kê & Bộ lọc**

<figure><img src="/files/0HmlAXVCSzdbCvJu6OjW" alt="" width="188"><figcaption></figcaption></figure>

* Thanh tìm kiếm: Ô *"Tìm kiếm mã phiếu, kho..."* kết hợp biểu tượng Máy ảnh để quét nhanh mã QR của phiếu và biểu tượng Bộ lọc nâng cao (Filter) ở góc phải.
* Vùng bộ lọc mở rộng (khi bấm vào nút Filter):
  * *Lọc trạng thái:* Gồm các nhãn tùy chọn nhanh như `Tất cả trạng thái`, `Đang kiểm kê`.
  * *Lọc thời gian:* Phân loại linh hoạt (`Toàn thời gian`, `Hôm nay`, `Hôm qua`, `7 ngày qua`, `Tháng này`, `Tháng trước`).
  * *Sắp xếp:* Tiêu chí hiển thị dữ liệu (`Mặc định`, `Mới cập nhật`, `Cũ nhất,...`).
* Danh sách phiếu hiển thị: Mỗi phiếu là một thẻ chứa: Mã phiếu (Ví dụ: `IC-0515151526-3261`), Tên kho (`KHO_A`), Ngày giờ tạo và Nhãn trạng thái màu cam (`ĐANG KIỂM KÊ`).

**Màn hình Chi tiết Phiếu Kiểm kê**

<figure><img src="/files/GjcYCiVeEHsdWBNJ1TeK" alt="" width="188"><figcaption></figcaption></figure>

* Thẻ thông tin tổng quan của phiếu: Hiển thị Mã phiếu, Kho kiểm kê, Chế độ kiểm kê (Theo `SKU` hoặc theo `LOT`), Ngày kiểm kê và mã Phiếu liên quan (nếu có). Trạng thái phiếu hiển thị nhãn màu cam "COUNTING".
* Danh sách Item: Hiển thị tổng số lượng sản phẩm cần kiểm kê và danh sách chi tiết từng sản phẩm. Mỗi dòng sản phẩm bao gồm: Tên/Mã sản phẩm (Ví dụ: `PANA1928 - máy lạnh Panasonic`), Phân loại (`Serial` - `Cái`), kèm 2 cột đối chiếu thông số:
  * Thực tế: Hiển thị số lượng màu xanh lá (số lượng do Scanner quét được).
  * Tồn kho: Hiển thị số lượng màu xanh dương (số lượng đang có trên hệ thống).
* Nút chức năng dưới cùng: Nút "Đồng bộ phiếu" (mặc định mờ khi chưa có dữ liệu mới và sáng lên sau khi quét hoàn tất).

**Màn hình Danh sách Chi tiết Mã Serial/Lot (Khi bấm vào sản phẩm)**

<figure><img src="/files/qKxr5V8NFpl2ZldQrEt0" alt="" width="188"><figcaption></figcaption></figure>

* Thẻ thông tin sản phẩm: Hiển thị mã, tên sản phẩm và nhãn loại quản lý (Ví dụ: `SERIAL` hoặc `LOT`).
* Tiêu đề danh sách: *"Danh sách Serial"* kèm tổng tiến độ thực tế/hệ thống (Ví dụ: `7 Cái (7/8)` - nghĩa là hệ thống có 8 nhưng mới quét được 7).
* Danh sách chi tiết dòng mã: Hiển thị từng mã định danh cụ thể của sản phẩm đã quét kèm số lượng đơn vị (`1 cái`) và Vị trí (Bin).
* Thanh thao tác chân trang: Gồm nút "Scan" (icon khung quét) để mở camera quét liên tục và nút "Xác nhận" màu xám/xanh để ghi nhận kết quả của sản phẩm đó.

***

### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN

{% stepper %}
{% step %}
**Tiếp nhận và Mở phiếu kiểm kê**

* Tại thanh điều hướng dưới cùng của app, chọn tab Kiểm kê.
* Sử dụng thanh tìm kiếm hoặc lướt danh sách để tìm đúng Mã phiếu kiểm kê được bàn giao (Ví dụ: `IC-0515151526-3261`).
* Ấn trực tiếp vào thẻ phiếu để truy cập vào màn hình Chi tiết Phiếu.
  {% endstep %}

{% step %}
**Chọn sản phẩm và Tiến hành quét thực tế**

* Tại màn hình Chi tiết Phiếu, bấm chọn vào sản phẩm cần đếm (Ví dụ: `PANA1928`).
* Tại màn hình danh sách chi tiết của sản phẩm đó, bấm vào nút "Scan" ở góc dưới bên trái để kích hoạt camera quét mã hoặc scan trực tiếp nếu sử dụng PDA.
* Đưa camera vào mã vạch/QR của sản phẩm/lô hàng. Hệ thống sẽ tự động bắt mã và cộng dồn số lượng thực tế lên danh sách (`1 cái`, `2 cái`,...).
* *Lưu ý:* Đối với chế độ kiểm kê theo `SKU/Serial`, mỗi lần quét một mã máy sẽ nhận diện là 1 đơn vị riêng biệt. Đối với kiểm kê theo `LOT`, hệ thống sẽ ghi nhận theo số lượng của cả lô.
* Sau khi quét xong toàn bộ hàng hóa đang có của sản phẩm đó, bấm nút "Xác nhận" để lưu kết quả tạm thời và quay lại màn hình chi tiết phiếu.
  {% endstep %}

{% step %}
**Kiểm tra chênh lệch nhanh và Đồng bộ dữ liệu**

* Tại màn hình Chi tiết Phiếu, kiểm tra lại con số tại cột Thực tế (Màu xanh lá) so với cột Tồn kho (Màu xanh dương) để nhận diện nhanh trạng thái thừa/thiếu.
* Kiểm tra nếu thấy chuẩn xác, bấm vào nút "Đồng bộ phiếu" ở dưới cùng màn hình.
* Hệ thống sẽ đẩy dữ liệu quét thực tế từ App Scanner lên Web quản lý để Admin tiến hành các bước phê duyệt và cân đối tồn kho tiếp theo.
  {% endstep %}
  {% endstepper %}

***

### VÍ DỤ THỰC TẾ

* Tình huống: Nhân viên kiểm kê tiến hành đối soát sản phẩm "Máy lạnh Panasonic" (Mã `PANA1928`) tại `KHO_A` theo phiếu kiểm kê mã `IC-0515151526-3261`, chế độ kiểm kê là `SKU`. Số lượng trên hệ thống Web đang báo là `08` cái.
* Các bước Scanner thực hiện:
  1. Vào App Scanner $$\rightarrow$$ Chọn tab Kiểm kê $$\rightarrow$$ Bấm chọn phiếu `IC-0515151526-3261`.
  2. Bấm vào sản phẩm `PANA1928` $$\rightarrow$$ Nhấn nút Scan và lần lượt quét mã Serial của các máy lạnh thực tế có trong kho.
  3. Sau khi quét hết tất cả máy hiện hữu tại khu vực, danh sách hiển thị `7 Cái (7/8)`. Nhân viên bấm Xác nhận.
  4. Màn hình Chi tiết Phiếu cập nhật cột *Thực tế: 07* | *Tồn kho: 08*. Nhân viên bấm Đồng bộ phiếu.
* Kết quả: Dữ liệu "Thực tế: 07" được đẩy lên Web thành công. Admin trên Web sẽ thấy phần chênh lệch thiếu 1 sản phẩm và tiến hành xử lý tạo phiếu xuất bù để đưa tồn kho hệ thống về đúng số 7.

<figure><img src="/files/iuKmh37fqUxU46rGdpT3" alt="" width="188"><figcaption></figcaption></figure>

***

### LƯU Ý CHUNG KHI SỬ DỤNG

| Tình huống / Lỗi                                            | Nguyên nhân                                                                                                                                                                                                                                             | Cách xử lý                                                                                                                                                                                                                                                                        |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Không tìm thấy phiếu kiểm kê trên App Scanner               | <p>1. Phiếu chưa được chuyển trạng thái "Đang kiểm kê" trên Web.</p><p>2. Admin chưa gán tài khoản Scanner của bạn vào phiếu này.</p><p>3. Bộ lọc thời gian trên App đang bị giới hạn (Ví dụ: Chỉ lọc "Hôm nay" trong khi phiếu tạo từ tuần trước).</p> | <p>1. Bấm vào biểu tượng Bộ lọc (Filter) trên App, chọn <code>Tất cả trạng thái</code> và <code>Toàn thời gian</code> để tìm lại.</p><p>2. Nếu vẫn không thấy, liên hệ Admin trên Web kiểm tra lại mục "Nhân viên Scanner phụ trách" xem đã chọn đúng tài khoản của bạn chưa.</p> |
| Nút "Đồng bộ phiếu" bị mờ (không bấm được)                  | <p>1. Bạn chưa thực hiện hành động quét hay thay đổi số lượng thực tế của bất kỳ sản phẩm nào trong phiếu.</p><p>2. Thiết bị mất kết nối mạng.</p>                                                                                                      | <p>1. Vào chi tiết sản phẩm và thực hiện quét mã ít nhất 1 lần.</p><p>2. Kiểm tra tín hiệu mạng ở góc trên bên phải (Đảm bảo trạng thái báo chấm xanh "Tốt").</p>                                                                                                                 |
| Quét nhãn Serial báo lỗi hoặc không nhận diện diện tích hợp | Nhãn mã vạch bị mờ, rách hoặc camera thiết bị bị bám bẩn, môi trường thiếu ánh sáng.                                                                                                                                                                    | Lau sạch camera, di chuyển thiết bị ra xa/gần (khoảng 15-20cm) hoặc đổi góc quét để tránh phản chiếu ánh sáng. Nếu nhãn hỏng hoàn toàn, báo bộ phận Admin hỗ trợ chỉnh sửa số lượng thực tế trực tiếp bằng tay trên giao diện Web (bằng biểu tượng "Cây bút" ở cột SL Thực tế).   |


---

# 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/scanner/features/count.md?ask=<question>
```

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.
