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

# Thiết lập tổ chức

### MÔ TẢ GIAO DIỆN

Khu vực nội dung chính được chia thành hai phần rõ rệt, quản lý toàn bộ thông tin định danh và các quy tắc vận hành tự động của tổ chức trên hệ thống:

* Khối "Thông tin" (Bên trái): Hiển thị tổng quan về tổ chức bao gồm hình ảnh/banner đăng nhập, Mã tổ chức (Code), Tên tổ chức (Name), Trạng thái hoạt động (Status) và Ghi chú (Notes). Có tích hợp biểu tượng chỉnh sửa (cây bút).

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

Khối "Cài đặt" (Bên phải): Nơi cấu hình các tiêu chuẩn hoạt động cốt lõi, bao gồm:

* Cài đặt thời gian & bảo mật: Cấu hình Múi giờ, Định dạng ngày/giờ (kèm hiển thị xem trước) và thiết lập Mật khẩu reset mặc định cho người dùng.
* Cấu hình "Bật đặt tên có quy tắc": Công tắc tổng để kích hoạt tính năng tự động sinh mã hệ thống.
* Danh sách thiết lập quy tắc đặt tên: Được chia thành các nhóm gồm:
  * *Đặt tên danh mục* (Kho hàng, Vị trí, Sản phẩm, Đối tác...).
  * *Đặt tên chứng từ* (Phiếu nhập, Phiếu xuất, Phiếu kiểm kê...).
  * *Cấu hình đặt tên serial & đặt tên lô*.
* Mỗi quy tắc đều có công tắc Bật/Tắt riêng, cột hiển thị Cấu trúc (Template), cột Xem trước (Preview) kết quả, và nút Lưu thay đổi.

***

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

Trước khi tiến hành thiết lập, người quản trị cần chuẩn bị:

* Hình ảnh logo/banner của công ty (nếu có nhu cầu cập nhật thay đổi giao diện đăng nhập).
* Thống nhất quy định về định dạng thời gian chuẩn sẽ dùng chung cho toàn hệ thống.
* Bảng quy chuẩn đặt mã (Naming Convention) của doanh nghiệp cho các danh mục và chứng từ kho (Ví dụ: Phiếu nhập kho luôn bắt đầu bằng `GR-`, Phiếu kiểm kê là `IC-`).
* Quy tắc đánh số Serial và số Lô (Lot) cho sản phẩm (Xác định tiền tố, có kèm ngày tháng không, độ dài chuỗi số chạy tự động là bao nhiêu).

***

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

{% stepper %}
{% step %}
**Cập nhật thông tin cơ bản của tổ chức**

* Tại khối Thông tin (bên trái), nhấn vào biểu tượng Cây bút ở góc trên cùng bên phải.
* Cập nhật các trường dữ liệu cần thiết (Tên, Mã, Ghi chú, Hình ảnh).
* Xác nhận lưu để cập nhật thông tin mới.

<figure><img src="/files/rQVLYlfpqEeARArPwx54" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Thiết lập thời gian và bảo mật**

* Tại khối Cài đặt (bên phải), click vào ô Múi giờ để chọn khu vực phù hợp (VD: `Asia/Ho_Chi_Minh`).
* Nhấn vào biểu tượng Cây bút cạnh Định dạng ngày và Định dạng giờ để chọn cấu trúc hiển thị mong muốn. Chú ý phần text trong ngoặc đơn bên cạnh để xem trước kết quả thực tế (VD: `2026/05/11`).
* Nhập mật khẩu dùng chung vào ô Mật khẩu reset mặc định. Bạn có thể nhấn vào biểu tượng "con mắt" có gạch chéo để hiển thị mật khẩu vừa nhập.
  {% endstep %}

{% step %}
**Thiết lập quy tắc đặt tên tự động (System Naming)**

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

* Gạt công tắc Bật đặt tên có quy tắc sang màu xanh để kích hoạt tính năng.
* Di chuyển xuống các khu vực: *Đặt tên danh mục*, *Đặt tên chứng từ*.
* Gạt công tắc bật (màu xanh) cho những đối tượng bạn muốn hệ thống tự động sinh mã (VD: Vị trí, Loại sản phẩm, Phiếu kiểm kê).
* Quan sát cột Preview để đảm bảo mã hệ thống tự sinh ra đúng với quy chuẩn của doanh nghiệp.

<figure><img src="/files/8zozPo9DLnStqac749za" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Cấu hình quy tắc Serial và Lô chuyên sâu**

* Kéo xuống phần *Cấu hình đặt tên serial* hoặc *Cấu hình đặt tên lô*.
* Bật công tắc kích hoạt cho đối tượng tương ứng.
* Nhấn vào biểu tượng Cây bút ở cuối dòng để mở bảng tuỳ chỉnh chi tiết.
* Thiết lập các khối dữ liệu:
  * Tiền tố: Ký tự cố định đứng đầu (VD: `SN` cho Serial, `LOT` cho Lô).
  * Ngày: Định dạng thời gian đi kèm (VD: `YYMMDD`).
  * Số chạy: Độ dài của dãy số tự tăng (VD: `6` tương đương với `000001`).
* Kiểm tra kết quả hiển thị ở cột Xem trước (VD: `SN-PRD001-260511-000001`).

<figure><img src="/files/AYlwWXS0Wh9OgODrInJX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Lưu cấu hình**

Bắt buộc nhấn nút Lưu thay đổi (màu xanh) nằm bên dưới các khu vực cấu hình để hệ thống ghi nhận các thiết lập vừa tạo.
{% endstep %}
{% endstepper %}

***

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

Tính kế thừa: Khi thay đổi quy tắc đặt tên, định dạng mới sẽ chỉ áp dụng cho các danh mục, chứng từ hoặc serial/lô được tạo mới kể từ thời điểm lưu thành công. Các dữ liệu cũ đã tạo trước đó sẽ giữ nguyên mã cũ, không bị thay đổi hồi tố.

Xung đột mã: Khi tắt tính năng "Bật đặt tên có quy tắc", người dùng sẽ phải tự nhập tay các mã này khi thực hiện nghiệp vụ kho. Cần đảm bảo quản lý chặt chẽ để tránh trùng lặp mã trên hệ thống.

Kiểm tra kỹ lưỡng: Luôn nhìn vào cột "Preview" (Xem trước) trước khi bấm lưu để chắc chắn chuỗi mã được tạo ra đúng ý đồ, đặc biệt quan trọng với hệ thống quy mô lớn có tích hợp in tem nhãn mã vạch.


---

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