SERIES_ANNUAL_REQUIRES

Example response

When this error occurs, the API returns a JSON response with the following shape:

{
  "type": "https://docs.beel.es/errors/SERIES_ANNUAL_REQUIRES_YEAR",
  "title": "SERIES_ANNUAL_REQUIRES_YEAR",
  "detail": "Annual reset requires the format to include the year ({YYYY} or {YY}); otherwise the invoice number would repeat every year.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SERIES_ANNUAL_REQUIRES_YEAR",
    "message": "Annual reset requires the format to include the year ({YYYY} or {YY}); otherwise the invoice number would repeat every year.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

Annual reset requires the format to include the year ({YYYY} or {YY}); otherwise the invoice number would repeat every year.

El reseteo anual exige que el formato incluya el año ({YYYY} o {YY}); de lo contrario se repetiría el número de factura cada año.

El reinici anual exigeix que el format inclogui l'any ({YYYY} o {YY}); altrament es repetiria el número de factura cada any.

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

Other errors in this category

ACTIVE_CANNOT_DELETE

Cannot delete an active series. Deactivate it first

DEFAULT_CANNOT_DEACTIVATE

Cannot deactivate the default series. Set another series as default first

DEFAULT_CANNOT_DELETE

Cannot delete the default series. Set another series as default first

FISCAL_IDENTITY_LIVE_ONLY

This company is live. In Test mode you can only change how the invoice looks (logo, colour, template and languages). Fiscal details are edited in Live mode