> 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/master-data/locations.md).

# Vị trí / Khu vực

### TỔNG QUAN

**Mục đích:** Thiết lập và quản lý sơ đồ lưu trữ vật lý (dãy kệ, tầng, ngăn chứa). Đây là cơ sở dữ liệu cốt lõi để hệ thống chỉ dẫn chính xác việc cất hàng, lấy hàng và kiểm kê thông qua mã QR/Barcode.

**Đối tượng sử dụng:** Quản lý kho, Thủ kho, Quản trị viên hệ thống.

**Thời điểm thực hiện:** Khi phát sinh kho mới, thay đổi sơ đồ kệ hàng hoặc bổ sung không gian lưu trữ thực tế.

***

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

**Danh mục Kho hàng:** Kho vật lý phải được khởi tạo trước tại menu "Kho hàng" để có dữ liệu chọn lựa.

**Quy chuẩn đặt mã**: Cần thống nhất quy tắc đặt mã vị trí (Ví dụ: `KHO-KE-TANG-NGAN`) để đảm bảo tính khoa học và dễ nhận diện khi vận hành.

***

### MÔ TẢ GIAO DIỆN

#### Danh sách Vị trí

<figure><img src="/files/yXobQPMPg1vSW65YScyg" alt=""><figcaption></figcaption></figure>

* Thanh công cụ: Bao gồm bộ lọc dữ liệu, nút \[+ Thêm mới] màu xanh lá và nút \[Xuất Excel] màu xanh dương.
* Bảng dữ liệu: Hiển thị các thông tin: Mã Vị trí, Tên Vị trí, Kho, Trạng thái (được gắn nhãn màu trực quan), Ghi chú, Người cập nhật và Ngày cập nhật.
* Cột Hành động: Chứa các biểu tượng:
  * Sửa (Bút chì): Chỉnh sửa thông tin.
  * Khóa/Mở khóa (Ổ khóa): Thay đổi trạng thái hoạt động nhanh.
  * Xóa (Thùng rác): Xóa vị trí (chỉ khi chưa có dữ liệu phát sinh).
  * In Tem (Mã QR): Xuất tem nhãn cho vị trí đó.

#### Form Nhập liệu

<figure><img src="/files/YPffuByZvuxwzLZepEDk" alt=""><figcaption></figcaption></figure>

* Kho (\*): Danh mục chọn kho quản lý vị trí đó.
* Mã Vị trí (\*): Mã định danh duy nhất (Bị khóa khi chỉnh sửa).
* Tên Vị trí (\*): Tên hiển thị mô tả vị trí.
* Trạng thái: Lựa chọn "Hoạt động" hoặc "Ngừng hoạt động".
* Ghi chú: Thông tin bổ sung.

***

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

#### Thêm mới Vị trí

* Truy cập: Tại màn hình danh sách, nhấn nút \[+ Thêm mới]
* Nhập thông tin:
  * Chọn Kho hàng trực thuộc.
  * Nhập Mã Vị trí (Lưu ý: Mã này sẽ không được sửa sau khi lưu để tránh sai lệch dữ liệu lịch sử).
  * Nhập Tên Vị trí và Ghi chú (nếu có).
* Hoàn tất: Nhấn nút \[Thêm mới] màu xanh ở góc dưới bên phải.

#### Chỉnh sửa Vị trí

<figure><img src="/files/NvuWSxGmTWH07CAYbhMZ" alt=""><figcaption></figcaption></figure>

* Tìm kiếm: Sử dụng thanh tìm kiếm hoặc bộ lọc để tìm vị trí cần sửa.
* Mở Form: Nhấn vào biểu tượng Sửa (Bút chì) tại dòng tương ứng.
* Cập nhật: Thay đổi Tên vị trí, Trạng thái hoặc Ghi chú.
  * *Lưu ý:* Hệ thống sẽ khóa trường Kho và Mã Vị trí để đảm bảo tính toàn vẹn dữ liệu tồn kho.
* Lưu: Nhấn nút \[Lưu] để hoàn tất.

***

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

Giả sử bạn cần tạo vị trí cho một ngăn chứa tại kho Quận 7. Cách điền thông tin như sau:

* Kho: Chọn Kho Tổng Bình Tân
* Mã Vị trí: Q7-A1-01
* Tên Vị trí: Kệ A1 - Ngăn 01
* Trạng thái: Hoạt động.
* Ghi chú: Ngăn chứa hàng thực phẩm khô.
* Nhấn \[Thêm mới].

<figure><img src="/files/vHdeNz4IfYfj7tx9xCKf" alt="" width="288"><figcaption></figcaption></figure>

***

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

| Tình huống / Lỗi                    | Nguyên nhân                                                                     | Cách xử lý                                                                                        |
| ----------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Báo lỗi trùng mã vị trí             | Mã vị trí đã tồn tại trong hệ thống (có thể ở kho khác hoặc đã bị ẩn).          | Kiểm tra lại danh sách hoặc thêm tiền tố mã kho để phân biệt (VD: `HCM-LOC01`).                   |
| Không sửa được Mã Vị trí/Kho        | Đây là ràng buộc hệ thống để tránh lỗi logic tồn kho khi đã có hàng nằm tại đó. | Nếu nhập sai mã, hãy đổi trạng thái sang Ngừng hoạt động và tạo một mã mới đúng.                  |
| Vị trí không hiển thị khi nhập hàng | Vị trí đang ở trạng thái Ngừng hoạt động.                                       | Vào danh sách, tìm vị trí đó và nhấn vào biểu tượng Ổ khóa hoặc vào sửa để chuyển sang Hoạt động. |
| Không tìm thấy Kho khi thêm mới     | Kho chưa được khai báo Master Data.                                             | Truy cập menu Kho hàng để tạo mới kho trước khi quay lại màn hình này.                            |


---

# 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/master-data/locations.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.