Đồng bộ Kiotviet FnB

Estimated reading: 10 minutes 2605 views

Tính năng Đồng Bộ KiotViet F&B – Kết Nối Zalo Mini App Zacademy

1. Tính năng này là gì?

Đây là tính năng cho phép kết nối phần mềm bán hàng KiotViet F&B (chuyên dùng cho quán cà phê, nhà hàng, quán ăn…) với Zalo Mini App được phát triển trên nền tảng Zacademy.
Từ đó, menu món ăn, tình trạng món, đơn hàng sẽ được đồng bộ tự động. Khách hàng chỉ cần truy cập Zalo, xem thực đơn, đặt món – và đơn hàng sẽ được chuyển về hệ thống KiotViet tại quán để xử lý.

2. Dành cho ai?

Tính năng này phù hợp cho:

Các quán cà phê, trà sữa, nhà hàng, tiệm ăn sử dụng KiotViet F&B làm phần mềm bán hàng.
Cửa hàng mong muốn triển khai đặt món trực tuyến qua Zalo để tăng kênh bán hàng, phục vụ khách tốt hơn.
Mô hình bán mang về, đặt bàn, giao hàng – cần đồng bộ menu, đơn nhanh chóng & chính xác.

3. Lợi ích nổi bật

Tự động đồng bộ menu từ KiotViet lên Mini App, không cần nhập tay.
Cập nhật tình trạng món theo thời gian thực (hết món sẽ tự ẩn).
Đơn hàng từ Zalo được gửi trực tiếp về hệ thống POS KiotViet để xử lý.
Hỗ trợ các hình thức: đặt tại bàn, mang về, giao hàng, dễ tùy chỉnh.
Tạo trải nghiệm đặt món hiện đại, tiện lợi – giúp tăng doanh thu và giảm tải cho nhân viên.

4. Cần gì để sử dụng tính năng?

Điều kiện từ phía KiotViet:

Tài khoản KiotViet F&B còn hiệu lực.
Đang dùng gói dịch vụ có hỗ trợ API (hãy liên hệ KiotViet để kiểm tra gói đang dùng).
Tài khoản có quyền Quản trị viên (Admin).

Thông tin cần cung cấp cho Zacademy:

Client ID
Client Secret
Phân quyền truy cập dữ liệu gồm: món ăn, nhóm món, đơn hàng.
(Tuỳ chọn) Webhook nếu muốn cập nhật dữ liệu theo thời gian thực.

? Cách lấy: Vào Thiết lập → Thiết lập cửa hàng → Thiết lập kết nối API → Bật hoạt động → Tạo mã bảo mật

5. Cách sử dụng – Triển khai:

Quy trình:

Cung cấp mã kết nối từ KiotViet F&B (Client ID + Secret).
Zacademy thiết lập kết nối và đồng bộ menu tự động.
Menu sẽ hiển thị trên Zalo Mini App, tình trạng món được cập nhật liên tục.
Khi khách đặt món, đơn sẽ được chuyển về KiotViet như đơn tại quán.
Kiểm tra – xác nhận – bàn giao hoàn tất.

⏱ Thời gian triển khai: 1–2 ngày làm việc
?‍? Zacademy hỗ trợ toàn bộ – bạn không cần thao tác kỹ thuật

6. Chi phí

Tính năng có giá 250.000đ/tháng
Khách hàng có thể chọn gói sử dụng theo 3 tháng – 6 tháng – 12 tháng, tùy theo nhu cầu.

Không phát sinh thêm chi phí tích hợp – hỗ trợ đầy đủ trong suốt thời gian sử dụng.

✅ Hỗ trợ miễn phí trong suốt thời gian dùng dịch vụ.
✅ Có hệ thống ghi nhận & theo dõi riêng từng khách hàng.

HƯỚNG DẪN ĐỒNG BỘ KOV F&B

Lưu ý: Để thực hiện được đồng bộ, quản trị viên cần nâng cấp tài khoản Kiotviet lên gói cao cấp mới được sử dụng tính năng đồng bộ với hệ thống khác của Kiotviet.

CÁC DANH MỤC ĐỒNG BỘ

Đồng bộ DANH MỤC/ SẢN PHẨM.
Đồng bộ KHÁCH HÀNG.
Đồng bộ ĐƠN HÀNG.

Động bộ KiotViet FnB sẽ giữ nguyên luồng đồng bộ liên quan đến Danh mục, Khách hàng chỉ có thay đổi một vài phần ở đồng bộ Sản phẩm và đồng bộ Đơn hàng.

CÁC BƯỚC TIẾN HÀNH ĐỒNG BỘ

Bước 1: Tại màn Đồng bộ của module SẢN PHẨM chọn đơn vị đồng bộ KiotViet

Hình 1: Chọn đơn vị KiotViet để đồng bộ.

Bước 2: Bật các danh mục cần đồng bộ:

