Kết nối Nhanh V2

Quản lý bán hàng đa kênh hỗ trợ quản lý không giới hạn số lượng cửa hàng, dữ liệu tồn kho, đơn hàng, khách hàng tập trung tại một nơi, cập nhật liên tục và chia sẻ giữa hệ thống với mọi kênh bán hàng

Từ ngày 01/06/2022, ngừng hỗ trợ Nhanh V1, vui lòng sử dụng phiên bản mới

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

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

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

Thêm mới app

1. Ở giao diện apps Nhanh.vn 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 (https://integration.cnvloyalty.com/nhanhvn/connect/callback/72629/1 )
• Thay số 1 (ở cuối link) thành account Id (385) đã copy ở Bước 1
• 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
2. Chọn Kết nối Nhanh

3. Nhập App Id, Secret Key đã sao chép ở Bước 2 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

1.Truy cập Cổng kết nối dữ liệu

2.Chọn Kết nối Nhanh

3.Nhập App Id, Secret Key đã sao chép ở Bước 2 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 https://open.nhanh.vn/app/detail?id=72639 (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 https://integration.cnvloyalty.com/nhanhvn/hook/72629 (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
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 ở CNVloyalty để kiểm tra kết nối giữa Nhanh và CNV

Chọn Sản phẩm

Chọn Thêm mới

Điền thông tin sản phẩm muốn tạo -> chọn Lưu

Truy cập sản phẩm ở CNVloyalty để kiểm tra kết nối giữa Nhanh và CNV