# Kết nối Nhanh V2
{% hint style="warning" %}
Từ ngày 01/06/2022, ngừng hỗ trợ Nhanh V1, vui lòng sử dụng phiên bản mới
{% endhint %}
## 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 Nhanh ở 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 Nhanh 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 |
Tài khoản kết nối phải là
Admin của Loyalty Hub
Admin của Nhanh
|
| 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à Nhanh
Danh Mục
Chiều
Thông tin đồng bộ
Hoạt động đồng bộ
Đơn hàng
2
CNV -> Nhanh
CNV Thêm
Nhanh -> CNV
Nhanh Thêm, Sửa
Sản phẩm
1
Nhanh -> CNV
Nhanh Thêm, Sửa
Nhóm sản phẩm
1
Nhanh -> CNV
Nhanh Thêm, Sửa (Chỉ đồng bộ 1 lần sau khi kết nối)
Khách hàng
2
CNV -> Nhanh
CNV Thêm
Nhanh -> CNV Thông tin khách hàng được đồng bộ theo đơn hàng
Nhanh Thêm, Sửa
## Tổng quan các thông tin đồng bộ Nhanh
### Sản phẩm (Đồng bộ 1 chiều)
Sản phẩm Nhanh -> CNV
### Nhóm sản phẩm (Đồng bộ 1 chiều)
Nhóm sản phẩm Nhanh -> CNV
### Đặt hàng (Đồng bộ hai chiều và xử lý đơn hàng bên Nhanh)
Đơn hàng Nhanh -> CNV
Đơn hàng CNV -> Nhanh
### 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.
Khách hàng CNV -> Nhanh
{% 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 Nhanh V2
### Bước 1: Lấy thông tin Account Id ở cnvloyalty
1. Truy cập [Cấu hình chung](https://app.cnvloyalty.com/settings/general)
2. Sao chép **Account Id**
### Bước 2: Thêm mới app -> Nhập App Id, Redirect URL ở Nhanh
#### Tạo tài khoản/Đăng nhập:
* Truy cập [Nhanh.vn](https://open.nhanh.vn/)
* Chọn **Tạo tài khoản/Đăng nhập**
* Chọn **Xác nhận** để truy cập vào giao diện [apps Nhanh.vn](https://open.nhanh.vn/apps)
#### Thêm mới app
1. Ở giao diện [apps Nhanh.vn](https://open.nhanh.vn/apps) chọn **Thêm mới**
* Tên Apps\*: Tên app mà bạn muốn tạo
* Trạng thái\*: Đang hoạt động/Ngừng hoạt động
* Redirect URL\*: Nhập đường link mẫu ( )
* Thay số **1** (ở cuối link) thành **account Id** (385) đã copy ở[ Bước 1](#buoc-1-lay-thong-tin-account-id-o-cnvloyalty)
* Chọn **Lưu**
2\. Sao chép **App Id** và **Secret Key**
#### Nhập app Id vào Redirect URL
* Chọn **Sửa**
* Dán **App ID** đã sao chép (ví dụ trên hình: **72639**) vào Redirect URL (gạch dưới đỏ) và chọn **Lưu**
### Bước 3: Kết nối Nhanh.vn V2
1. Truy cập [Cổng kết nối dữ liệu](https://app.cnvloyalty.com/settings/integrations)
2. Chọn **Kết nối Nhanh**
3. Nhập App Id, Secret Key đã sao chép ở [Bước 2](#buoc-2-them-moi-app-greater-than-nhap-app-id-redirect-url-o-nhanh) và chọn **Kích hoạt**
4. Cấp quyền cho app – khách hàng tick vào các ô vuông để cấp quyền, sau đó chọn **Đồng ý**
5. Khi kết nối thành công giao diện app sẽ hiện chữ **Ngừng kết nối**, chọn **Ngừng kết nối** để tiếp tục lấy **Webhooks Verify Tokens**
### Bước 4: Nhập webhooks, kiểm tra thông tin
\
1\. Truy cập (72639 thay bằng app id của App)\
2\. Chọn **Sửa**\
3\. Bật Webhooks
* **Webhooks callback URL:** nhập link mẫu (72629 được thay bằng App ID của App)
* **Webhooks Verify Tokens**: nhập Token đã được sao chép trước
* **Chọn các sự kiện muốn nhận webhooks**: Tick vào các ô vuông
### Bước 5: Tạo thử sản phẩm
1. Truy cập trang [admin của Nhanh](https://nhanh.vn/admin)
2. Chọn **Sản phẩm**
3. Chọn **Thêm mới**
4. Điền thông tin sản phẩm muốn tạo -> chọn **Lưu**
5. Truy cập[ sản phẩm](https://app.cnvloyalty.com/products/list) ở CNVloyalty để kiểm tra kết nối giữa Nhanh và CNV
---
# 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-nhanh-v2.md?ask=
```
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.