Kết nối Kiot Viet - Retail

KiotViet là phần mềm quản lý bán hàng chuyên nghiệp, hỗ trợ cả nền tảng web lẫn thiết bị iOS và Android, cho phép người dùng theo dõi hoạt động kinh doanh của mình nhanh chóng, đơn giản, chính xác

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:

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

Truy cập vào KiotViet
TÌm đến Thiết lập ➝ Thiết lập cửa hàng ➝ Thiết lập kết nối API
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 ý

Cần kiểm tra kỹ và nhập đúng các thông tin kết nối KOV ở 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 KOV chỉ kết nối với một shop duy nhất

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 Kiot Việt

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

Thông tin đồng bộ CNV và Kiot Việt Retail

Danh mục

Chiều

Thông tin đồng bộ

Hoạt động đồng bộ

Đơn Hàng

CNV → Kiot Việt

Đồng bộ từ Đặt hàng

CNV Thêm, Hủy

Kiot Việt → CNV

Đồng bộ từ Đặt hàng
hoặc Hóa đơn

KOV Thêm, Sửa

Sản phẩm

Kiot Việt→ CNV

KOV Thêm, Sửa, Xóa

Nhóm sản phẩm

Kiot Việt → CNV

KOV Thêm, Sửa

Khách Hàng

CNV → Kiot Việt

CNV Thêm, Sửa

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

Truy cập vào KiotViet
Tìm đến Thiết lập ➝ Thiết lập quản lý ➝ Đối tác
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

Bước 2: Nhập dữ liệu theo mẫu Excel

Hướng dẫn Import dữ liệu

Bước 3: Liên hệ CNV Loyalty để cập nhật dữ liệu

Email: [email protected]

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ộ:

Truy cập vào hub.cnvcdp.com
Trong menu chính, chọn Ứng dụng (B1)
Trong menu phụ, chọn mục POS (B2)
Tìm app Đồng bộ KiotViet Retail và Mở ứng dụng (B3)

Trong giao diện app:

Click vào Thêm kết nối (B1)
Đ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

Click Kết nối ứng dụng

Thêm cài đặt chi tiết kết nối ở Hub CDP

Trong giao diện app Đồng bộ KiotViet - Retail
Chọn 1 ID hay Tên kết nối bất kỳ

Trong trang vừa mở, tìm đến phần đường dẫn - link web - trong hình

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

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ã secret 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:

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

Cấu hình đồng bộ hình ảnh

Đồng bộ hình ảnh sản phẩm

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

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

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

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

Xóa hết các Danh mục sản phẩm cũ ở cnvloyalty
Chọn Kéo dữ liệu trong Danh mục
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

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

Chọn Từ ngày Đến ngày đầy đủ thời gian từ khi tạo lập shop đến hiện tại
Tên đồng bộ: điền tự do
Tài khoản kết nối: sẽ được chọn mặc định và chỉ có 1 option

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:

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 )
Sau đó kiểm tra xem chiến dịch xóa webhook đã chạy đúng chưa (shop 1168) https://hub.cnvcdp.com/update-campaign/65788