Nhập từ khoá để bắt đầu...
↑↓ Di chuyển Enter Mở Esc Đóng
024 7306 8956 Hướng dẫn 1-1

Bắt đầu sử dụng

Cách truy cập phần mềm QBIS

QBIS hỗ trợ truy cập trên cả trình duyệt web và ứng dụng di động — bạn có thể làm việc mọi lúc, mọi nơi trên bất kỳ thiết bị nào.

🌐
Truy cập Web
Trình duyệt trên máy tính hoặc điện thoại
Địa chỉ truy cập
🔗 swork.qbis.vn
Khuyến nghị
✅ Google Chrome (khuyên dùng)
✅ Microsoft Edge
✅ Safari (macOS / iOS)
✅ Firefox
📱
Ứng dụng di động
App SWORKv2 — iOS & Android

Thao tác

Các bước đăng nhập

1
Truy cập địa chỉ hoặc mở ứng dụng
Mở trình duyệt và truy cập swork.qbis.vn, hoặc mở app SWORKv2 trên điện thoại.
2
Nhập thông tin đăng nhập
Điền Tên đăng nhập (số điện thoại hoặc email) và Mật khẩu do quản trị viên cấp. Nhấn Đăng nhập.
3
Chọn đơn vị (nếu có nhiều đơn vị)
Nếu tài khoản thuộc nhiều đơn vị/chi nhánh, hệ thống sẽ yêu cầu chọn đơn vị cần làm việc trước khi vào màn hình chính.
✓
Vào màn hình làm việc
Đăng nhập thành công, bạn được chuyển đến màn hình chính. Các tính năng hiển thị tùy theo quyền hạn được phân công.

Lựa chọn

Nên dùng Web hay App?

🌐 Web 📱 App SWORKv2
Nhập liệu, xử lý nghiệp vụ ✅ Tối ưu Có
Xem thông báo, nhắc việc Có ✅ Tối ưu (Push)
Làm việc khi di chuyển Hạn chế ✅ Tối ưu
Xem báo cáo, dashboard ✅ Tối ưu Có
Không cần cài đặt ✅ Có Cần cài
Nhận thông báo push — ✅ Có
💡
Khuyến nghị: dùng Web khi làm việc tại văn phòng và App SWORKv2 khi cần theo dõi công việc, nhận thông báo hoặc làm việc ngoài văn phòng.

Hỗ trợ

Gặp sự cố khi đăng nhập?

🔑
Quên mật khẩu: Liên hệ quản trị viên của đơn vị để được cấp lại mật khẩu. Quản trị viên có thể đặt lại mật khẩu trong phần Quản trị → Người dùng.
🚫
Tài khoản bị khóa / không có quyền: Tài khoản có thể bị vô hiệu hóa hoặc chưa được cấp quyền. Liên hệ quản trị viên để kiểm tra trạng thái tài khoản.
🌐
Không tải được trang: Kiểm tra kết nối Internet. Thử xóa cache trình duyệt (Ctrl + Shift + Delete) hoặc mở tab ẩn danh.
Vẫn gặp sự cố? Đội hỗ trợ QBIS sẵn sàng giúp bạn.

Tổng quan tích hợp API

QBIS hỗ trợ tích hợp linh hoạt với các hệ thống bên ngoài thông qua RESTful API sử dụng định dạng JSON chuẩn.

Kiến trúc

1. Kiến trúc tổng quan

Toàn bộ giao tiếp giữa hệ thống bên ngoài và QBIS đều đi qua một lớp trung gian duy nhất là QBIS API Gateway — lớp này chịu trách nhiệm tiếp nhận, xác thực và chuyển tiếp request đến các module nghiệp vụ bên trong.

Hệ thống bên ngoài 🧾 Kế toán (MISA, FAST...) 🌐 Website / Mobile App 📦 Mini App (Zalo, ...) 🛒 Sàn thương mại điện tử 📢 Kênh bán hàng 💬 Kênh chat (Zalo OA...) HTTPS JSON QBIS API GATEWAY Tiếp nhận · Xác thực Xử lý Request / Response API Key · Logging · Versioning QBIS Core Modules 🔧 SPOS – Sửa chữa & Bán hàng 📈 SSALE – Sales & CRM ✈️ STOUR – Du lịch 🛡️ SCELL – Bảo hành 🚗 SGARA – Garage ⚙️ HRM · ERP · Platform
Thành phần Vai trò
Hệ thống bên ngoài Phần mềm kế toán (MISA, FAST...), Website/Mobile App, Mini App, Sàn thương mại điện tử, Kênh bán hàng, Kênh chat — kết nối trao đổi dữ liệu với QBIS qua API
QBIS API Gateway Lớp trung gian tiếp nhận, xác thực và điều phối request/response. Ghi log toàn bộ lịch sử giao tiếp, hỗ trợ versioning và rate limiting
QBIS Core Modules Các phần mềm nghiệp vụ của QBIS: SPOS (Sửa chữa & Bán hàng), SSALE (Sales & CRM), STOUR (Du lịch), SCELL (Bảo hành), SGARA (Garage), HRM, ERP, Platform

