Quay lại catalog nguồn dữ liệu
POS / ERP / Kế toánPhù hợp với RetailerPhù hợp với F&B

Sapo

POS và omnichannel quản lý bán hàng đa kênh tại VN, phổ biến với chuỗi vừa và lớn.

Trang chính của vendor Tài liệu API chính thức

Loại API

REST API

Xác thực

API Key

Tần suất refresh khả thi

Mỗi giờ, Hằng ngày

Setup · Maintain hằng tháng

4-8 giờ · 0,5-1 giờ

Hướng dẫn kết nối, 6 bước

Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.

  1. 1

    Yêu cầu kích hoạt API

    Liên hệ CSKH Sapo yêu cầu kích hoạt API trên tài khoản. Một số gói chỉ có API ở mức limit thấp, xác nhận trước.

  2. 2

    Lấy API Key từ Sapo admin

    Đăng nhập admin Sapo, vào Cài đặt > Tích hợp > API Key. Generate key mới. Lưu vào vault.

  3. 3

    Lấy subdomain của shop

    Subdomain định dạng yourstore.mysapo.net, dùng làm base URL.

  4. 4

    Test endpoint /admin/orders.json

    Curl với X-Sapo-Access-Token header. Kiểm tra response trả về JSON đúng định dạng.

  5. 5

    Pull theo cửa sổ thời gian

    /admin/orders.json?created_at_min=...&created_at_max=..., pull theo cửa sổ ngày, paginate qua page và limit (tối đa 250/page).

  6. 6

    Tùy chọn: setup webhook (nếu gói cho phép)

    POST /admin/webhooks.json đăng ký event. Một số gói Sapo không có webhook, cần kết hợp polling.

Credentials cần có

Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.

  • API Key (Access Token)
  • Subdomain

Trường dữ liệu mẫu

Các field thường có trong API response. Map vào schema warehouse khi ingest.

  • order_id
  • created_at
  • total_price
  • line_items[].sku
  • customer.email
  • shipping_address.city
  • transactions[].kind
  • location_id

Lỗi và pitfalls thường gặp tại Việt Nam

Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.

  • Documentation có chỗ chưa cập nhật, đôi khi field tên khác so với doc, test thực tế trước khi dùng.
  • Khi shop có nhiều location (chi nhánh), location_id quan trọng cho phân tích nhưng đôi khi null trong order cũ.
  • Sapo có hai sản phẩm: Sapo POS và Sapo Web, API khác biệt nhỏ giữa hai bản, cần xác nhận đang dùng bản nào.
  • Discount code và shipping fee đôi khi không tách rõ trong line items, cần đối chiếu với invoice.

Dashboard sử dụng Sapo

Xem toàn bộ thư viện dashboard →
Bán lẻ đa kênhTrưởng phòng vận hành

Cảnh báo hết hàng và hàng tồn chậm bán

Hai mặt của một vấn đề: SKU bán chạy có nguy cơ hết trong 7-14 ngày tới, và hàng đã không bán hơn 90 ngày đang khóa vốn. Một danh sách hành động, không phải bảng tồn kho khô khan.

Mở dashboard
Nhà phân phốiCFO / Kế toán trưởng

Công nợ quá hạn theo tuổi nợ

Phân bổ công nợ theo các nhóm tuổi nợ (0-30 / 31-60 / 61-90 / >90 ngày) theo từng khách hàng. Highlight khách đang trượt sang nhóm cao hơn để gọi điện trước khi quá trễ.

Mở dashboard
Nhà phân phốiCEO

Lợi nhuận theo khách hàng (top 20 và đáy 20)

Doanh thu, biên gộp, chi phí vận chuyển, chiết khấu thương mại, công nợ, gói lại thành một con số lãi/lỗ ròng cho từng khách hàng. Hai nhóm: top 20 đem lại hầu hết lợi nhuận, và đáy 20 đang âm hoặc cận biên.

Mở dashboard
Nhà phân phốiTrưởng phòng kinh doanh

Hiệu quả nhân viên kinh doanh

Doanh thu, biên gộp, công nợ quá hạn, số khách phụ trách, số đơn mỗi tháng, theo từng nhân viên kinh doanh. So sánh ngang giữa các nhân viên và xu hướng theo thời gian.

Mở dashboard
Chuỗi F&BTrưởng phòng vận hành

Food cost % theo món và chi nhánh

Tỷ lệ chi phí nguyên liệu trên doanh thu cho từng món và từng chi nhánh, so sánh với chuẩn công thức (theoretical food cost). Phát hiện món bị thâm hụt nguyên liệu vượt chuẩn, cảnh báo thất thoát hoặc khẩu phần lệch.

Mở dashboard
Chuỗi F&BCEO

P&L theo chi nhánh (so sánh ngang)

Doanh thu, food cost, labor cost, chi phí cố định, EBITDA, theo từng chi nhánh, xếp hạng so với mức trung bình và 3 tháng trước. Tách rõ chi nhánh đang lãi gánh chi nhánh đang lỗ.

Mở dashboard
Chuỗi F&BTrưởng phòng vận hành

Operations hằng ngày

Doanh thu, lượt khách, vòng quay bàn và AOV theo giờ trong ngày, cho từng chi nhánh. Phát hiện giờ ngấm (thừa hoặc thiếu nhân sự) và xu hướng vòng quay bàn giảm dần.

Mở dashboard
Chuỗi F&BTrưởng phòng marketing

Loyalty và retention khách hàng

Phân nhóm khách hàng theo cohort, tần suất ghé, AOV và thời gian từ lần ghé gần nhất. Trả lời "có bao nhiêu khách quay lại trong 30 ngày" và "khách VIP nào đang biến mất".

Mở dashboard
Bước tiếp theo

Kết nối Sapo vào data warehouse của doanh nghiệp bạn

Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.

Đặt lịch rà soát 30 phútXem toàn bộ nguồn dữ liệu