Đồng bộ Sapo Omni (Sapo Pos)

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

Giúp liên kết dịch vụ Sapo Omni / Sapo POS với Zalo Mini App của Zacademy. Từ đó, toàn bộ danh mục sản phẩm, tồn kho, đơn hàng, khách hàng đều được đồng bộ hai chiều giữa hệ thống Sapo và Zacademy, đảm bảo dữ liệu nhất quán, quy trình vận hành liền mạch.

---

2. Sử dụng cho ai?

• Các cửa hàng, chuỗi kinh doanh đang dùng Sapo Omni / Sapo POS để quản lý bán tại quầy, nhiều chi nhánh, hoặc bán đa kênh.
  
• Shop cần kết nối thêm kênh bán trên Zalo Mini App, nhưng không muốn nhập liệu thủ công.
  
• Mô hình bán hàng online + offline – cần đồng bộ trạng thái sản phẩm & đơn hàng giữa hai nền tảng.
  

---

3. Lợi ích chính

• Danh mục & sản phẩm từ Sapo tự động đồng bộ về Zacademy (1 chiều).
  
• Sản phẩm có thể thêm tại Zacademy và đẩy về Sapo (2 chiều).
  
• Đơn đặt hàng và khách hàng chuyển đổi hai chiều, giữa Sapo và Zacademy.
  
• Tồn kho & trạng thái hàng hoá cập nhật chính xác từ Sapo sang Mini App
• Hỗ trợ đồng bộ tồn kho theo kho/điểm bán.
  
• Dữ liệu đồng bộ real-time khi cài đặt Webhook, giảm thiểu lỗi & trùng lặp thông tin.
  

---

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

Điều kiện để đồng bộ:

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

Quy trình triển khai:

1. Khách hàng liên hệ Sapo để mở API, nhận thông tin cấu hình.
   
2. Lấy mã OAuth (Authorization code) và access_token theo hướng dẫn Sapo.
   
3. Đăng nhập Zacademy Admin → chọn phần mềm Sapo POS.
   
4. Nhập thông tin shop và access_token.
   
5. Cấu hình chi nhánh, nguồn đơn, nhân viên, phương thức thanh toán.
   
6. Chọn các mục đồng bộ → nhấn “Đồng bộ” → bắt đầu chuyển dữ liệu.
   

I. HƯỚNG DẪN ĐỒNG BỘ SAPO OMNI

Sapo Omni sẽ đồng bộ về App những thông tin sau:

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

1. Danh mục sản phẩm – sản phẩm

Đối với đồng bộ Danh mục SP – sản phẩm: hệ thống Zacademy đồng bộ một chiều từ Sapo Omni về Zacademy

• Điều kiện để đồng bộ sản phẩm: Bật chức năng đồng bộ sản phẩm

Lưu ý:

Hệ thống có cập nhật thông tin về name, của danh mục khi có thay đổi ở bên Sapo Pos.

Đồng bộ trạng thái của sản phẩm

• Trạng thái [Ngừng giao dịch] bên Sapo Pos sẽ được đồng bộ về trạng thái Ẩn tại Zacademy
• Trạng thái [Đang giao dịch] bên Sapo Pos sẽ được đồng bộ về trạng thái Hiện tại Zacademy

Tại Sapo pos: Nếu nhập giá bán lẻ khác giá bán buôn, sẽ đồng bộ về Zacademy giá niêm yết = giá bán = giá bán lẻ bên Sapo pos

Đồng bộ tồn kho của sản phẩm: theo tồn kho của Chi nhánh mặc định được cài đặt bên Sapo Omni

2. Khách hàng

• Chỉ đồng bộ 1 chiều từ Sapo omni về Zacademy.
• Điều kiện để đồng bộ khách hàng: Bật chức năng Đồng bộ khách hàng

Lưu ý:

• Không đồng bộ tên khách hàng mặc định khi đồng bộ về sẽ lấy tên là Khách
• Không đồng bộ địa chỉ khách hàng
• Chỉ đồng bộ khách hàng có số điện thoại

3. Đơn hàng

Đồng bộ 2 chiều giữa Sapo omni và Zacademy

Điều kiện để đồng bộ đơn hàng về Zacademy:

• Nếu đơn hàng chứa sản phẩm và khách hàng đã tồn tại bên Zacademy => Cần bật chức năng Đồng bộ đơn hàng
• Nếu đơn hàng chứa sản phẩm chưa tồn tại bên Zacademy và khách hàng đã tồn tại bên Zacademy => Cần bật chức năng Đồng bộ đơn hàng và Đồng bộ sản phẩm
• Nếu đơn hàng chứa sản phẩm đã tồn tại bên Zacademy và khách hàng chưa tồn tại bên Zacademy => Cần bật chức năng Đồng bộ đơn hàng và Đồng bộ khách hàng
• Điều kiện để đẩy đơn sang Sapo Pos : Bật chức năng Đồng bộ đơn hàng, sản phẩm, Khách hàng

Lưu ý:

• Không đồng bộ địa chỉ giao hàng.
• Các trạng thái tương ứng của 2 hệ thống:

