SIMPLIFIED_INVOICE_EXCEEDS_LEGAL_LIMIT

When it happens

The total of a SIMPLIFIED invoice, VAT included, is above the maximum BeeL. accepts for simplified invoices (3,000 €). It is checked when the invoice is created, when an edit takes it over the cap (by changing the lines or by changing type to SIMPLIFIED), and when it is issued.

How to fix it

Issue a STANDARD invoice with the recipient's details instead.

Retry

Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.

Returned by

The operations where this code is most likely. The list is not exhaustive.

• POST /v1/companies/{company_id}/invoices
• PATCH /v1/companies/{company_id}/invoices/{invoice_id}
• POST /v1/companies/{company_id}/invoices/{invoice_id}/issue

Rules that cite this code

• SIM-001 A simplified invoice never exceeds 3,000 €

Example response

When this error occurs, the API answers 400 Bad Request with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/SIMPLIFIED_INVOICE_EXCEEDS_LEGAL_LIMIT",
  "title": "SIMPLIFIED_INVOICE_EXCEEDS_LEGAL_LIMIT",
  "detail": "Simplified invoices cannot exceed ‹limit›€ (VAT included). Current total: ‹total›€. Reduce the amount or issue an ordinary invoice.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SIMPLIFIED_INVOICE_EXCEEDS_LEGAL_LIMIT",
    "message": "Simplified invoices cannot exceed ‹limit›€ (VAT included). Current total: ‹total›€. Reduce the amount or issue an ordinary invoice.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

The type URI is stable and always resolves to this page.

Message

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Placeholders are filled in at runtime:

• ‹total› — the invoice total, VAT included, in euros.
• ‹limit› — the maximum, in euros (3000.00).

Other errors in this category

Keep exploring