Đồng bộ Sản phẩm
Đồng bộ Đơn hàng
Đồng bộ Khách hàng

Lưu ý: Khi đồng bộ sản phẩm cần bật tính năng Không đồng bộ trạng thái sản phẩm trên App chuyển đổi theo trạng thái sản phẩm trên POS để đảm bảo sản phẩm được đồng bộ về ở trạng thái hiện.

Hình 2: Bật option Tắt đồng bộ trạng thái sản phẩm App theo POS

Loại tài khoản: Chọn option Cửa hàng ăn uống
Tên kết nối: Lấy thông tin Tên kết nối tương ứng bên KiotViet FnB.
Client ID: Lấy thông tin Client ID tương ứng bên KiotViet FnB.
Mã bảo mật: Lấy thông tin Mã bảo mật tương ứng bên KiotViet FnB.
Chi nhánh: Chọn chi nhánh trung tâm

Hình 3: Khung nhập thông tin kết nối với Kiotviet

Bước 4: Đăng nhập tài khoản Kiotviet FNB để thiết lập kết nối API:

Hình 4: Các thông tin kết nối tương ứng bên KiotvietFnB

Bước 5: Vào trang quản trị web admin Zacademy, nhập thông tin kết nối và Chọn nút [Đồng bộ] sau đó chờ 5 – 10 phút để đồng bộ các thông tin bên KiotViet FnB về bên Zacademy.

Hình 5: Thông tin được điền đầy đủ sau khi lấy dữ liệu từ bên KiotViet FnB.

CÁC LƯU Ý CẦN THIẾT

Phần đồng bộ sản phẩm có thay đổi khi đồng bộ sản phẩm từ KiotvietFnB về Zacademy:

Không đồng bộ bảng giá
Khi đồng bộ sản phẩm từ Kiotviet FnB bắt buộc phải Bật option Không đồng bộ trạng thái sản phẩm trên App chuyển đổi theo trạng thái sản phẩm trên POS.

(Lý do: Kiotviet chưa hỗ trợ trả về thông tin trạng thái đang kinh doanh, hoặc ngừng kinh doanh, đồng bộ sản phẩm về Zacademy sẽ hiển thị sai trạng thái vì vậy cần phải bật option này lên.)

Phần đồng bộ đơn hàng có thay đổi sau:

2.1. Đồng bộ đơn từ Zacademy sang KiotvietFnB

Đơn hàng bên Zacademy ở các trạng thái Đặt hàng, Duyệt, Đóng gói, Xuất kho, Hoàn thành sẽ được đẩy sang KiotvietFnB.
Đơn hàng đã đồng bộ từ Zacademy sang KiotvietFnB nếu được cập nhật trạng thái Hủy bên Zacademy thì sẽ không tự động đồng bộ sang KiotvietFnB (do KiotvietFnB chưa hỗ trợ) nên Admin cửa hàng phải tự xử lý cập nhật bằng tay bên KiotvietFnB.
Ghi chú của đơn hàng khi đẩy đơn sang KiotvietFnB sẽ được note vào ghi chú của 1 sản phẩm thay vì note vào ghi chú chung của đơn hàng.
Nếu đơn hàng bên Zacademy có thời gian giao hàng lớn hơn thời điểm thực hiển đẩy đơn sang KiotvietFnB sẽ đẩy thời gian giao hàng tương ứng sang KiotvietFnB. Nếu đơn hàng bên Zacademy không có thời gian giao hàng hoặc thời gian giao hàng nhỏ hơn thời điểm thực hiện đồng bộ đơn sang KiotvietFnB khi đó đơn hàng đẩy sang KiotvietFnB sẽ có thời gian giao hàng được cộng thêm 1 giờ tính từ thời điểm đồng bộ.

2.2 Đồng bộ đơn từ KiotvietFnB về Zacademy

Chỉ đồng bộ hóa đơn Hoàn thành từ KiotvietFnB về Zacademy (không đồng bộ đơn hàng của KiotvietFnB mà đồng bộ hóa đơn).
Luồng api KiotViet FnB hiện chỉ áp dùng với giao diện KiotViet Fnb cũ của Kiotviet ➝ Để chuyển từ giao diện mới về giao diện cũ, cần confirm với KiotViet FnB để setup.

2.3 Lưu ý khác:

Không sửa đơn trên App: Nếu admin muốn sửa đơn yêu cầu sửa đơn trên Kitotviet và thao tác xuất hóa đơn thì đơn hàng sẽ được đồng bộ ngược lại
Hệ thống không đồng bộ trạng thái giao vận
Không được phép xóa sản phẩm trên Kiotviet ( Nếu thao tác xóa trên Kiotviet cần thao tác xóa sản phẩm trên APP)
Không hỗ trợ đồng bộ trạng thái ẩn/hiện sản phẩm (Do Kiotviet không có API) => Muốn ẩn sản phẩm phải thao tác thủ công trên APP

Abaha