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

CORRECTIVE_CIRCUMSTANCE_DATE_OUT_OF_RANGE

The circumstance date must be between the operation date (‹value›) and today (‹value›).


Category: Invoices

HTTP status422 Unprocessable Content
RetryAfter fixing the cause

When it happens

circumstance_date is before the original's operation date or after today.

How to fix it

Send a date between the original's operation date and today.

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_CIRCUMSTANCE_DATE_OUT_OF_RANGE",
  "title": "CORRECTIVE_CIRCUMSTANCE_DATE_OUT_OF_RANGE",
  "detail": "The circumstance date must be between the operation date (‹value›) and today (‹value›).",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "CORRECTIVE_CIRCUMSTANCE_DATE_OUT_OF_RANGE",
    "message": "The circumstance date must be between the operation date (‹value›) and today (‹value›).",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

The circumstance date must be between the operation date (‹value›) and today (‹value›).
La fecha de la circunstancia tiene que estar entre la de la operación (‹value›) y hoy (‹value›).
La data de la circumstància ha d’estar entre la de l’operació (‹value›) i avui (‹value›).

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