Kiểm tra hạn ngạch

API trả về số lượt phát hành/xuất hóa đơn còn lại của gói dịch vụ hiện tại. Giá trị cập nhật theo thời gian thực.

API Endpoint

GET
https://einvoice-api-sandbox.sepay.vn/v1/usage

API Request

Endpoint này không yêu cầu tham số request. Chỉ cần gửi Bearer token trong header để xác thực.

API Response

Response thành công (200)
{
  "data": {
    "quota_remaining": "534"
  }
}
dataobject

Xử lý lỗi

401Unauthorized

Thiếu hoặc token không hợp lệ/đã hết hạn.

Lưu ý

Về giá trị quota_remaining
  • quota_remaining là số lượt phát hành hóa đơn còn lại trong gói dịch vụ hiện tại
  • Giá trị được cập nhật theo thời gian thực sau mỗi lần phát hành hóa đơn thành công
Hóa đơn nháp không tính vào hạn ngạch

Khi xuất hóa đơn với is_draft: true, hệ thống sẽ không trừ hạn ngạch. Hạn ngạch chỉ bị trừ khi hóa đơn được phát hành chính thức (gọi API phát hành hoặc xuất với is_draft: false).

Code mẫu

>
>
>
curl --request GET \
  --url https://einvoice-api-sandbox.sepay.vn/v1/usage \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Bước tiếp theo

Sau khi kiểm tra hạn ngạch:

  • Nếu còn hạn ngạch, bạn có thể Xuất hóa đơn điện tử để tạo hóa đơn mới
  • Nếu hết hạn ngạch, vui lòng liên hệ SePay để nâng cấp gói dịch vụ
Trước
—
Tiếp theo
—