# Kết nối KiotViet - FnB

## 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ộ.** |

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

<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>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>CNV → Kiot Việt<br>Thông tin khách hàng được đồng bộ theo đơn hàng</td><td>KOV Thêm, sửa</td></tr><tr><td>Đơn hàng</td><td align="center">1</td><td>Kiot Việt→ CNV</td><td>KOV Thêm, Sửa, Xó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 - FnB

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

<figure><img src="/files/X7uUCsx4QFgPLc4rSeMC" alt=""><figcaption><p>Sản phẩm KOV -> CNV</p></figcaption></figure>

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

<figure><img src="/files/QT4wX3ZmA7wvdSrGgDRa" 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 %}

### 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.

<figure><img src="/files/5oTNXNlqXRRPd05pzaJW" 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 %}

### Đơn hàng (Đồng bộ 1 chiều)

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

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

* Bấm vào link sau: <https://www.kiotviet.vn/dang-ky/>

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

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

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

{% 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

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

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

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

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

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

<figure><img src="/files/618udFdCbOFiBUUWNwDI" alt=""><figcaption></figcaption></figure>

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

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

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

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
3. Chọn Kích hoạt

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

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

* Chọn Kích hoạt -> Kết nối thành công

<figure><img src="/files/n2hSPoGCDhMjcIvSxCo8" alt=""><figcaption><p>Kích hoạt</p></figcaption></figure>


---

# 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://huongdan.cnvloyalty.com/tinh-nang/cau-hinh/cong-ket-noi-du-lieu/ket-noi-kiotviet-fnb.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.