Gói, dùng thử & giới hạn
Khái niệm gói dịch vụ, dùng thử, trạng thái cửa hàng, tính năng trả phí, hạn mức và các mã lỗi liên quan trên Hubport SaaS
Chỉ có trên Hubport SaaS
Các endpoint trong mục Gói dịch vụ & thanh toán chỉ hoạt động trên Hubport SaaS (https://api.hubport.vn). Trên bản cài đặt riêng (máy chủ riêng / dedicated), các endpoint này trả về HTTP 404 với mã lỗi error_saas_mode_inactive (trừ Trạng thái nền tảng), và không có giới hạn theo gói như mô tả dưới đây.
Mô hình gói
- Phần lớn chức năng miễn phí: sản phẩm, kho, đơn hàng, POS, khách hàng, báo cáo, storefront cơ bản...
- Tính năng trả phí là các dịch vụ kết nối (Connector):
connector.marketplace: kết nối và đồng bộ sàn TMĐT Shopee, Lazada, TikTok Shop.connector.social: kết nối kênh mạng xã hội / inbox (Facebook, Instagram, Zalo, TikTok...).
custom_domain: dùng tên miền riêng cho website bán hàng (xem Tên miền website). Hiện có ở mọi gói, kể cả gói miễn phí; Hubport có thể chuyển thành tính năng trả phí sau này, kiểm giá trị hiện hành ởfeaturescủa Gói của tôi.- Kết nối Haravan / WooCommerce miễn phí, không cần tính năng trả phí và không tính vào hạn mức.
- Mỗi gói trả phí có giá theo tháng/năm, danh sách tính năng trả phí và các hạn mức (số shop sàn, số kênh mạng xã hội, số đơn sàn đồng bộ mỗi tháng). Xem các gói đang bán bằng Danh sách gói.
- Thanh toán bằng chuyển khoản ngân hàng theo hoá đơn. Gói được kích hoạt khi Hubport ghi nhận đủ số tiền của hoá đơn.
Dùng thử
- Cửa hàng mới đăng ký được dùng đầy đủ chức năng, kể cả phần trả phí, trong N ngày (mặc định 7 ngày; giá trị hiện hành xem trường
trial_dayscủa Trạng thái nền tảng). - Hết hạn dùng thử mà chưa mua gói: các tính năng trả phí bị khoá, phần miễn phí vẫn dùng bình thường. Dữ liệu không bị xoá.
Trạng thái cửa hàng (state) và quyền truy cập (access)
state | access | Ý nghĩa |
|---|---|---|
trial | full | Đang dùng thử |
paid | full | Đang dùng gói trả phí còn hạn |
past_due | full | Gói trả phí đã hết kỳ, đang trong thời gian ân hạn chờ gia hạn |
comped | full | Được Hubport cấp toàn quyền (mọi tính năng, không giới hạn) |
free | limited | Gói miễn phí: chỉ có các tính năng của gói miễn phí (hiện là custom_domain), hạn mức theo gói miễn phí |
suspended | blocked | Cửa hàng bị tạm khoá (website hiện trang "Cửa hàng tạm ngưng hoạt động") |
soft_deleted | blocked | Cửa hàng bị tạm khoá (xoá mềm) do không hoạt động hoặc do gói trả phí quá hạn thanh toán, chủ cửa hàng tự khôi phục được (xem Khôi phục cửa hàng) |
hard_deleted | blocked | Dữ liệu cửa hàng đã bị xoá vĩnh viễn |
Dọn cửa hàng không hoạt động
Cửa hàng không trả phí và không có hoạt động (đăng nhập trang quản trị, có đơn mới hoặc có đơn đồng bộ từ sàn) trong một thời gian dài (mặc định 30 ngày) sẽ nhận email cảnh báo, sau đó bị xoá mềm (khoá cửa hàng, ẩn storefront) nếu vẫn không hoạt động. Trong thời gian xoá mềm, chủ cửa hàng đăng nhập và khôi phục được. Quá hạn khôi phục, dữ liệu bị xoá vĩnh viễn. Không áp dụng cho cửa hàng đang trả phí.
Gói trả phí quá hạn thanh toán
- Trước khi hết kỳ (mặc định 7 ngày), Hubport tạo một hoá đơn gia hạn cho kỳ kế tiếp và gửi email hoá đơn.
- Hết kỳ mà chưa thanh toán:
statelàpast_due, vẫn dùng đầy đủ trong thời gian ân hạn (mặc định 7 ngày). Chủ cửa hàng nhận một email quá hạn kèm hoá đơn gia hạn. - Hết ân hạn mà vẫn chưa thanh toán: cửa hàng bị tạm khoá (
state = soft_deleted,access = blocked). Chủ cửa hàng nhận một email nêu rõ số ngày và ngày dữ liệu bị xoá vĩnh viễn (mặc định 30 ngày sau khi khoá, xemhard_delete_due_atcủa Trạng thái khôi phục cửa hàng). - Trong thời gian tạm khoá:
- thanh toán hoá đơn gia hạn: cửa hàng tự mở khoá và gói được gia hạn;
- hoặc chủ cửa hàng khôi phục: cửa hàng mở lại với gói miễn phí, dữ liệu giữ nguyên.
- Trước ngày xoá vĩnh viễn vài ngày (mặc định 3 ngày), chủ cửa hàng nhận một email nhắc lần cuối. Quá hạn mà không khôi phục hay thanh toán, dữ liệu bị xoá vĩnh viễn.
Hết hạn dùng thử thì không bị khoá (chỉ chuyển về gói miễn phí, như mục Dùng thử ở trên).
Tính năng (features) và hạn mức (limits)
Lấy giá trị hiện hành của cửa hàng bằng Gói của tôi.
| Key | Loại | Mô tả |
|---|---|---|
connector.marketplace | feature (bool) | Được kết nối/đồng bộ sàn Shopee, Lazada, TikTok Shop |
connector.social | feature (bool) | Được kết nối kênh mạng xã hội / inbox |
custom_domain | feature (bool) | Được dùng tên miền riêng cho website |
ecomplatform_marketplace | limit (int) | Số shop sàn (Shopee + Lazada + TikTok Shop) tối đa |
ecomchannel | limit (int) | Số kênh mạng xã hội / inbox tối đa |
synced_order_monthly | limit (int) | Số đơn sàn mới được đồng bộ vào Hubport mỗi tháng |
Hạn mức -1 nghĩa là không giới hạn.
Mã lỗi liên quan
error_company_locked (HTTP 403)
Trả về cho mọi API của cửa hàng khi cửa hàng có access = blocked (bị tạm khoá, xoá mềm hoặc đã xoá).
{
"error": ["error_company_locked"],
"detail": {
"reason": "soft_deleted",
"state": "soft_deleted"
}
}| Trường | Mô tả |
|---|---|
detail.state | Trạng thái cửa hàng: suspended, soft_deleted hoặc hard_deleted |
detail.reason | Lý do khoá: soft_deleted, hard_deleted, hoặc lý do tạm khoá (mặc định suspended) |
Khi cửa hàng bị khoá, chỉ các route sau vẫn dùng được:
| Route | Mục đích |
|---|---|
GET /v1/usersessions/logout | Đăng xuất |
GET /v1/usersessions/me (và các route con /v1/usersessions/me/...) | Thông tin người dùng đang đăng nhập |
POST /v1/usersessions/switchcompany | Chuyển sang cửa hàng khác của cùng tài khoản |
GET /v1/platformsubscriptions/me | Gói của tôi (để hiển thị màn hình khoá) |
GET /v1/platformrestores, POST /v1/platformrestores | Trạng thái khôi phục và Khôi phục cửa hàng |
error_feature_requires_plan (HTTP 402)
Cửa hàng không có tính năng trả phí cần thiết (ví dụ hết hạn dùng thử, đang ở gói miễn phí, hoặc gói hiện tại không gồm tính năng này). Gặp khi kết nối shop Shopee / Lazada / TikTok Shop, lấy URL uỷ quyền kết nối sàn, thêm kênh mạng xã hội / inbox, hoặc thêm / kiểm tra / sửa tên miền riêng của website.
{
"error": ["error_feature_requires_plan"],
"detail": {
"feature": "connector.marketplace"
}
}detail.feature là tính năng còn thiếu (connector.marketplace, connector.social hoặc custom_domain). Hướng xử lý: nâng cấp gói qua Chọn gói & tạo hoá đơn.
error_quota_limit_exceed (HTTP 422)
Đã dùng hết hạn mức của tài nguyên khi tạo mới. Trả về trong mảng error của request tạo (ví dụ kết nối thêm shop sàn vượt ecomplatform_marketplace, thêm kênh vượt hạn mức kênh, hoặc tạo thêm chi nhánh, cửa hàng, kho, phòng ban, nhóm khách hàng, vai trò, webhook, hãng vận chuyển, file... vượt hạn mức của tài khoản).
{
"error": ["error_quota_limit_exceed"]
}Vượt hạn mức đơn sàn/tháng
Khi đã đồng bộ đủ synced_order_monthly đơn sàn mới trong tháng, các đơn sàn mới tiếp theo không được tạo trong Hubport (trạng thái đồng bộ của đơn ghi lỗi error_synced_order_monthly_limit_exceeded) cho tới khi sang tháng mới hoặc nâng cấp gói. Lỗi này không trả về qua HTTP mà hiển thị ở trạng thái đồng bộ đơn của kênh sàn.