> For the complete documentation index, see [llms.txt](https://help-cdp.hub-js.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help-cdp.hub-js.com/warehouse/tich-hop-du-lieu/tich-hop-he-thong-kiotviet.md).

# 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 %}