SIMPLIFICADA_FORBIDS

BeeL. does not accept IRPF withholding on simplified invoices or their correctives (R5): issue a standard invoice identifying the recipient

Category: Invoices


HTTP status	`422` Unprocessable Content
Retry	After fixing the cause

When it happens

A line of a SIMPLIFIED invoice sets an irpf_rate above zero. Withholding needs an identified payer, and a simplified invoice has none. The company's default IRPF rate is never applied to simplified invoices, so this only happens when the line sends the rate explicitly.

How to fix it

Remove irpf_rate from the lines, or issue a STANDARD invoice with the recipient identified.

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/SIMPLIFICADA_FORBIDS_IRPF",
  "title": "SIMPLIFICADA_FORBIDS_IRPF",
  "detail": "BeeL. does not accept IRPF withholding on simplified invoices or their correctives (R5): issue a standard invoice identifying the recipient",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SIMPLIFICADA_FORBIDS_IRPF",
    "message": "BeeL. does not accept IRPF withholding on simplified invoices or their correctives (R5): issue a standard invoice identifying the recipient",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

BeeL. does not accept IRPF withholding on simplified invoices or their correctives (R5): issue a standard invoice identifying the recipient

BeeL. no admite retención de IRPF en las facturas simplificadas ni en sus rectificativas (R5): emita una factura ordinaria identificando al destinatario

BeeL. no admet retenció d'IRPF a les factures simplificades ni a les seves rectificatives (R5): emeti una factura ordinària identificant el destinatari

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