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

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

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	2	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	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
		Kiot Việt → CNV Thông tin khách hàng được đồng bộ theo đơn hàng	KOV Thêm, sử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 - Retail

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 đồ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

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

• Đăng ký Kiot Việt

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

• 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

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

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

   • Đồng bộ đơn hàng: đồng bộ ở chiều KOV → CNV

     • Chọn Đặt hàng hoặc Hóa đơn

       • Hướng dẫn Đặt hàng
     • Sau khi kết nối, các đơn hàng từ KOV → CNV sẽ tự động đồng bộ theo loại dữ liệu đã chọn

3. Chọn Kích hoạt

Lưu ý:

• Lựa chọn đúng Đặt hàng hoặc Hóa đơn nếu không sẽ không đồng bộ được đơn hàng

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 Kiot Việt thành công