Kết nối KiotViet - FnB

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

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

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

Danh mục	Chiều	Thông tin đồng bộ	Hoạt động đồng bộ
Sản phẩm	1	Kiot Việt→ CNV	KOV Thêm, Sửa, Xóa
Nhóm sản phẩm	1	Kiot Việt → CNV	KOV Thêm, Sửa
Khách Hàng	2	CNV → Kiot Việt	CNV Thêm, Sửa
		CNV → Kiot Việt Thông tin khách hàng được đồng bộ theo đơn hàng	KOV Thêm, sửa
Đơn hàng	1	Kiot Việt→ CNV	KOV Thêm, Sửa, Xóa

Import dữ liệu cũ bằng File Excel

Bước 1: Tải về mẫu Excel

10KB

customer.xlsx

Mẫu file Khách hàng

10KB

order.xlsx

Mẫu file Đơn hàng

8KB

collection.xlsx

Mẫu file Nhóm sản phẩm

9KB

product.xlsx

Mẫu file Sản phẩm

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: [e-mail]

Tổng quan các thông tin đồng bộ KiotViet - FnB

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

Sản phẩm KOV -> CNV

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

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

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

Đơn hàng (Đồng bộ 1 chiều)

Đơn hàng KOV -> CNV

Kết nối Kiot Việt

Bước 1: Lấy thông tin kết nối ở Kiot Việt

1. Doanh nghiệp chưa có tài khoản Kiot Việt

• Bấm vào link sau: https://www.kiotviet.vn/dang-ky/

2. Doanh nghiệp đã có tài khoản Kiot Việt

• Truy cập Kiot Việt theo đường dẫn Tên gian hàng đã đăng ký

  • Ví dụ: https://cnvloyalty.kiotviet.vn

• Vào Thiết lập ➝ Thiết lập cửa hàng ➝ Thiết lập kết nối API

Lưu ý: Tích chọn Cho phép truy xuất thông tin khách hàng, hoá đơn, đặt hàng từ gian hàng của bạn

Lấy thông tin kết nối

1. Retailer: tên shop ở đường dẫn Tên gian hàng đã đăng ký

   • Ví dụ: https://cnvloyalty.kiotviet.vn

     • Lấy thông tin Retailer: cnvloyalty (như hình bên dưới)

2. Client ID

3. Client Secret: mã bảo mật

Lưu ý:

Cài đặt Hoạt động để Kiot Việt cấp quyền truy xuất dữ liệu cho Loyalty Hub

• Chọn Hoạt động

• Chọn Cho phép truy xuất thông tin khách hàng, hoá đơn, đặt hàng từ gian hàng của bạn

Bước 2: Vào Cấu hình ➝ Cổng kết nối dữ liệu

Bước 3: Chọn Thêm Cổng kết nối

Bước 4: Thêm Kiot Việt - FnB

Bước 5: Kích hoạt Kiot Việt - FnB

1. Chọn Kết nối

2. Nhập thông tin đã lấy ở bước 1

   • Retailer: tên shop ở đường dẫn Tên gian hàng đã đăng ký

     • Ví dụ: https://cnvloyalty.kiotviet.vn

       • Lấy thông tin Retailer: cnvloyalty

   • Client ID

   • Client Secret: mã bảo mật

3. Chọn Kích hoạt

Bước 6: Kích hoạt Cổng kết nối Kiot Việt

• Chọn Kích hoạt -> Kết nối thành công

Kích hoạt