Cơ chế

2. Cơ chế tích hợp

QBIS hỗ trợ hai hướng giao tiếp, có thể dùng độc lập hoặc kết hợp cả hai trong cùng một hệ thống tích hợp.

📥
API Pull
Hệ thống ngoài → QBIS

Hệ thống bên ngoài chủ động gọi API của QBIS để lấy hoặc cập nhật dữ liệu. Phù hợp cho đồng bộ theo yêu cầu hoặc định kỳ.

Hệ thống ngoài → POST /api/leads → QBIS
📤
API Push
QBIS → Hệ thống ngoài

QBIS chủ động gửi dữ liệu đến endpoint của đối tác khi có sự kiện phát sinh. Phù hợp cho thông báo real-time.

QBIS → POST your-api.com/hook → Ngoài

Giao thức

3. Phương thức giao tiếp

Thành phần Phương thức Mô tả
Xác thực API Key Mỗi hệ thống cần được cấp quyền truy cập thông qua API Key riêng. Key được đặt trong body data của request.
Giao thức HTTPS Mọi giao tiếp đều thực hiện qua HTTPS để đảm bảo mã hóa và an toàn dữ liệu truyền tải.
Dữ liệu JSON Định dạng dữ liệu chuẩn cho cả request và response. Hỗ trợ đầy đủ Unicode UTF-8.
HTTP Method POST Tất cả API QBIS đều sử dụng HTTP POST, kể cả các thao tác đọc dữ liệu.
ℹ️
Thông tin xác thực được đặt trong body data của request, không đặt trong header Authorization.

Request

4. Cấu trúc Request

Tất cả API đều theo phương thức HTTP POST với cấu trúc thống nhất:

Trường Giá trị Mô tả
Phương thức HTTP POST Bắt buộc dùng POST cho mọi endpoint
URL https://api.qbis.vn/v1/{endpoint} Base URL + tên endpoint
Content-Type application/json Bắt buộc khai báo trong header
Body data JSON object Chứa tham số nghiệp vụ + 3 thông tin xác thực

Ví dụ Request (cURL)

curl -X POST https://api.qbis.vn/v1/{endpoint} \
  -H "Content-Type: application/json" \
  -d '{
    "api_key":    "qbis_key_xxxx",
    "secret_key": "qbis_secret_xxxx",
    "store_key":  "088287028781",
    "param1":     "value1"
  }'

Cấu trúc Response

// Thành công
{ "success": true,  "code": 200, "data": { ... } }

// Lỗi
{ "success": false, "code": 401, "message": "api_key không hợp lệ" }

API Push

5. QBIS đẩy dữ liệu ra hệ thống ngoài

Sử dụng tính năng Automation để cấu hình QBIS đẩy dữ liệu — không cần viết code phía QBIS.

1
Cấu hình App Connect
Vào Automation → App Connect, thêm kết nối mới với URL endpoint nhận dữ liệu của hệ thống ngoài.
2
Cấu hình Activity theo sự kiện
Trong Automation → Activity, tạo rule: khi sự kiện X xảy ra thì gọi App Connect và gửi dữ liệu tương ứng.
✓
QBIS tự động gửi dữ liệu
Mỗi khi sự kiện phát sinh, QBIS tự động HTTP POST dữ liệu JSON đến endpoint. Lịch sử được ghi log đầy đủ.
⚠️
Lưu ý: QBIS không tự động retry nếu push thất bại. Hệ thống nhận cần đảm bảo endpoint luôn sẵn sàng và trả về HTTP 200 khi nhận thành công.

Độ tin cậy

6. Cơ chế đảm bảo dữ liệu

Cơ chế Trạng thái Chi tiết
Retry tự động Không hỗ trợ Nếu push thất bại, QBIS sẽ không tự động thử lại. Hệ thống nhận cần xử lý idempotent.
Logging ✓ Có Toàn bộ lịch sử giao tiếp được ghi log và tra cứu trong màn hình Automation.
Versioning ✓ Có Hỗ trợ nhiều phiên bản API (/v1/, /v2/...) để đảm bảo ổn định khi nâng cấp.
Mã hóa ✓ Có Tất cả giao tiếp qua HTTPS/TLS. Không hỗ trợ HTTP thuần.
💡
Để đảm bảo không mất dữ liệu khi push thất bại, nên implement thêm cơ chế polling định kỳ (API Pull) song song để đồng bộ bù khi có sự cố mạng.

Nền tảng quản trị doanh nghiệp mới với AI - Low-code, no-code

Nền tảng quản trị doanh nghiệp thế hệ mới QBIS.VN — video giới thiệu sản phẩm, tính năng và hướng dẫn triển khai trong hệ sinh thái phần mềm QBIS.