NewProvince is only required for addresses in Spain
BeeL
Get startedMulti-NIFVeriFactuRulesStripeAPI referenceChangelog
ErrorsAll codes

REGIME_KEY_NOT_SUPPORTED

Regime key ‹value› is not available. Keys 06 and 14 require data the invoice does not carry (06, the cost-based taxable base; 14, an operation date after the issue date and a public-administration recipient). Key 03 requires the invoice not to show the tax separately (RD 1619/2012, art. 16.2.c), and the invoice always does. Use the key that fits the operation


Category: Invoices

HTTP status422 Unprocessable Content
RetryAfter fixing the cause

When it happens

A line, or the default of the tax configuration, carries regime_key 03, 06 or 14. Under 03 the invoice must not show the tax separately, and a BeeL. invoice always does; with 06 and 14 AEAT requires data the invoice does not carry.

How to fix it

Use another regime key. A corrective invoice of an original that already carried one of these keys keeps it.

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.

Rules that cite this code

Example response

When this error occurs, the API answers 422 Unprocessable Content with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/REGIME_KEY_NOT_SUPPORTED",
  "title": "REGIME_KEY_NOT_SUPPORTED",
  "detail": "Regime key ‹value› is not available. Keys 06 and 14 require data the invoice does not carry (06, the cost-based taxable base; 14, an operation date after the issue date and a public-administration recipient). Key 03 requires the invoice not to show the tax separately (RD 1619/2012, art. 16.2.c), and the invoice always does. Use the key that fits the operation",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "REGIME_KEY_NOT_SUPPORTED",
    "message": "Regime key ‹value› is not available. Keys 06 and 14 require data the invoice does not carry (06, the cost-based taxable base; 14, an operation date after the issue date and a public-administration recipient). Key 03 requires the invoice not to show the tax separately (RD 1619/2012, art. 16.2.c), and the invoice always does. Use the key that fits the operation",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

Regime key ‹value› is not available. Keys 06 and 14 require data the invoice does not carry (06, the cost-based taxable base; 14, an operation date after the issue date and a public-administration recipient). Key 03 requires the invoice not to show the tax separately (RD 1619/2012, art. 16.2.c), and the invoice always does. Use the key that fits the operation
La clave de régimen ‹value› no está disponible. La 06 y la 14 exigen datos que la factura no lleva (la 06, la base imponible a coste; la 14, una fecha de operación posterior a la de expedición y un destinatario Administración Pública). La 03 exige que la cuota no figure por separado en la factura (RD 1619/2012, art. 16.2.c), y la factura siempre la desglosa. Usa la clave que corresponda a la operación
La clau de règim ‹value› no està disponible. La 06 i la 14 exigeixen dades que la factura no porta (la 06, la base imposable a cost; la 14, una data d'operació posterior a la d'expedició i un destinatari Administració Pública). La 03 exigeix que la quota no figuri per separat a la factura (RD 1619/2012, art. 16.2.c), i la factura sempre la desglossa. Fes servir la clau que correspongui a l'operació

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

Placeholders like ‹value› are filled in at runtime with the actual values of your request.

Other errors in this category

Keep exploring