API kiểm tra hạn ngạch hóa đơn

Kiểm tra số lượt phát hành hóa đơn điện tử còn lại trong gói dịch vụ hiện tại qua SePay E-Invoice API trước khi phát hành hóa đơn mới.

||

API Endpoint

GET
https://einvoice-api.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.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
—