Chọn tab bên dưới để xem video hướng dẫn, tài liệu sử dụng hoặc tài liệu API.
Tài liệu hướng dẫn sử dụng hệ sinh thái QBIS — bao gồm SPOS, STOUR, SSALE và nền tảng chung. Mỗi sản phẩm có module và quy trình riêng, tài liệu này giúp bạn làm quen và vận hành nhanh.
SPOS dùng cho trung tâm sửa chữa điện tử, cửa hàng bán và sửa điện thoại/laptop.
Vào menu Phiếu sửa chữa → Tạo phiếu mới. Nhập thông tin khách hàng, thiết bị, tình trạng. Hệ thống tự gán mã phiếu và gửi thông báo Zalo (nếu đã tích hợp).
Trạng thái phiếu: Tiếp nhận → Chẩn đoán → Báo giá → Khách đồng ý → Đang sửa → Hoàn thành. Mỗi bước có thể cấu hình thông báo và quyền xem/sửa.
STOUR phục vụ công ty lữ hành, OTA, resort và khách sạn.
Vào Sản phẩm tour tạo tour, đặt giá, ngày khởi hành. Có thể đồng bộ lên website hoặc kênh OTA qua API.
Khách đặt qua form/web → đơn hàng vào hệ thống. Sales xác nhận, thu tiền, xuất hợp đồng và danh sách đoàn cho HDV.
SSALE dành cho team bán hàng B2B, agency.
Kéo thả deal giữa các cột: Lead → Liên hệ → Báo giá → Đàm phán → Chốt. Mỗi deal có thông tin khách, giá trị, ngày cập nhật.
Tạo báo giá từ mẫu, gửi link cho khách ký điện tử. Sau khi chốt, chuyển thành hợp đồng và đơn hàng.
Nền tảng Low Code cho phép thiết kế quy trình, form thu thập dữ liệu và báo cáo không cần lập trình.
Tạo bước phê duyệt, điều kiện rẽ nhánh, gửi thông báo. Ví dụ: Đơn từ → Trưởng phòng duyệt → Kế toán thanh toán.
Kéo thả trường để tạo form; dữ liệu gửi vào lưu trữ và có thể dùng cho báo cáo, dashboard.
QBIS cung cấp REST API để tích hợp với phần mềm kế toán, CRM, website bán hàng hoặc hệ thống nội bộ. Base URL:
https://api.qbis.vn/v1
Định dạng request/response: JSON. Mã hóa: UTF-8. Rate limit: 1000 request/phút (có thể nâng cấp).
Hai cách xác thực: API Key (đơn giản) và OAuth2 (cho ứng dụng bên thứ ba).
Lấy API Key trong QBIS: Cài đặt → Tích hợp → API. Gửi kèm header mỗi request:
Authorization: Bearer YOUR_API_KEY
Flow: redirect user đến trang authorize QBIS → user đăng nhập và đồng ý → redirect về callback với code → đổi code lấy access_token. Dùng access_token trong header như API Key.
Một số endpoint chính:
GET /spos/phiếu — Danh sách phiếu (filter theo trạng thái, ngày).POST /spos/phiếu — Tạo phiếu mới.PATCH /spos/phiếu/:id — Cập nhật trạng thái, ghi chú.GET /spos/san-pham — Danh sách sản phẩm/linh kiện.Chi tiết tham số và response xem tại Swagger: https://api.qbis.vn/docs (bạn thay link thật khi có).
Đăng ký URL nhận sự kiện real-time (phiếu thay đổi trạng thái, đơn hàng mới, v.v.). QBIS gửi POST với payload JSON. Bạn cần trả về HTTP 200 trong vòng 5 giây; nếu lỗi hệ thống retry tối đa 3 lần.
{
"event": "phiếu.updated",
"id": "P2025000123",
"trang_thai": "hoan_thanh",
"timestamp": "2025-02-27T10:00:00Z"
}