# Kết nối Kiotviet
## Tổng quan
Kiotviet là phần mềm bán hàng phổ biến nhất ở Việt Nam, Kiotviet là sản phẩm của công ty Citigo có trụ sở chính tại Hà Nội và văn phòng đại diện ở nhiều tỉnh thành Việt Nam.
Việc kết nối tài khoản Kiotviet vào hệ thống của AppVN hỗ trợ cho người dùng có thể đồng bộ thông tin đơn hàng, vận chuyển, thông tin khách hàng để chăm sóc lại, thông qua hệ thống kịch bản chatbot tự động trên nền tảng AppVN.
## Thao tác
Để kết nối Kiotviet vào AppVN, người dùng thao tác như sau:
* Trên màn hình danh sách kết nối, bấm **+ Thêm** ở góc trên cùng bên phải của màn hình.
* Pop-up tạo kết nối mới hiển thị trên màn hình, người dùng có thể cấu hình như sau.
* **Tên nền tảng:** Đặt tên cho kết nối, ví dụ tên là Kiotviet
* **Nền tảng:** Chọn Kiotviet
* Cập nhật thông tin về Client ID và Mã bảo mật của tài khoản Kiotviet mà người dùng muốn kết nối
* Hướng dẫn lấy Client ID và Mã bảo mật: [Hướng dẫn](https://www.kiotviet.vn/huong-dan-su-dung-kiotviet/thiet-lap-nang-cao/thiet-lap-ket-noi-api/)
* **Tình huống**: Ngườidùng là quản trị viên của gian hàng và cần lấy thông tin API(Client ID, Mã bảo mật) để cung cấp cho đối tác kỹ thuật tích hợp hệ thống.
* **Thao tác thực hiện như sau:**
1. Từ màn hình Quản lý, vào menu **Thiết lập** → **Cửa hàng**.
2. Trên menu bên trái màn hình, bạn chọn **Kết nối API** → nhấn ***Chỉnh sửa***
3. Nhập số điện thoại trên hợp đồng để nhận mã xác thực → nhấn ***Nhận mã xác thực***.
4. Nhập mã xác thực hệ thống gửi về số điện thoại trên → chọn ***Tiếp tục***.
5. Tại thông tin Mã bảo mật → nhấn **Tạo mã**
6. Đọc kỹ điều khoản sử dụng và tích chọn đồng ý → nhấn ***Đồng ý***
7. Tích chọn: ***Cho phép truy xuất thông tin khách hàng, hoá đơn, đặt hàng từ gian hàng của bạn*** và ***Lưu*** thông tin
8. Bạn cung cấp thông tin về Client ID và Mã bảo mật cho bên thứ 3 truy xuất dữ liệu trên gian hàng
* Sau khi bấm Lưu và nhận được thông báo Thiết lập thành công, copy Client ID và Mã bảo mật và dán vào phần Tạo kết nối mới bên AppVN.
* **Chi nhánh đồng bộ đơn hàng và Kho đồng bộ đơn hàng:** tự động gắn chi nhánh và kho cho đơn hàng được đồng bộ về AppVN
* **Kích hoạt webhook:** để nhận thông tin Đơn hàng, Hóa đơn đồng bộ từ Kiotviet đồng bộ về AppVN
* **Đồng bộ:** cập nhật thông tin đơn hàng từ AppVN sang Kiotviet (chỉ đồng bộ đơn hàng sang Kiot dưới dạng hóa đơn)
* Yêu cầu cập nhật thêm chi nhánh cho đơn được đồng bộ về Kiotviet
* Người dùng tích chọn kích hoạt và bấm **Thêm** để hoàn thành việc kết nối.
### **Trạng thái đơn**
Các trạng thái đơn hàng khi đơn hàng được đồng bộ từ Kiotviet sang AppVN:
* Đơn đặt (Chưa chuyển hóa đơn)
| Kiotviet | AppVN |
| ---------- | ---------- |
| Tạo mới | Nháp |
| Đang xử lý | Lên đơn |
| Đang giao | Đang giao |
| Hoàn thành | Hoàn thành |
| Đã hủy | Đã hủy |
* Hóa đơn (Sau khi đơn đặt chuyển sang hóa đơn thì sẽ ưu tiên theo trạng thái của hóa đơn)
| Kiotviet | AppVN |
| --------------- | ----------- |
| Đang xử lý | Lên đơn |
| Không giao được | Đã gửi hàng |
| Hoàn thành | Hoàn thành |
| Đã hủy | Đã hủy |
---
# Agent Instructions: 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://tailieu.smax.app/tai-lieu-huong-dan-app.vn/su-dung-app.vn/tich-hop/ket-noi-nen-tang/ket-noi-kiotviet.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.