> For the complete documentation index, see [llms.txt](https://huongdan.cnvloyalty.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/ket-noi-kiot-viet.md).

# Kết nối Kiot Viet - Retail (Cũ)

## Những điều cần lưu ý

| STT | Lưu ý                                                                                                                    |
| :-: | ------------------------------------------------------------------------------------------------------------------------ |
|  1  | Cần **kiểm tra kỹ** và **nhập đúng** các thông tin kết nối KOV ở Loyalty Hub                                             |
|  2  | Sau khi kết nối, vui lòng **không thay đổi thông tin** trong quá trình CNV đồng bộ dữ liệu                               |
|  3  | Một tài khoản KOV chỉ kết nối với một shop duy nhất                                                                      |
|  4  | Nên tích hợp một POS/một Hub để tránh trùng lặp dữ liệu đồng bộ giữa các POS                                             |
|  5  | <p>Tài khoản kết nối phải là</p><ul><li>Admin của Loyalty Hub</li><li>Admin của Kiot Việt</li></ul>                      |
|  6  | Chỉ **đồng bộ** dữ liệu **trong thời gian kết nối**, các dữ liệu trong thời gian ngắt kết nối sẽ **không được đồng bộ.** |

## Bảng giá đồng bộ dữ liệu cũ

* [Bảng giá chi tiết](https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/dong-bo-du-lieu-cu)

## Thông tin đồng bộ CNV và Kiot Việt Retail

<table data-header-hidden><thead><tr><th width="223">Danh mục</th><th align="center">Chiều</th><th>Thông tin đồng bộ</th><th>Hoạt động đồng bộ</th></tr></thead><tbody><tr><td>Danh mục</td><td align="center">Chiều</td><td>Thông tin đồng bộ</td><td>Hoạt động đồng bộ</td></tr><tr><td>Đơn Hàng</td><td align="center">2</td><td><p>CNV → Kiot Việt</p><ul><li>Đồng bộ từ <a href="https://huongdan.cnvloyalty.com/tinh-nang/don-hang/tat-ca-don-hang/tao-don-hang">Đặt hàng</a></li></ul></td><td>CNV Thêm, Hủy</td></tr><tr><td></td><td align="center"></td><td><p>Kiot Việt → CNV</p><ul><li><p>Đồng bộ từ <a href="https://huongdan.cnvloyalty.com/tinh-nang/don-hang/tat-ca-don-hang/tao-don-hang">Đặt hàng</a> </p><p>hoặc Hóa đơn</p></li></ul></td><td>KOV Thêm, Sửa</td></tr><tr><td>Sản phẩm</td><td align="center">1</td><td>Kiot Việt→ CNV</td><td>KOV Thêm, Sửa, Xóa</td></tr><tr><td>Nhóm sản phẩm </td><td align="center">1</td><td>Kiot Việt → CNV</td><td>KOV Thêm, Sửa</td></tr><tr><td>Khách Hàng</td><td align="center">2</td><td>CNV → Kiot Việt</td><td>CNV Thêm, Sửa</td></tr><tr><td></td><td align="center"></td><td>Kiot Việt → CNV <br>Thông tin khách hàng được đồng bộ theo đơn hàng</td><td>KOV Thêm, sửa</td></tr></tbody></table>

## Import dữ liệu cũ bằng File Excel

### Bước 1: Tải về mẫu Excel

{% file src="/files/-MiqsAxU8rm\_CFeqX0ZU" %}
Mẫu file Khách hàng
{% endfile %}

{% file src="/files/-Mir8aMxQVxCWQFjLsDW" %}
Mẫu file Đơn hàng
{% endfile %}

{% file src="/files/-Mir5YQwd1PcxBdd1\_S3" %}
Mẫu file Nhóm sản phẩm
{% endfile %}

{% file src="/files/-MiqsXOQvLOeOmwRpDIM" %}
Mẫu file Sản phẩm
{% endfile %}

### Bước 2: Nhập dữ liệu theo mẫu Excel

* [Hướng dẫn Import dữ liệu](https://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/import-du-lieu-cu)

### Bước 3: Liên hệ CNV Loyalty để cập nhật dữ liệu

* Email: <cskh@cnvloyalty.com>

## Tổng quan các thông tin đồng bộ KiotViet - Retail

### Sản phẩm (Đồng bộ 1 chiều)

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

### Nhóm sản phẩm (Đồng bộ 1 chiều)

<figure><img src="/files/4Ko9cO0dgEr0ujNtsRm5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
KOV sản phẩm có quan hệ cha con nên khi đồng bộ về CNV sẽ vào danh mục sản phẩm thay vì nhóm sản phẩm.

Cấu hình danh mục để show lên Mini App vẫn theo nhóm sản phẩm&#x20;

\=> Ở HUB CNV, Tạo nhóm sản phẩm tự động sau đó chọn các danh mục sản phẩm muốn hiển thị trên Mini App&#x20;

Mini App sẽ hiển thị tất cả sản phẩm có trong danh mục sản phẩm thuộc nhóm sp đã được setup trong cấu hình danh mục
{% endhint %}

### Đơn hàng (Đồng bộ hai chiều và xử lý đơn hàng bên KOV)

<figure><img src="/files/F2dGy3LZhm6uviecvg7g" alt=""><figcaption><p>Đơn hàng KOV -> CNV</p></figcaption></figure>

<figure><img src="/files/dYSDpwaKz0IGyDX2Vx6Z" alt=""><figcaption><p>Đơn hàng CNV -> KOV</p></figcaption></figure>

### Khách hàng (Đồng bộ 2 chiều)

#### Luồng đồng bộ khách hàng từ KOV -> CNV sẽ đồng bộ theo số điện thoại trên hoá đơn/ đơn hàng. Khi thao tác cập nhật khách hàng trên KOV sẽ không đồng bộ về CNV.&#x20;

<figure><img src="/files/jXzAb9Ucbi9QGrSh1aHm" alt=""><figcaption><p>Khách hàng CNV -> KOV</p></figcaption></figure>

{% hint style="info" %}
Lưu ý: Đối với việc đồng bộ khách hàng, sẽ ko đồng bộ địa chỉ mặc định của khách hàng từ POS về CNV, vì các field địa chỉ ở POS khác với CNV nên khi đồng bộ địa chỉ khách hàng về CNV sẽ ko map theo các trường (tỉnh, tp, quận huyện xã phường ...), chỉ đổ về trường địa chỉ cụ thể, ảnh hưởng tới trải nghiệm khách hàng mua hàng và việc hiển thị phí vận chuyển theo setup của doanh nghiệp
{% endhint %}

## Kết nối Kiot Việt

### Bước 1: Lấy thông tin kết nối ở Kiot Việt

### 1. Doanh nghiệp chưa có tài khoản Kiot Việt

* [Đăng ký Kiot Việt](https://www.kiotviet.vn/dang-ky/)

![](/files/-MdHudszNyEjfwZsxmrB)

### 2. Doanh nghiệp đã có tài khoản Kiot Việt

* Truy cập Kiot Việt theo đường dẫn *Tên gian hàng* đã đăng ký
  * Ví dụ: <https://cnvloyalty.kiotviet.vn>
* Vào Thiết lập ➝ Thiết lập cửa hàng ➝ Thiết lập kết nối API

![](/files/-MdHRI1HTKrPpYJpovgp)

{% hint style="info" %}
Lưu ý: 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
{% endhint %}

* &#x20;Lấy thông tin kết nối
  1. Retailer: tên shop ở đường dẫn *Tên gian hàng* đã đăng ký
     * Ví dụ: <https://cnvloyalty.kiotviet.vn>
       * Lấy thông tin Retailer: cnvloyalty (như hình bên dưới)
  2. Client ID
  3. Client Secret: mã bảo mật

![](/files/-Me8mngTBqe7VezwvaMG)

{% hint style="success" %}

* Cài đặt *Hoạt động* để Kiot Việt cấp quyền truy xuất dữ liệu cho Loyalty Hub
  * Chọn Hoạt động
  * 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
    {% endhint %}

### Bước 2: Vào Cấu hình ➝ Cổng kết nối dữ liệu

![](/files/-Mcjbb6QVUS6tcM1dgmr)

### Bước 3: Chọn Thêm Cổng kết nối

![](/files/-McjcOhl9edPEPEpLNe7)

### Bước 4: Thêm Kiot Việt

![](/files/-MdxxpMT0Q9uVLCpkW07)

### Bước 5: Kích hoạt Kiot Việt

1. Chọn Kết nối
2. Nhập thông tin đã lấy ở bước 1
   * Retailer: tên shop ở đường dẫn *Tên gian hàng* đã đăng ký
     * Ví dụ: <https://cnvloyalty.kiotviet.vn>
       * Lấy thông tin Retailer: cnvloyalty
   * Client ID
   * Client Secret: mã bảo mật
   * Đồng bộ đơn hàng: đồng bộ ở chiều KOV → CNV
     * Chọn Đặt hàng hoặc Hóa đơn
       * [Hướng dẫn Đặt hàng](https://huongdan.cnvloyalty.com/tinh-nang/don-hang/tat-ca-don-hang/tao-don-hang)
     * Sau khi kết nối, các đơn hàng từ KOV → CNV sẽ tự động đồng bộ theo loại dữ liệu đã chọn
3. Chọn Kích hoạt

{% hint style="info" %}
Lưu ý:

* Lựa chọn đúng Đặt hàng hoặc Hóa đơn nếu không sẽ không đồng bộ được đơn hàng
  {% endhint %}

![](/files/-MeYb3BayZye9XwsIHNz)

### Bước 6: Kích hoạt Cổng kết nối Kiot Việt

* Chọn Kích hoạt

![](/files/-MeYayD1gRojve9BSevd)

### Kết nối Kiot Việt thành công

![](/files/-MeYeS7-oPSi3_bEpIVb)