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 ý

Cần kiểm tra kỹ và nhập đúng các thông tin kết nối Nhanh ở Loyalty Hub

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

Một tài khoản Nhanh chỉ kết nối với một tài khoản Loyalty Hub

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

Tài khoản kết nối phải là

Admin của Loyalty Hub
Admin của Nhanh

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

CNV -> Nhanh

CNV Thêm

Nhanh -> CNV

Nhanh Thêm, Sửa

Sản phẩm

Nhanh -> CNV

Nhanh Thêm, Sửa

Nhóm sản phẩm

Nhanh -> CNV

Nhanh Thêm, Sửa (Chỉ đồng bộ 1 lần sau khi kết nối)

Khách hàng

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)

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

Đặt hàng (Đồng bộ hai chiều và xử lý đơn hàng bên 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.

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

Truy cập Cấu hình chung
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

Ở 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

Truy cập Cổng kết nối dữ liệu
Chọn Kết nối Nhanh
Nhập App Id, Secret Key đã sao chép ở Bước 2 và chọn Kích hoạt
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 ý
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