# Kết nối Sapo Web

## 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 SAPO WEB ở 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 tài khoản Loyalty Hub                                                              |
|  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 SAPO WEB</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ộ.** |

## Tổng quan các thông tin đồng bộ Sapo Web

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

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

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

<figure><img src="/files/gdN8jSDMEiXZmhEHsM5A" alt=""><figcaption><p>Nhóm sản phẩm Sapo Web -> CNV</p></figcaption></figure>

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

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

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

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

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

<figure><img src="/files/w3H9l3fChYKDOWqGRB5t" alt=""><figcaption><p>Khách hàng CNV -> Sapo Web</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 SAPO WEB

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

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

* [`Đăng ký Sapo WEB`](https://www.sapo.vn/dang-nhap-kenh-ban-hang.html)

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

* [Truy cập SAPO WEB ](https://accounts.sapo.vn/login?serviceType=web)→ chọn Đăng nhập

![](/files/5J5WgHULntod3DQIG9i0)

Ở màn hình trang chủ, tiến hành lấy thông tin tên cửa hàng để kết nối:

![](/files/zkY0rnGUoTsSUBLhuzPZ)

{% hint style="warning" %}
Tên cửa hàng là phần tên ở đường link trước mục .mysapo.net

Ví dụ đường link truy cập của shop bạn là <https://odaybandocuahanh.mysapo.net/admin/dashboard> thì tên cửa hàng bạn để tiến hành kết nối là **odaybandocuahanh**
{% endhint %}

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

![](/files/-Mi8-9VNoyjJL4Z6TnGx)

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

![](/files/-Mi8-QLBzpORgCZb6jX0)

### Bước 4: Thêm SAPO WEB

![](/files/bfLgLmmN2iSL8GxnmSLs)

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

1. Chọn Kết nối
2. Nhập thông tin đã lấy ở bước 1 là tên cửa hàng kết nối
3. Chọn Kích hoạt

![](/files/39J6cYwH1SaFPg8Fl7LM)

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

![](/files/fFu2uE9nPzH2HacdZNq5)

###


---

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