> 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/warehouses.md).
# Kho hàng
### TỔNG QUAN
**Mục đích:** Khai báo và quản lý danh sách các địa điểm lưu trữ vật lý của doanh nghiệp. Đây là dữ liệu nền tảng để hệ thống phân tách tồn kho và điều phối các giao dịch Nhập/Xuất/Chuyển kho.
**Đối tượng sử dụng:** Quản trị viên hệ thống (Admin), Quản lý kho, Kế toán kho.
**Thời điểm thực hiện:** (\*) Khi bắt đầu thiết lập hệ thống.
* Khi doanh nghiệp mở thêm chi nhánh, kho bãi mới hoặc thay đổi địa điểm lưu trữ.
***
### DỮ LIỆU CẦN CHUẨN BỊ TRƯỚC
**Sơ đồ kho:** Xác định trước danh sách các kho và các vị trí/khu vực (vị trí) bên trong kho nếu cần quản lý chi tiết.
**Quy tắc đặt mã:** Thống nhất bộ mã kho (ví dụ: WH\_HCM\_01) để tránh trùng lặp và dễ quản lý.
***
### MÔ TẢ GIAO DIỆN
Nội dung bên trong phân hệ Kho hàng được chia thành hai phần chính:
#### Màn hình Danh sách Kho hàng
* Thanh điều khiển (Toolbar): Các bộ lọc nhanh (Filter), nút làm mới (Refresh).
* Ô Tìm kiếm: Hỗ trợ tìm nhanh theo tên hoặc mã kho.
* Nút \[Xuất Excel]: Trích xuất danh sách kho ra tệp tin.
* Nút \[+ Thêm mới]: Khởi tạo kho hàng mới.
* Bảng dữ liệu: Hiển thị các cột: *Mã Kho, Tên Kho, Tổ chức, Địa chỉ, Số lượng vị trí (Vị trí), Trạng thái (Hoạt động/Ngừng hoạt động), Ghi chú, Người cập nhật và Ngày cập nhật*.
* Cột Hành động:
* Biểu tượng Cây bút: Chỉnh sửa thông tin kho.
* Biểu tượng Ổ khóa: Khóa/Mở khóa (Ngưng kích hoạt) kho.
* Biểu tượng Thùng rác: Xóa kho (chỉ thực hiện được khi kho chưa có phát sinh giao dịch).
* Biểu tượng QR Code: Xem/In mã định danh kho.
#### Màn hình Form (Thêm mới/Chỉnh sửa)
* Giao diện bao gồm các trường thông tin:
* Mã Kho & Tên Kho: Các trường bắt buộc (\*).
* Trạng thái: Danh sách chọn (Dropdown) Hoạt động hoặc Ngừng hoạt động.
* Địa chỉ & Ghi chú: Ô nhập văn bản chi tiết.
* Quản lý Vị trí (Chỉ có ở màn hình Chỉnh sửa): Danh sách các vị trí (Location) con bên trong kho đó kèm nút \[+ Thêm mới] vị trí.
***
### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN
#### Thêm mới Kho hàng
* Truy cập: Chọn Danh mục > Kho hàng.
* Khởi tạo: Nhấn nút \[+ Thêm mới].
* Nhập thông tin:
* Nhập Mã Kho (không trùng lặp) và Tên Kho.
* Chọn Trạng thái là "Hoạt động".
* Nhập Địa chỉ thực tế và Ghi chú (nếu có).
* Lưu dữ liệu: Nhấn nút \[+ Thêm mới] màu xanh lá ở dưới cùng để hoàn tất.
#### Chỉnh sửa và Quản lý Vị trí
* Tại dòng kho cần sửa, nhấn biểu tượng Chỉnh sửa (Cây bút).
* Thay đổi các thông tin như Tên kho, Địa chỉ hoặc Ghi chú.
* Quản lý Vị trí (nếu có): Cuộn xuống phần "Vị trí", nhấn \[+ Thêm mới] để khai báo các kệ/ô/hàng bên trong kho này.
* Nhấn \[Lưu] để cập nhật thay đổi.
#### Ngừng hoạt động Kho
* Tại danh sách, nhấn biểu tượng Ổ khóa tại dòng kho tương ứng.
* Hệ thống hiển thị bảng xác nhận: "Bạn có chắc chắn muốn ngưng kích hoạt mục này?".
* Nhấn \[Có] để xác nhận. Kho sẽ chuyển sang trạng thái Ngừng hoạt động và không thể chọn khi làm phiếu Nhập/Xuất.
***
### VÍ DỤ THỰC TẾ
Giả sử doanh nghiệp của bạn vừa thuê thêm một kho mới tại Quận 7 để chứa nguyên liệu. Cách điền thông tin như sau:
* Mã kho: WH-Q7-NGUYENLIEU
* Tên kho: Kho Nguyên Liệu Quận 7
* Địa chỉ: 123 Nguyễn Văn Linh, Quận 7, TP. Hồ Chí Minh
* Ghi chú: Liên hệ anh Nam (thủ kho) - 090xxxxxxx
* Nhấn \[Lưu].
***
### 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 "Mã kho đã tồn tại" | Mã kho bạn nhập đã được sử dụng cho một kho khác trên hệ thống. | Nhập mã kho duy nhất khác hoặc kiểm tra lại danh sách kho (kể cả kho đã ngưng hoạt động). |
| Không thể sửa Mã kho | Hệ thống khóa trường này để đảm bảo tính toàn vẹn dữ liệu lịch sử. | Kiểm tra kỹ trước khi lưu. Nếu sai, phải ngừng hoạt động kho cũ và tạo kho mới. |
| Không tìm thấy kho khi lập phiếu | Kho đang ở trạng thái "Ngừng hoạt động". | Vào danh mục Kho hàng, dùng bộ lọc trạng thái để tìm và kích hoạt lại (Mở khóa). |
| Không thể Xóa kho | Kho này đã từng có giao dịch (Nhập/Xuất) hoặc có vị trí bên trong. | Chỉ có thể chuyển sang trạng thái "Ngừng hoạt động" để ẩn đi, không nên xóa để giữ lịch sử đối soá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/features/master-data/warehouses.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.