Tại Zacademy	Tại Sapo omni
Đặt hàngDuyệtĐóng góiXuất khoHoàn thành	Đã đặt hàng
HủyHoàn hàng	Đã hủy

II. CÁC BƯỚC THỰC HIỆN ĐỒNG BỘ

1. Khái quát

Bước 1: Khách hàng liên hệ Sapo yêu cầu mở chức năng đồng bộ API với app 

Bước 2: Sapo gửi cho khách hàng thông tin cấu hình đồng bộ qua email bao gồm cấu hình và tài liệu hướng dẫn đồng bộ API

 Bước 3: Khách hàng lấy Access_token (trong trường hợp khách muốn Zacademy hỗ trợ thì cần cung cấp tài khoản đăng nhập Omni/ Pos cho Zacademy và email tại bước 2 ) 

Bước 4: Thực hiện kết nối giữa Zacademy và Sapo Omni

Bước 5: Thực hiện đồng bộ và kiểm tra kết quả

2. Chi tiết các bước thực hiện

2.1 Hướng dẫn khởi tạo thông tin kết nối trên hệ thống Sapo Omni

Mục đích: Mục này phục vụ cho những khách hàng chưa biết cách khởi tạo thông tin kết nối trên hệ thống SAPO

Người thực hiện: Khách hàng

Link tài liệu hướng dẫn của SAPO: https://support.sapo.vn/sapo-omnichannel

Thông tin Chi nhánh cửa hàng Tham khảo tại đây: https://support.sapo.vn/quan-ly-chi-nhanh-pos

Thông tin Nhân viên phụ trách xử lý đơn hàng Tham khảo tại đây: https://support.sapo.vn/them-moi-nhan-vien-sapo-fnb

Thông tin Cài đặt nguồn bán hàng Tham khảo tại đây: https://support.sapo.vn/nguon-don-hang-pos

Thông tin Phương thức thanh toán mặc định Tham khảo tại link tại đây: https://support.sapo.vn/cau-hinh-thanh-toan

2.2 Lấy Access_token

Bước 1: Lấy thông tin Authorization code

• Đầu tiên, truy cập địa chỉ mà SAPO Omni cung cấp qua url: {domain sapo cung câp}.mysapogo.com , đăng nhập vào hệ thống bằng tài khoản do SAPO Omni cung cấp:
  • Username
  • Password

• Lấy Authorization code bằng cách chạy url [GET] trên một trình duyệt bất kỳ (VD: Chrome): https://{sub_domain}.mysapogo.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}

Thay các thông tin dưới đây được SAPO cung cấp thông qua Email tới khách hàng vào url phía trên:

• sub_domain
• api_key
• scopes
• redirect_uri

Sau khi có url đúng thì paste vào url của trình duyệt chrome và enter ta sẽ có màn hình tương tự như ảnh. Phần tô đậm chính là Authorization code.

Bước 2: Lấy access_token dựa trên authorization code vừa lấy tại bước 1

Vào phần mềm PostMan, chạy url [POST] https://{sub_domain}.mysapogo.com/admin/oauth/access_token để lấy access_token

Tham số truyền vào gồm:

• client_id: là API key (có trong email SAPO gửi)
• client_secret: là Secret Key (có trong email SAPO gửi)
• code: là Authorization code lấy tại bước 1

Kết quả trả về là access_token

2.3 Cấu hình kết nối với Sapo Omni tại hệ thống Zacademy

Bước 1: Truy cập trang quản trị, chọn chức năng Đồng bộ

Link truy câp: https://app.zalo.academy/sites/sync_product/{site_id}

Bước 2: Chọn phần mềm đồng bộ là [sapopos]. Tiếp tục chọn các đối tượng muốn đồng bộ

Bước 3: Nhập thông tin kết nối

Gồm 2 trường thông tin:

• Tên của shop: là thông tin [Alias] trong Email mà SAPO đã gửi về cho cửa hàng
• Access_token: Thông tin vừa lấy theo hướng dẫn phía trên.

Sau khi điền 2 trường thông tin này, các trường thông tin Chi nhánh cửa hàng, Nhân viên phụ trách xử lý đơn hàng, Nguồn bán hàng, Cài đặt phương thức thanh toán sẽ tự mở để người dùng lựa chọn tiếp.

Bước 4: Chọn các thông tin Chi nhánh cửa hàng, Nhân viên phụ trách xử lý đơn hàng, Nguồn bán hàng:

• Chi nhánh cửa hàng: lấy thông tin từ {Quản lý chi nhánh} trong phần Cầu hình của hệ thống SAPO

• Nhân viên phụ trách xử lý đơn hàng: lấy thông tin từ {Nhân viên và phân quyền} trong phần Cấu hình

• Nguồn bán hàng: Lấy thông tin từ {Nguồn bán hàng} trong phần Cấu hình

• Cài đặt phương thức thanh toán mặc định để xác nhận đơn đã thanh toán từ App đẩy sang

Bước 5: Click nút [Đồng bộ] để hệ thống thực hiện đồng bộ dữ liệu.

Đến đây là kết thúc cấu hình kết nối để đồng bộ thông tin thành công giữa APP và Sapo Omni

Chúc Quý khách cài đặt thành công !