CORRECTIVE_BAD_DEBT_BASE_TOO_LOW
A bad-debt corrective (R3) is not possible for an operation with a base of €‹value› to a consumer: the base must exceed €50. If the recipient acted as a business or professional, say so with recipient_is_business.
Category: Invoices
| HTTP status | 422 Unprocessable Content |
| Retry | After fixing the cause |
When it happens
A bad-debt corrective (R3) on an operation with a taxable base of 50 € or less, without recipient_is_business. The law allows that reduction only when the recipient acted as a business or professional.
How to fix it
If the recipient acted as a business or professional, send recipient_is_business: true. Otherwise the reduction does not apply.
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/CORRECTIVE_BAD_DEBT_BASE_TOO_LOW",
"title": "CORRECTIVE_BAD_DEBT_BASE_TOO_LOW",
"detail": "A bad-debt corrective (R3) is not possible for an operation with a base of €‹value› to a consumer: the base must exceed €50. If the recipient acted as a business or professional, say so with recipient_is_business.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "CORRECTIVE_BAD_DEBT_BASE_TOO_LOW",
"message": "A bad-debt corrective (R3) is not possible for an operation with a base of €‹value› to a consumer: the base must exceed €50. If the recipient acted as a business or professional, say so with recipient_is_business.",
"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 like
‹value›are filled in at runtime with the actual values of your request.
Other errors in this category
ATTACH_SOURCE_INVOICE_UNAVAILABLE
A source invoice is not available (it does not exist or you no longer have access); uncheck the source invoices attachment to send without the folder
ATTACH_SOURCE_INVOICES_NO_SOURCES
The invoice has no consolidation disbursements: there are no source invoices to attach
ATTACH_SOURCE_INVOICES_REQUIRES_PDF
Attaching the source invoices also requires attaching the invoice PDF
ATTACH_SOURCE_PDF_MISSING
These source invoices have no generated PDF: ‹value›
ATTACH_SOURCE_ZIP_TOO_LARGE
The source invoices ZIP (‹value› MB) exceeds the maximum sendable size (‹value› MB)
Keep exploring
CONVERSION_REQUIRES_PROFORMA
Only a proforma invoice can be converted into an invoice; this document is not a proforma
CORRECTIVE_BAD_DEBT_TOO_EARLY
It is too early for a bad-debt corrective (R3): at least six months must pass from when the tax accrued, one year if the previous year’s turnover exceeded €6,010,121.04. The earliest day is ‹value›.