Gói dịch vụ & thanh toán

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 ở features củ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_days củ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)

stateaccessÝ nghĩa
trialfullĐang dùng thử
paidfullĐang dùng gói trả phí còn hạn
past_duefullGói trả phí đã hết kỳ, đang trong thời gian ân hạn chờ gia hạn
compedfullĐược Hubport cấp toàn quyền (mọi tính năng, không giới hạn)
freelimitedGó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í
suspendedblockedCửa hàng bị tạm khoá (website hiện trang "Cửa hàng tạm ngưng hoạt động")
soft_deletedblockedCử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_deletedblockedDữ 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

  1. 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.
  2. Hết kỳ mà chưa thanh toán: state là 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.
  3. 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á, xem hard_delete_due_at của Trạng thái khôi phục cửa hàng).
  4. 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.
  5. 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.

KeyLoạiMô tả
connector.marketplacefeature (bool)Được kết nối/đồng bộ sàn Shopee, Lazada, TikTok Shop
connector.socialfeature (bool)Được kết nối kênh mạng xã hội / inbox
custom_domainfeature (bool)Được dùng tên miền riêng cho website
ecomplatform_marketplacelimit (int)Số shop sàn (Shopee + Lazada + TikTok Shop) tối đa
ecomchannellimit (int)Số kênh mạng xã hội / inbox tối đa
synced_order_monthlylimit (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ườngMô tả
detail.stateTrạng thái cửa hàng: suspended, soft_deleted hoặc hard_deleted
detail.reasonLý 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:

RouteMụ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/switchcompanyChuyển sang cửa hàng khác của cùng tài khoản
GET /v1/platformsubscriptions/meGói của tôi (để hiển thị màn hình khoá)
GET /v1/platformrestores, POST /v1/platformrestoresTrạ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.

On this page