Đồng bộ Sapo Web

Estimated reading: 10 minutes 2824 views

Hiện tại, hệ thống hỗ trợ đồng bộ với Sapo Web và Sapo Omni. Các sản phẩm của Sapo (SapoGO, SapoExpress…) chưa hỗ trợ đồng bộ.

A. Giới thiệu:

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

Tính năng này cho phép kết nối Sapo Web – nền tảng quản lý bán hàng trực tuyến – với Zalo Mini App của Zacademy. Toàn bộ danh mục sản phẩm, tồn kho, đơn hàng và khách hàng được đồng bộ hai chiều, giúp quản lý tập trung và nâng cao trải nghiệm khách hàng trên Zalo.

2. Đối tượng sử dụng

Các cửa hàng, doanh nghiệp đang sử dụng Sapo Web làm kênh bán hàng chính.
Shop muốn mở rộng kênh bán qua Zalo Mini App mà không muốn nhập liệu thủ công.
Doanh nghiệp cần đồng bộ thông tin đơn hàng, sản phẩm giữa website và kênh Zalo để giảm sai sót và tăng hiệu quả bán hàng.

3. Lợi ích chính

Danh mục sản phẩm & tồn kho từ Sapo Web tự động cập nhật trên Zalo Mini App.
Đơn hàng phát sinh từ Zalo Mini App được chuyển về hệ thống Sapo Web để xử lý nhanh chóng.
Khách hàng và thông tin đơn hàng được đồng bộ liên tục, tránh trùng lặp và sai sót.
Cập nhật trạng thái sản phẩm và tồn kho theo thời gian thực, giúp quản lý chính xác.
Tiết kiệm thời gian nhập liệu thủ công, giảm rủi ro sai sót.
Tăng trải nghiệm mua sắm liền mạch và chuyên nghiệp trên Zalo.

4. Điều kiện và cách triển khai

Điều kiện sử dụng:

Khách hàng cần sử dụng gói dịch vụ Sapo Web có hỗ trợ API / OAuth (thường là các gói trả phí hoặc nâng cao).
Liên hệ với Sapo để mở quyền truy cập API / OAuth, nhận các thông tin như API key, Secret, sub_domain, redirect_uri.
Tài khoản Sapo phải có quyền quản trị viên để cấp phép và cấu hình kết nối.

Quy trình triển khai:

Liên hệ với Sapo để mở API và nhận thông tin cấu hình.
Thực hiện quy trình OAuth để lấy mã ủy quyền (Authorization code) và access_token.
Đăng nhập hệ thống Zacademy Admin → chọn phần mềm Sapo Web.
Nhập tên shop (Alias) và access_token.
Cấu hình các thông số như chi nhánh, nguồn đơn, nhân viên, phương thức thanh toán.
Chọn các mục cần đồng bộ và nhấn “Đồng bộ” để bắt đầu kết nối.

B. Hướng dẫn đồng bộ:

I. Hướng dẫn trên web admin

1. Các danh mục đồng bộ:

Dữ liệu	Zacademy	Sapo Web	Sapo Omni
Danh mục sản phẩm		✓	✓
Sản phẩm	✓	✓	✓
Đơn đặt hàng	✓	✓	✓
Khách hàng	✓	✓	✓
Tin tức		✓	✓

Danh mục sản phẩm: Danh mục sản phẩm đồng bộ từ Sapo sang App sẽ hiển thị theo Nhóm sản phẩm, Zacademy đang đồng bộ nhóm sản phẩm 1 chiều từ Sapo Web/ Sapo Omni về Zacademy
Nhóm sản phẩm: Zacademy đang đồng bộ nhóm sản phẩm 1 chiều từ Sapo Web/ Sapo Omni về Zacademy.
Sản phẩm: Zacademy đang đồng bộ sản phẩm 2 chiều từ Sapo Web/ Sapo Omni về Zacademy

Nghĩa là: Sản phẩm tạo bên App sẽ có thể đẩy ngược về bên POS tạo thành sản phẩm mới bên POS. Áp dụng trong trường hợp khách hàng đã đăng tải sản phẩm trên App trước rồi mới có nhu cầu dùng tới POS. Khi đó khách hàng đẩy sản phẩm từ App sang POS là được, không cần xóa sản phẩm trên App, tạo mới sản phẩm trên POS nữa.

Đơn hàng: Zacademy đang đồng bộ đơn đặt hàng cả 2 chiều giữa Zacademy và Sapo Web/ Sapo Omni
Khách hàng: Zacademy đang đồng bộ khách hàng 2 chiều giữa Zacademy và Sapo Web/ Sapo Omni
Tin tức: Zacademy đang đồng bộ tin tức 1 chiều từ Sapo Web/ Sapo Omni về Zacademy
Sapo web: không hỗ trợ đồng bộ tồn kho theo kho/điểm bán

