> 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

iPOS là người bạn đồng hành đắc lực cùng chủ đầu tư kinh doanh F\&B. Hỗ trợ vận hành thương hiệu nhà hàng/café/trà sữa trở nên nhanh hơn, hiệu quả hơn và đón đầu xu thế

## 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="/tinh-nang/cau-hinh/dia-diem.md#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="https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2F4PgH5WebNBfqPRs0IFbr%2Fimage.png?alt=media&amp;token=39793cea-5a59-4ef3-ab16-a7b7cb0d7aab" alt=""><figcaption><p>Đơn hàng iPOS -> CNV</p></figcaption></figure>

<figure><img src="https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FZH5aeF6Mq3xQVVmDKrz0%2Fimage.png?alt=media&amp;token=17e4950c-b828-48a5-8a2d-f006d6ac5c86" alt=""><figcaption><p>Đơn hàng CNV -> iPOS</p></figcaption></figure>

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

<figure><img src="https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2F1o27Pg6N0A6JYlOtnOGw%2Fimage.png?alt=media&amp;token=8daeefa1-d5ae-44bb-86b6-92ab20590678" alt=""><figcaption><p>Khách hàng iPOS -> CNV</p></figcaption></figure>

<figure><img src="https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FEUvkaLaTis8OrMMwj8tQ%2Fimage.png?alt=media&amp;token=2bb7f52c-afaa-4ea8-8249-cdd1df2adf5d" alt=""><figcaption><p>Khách hàng CNV -> iPOS</p></figcaption></figure>

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

<figure><img src="https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2FVOf0zX7MIJf0FqqNNRqq%2Fimage.png?alt=media&amp;token=37f057a4-53d4-45fe-bead-07ab2f6ff511" 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="https://58134727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaSrApVr5L1rdZPZEAx%2Fuploads%2F9rtQmcnKHrEXIhy2clDz%2Fimage.png?alt=media&amp;token=12f44449-7a57-4c0f-a594-481eb4b173ce" 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ý

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-MkFSkvOHVK9eE37AttK%2F-MkFXd2X3jx-NqcROLyr%2Fimage.png?alt=media\&token=f4e9950f-2350-4c4e-90a2-2b66d6eafbd9)

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

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-MkFSkvOHVK9eE37AttK%2F-MkFUfojARe4ONKhs8Xb%2Fimage.png?alt=media\&token=8798c56a-1d03-4cb0-8f44-c4013f692d80)

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

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-Mcjaonb5hUG2nlZLmMx%2F-Mcjbb6QVUS6tcM1dgmr%2Fimage.png?alt=media\&token=4915b1e8-c2a5-40b9-b0e8-32690172f89d)

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

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-Mcjaonb5hUG2nlZLmMx%2F-McjcOhl9edPEPEpLNe7%2Fimage.png?alt=media\&token=729c351f-cd4e-4738-9599-9f1b3fa6438e)

### Bước 4: Thêm iPOS

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-MdvJfROYDMIeaEZJ3UZ%2F-MdxyQjLKN3_btCOC-Ct%2Fimage.png?alt=media\&token=2bbbaf31-fc97-4958-bc96-c96cf08ec7f0)

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

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-Mdy6xW6P8shq8ygAGGd%2F-Me-9RskZ-rz93RuSQWt%2Fimage.png?alt=media\&token=fd54239f-82d1-4e9c-a126-996c713cfc9c)

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

* Chọn Kích hoạt

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-Me_YRs7IGByArY36S14%2F-Mea0u5Wof3-oUKxjGVM%2Fimage.png?alt=media\&token=344e91e7-3ac9-49e1-b31c-d4b85b0a4a6d)

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

![](https://58134727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaSrApVr5L1rdZPZEAx%2F-Mdy6xW6P8shq8ygAGGd%2F-Me-CNlJrsDj9bOPocXV%2Fimage.png?alt=media\&token=bf348628-65ae-4d65-a3f6-8d1fe51a6b1f)