> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agent-x.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# KiotViet

> Tích hợp với KiotViet

## Tích hợp AI Agent với KiotViet

Tích hợp KiotViet giúp Agent-X lên đơn hàng, kiểm tra đơn hàng,... hỗ trợ tự động hóa quy trình bán hàng và chăm sóc khách hàng.

***

### **Bước 1:** Yêu cầu trước khi bắt đầu

* Bạn đã có tài khoản **KiotViet** và quyền quản trị hệ thống
* Đã tạo cửa hàng trên hệ thống KiotViet
* Bạn đã thiết lập các thông tin API cửa hàng của bạn trên hệ thống KiotViet

***

### **Bước 2:** Các bước tích hợp

* Truy cập tab `Tích hợp`
* Kéo xuống phần **Nền tảng quản lý đơn hàng**
* Tìm **KiotViet** → Nhấn **Kết nối**

  <img src="https://mintcdn.com/agent-x/cEjo8yKsQO_mesm1/images/kiotviet1.png?fit=max&auto=format&n=cEjo8yKsQO_mesm1&q=85&s=57b9a194bdbf7b408781135be49d4b36" alt="Kiotviet1 Pn" width="1918" height="788" data-path="images/kiotviet1.png" />
* Màn hình thiết lập thông tin kết nối hiện ra

  <img src="https://mintcdn.com/agent-x/cEjo8yKsQO_mesm1/images/kiotviet3.png?fit=max&auto=format&n=cEjo8yKsQO_mesm1&q=85&s=9c6d0e7c304bc623c34d9c99f705c1c0" alt="Kiotviet3 Pn" title="Kiotviet3 Pn" style={{ width:"40%" }} width="497" height="577" data-path="images/kiotviet3.png" />

***

### **Bước 3:** Thiết lập thông tin API

* Trong giao diện quản lý KiotViet, truy cập vào **Thiết lập -> Cửa hàng -> Kết nối API**
* Nhập thông tin API lấy từ KiotViet vào các trường tương ứng gồm: `Tên kết nối`, `Client ID`, `Mã bảo mật`

  <img src="https://mintcdn.com/agent-x/cEjo8yKsQO_mesm1/images/kiotviet2.png?fit=max&auto=format&n=cEjo8yKsQO_mesm1&q=85&s=97a2a938f64dccb1b8da0e4d5c1280b8" alt="Kiotviet2 Pn" width="1918" height="863" data-path="images/kiotviet2.png" />
* Nhấn nút **Kiểm tra kết nối**
* Nếu hệ thống kết nối thành công, nhấn nút **Lưu** để lưu lại thông tin API

***

### **Bước 4:** Kiểm tra hoạt động

* Bạn có thể yêu cầu AI Agent đặt đơn hàng, hệ thống sẽ tự động tạo đơn hàng với các thông tin mà bạn cung cấp trên KiotViet
* Để Agent đặt được đơn hàng thành công trên KiotViet, cần đảm bảo:
  * `Mã sản phẩm mà Agent đã học phải khớp với mã sản phẩm đang có trên KiotViet`
  * `Sản phẩm phải còn tồn kho`

***

### Lưu ý

* Nếu thay đổi API key hoặc thông tin đăng nhập KiotViet, bạn cần **kết nối lại**
* Một số chức năng nâng cao yêu cầu nâng cấp gói dịch vụ Agent-X