> 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-ipos.md).

# Kết nối iPOS

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

<table data-header-hidden><thead><tr><th width="110" align="center">STT</th><th>Lưu ý</th></tr></thead><tbody><tr><td align="center">1</td><td>Cần <strong>kiểm tra kỹ</strong> và <strong>nhập đúng</strong> các thông tin kết nối iPOS ở Loyalty Hub</td></tr><tr><td align="center">2</td><td>Sau khi kết nối, vui lòng <strong>không thay đổi thông tin</strong> trong quá trình CNV đồng bộ dữ liệu</td></tr><tr><td align="center">3</td><td>Một tài khoản iPOS chỉ kết nối với một tài khoản Loyalty Hub</td></tr><tr><td align="center">4</td><td>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</td></tr><tr><td align="center">5</td><td><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 iPOS</li></ul></td></tr><tr><td align="center">6</td><td>Đối với POS IPOS, CNV <mark style="color:orange;"><strong>có tuỳ chọn nâng cao</strong></mark> <em>(có trả phí)</em> để đồng bộ đơn hàng từ chi nhánh A ở IPOS qua chi nhánh A ở CNV <em>(chi nhánh A là tên 1 chi nhánh)</em><br><em>-> Để sử dụng đồng bộ theo chi nhánh vui lòng xem hướng dẫn</em> <a href="/pages/-MbaBBSWBdmN-DTn-UIC#nhap-id-pos"><em>tại đây</em></a></td></tr><tr><td align="center">7</td><td>Chỉ <strong>đồng bộ</strong> dữ liệu <strong>trong thời gian kết nối</strong>, các dữ liệu trong thời gian ngắt kết nối sẽ <strong>không được đồng bộ.</strong></td></tr></tbody></table>

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

| Danh mục      | Chiều | Thông tin đồng bộ                                                        | Hoạt động đồng bộ |
| ------------- | :---: | ------------------------------------------------------------------------ | ----------------- |
| Đơn hàng      |   2   | CNV → iPOS                                                               | CNV Thêm          |
|               |       | iPOS → CNV                                                               | iPOS Thêm         |
| Sản phẩm      |   1   | iPOS → CNV                                                               | iPOS Thêm, Sửa    |
| Nhóm sản phẩm |   1   | iPOS → CNV                                                               | iPOS Thêm, Sửa    |
| Khách hàng    |   2   | CNV → iPOS                                                               | CNV Thêm, Sửa     |
|               |       | <p>iPOS → CNV</p><p>Khách hàng ở iPOS phát sinh </p><p>theo đơn hàng</p> | iPOS Thêm         |

### Luồng đồng bộ đơn hàng

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

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

### Luồng đồng bộ khách hàng

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

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

### Luồng đồng bộ Sản phẩm

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

### Luồng đồng bộ Nhóm sản phẩm

<figure><img src="/files/65DvLBYspeNZeiQjNt0R" alt=""><figcaption><p>Nhóm sản phẩm iPOS -> CNV</p></figcaption></figure>

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

## Kết nối iPOS

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

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

1. [Liên hệ iPOS](https://ipos.vn/) ký hợp đồng
2. iPOS sẽ cung cấp thông tin
   * Tên thương hiệu
   * Tài khoản đăng nhập
     * [iPOS CRM](https://crm.ipos.vn/vi/)
     * [Foodbook Hub](https://partner.foodbook.vn/)

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

* Truy cập [Foodbook Hub](https://partner.foodbook.vn/)
  * Lấy thông tin ID Token: là tên nhà hàng đã đăng ký

![](/files/-MkFXd2X3jx-NqcROLyr)

1. Vào Cấu hình
2. Lấy thông tin Token Value: Access Token
3. Nhập Call Back URL **(bắt buộc)**
   * Chọn :pen\_ballpoint:&#x20;
   * Nhập URL để gọi lệnh kết nối từ iPOS đến CNV như sau:
     * <https://integration.cnvloyalty.com/ipos/hook>
   * Chọn Save

![](/files/-MkFUfojARe4ONKhs8Xb)

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

![](/files/-MdxyQjLKN3_btCOC-Ct)

### Bước 5: Kích hoạt iPOS

1. Chọn Kết nối
2. Nhập thông tin đã lấy ở bước 1
   * ID Token: tên nhà hàng đã đăng ký
   * Token Value: Access Token
3. Chọn Kích hoạt

![](/files/-Me-9RskZ-rz93RuSQWt)

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

* Chọn Kích hoạt

![](/files/-Mea0u5Wof3-oUKxjGVM)

### Kết nối iPOS thành công

![](/files/-Me-CNlJrsDj9bOPocXV)