EXCHANGE_SIMPLIFIED_RECORD_REJECTED

When it happens

The exchange invoice is recorded with VeriFactu as F3, which only replaces simplified invoices the AEAT has accepted, and the record of one of simplified_invoice_ids was rejected, so that invoice is not on file with the AEAT. Nothing is issued.

How to fix it

Fix or resubmit that simplified invoice first, and exchange it once the AEAT accepts its record.

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/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/EXCHANGE_SIMPLIFIED_RECORD_REJECTED",
  "title": "EXCHANGE_SIMPLIFIED_RECORD_REJECTED",
  "detail": "The record of simplified invoice ‹invoice_number› was rejected and is not on file with AEAT: fix or resubmit it first, and exchange it again once AEAT accepts it.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "EXCHANGE_SIMPLIFIED_RECORD_REJECTED",
    "message": "The record of simplified invoice ‹invoice_number› was rejected and is not on file with AEAT: fix or resubmit it first, and exchange it again once AEAT accepts it.",
    "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:

• ‹invoice_number› — the number of the simplified invoice, for example T-2026-0042.

Other errors in this category

Keep exploring