# Kết nối Kiot Viet - Retail
## Mục tiêu:
* Thông qua Mini App để thiết lập kết nối giữa KiotViet - Retail (KOV) và CNVCDP (CNV) với chức năng đồng bộ thông tin giữa 2 bên
* Mini app: Đồng bộ KiotViet Retail
## Lưu ý trước khi bắt đầu:
1. Nên dùng **webhook** để tự động nhận dữ liệu từ KOV về CNV. Trường hợp cần **kéo để nhận dữ liệu thủ công** là khi bị thiếu dữ liệu từ KOV
2. Trường hợp đơn hàng từ KOV về CNV là **thanh toán 1 phần** thì nên xử lý đơn hàng đó bên KOV để tránh xảy ra lỗi về số tiền thanh toán đơn hàng.
3. Kiểm tra cài đặt kết nối cũ, phần "Đồng bộ đơn hàng từ" đang là Hóa đơn hay Đặt hàng ( để hỗ trợ migrate). Và phải confirm với khách là khi lên kết nối mới sẽ sử dụng đồng bộ đơn hàng từ Hóa đơn hay Đặt hàng.
## Các thông tin kết nối từ KiotViet
1. Truy cập vào KiotViet
2. TÌm đến Thiết lập ➝ Thiết lập cửa hàng ➝ Thiết lập kết nối API
3. Copy các thông tin trong trang này:
1. Tên cửa hàng: phần nằm trước “.kiotviet.vn” trong link
2. Tên kết nối
3. Client Id
4. Mã bảo mật
## 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 KOV ở 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 shop duy nhất |
| 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 Kiot Việt
|
| 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ộ.** |
## 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à Kiot Việt Retail
Kiot Việt → CNV Thông tin khách hàng được đồng bộ theo đơn hàng
KOV Thêm, sửa
#### Sản phẩm (Đồng bộ 1 chiều)
#### Nhóm sản phẩm (Đồng bộ 1 chiều)
KOV sản phẩm có quan hệ cha con nên khi đồng bộ về CNV sẽ vào danh mục sản phẩm thay vì nhóm sản phẩm.
Cấu hình danh mục để show lên Mini App vẫn theo nhóm sản phẩm
\=> Ở HUB CNV, Tạo nhóm sản phẩm tự động sau đó chọn các danh mục sản phẩm muốn hiển thị trên Mini App
Mini App sẽ hiển thị tất cả sản phẩm có trong danh mục sản phẩm thuộc nhóm sp đã được setup trong cấu hình danh mục
#### Đơn hàng (Đồng bộ hai chiều và xử lý đơn hàng bên KOV)
**Đơn hàng KOV -> CNV**
**Đơn hàng CNV -> KOV**
#### Khách hàng (Đồng bộ 2 chiều)
* Luồng tạo và update khách hàng ở KOV sẽ đồng bộ về CNV và ngược lại từ CNV qua KOV.
* 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 (tạo khách hàng cho hoá đơn/ đơn hàng) nếu CNV chưa có dữ liệu khách hàng này.
**Khách hàng CNV -> KOV**
**Khách hàng KOV -> CNV**
\
**Chú ý:** Tắt "Quản lý khách hàng theo chi nhánh"
Do CNV không hỗ trợ khách hàng đa chi nhánh, nên bước này cần để tránh lỗi không tạo được đơn hàng trong trường hợp khác chi nhánh
1. Truy cập vào KiotViet
2. Tìm đến Thiết lập ➝ Thiết lập quản lý ➝ Đối tác
3. Tắt mục Quản lý khách hàng theo chi nhánh
\
Import dữ liệu cũ bằng File Excel
---------------------------------
### Bước 1: Tải về mẫu Excel
{% file src="" %}
Mẫu file Khách hàng
{% endfile %}
{% file src="" %}
Mẫu file Đơn hàng
{% endfile %}
{% file src="" %}
Mẫu file Nhóm sản phẩm
{% endfile %}
{% file src="" %}
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:
**Chú ý:** Để tránh dữ liệu bị nghẽn, khi Import dữ liệu qua file excel, cần tắt cài đặt cho mục Đẩy dữ liệu như trong hình. Sau đó bật lại.
Để vào mục này, tiếp tục các bước tiếp theo đến phần **Thêm cài đặt chi tiết kết nối ở Hub CDP** bên dưới.
## Thêm kết nối KOV Retail
**Truy cập vào app đồng bộ:**
1. Truy cập vào [hub.cnvcdp.com](http://hub.cnvcdp.com)
2. Trong menu chính, chọn Ứng dụng (B1)
3. Trong menu phụ, chọn mục POS (B2)
4. Tìm app Đồng bộ KiotViet Retail và Mở ứng dụng (B3)
**Trong giao diện app:**
1. Click vào Thêm kết nối (B1)
2. Điền các thông tin kết nối
* Sử dụng các thông tin đã lấy từ KiotViet:
và điền tương ứng vào 4 bước trong pop-up:
* Bước 1: tên hiển thị ở CDP, có thể lấy theo Tên kết nối của KOV hoặc tự đặt tên dễ nhớ
* Bước 2: Tên cửa hàng
* Bước 3: Client ID
* Bước 4: Mã bảo mật
3. Click Kết nối ứng dụng
## Thêm cài đặt chi tiết kết nối ở Hub CDP
1. Trong giao diện app Đồng bộ KiotViet - Retail
2. Chọn 1 ID hay Tên kết nối bất kỳ
3. Trong trang vừa mở, tìm đến phần đường dẫn - link web - trong hình
\
4. Copy đoạn text sau (gọi là **secret key**) và dán thêm vào sau đường dẫn đó:
**?cs=b7bae0c1-2176-4c85-a10b-d9b1b7a2cf10**
5. Nhấn Enter, phần **Danh Mục** sẽ thấy xuất hiện thêm các mục khác
**Chú ý:** Sau khi nhấn Enter giữ ở trang có các mục mới này
* Nếu thoát khỏi app đồng bộ sẽ mất các mục này, khi đó quay lại thực hiện các bước vừa rồi để có menu đầy đủ các mục
Do tính năng hiện tại không để khách tự setup, nên cần có mã s**ecret key** trên để truy cập vào các bước tiếp theo
## Cài đặt chi tiết kết nối ở Hub CDP
Chọn mục **Cài đặt** và cấu hình:
1. Cấu hình đồng bộ chi nhánh
* Phần này mặc định sẽ ẩn đi, không được cài đặt
**Chú ý:** Nếu khách có nhu cầu phân đơn theo chi nhánh sẽ cần cấu hình này, thì phải mua gói **API- Hệ thống kết nối Pos phân đơn** trên CRM
2. Cấu hình đồng bộ hình ảnh
* Đồng bộ hình ảnh sản phẩm
3. Cầu hình đồng bộ đơn hàng
* Nếu chọn Hóa đơn thì cần chọn thêm Nhân viên mặc định có quyền thêm/xóa/sửa Hóa đơn
* Nếu chọn Đặt hàng thì không cần
4. Cấu hình tạo đơn hàng khi sản phẩm đã hết tồn kho
* Nếu bên KOV chọn option Cho phép đặt hàng khi hết tồn kho thì bật Cấu hình tạo đơn hàng khi sản phẩm đã hết tồn kho bên CDP. Nếu không chọn thì không cần bật
5. Cấu hình kênh bán hàng
* Cấu hình này áp dụng cho sản phẩm khi đồng bộ theo đơn hàng từ POS về CNV
6. Cấu hình chi nhánh mặc định và Nguồn đơn hàng mặc định
* Chọn chi nhánh mặc định để đồng bộ Đặt hàng/Hóa Đơn/Khách hàng từ CNV sang KOV
Nhấn Lưu thông tin để kết thúc
## Kéo dữ liệu
Thiết lập cơ chế kéo - đồng bộ - dữ liệu
1. Xóa hết các **Danh mục sản phẩm** cũ ở **cnvloyalty**
2. Chọn **Kéo dữ liệu** trong **Danh mục**
3. Bấm **Tạo mới** và **Thủ công** để tạo các chiến dịch kéo dữ liệu thủ công
4. Bấm **Thêm loại** và chọn mục dữ liệu cần kéo
**Chú ý:** với **Danh mục** và **Sản phẩm** phải theo thứ tự:
* 1\. Danh mục
* 2\. Sản phẩm
5. Chọn **Từ ngày Đến ngày** đầy đủ thời gian từ khi tạo lập shop đến hiện tại
6. **Tên đồng bộ**: điền tự do
7. **Tài khoản kết nối**: sẽ được chọn mặc định và chỉ có 1 option
8. Bấm **Kích hoạt**
\
**Kiểm tra dữ liệu đã chạy:**
Quá trình chạy chiến dịch đồng bộ nếu có lỗi thì thông tin sẽ hiện thị trong Traffic và Dữ liệu lỗi.
**Kéo dữ liệu luồng mới**
Có thể tạo các chiến dịch Kéo dữ liệu thủ công, hoặc định kỳ với nhiều loại dữ liệu
## Webhook
Hủy kết nối webhook luồng đồng bộ cũ trước khi kết nối đồng bộ mới:
1. Quét và Nhập thông tin vào Dynamic Action sau ( thông tin Tên shop, clientID, clientSecret đã chuẩn bị lúc đầu )
2. Sau đó kiểm tra xem chiến dịch xóa webhook đã chạy đúng chưa (shop 1168)
h
\+ Đăng ký các webhook mới bằng cách chọn các webhook, sau đó nhấn Cập nhật
Lưu ý: Nếu trên phần Cài đặt chọn Đồng bộ đơn hàng từ Đặt hàng thì không cần đăng ký webhook Hóa đơn (và ngược lại)\
\
## Đẩy dữ liệu
Hiện tại chỉ hỗ trợ đồng bộ chiều CNV -> KOV cho Đơn hàng, Khách hàng
* Đơn hàng : sẽ tạo bên KOV khi đẩy dữ liệu
\+ Nếu trên Cài đặt chọn đồng bộ đơn hàng từ Đặt hàng, thì khi đẩy dữ liệu sẽ tạo Đặt hàng bên Kiot Việt Retail
\+ Nếu trên Cài đặt chọn đồng bộ đơn hàng từ Hóa đơn, thì khi đẩy dữ liệu sẽ tạo Hóa đơn bên Kiot Việt Retail
* Khách hàng : Tạo/Cập nhật khách hàng bên KOV
\
## Hủy kết nối
Trong trường hợp kết nối sai shop KOV hoặc muốn hủy KOV và kết nối pos khác
1. Vào mini app Đồng bộ KiotViet - Retail
2. Mở kết nối cần hủy và bấm Gỡ cài đặt
\
\
\
\
\
\
