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


---

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