> 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/settings.md).

# CÀI ĐẶT

### TỔNG QUAN

**Mục đích:** Cho phép người dùng tùy chỉnh cơ chế quét mã vạch, tối ưu hóa phần cứng thiết bị PDA và quản lý thông tin tài khoản cá nhân để đạt tốc độ vận hành cao nhất.

**Đối tượng sử dụng:** Nhân viên kho (thực hiện cài đặt cơ bản) và Cán bộ kỹ thuật/IT (cấu hình nâng cao).

**Thời điểm thực hiện:** Ngay sau khi đăng nhập lần đầu, khi thay đổi thiết bị quét mới, hoặc khi gặp tình trạng quét mã chậm/sai lệch.

***

### MÔ TẢ GIAO DIỆN

Giao diện Cài đặt được chia thành 4 phân vùng chức năng chính:

* Tinh chỉnh quét nâng cao: Cấu hình kỹ thuật cho bộ đọc mã vạch (Keyboard Wedge, Timeout, Độ trễ giữa các ký tự).

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

* Tiện ích vận hành: Các công tắc bật/tắt tính năng bổ trợ như *Ẩn bàn phím ảo* và *Auto Submit*.

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

* Ngôn ngữ: Tùy chọn hiển thị đa ngôn ngữ (VI/EN).

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

* Thông tin tài khoản: Hiển thị tên người dùng và danh sách các quyền hạn (Role) đang được gán trên hệ thống.

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

***

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

#### Bước 1: Cấu hình chế độ quét (Scanner Mode)

* Tại mục Chế độ quét, chọn "Keyboard Wedge mode" (đối với hầu hết các thiết bị PDA hiện nay).
* Ký tự kết thúc: Chọn "Enter" để hệ thống tự động xuống dòng hoặc nhận lệnh sau mỗi lần quét.
* Timeout (ms): Điều chỉnh trong khoảng 180-350ms (Khuyến nghị: 200ms). Đây là thời gian hệ thống đợi để xác định đã kết thúc một mã quét.

#### Bước 2: Tối ưu hóa giao diện quét

* Ẩn bàn phím ảo: Gạt nút sang trạng thái Bật (ON). Tính năng này giúp màn hình không bị chiếm diện tích bởi bàn phím hệ thống, giữ tiêu điểm (focus) luôn nằm ở ô nhập liệu.
* Auto Submit: Gạt nút sang trạng thái Bật (ON) nếu muốn hệ thống tự động gửi dữ liệu ngay sau khi quét thành công mà không cần bấm nút "Xác nhận" thủ công.

#### Bước 3: Cấu hình đọc Clipboard (Dành cho việc sao chép mã)

* Phím nóng: Thường mặc định là F9 (hoặc tùy chỉnh phím cứng trên PDA) để đọc nhanh dữ liệu từ bộ nhớ tạm.
* Tách mã: Chọn "Tự động" để hệ thống tự phân tách nếu Clipboard chứa nhiều mã cùng lúc (ngăn cách bởi dấu phẩy, chấm phẩy hoặc xuống dòng).

#### Bước 4: Kiểm tra quyền hạn và Ngôn ngữ

* Chọn ngôn ngữ phù hợp (VI) để dễ dàng thao tác.
* Xem danh sách các thẻ đỏ ở mục Tài khoản để biết mình có quyền thực hiện các nghiệp vụ như: *Goods Receipt (Nhập), Goods Issues (Xuất), Inventories Count (Kiểm kê)...*

***

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

| Tình huống / Lỗi                      | Nguyên nhân                                     | Cách xử lý                                                                                                             |
| ------------------------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Dữ liệu quét bị dính với nhau         | Độ trễ giữa 2 ký tự (ms) đang để quá thấp.      | Tăng giá trị "Độ trễ tối đa giữa 2 ký tự" lên (ví dụ: 110ms) để thiết bị nhận diện rõ từng ký tự.                      |
| Thiếu chức năng nghiệp vụ (Nhập/Xuất) | Tài khoản chưa được gán quyền (Role) tương ứng. | Kiểm tra danh sách Role trong mục tài khoản. Nếu thiếu, hãy liên hệ Admin để cấp quyền (như *Goods Receipt Operator*). |
| Muốn quay về ban đầu                  | Cấu hình sai gây lỗi quét.                      | Nhấn nút "Khôi phục mặc định" để đưa toàn bộ thông số về trạng thái chuẩn của nhà sản xuất App.                        |


---

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