2. Lưu ý quan trọng:

Với chức năng đồng bộ dữ liệu danh mục tin tức, khách hàng lưu ý không xoá danh mục tin tức, tin tức ở bên Sapo chỉ nên sử dụng chức năng ẩn/ hiện danh mục tin tức, tin tức để đảm bảo dữ liệu đồng bộ sản phẩm chính xác hơn.
Quá trình đồng bộ có thể real-time nếu khách hàng có nhu cầu.
Với chức năng đồng bộ dữ liệu nhóm sản phẩm, khách hàng lưu ý không xoá nhóm sản phẩm, sản phẩm ở bên Sapo chỉ nên sử dụng chức năng ẩn/ hiện danh mục, nhóm sản phẩm, sản phẩm để đảm bảo dữ liệu đồng bộ sản phẩm chính xác hơn.

Lưu ý: Khi xóa sản phẩm trên POS, sản phẩm trên app Zacademy không bị xóa đi, vì vậy khách hàng tuyệt đối không thao tác xóa sản phẩm trên POS để tránh gây ra lỗi đồng bộ

( Nếu khách hàng vô tình đã xóa sản phẩm trên POS thì cần vào app xóa sản phẩm trên app )

Khách hàng lưu ý, đối với sản phẩm vừa tạo chỉ nên chọn duy nhất một danh mục, do dữ liệu giữa Zacademy và Sapo không giống nhau về việc tổ chức dữ liệu.

Đối với đồng bộ đơn đặt hàng

Đồng bộ đơn đặt hàng và khách hàng liên hệ với Zacademy để cài đặt tự động. Đơn hàng Zacademy đang đồng bộ đơn đặt hàng cả 2 chiều giữa Zacademy và Sapo Web/ Sapo Omni.

Đồng bộ về trạng thái đơn hàng:

Đơn lưu trữ là: Đơn mà khách đã thanh toán rồi, cửa hàng đã giao hàng rồi. Khi đó cửa hàng xác nhận đơn đó là lưu trữ, để công nhận đơn đó đã hoàn thành.
Khi đồng bộ kết nối với Sapo, khách hàng cần xử lý đơn từ Sapo, App chỉ có nhiệm vụ đẩy đơn về Sapo Web/ Sapo Omni, sau đó Sapo Web/ Sapo Omni sẽ đẩy đơn lên Sapo Pos.

Lưu ý:

Khi đồng bộ đơn hàng với SAPO, cần tắt tính năng cho phép khách hàng SỬA ĐƠN trên web admin

Tính năng SỬA ĐƠN, HỦY ĐƠN trên app

Lý do: Đối với trường hợp khách hàng đã đặt đơn thành công -> hệ thống đã đồng bộ đơn hàng đó sang SAPO, sau đó khách hàng lại thao tác chỉnh sửa đơn hàng thì sẽ gây lỗi đồng bộ dữ liệu

II. Các bước tiến hành đồng bộ:

Thông tin kết nối Api (được thiết lập trên hệ thống quản lý trên Sapo Web).

1. Cách thiết lập tại hệ thống Sapo:

Bước 1: Đăng nhập tài khoản trên Sapo chọn -> Quản trị website

Bước 2: Chọn mục Ứng dụng -> Ứng dụng riêng

Bước 3: Tiếp tục vào phần Tạo ứng dụng riêng

Bước 4: Cho phép quyền đọc và ghi, để thực hiện đồng bộ-> Và ấn Lưu lại

2. Nhập cấu hình đồng bộ tại Zacademy

Bước 1: Đăng nhập trang Admin của Zacademy

Bước 2: Chọn Mục Sản phẩm -> Chọn Đồng bộ

Bước 3: Nhập thông tin API

Ví dụ website quản trị của bạn bên sapo có dạng: https://banhangonline.sapo.net

Nhập tên của shop: banhangonline
Nhập Apikey: copy apikey ở sapo đã tạo trước đó (ứng dụng riêng) và paste vào ô nhập apikey ở Zacademy
Nhập apisecret: copy apisecret ở sapo đã tạo trước đó (ứng dụng riêng) và paste vào ô nhập apisecret ở Zacademy

Bước 4: Cuối cùng bạn ấn nút Đồng bộ.

Bước 5: Nếu khách hàng muốn đồng bộ sản phẩm từ App lên POS thao tác tại đây:

Abaha