# Tích hợp hệ thống POS Kiot Viet

Đối với các hệ thống POS KiotViet, HUB Platform hỗ trợ doanh nghiệp đồng bộ thông tin về Khách hàng, Đơn hàng và Hoá đơn.

## <mark style="color:blue;">Thao tác trên hệ thống KiotViet</mark>

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Vào cài đặt của KiotViet</mark>

Tại trang quản lý của tài khoản Kiot Viet, chọn bánh răng cài đặt ![](/files/A1kOOlJ7vLhd3r3gDJHp) tại góc phải trên màn hình.

Ở trình đơn thả xuống, chọn mục "**Thiết lập cửa hàng**".

<figure><img src="/files/5GV6udVfK7AjrNOBuuko" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">Vào cài đặt kết nối API</mark>

Khi vào màn hình cài đặt, ở thanh menu bên trái, hãy kéo danh mục cài đặt xuống cuối trang, sau đó chọn mục "**Thiết lập kết nối API**".

<figure><img src="/files/DZ8V22hOEZC75AmO7nEY" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 3" %}

### <mark style="color:blue;">Thiết lập kết nối</mark>

Tại màn hình **Thiết lập kết nôí API,** bạn hãy điền đầy đủ các thông tin dưới đây:

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

* **Tên kết nối**: Tên kết nối API được lấy từ subdomain của tài khoản quản lý. Bạn có thể xem cách lấy tên tài khoản như hình sau:

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

* **Client ID:** Client ID là ID được sử dụng để định danh duy nhất cho khách hàng sử dụng hệ thống. Client ID đã được hệ thống tạo lập sẵn, do đó người dùng không cần tạo mới hay điền vào.

{% hint style="warning" %}
Lưu ý:&#x20;
{% endhint %}

* **Mã bảo mật:** Click chọn nút ![](/files/VXrKIGV8YalTTBsJztwn) -> Sau đó, bạn tick vào *"Tôi đã đọc và đồng ý điều khoản"* -> Nhấn **Đồng ý** để được cấp mã bảo mật.

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

{% hint style="info" %}
**Lưu ý:** Bạn cần copy giá trị của 3 trường **Tên kết nối, Client ID** và **Mã bảo mật** để điền thông tin kết nối trên hệ thống của HUB Platform.
{% endhint %}

* Nhấn chọn **Hoạt động** và **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.**

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

Cuối cùng, nhấn **Lưu** để kích hoạt API.
{% endtab %}
{% endtabs %}

## <mark style="color:blue;">Thao tác trên hệ thống HUB Platform</mark>

{% tabs %}
{% tab title="Bước 1" %}

### <mark style="color:blue;">Truy cập vào Quản lý Plugin</mark>

Tại màn hình trang chủ hệ thống CDP, nhấn vào biểu tượng **Cài đặt -> Quản lý nền tảng -> Plugins** để vào trang quản lý danh sách các Plugin của hệ thống

<figure><img src="/files/jHsPTJT69HI6Hb17M27q" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 2" %}

### <mark style="color:blue;">**Chọn Plugin Kiot Viet**</mark>

Bạn có thể gõ trên thanh tìm kiếm hoặc tìm trực tiếp trên màn hình danh sách để chọn plugin **KiotViet**

<figure><img src="/files/rIb96ejjlCR4yq9ZmYoV" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bước 3" %}

### <mark style="color:blue;">Thông tin chi tiết</mark>

Sau khi chọn, hãy điền các thông tin chi tiết để hoàn thành kết nối API KiotViet và HUB Platform, bao gồm các thông tin sau:

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

* Chọn "**CÓ**" trong mục **Xuất bản** để đồng ý kích hoạt API.
* **Connect Name**: Copy thông tin "Tên kết nối" từ Kiot Việt.
* **Client ID**: copy thông tin "Client ID" từ Kiot Việt.
* **Client Secret**: copy thông tin "Mã bảo mật" từ Kiot Việt.

Ở plugin KiotViet, doanh nghiệp có thể kết nối nhiều cửa hàng/chi nhánh của cửa hàng KiotViet với hệ thống CDP.

{% hint style="info" %}
Trường hợp doanh nghiệp sử dụng nhiều tài khoản Kiot Việt để quản lý đơn hàng, hóa đơn theo nghiệp vụ, hệ thống hỗ trợ cho phép kết nối tất cả các tài khoản KiotViet về chung một hệ thống để quản lý và chăm sóc.
{% endhint %}

Để tạo mới tài khoản, nhấn chọn ![](/files/KwpNCUHVHdttpV8ZVvU6), màn hình sinh ra thêm các trường thông tin của tài khoản mới:

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

Bạn nhập thông tin tương tự như trên.
{% endtab %}

{% tab title="Bước 4" %}

### <mark style="color:blue;">Lưu kết nối</mark>

Chọn **Lưu** hoặc **Lưu & Đóng** để lưu thao tác kết nối giữa KiotViet và HUB Platform.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Trong quá trình kết nối, nếu bạn gặp vấn đề ở bất kỳ bước nào, vui lòng liên hệ với HUB để nhận được hỗ trợ thông qua các nhóm làm việc chung hoặc qua hotline 032.817.9699
{% endhint %}


---

# 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://help-cdp.hub-js.com/data-collect/tich-hop-du-lieu/tich-hop-he-thong-pos-kiot-viet.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.