> 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/partners.md).
# Đối tác
### TỔNG QUAN
**Mục đích sử dụng:** Quản lý tập trung toàn bộ thông tin các đơn vị có giao dịch với doanh nghiệp (Khách hàng, Nhà cung cấp, Đơn vị vận chuyển). Đây là cơ sở dữ liệu nền (Master Data) để thực hiện các nghiệp vụ Nhập/Xuất kho và quản trị chuỗi cung ứng.
**Đối tượng sử dụng:** Nhân viên thu mua, Nhân viên kho, Bộ phận kế toán và Quản trị hệ thống.
**Thời điểm thực hiện:** (\*) Khi có đối tác mới phát sinh giao dịch.
* Khi cần cập nhật thay đổi thông tin liên hệ, mã số thuế hoặc trạng thái hoạt động của đối tác cũ.
***
### DỮ LIỆU CẦN CHUẨN BỊ TRƯỚC
Để đảm bảo tính chính xác của hệ thống, người dùng cần chuẩn bị:
* Thông tin pháp lý: Tên đầy đủ trên giấy phép kinh doanh, Mã số thuế chính xác.
* Thông tin liên lạc: Số điện thoại, Email và đặc biệt là Địa chỉ giao nhận (để hiển thị trên phiếu kho).
* Quy ước đặt mã: Nếu doanh nghiệp tự quản lý mã (ví dụ: NCC\_VIN\_001), cần chuẩn bị danh sách mã theo quy chuẩn nội bộ.
***
### MÔ TẢ GIAO DIỆN
Giao diện được thiết kế tối giản, tập trung vào trải nghiệm người dùng với các khu vực chính:
#### Màn hình Danh sách Đối tác
* Thanh công cụ phía trên: Chứa nút \[Thêm mới] (màu xanh dương) để khởi tạo đối tác và ô \[Tìm kiếm] đa năng (tìm theo tên, mã, số điện thoại).
* Bảng dữ liệu (Grid View): Hiển thị danh sách đối tác với các cột thông tin: *Mã đối tác, Tên đối tác, Phân loại, Mã số thuế, Số điện thoại, Địa chỉ và Trạng thái*.
* Cột Thao tác: Nằm ở cuối mỗi dòng, chứa biểu tượng \[Chỉnh sửa] (hình cây bút) giúp truy cập nhanh vào hồ sơ đối tác đó.
#### Màn hình Thêm mới/Chỉnh sửa
* Thông tin định danh: Nhóm các trường Mã đối tác (tự động/thủ công), Tên đối tác và Phân loại (Dropdown menu).
* Thông tin chi tiết: Khu vực nhập Mã số thuế, Email, Số điện thoại và Địa chỉ.
* Trạng thái: Nút gạt (Toggle) hoặc Checkbox để chuyển đổi giữa *Hoạt động* và *Ngừng hoạt động*.
* Khu vực điều hướng: Nút \[Hủy] và \[Lưu/Thêm mới] nằm ở góc dưới bên phải.
***
### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN
#### Thêm mới Đối tác
* Truy cập: Từ menu chính, chọn Danh mục > Đối tác.
* Khởi tạo: Nhấn nút \[Thêm mới] ở góc trên bên phải màn hình.
* Nhập liệu:
* Tên đối tác: Nhập tên công ty hoặc cá nhân.
* Phân loại: Chọn đúng nhóm (Khách hàng/Nhà cung cấp/Vận chuyển).
* Thông tin khác: Điền Mã số thuế, Số điện thoại và Địa chỉ (bắt buộc).
* Hoàn tất: Kiểm tra lại thông tin và nhấn \[Thêm mới]. Hệ thống sẽ thông báo thành công và hiển thị đối tác tại danh sách.
#### Chỉnh sửa thông tin
* Tìm kiếm: Sử dụng thanh tìm kiếm để lọc ra đối tác cần sửa.
* Mở form: Nhấn vào biểu tượng \[Cây bút] tại cột Thao tác của dòng tương ứng.
* Cập nhật: Thay đổi các thông tin cần thiết (ví dụ: cập nhật số điện thoại mới hoặc đổi trạng thái sang "Ngừng hoạt động" nếu không còn hợp tác).
* Lưu: Nhấn \[Lưu thay đổi] để cập nhật hồ sơ.
***
### VÍ DỤ THỰC TẾ
Giả sử doanh nghiệp cần thêm mới một Nhà cung cấp thực phẩm. Cách điền thông tin như sau:
* Mã đối tác: Để trống (hệ thống tự sinh mã).
* Tên đối tác: Công ty TNHH Thực phẩm Sạch Việt Nam.
* Phân loại: Chọn Nhà cung cấp.
* Mã số thuế: 0101234567.
* Địa chỉ: Số 10, Đường Hoa Mai, Quận Phú Nhuận, TP.HCM.
* Trạng thái: Hoạt động.
* Nhấn \[Lưu].
***
### LƯU Ý CHUNG KHI SỬ DỤNG (TÌNH HUỐNG & XỬ LÝ LỖI)
| Tình huống / Lỗi | Nguyên nhân | Cách xử lý |
| ------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Báo lỗi "Trùng mã đối tác" | Mã bạn nhập thủ công đã tồn tại (có thể nằm ở bản ghi đã bị ẩn/ngừng hoạt động). | Thay đổi mã khác hoặc để trống để hệ thống tự sinh mã duy nhất. |
| Nút \[Lưu] không sáng hoặc báo đỏ | Bạn chưa nhập các trường bắt buộc như Tên đối tác hoặc Địa chỉ. | Kiểm tra các trường có đánh dấu sao đỏ (\*) hoặc viền đỏ để bổ sung thông tin. |
| Không tìm thấy đối tác khi lập phiếu kho | Đối tác đang ở trạng thái "Ngừng hoạt động". | Vào phần Quản lý đối tác, chỉnh sửa và chuyển trạng thái sang "Hoạt động". |
| Nhập mã số thuế bị sai định dạng | Mã số thuế chứa ký tự đặc biệt hoặc quá dài. | Kiểm tra lại số ký tự (tối đa 255) và đảm bảo chỉ chứa số/gạch nối theo quy định thuế. |
| Trùng lặp đối tác (Tên khác nhưng cùng MST) | Do người dùng trước đó đã tạo hồ sơ nhưng chưa kiểm tra kỹ. | Trước khi thêm mới, luôn thực hiện tìm kiếm theo Mã số thuế để kiểm tra sự tồn tại của đối tác. |
---
# 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/partners.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.