Gói dịch vụ TKHQ — Nghiệp vụ + Add-on

3 gói cơ bản (KHAI_BAO / DAI_LY / FORWARDER) + add-on Fleet, Commercial, Load Plans. Thanh toán SePay VietQR. Trial 14 ngày, hoàn tiền 7 ngày. Route: /billing.

Mô hình gói

Mô hình gói nghiệp vụ — 3 gói cơ bản theo phân khúc + add-on theo module. Token meter riêng cho AI, seat riêng cho module nghiệp vụ.

3 gói cơ bản theo phân khúc:

Gói	Dành cho	Module bao gồm
KHAI_BAO	Doanh nghiệp tự khai báo HQ	Documents, HS Code, Declarations, Chat AI
DAI_LY	Đại lý hải quan	KHAI_BAO + Workspace multi-client + export hàng loạt
FORWARDER	Công ty forwarder / logistics	DAI_LY + Shipment/Booking/Container/SLA/Fleet ops-core

Add-on module (bật thêm theo nhu cầu):

Add-on	Module thêm	Yêu cầu gói nền
Fleet + Fuel	Xe, tài xế, chuyến, nhiên liệu	FORWARDER (ops-core)
Commercial	CRM, Rate Cards, Quotes, Bảng giá	FORWARDER (ops-core)
Load Plans 3D	Bin-packing, sơ đồ 3D, PDF xếp hàng	FORWARDER (ops-full)
GPS Connector	VietMap real-time, geofence	FORWARDER + Fleet add-on
Port Connector	ePort / ADA container events	FORWARDER (ops-core)

Dependency graph add-on:

ops-core → ops-full · ops-full → finance · ops-core → commercial · ops-full → load-plans

Token meter vs Seat

AI features (OCR, extract, chat) tính bằng token. Module nghiệp vụ (Shipment, Fleet, Commercial) tính bằng seat theo số thành viên active. 2 meter độc lập — không lẫn nhau.

Giá chưa chốt

Giá add-on chưa được công bố chính thức. Liên hệ sales để được tư vấn gói phù hợp.

Trial adjacency

Mỗi add-on có 14 ngày trial miễn phí khi bật lần đầu — không cần thanh toán để dùng thử.

Đăng ký

Đăng ký gói trực tiếp từ workspace settings → mục Gói & thanh toán hoặc trang /billing.

Trial 14 ngày:

Mọi gói trả phí có trial 14 ngày miễn phí, không cần thẻ tín dụng. Hết trial mà không thanh toán → tự động hạ về Free.

SePay VietQR

Phương thức thanh toán chính: SePay VietQR — chuyển khoản qua app ngân hàng. Hệ thống xác nhận tự động qua webhook HMAC-SHA256.

Luồng thanh toán:

Chọn gói → Trang checkout → Quét VietQR → Chuyển khoản → Webhook confirm → Active

🔍

Quét QR bằng app ngân hàng, hệ thống active gói ngay khi nhận webhook

Đúng nội dung chuyển khoản

Nội dung CK đã được sinh sẵn dạng TKHQ-<orderCode>. Không sửa nội dung — webhook sẽ không match.

Mẫu nội dung CK:

TKHQ-ORD20260603-A1B2C3

Quản lý

Subscription FSM hỗ trợ:

• Pause / Resume — tạm ngưng tối đa 90 ngày, không bị trừ token
• Tier upgrade — prorate phần ngày còn lại, charge chênh lệch
• Tier downgrade — áp dụng vào chu kỳ kế tiếp, credit unused → wallet
• Annual ↔ Monthly — đổi annual giảm 16% so với monthly × 12

Hoá đơn

Mỗi giao dịch thành công sinh hoá đơn điện tử qua Viettel SInvoice — mã số mẫu INV-2026-00001. Per-line-item VAT: 0% KCT + 10% dịch vụ.

Vào /billing → tab Hoá đơn → tải PDF + XML SInvoice. Có thể sửa thông tin xuất hoá đơn (tên công ty, MST) trước khi xuất.

Hoàn tiền

Chính sách hoàn tiền 7 ngày — rủi ro thấp cho người dùng mới.

Điều kiện

Hoàn 100% trong 7 ngày kể từ ngày thanh toán đầu tiên. Sau 7 ngày, không hoàn tiền nhưng có thể pause subscription.

Cách tính seat (số ghế)

Seat được tính dựa trên số thành viên workspace đang active (không bị vô hiệu hoá):

• Thành viên mới join → seat count +1 ngay lập tức
• Vô hiệu hoá thành viên → seat count -1, billing giảm vào chu kỳ kế tiếp
• Seat count được kiểm tra định kỳ và charge prorated nếu vượt gói

Giảm chi phí seat

Vô hiệu hoá tài khoản nhân viên đã nghỉ ngay sau khi họ rời đi — tránh bị tính phí seat không dùng.

Khi thanh toán thất bại — quy trình dunning

Nếu subscription hết hạn mà chưa có thanh toán mới (ví dụ: quên gia hạn), hệ thống chạy quy trình nhắc nợ tự động với grace period 7 ngày — workspace vẫn hoạt động bình thường.

Xem chi tiết đầy đủ → Dunning & Thanh toán thất bại.

Subscription lifecycle sau thanh toán

Khi thanh toán thành công, hệ thống xử lý theo chuỗi event qua Transactional Outbox:

SePay webhook → payment.succeeded
    → SubscriptionService: kích hoạt / gia hạn period
    → TokenMeterService: reset / cộng token quota
    → AffiliateService: tạo commission (nếu có referral)
    → NotificationService: gửi email/Telegram xác nhận