> 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

Chức năng này cho phép đồng bộ dữ liệu sản phẩm và tồn kho theo thời gian thực, hỗ trợ quản lý hệ thống tồn kho đa kênh hiệu quả.

Để 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="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FYmwUu6dbtMwUO7Y6V3wM%2Fimage.png?alt=media&amp;token=7e347072-2f30-4265-b7ce-47278f2a8fa4" 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="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FwOwBL4yvqaUJaS2hqSZ8%2Fimage.png?alt=media&amp;token=c2e3152d-bc20-4248-9256-ab1fb8c27111" 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="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FegLJgndylJyqJt7pDHo9%2Fimage.png?alt=media&amp;token=d0885ed6-f0c5-49a9-9995-bbf0dd6c0013" 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="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2FAJxAl1AHG26Gajf4sCGc%2Fimage.png?alt=media&amp;token=d4f07bb8-ccf1-4895-8990-4ce231ab9f42" 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 ![](https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2Fyfrpj9I5XliwsGxZ7XAH%2Fimage.png?alt=media\&token=ad2752a4-5cf6-4676-bef6-338fa023f572) để 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="https://2695816526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIPMaahbinE4mnaANuMqj%2Fuploads%2F5c7hRavGk6omBctnUi6k%2Fimage.png?alt=media&amp;token=489ce17e-6d0f-4789-a112-d65982d147cc" 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 %}