# Tích hợp hệ thống KiotViet

Để kết nối KiotViet với hệ thống tồn kho, bạn thao tác theo 5 bước sau:

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

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

Tại menu bên trái, nhấn vào **Tích hợp -> Quản lý plugins** để mở màn hình Quản lý Plugins

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

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

## <mark style="color:blue;">Chọn Plugins KiotViet</mark>

Trên màn hình danh sách plugin, bạn hãy nhấn chọn nút **Thiết lập** tại Plugins KiotViet

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

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

## <mark style="color:blue;">Cấu hình API Keys</mark>

Sau khi chọn plugins KiotViet, tại tab API Keys bạn hãy điền các thông tin sau:

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

* **Tên Connection**: Nhập tên kết nối để nhận diện dễ dàng.
* **Trạng thái**: Chọn trạng thái hoạt động (Hoạt động/Không hoạt động) để kích hoạt hoặc tạm dừng kết nối.
* **Mã chi nhánh**: Nhập mã chi nhánh để chỉ định chi nhánh cụ thể cần đồng bộ dữ liệu
* **Tên chi nhánh**: Nhập tên chi nhánh để ghi nhận thông tin chi nhánh liên kế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

{% hint style="info" %}
Bạn có thể tham khảo bài viết để lấy ***Client ID*** và ***Client Secret*** [tại đây](/data-collect/tich-hop-du-lieu/tich-hop-he-thong-pos-kiot-viet.md)
{% endhint %}

* **Retailer Code**: Nhập mã cưa hàng/ chi nhánh
  {% endtab %}

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

## <mark style="color:blue;">Cài đặt tính năng</mark>

Nhập thông tin để kích hoạt các chức năng đồng bộ, bao gồm các tùy chọn sau:

<figure><img src="/files/3cUBHGKN5Aamkr4uZZfu" alt=""><figcaption></figcaption></figure>

* **Tự động đồng bộ chi nhánh**: Bật/tắt để tự động cập nhật thông tin chi nhánh từ KiotViet
* **Tự động đồng bộ đơn hàng**: Bật/tắt để tự động cập nhật thông tin đơn hàng từ KiotViet
* **Tự động đồng bộ danh mục**: Bật/tắt để tự động cập nhật thông tin danh mục từ KiotViet
* **Tự động đồng bộ sản phẩm**: Bật/tắt để tự động cập nhật thông tin sản phẩm từ KiotViet
* **Webhook cập nhật tồn kho**: Bật/tắt để kích hoạt webhook cập nhật tồn kho theo thời gian thực từ KiotViet&#x20;

{% hint style="info" %}
Lưu ý: Hệ thống tự động khởi tạo webhook khi bật webhook cập nhật tồn kho
{% endhint %}

* **Khoảng thời gian đồng bộ (giây)**: Nhập thời gian (ví dụ: 900 giây) để định kỳ đồng bộ dữ liệu, đảm bảo cập nhật liên tục
  {% endtab %}

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

## <mark style="color:blue;">Kết nối</mark>

Hoàn tất nhập thông tin, bạn hãy nhấn vào nút ![](/files/bXQoeACZ5QTP2ltTHvZV) để hoàn tất kết nối

Tại màn hình plugins KiotViet sẽ hiển thị số tài khoản KiotViet được kết nối thành công

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

{% hint style="info" %}
Doanh nghiệp có thể kết nối nhiều tài khoản của cửa hàng KiotViet với hệ thống tồn kho
{% 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/warehouse/tich-hop-du-lieu/tich-hop-he-thong-kiotviet.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.