Giới hạn tần suất

Số request tối đa mỗi phút, cách xử lý mã 429 và giới hạn phát hành của nhà cung cấp hóa đơn điện tử.

NexERP giới hạn số request mỗi phút để giữ hệ thống ổn định cho mọi doanh nghiệp.

Giới hạn

Mức mặc định

Khi vượt

Mỗi quyền tích hợp (ứng dụng × doanh nghiệp), chung cho mọi khóa và mọi cửa hàng

300 request mỗi phút. NexERP có thể chỉnh theo thỏa thuận

429 rate_limited kèm header Retry-After

Xác thực sai, theo địa chỉ IP

30 lần mỗi phút

429 rate_limited thay cho 401

Khi nhận 429

Đợi đúng số giây trong Retry-After rồi gửi lại y hệt. Với POST /invoices, gửi lại an toàn nhờ external_id.

Giới hạn của nhà cung cấp hóa đơn điện tử

Mỗi cửa hàng phát hành khoảng một hóa đơn mỗi 20 giây. Hàng chờ phát hành vì thế có thể dài lúc cao điểm.

Giới hạn này không làm chậm API tạo hóa đơn. Nó chỉ làm einvoice_status ở queued lâu hơn.

Lưu ý

  • Khóa đúng không bị ảnh hưởng bởi bộ đếm xác thực sai.

  • Máy bán hàng gọi liên tục bằng khóa sai sẽ bị chặn cho đến hết phút.