SIMPLIFIED_NOT_EXCHANGEABLE

When it happens

One of simplified_invoice_ids cannot be exchanged: it is not issued, it was already voided, exchanged or corrected, or it belongs to another company or environment (Test or Live) than the request.

How to fix it

Exchange only issued simplified invoices of the same company and environment that were not voided, exchanged or corrected before.

Retry

Do not retry. The outcome is final: sending the same request again gets the same answer.

Returned by

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

• POST /v1/companies/{company_id}/invoices/simplified-exchanges

Rules that cite this code

• SIM-007 Exchanging a simplified invoice for a full one

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/SIMPLIFIED_NOT_EXCHANGEABLE",
  "title": "SIMPLIFIED_NOT_EXCHANGEABLE",
  "detail": "Simplified invoice ‹value› cannot be exchanged: it must be issued, not voided or exchanged before, and have no corrective invoices.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SIMPLIFIED_NOT_EXCHANGEABLE",
    "message": "Simplified invoice ‹value› cannot be exchanged: it must be issued, not voided or exchanged before, and have no corrective invoices.",
    "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

Keep exploring