SERIES_INITIAL_NUMBER_LOCKED_HAS

Cannot modify the initial number because the series has associated invoices. This would affect numbering integrity.


HTTP status	`400` Bad Request
Retry	No

When it happens

You tried to change initial_number on a series that has already numbered at least one invoice (numbering_locked is true).

How to fix it

Create a new series starting at the number you need.

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.

PATCH /v1/companies/{company_id}/series/{series_id}

Rules that cite this code

NUM-007 A series cannot be renumbered once it has issued

Example response

When this error occurs, the API answers 400 Bad Request with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES",
  "title": "SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES",
  "detail": "Cannot modify the initial number because the series has associated invoices. This would affect numbering integrity.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES",
    "message": "Cannot modify the initial number because the series has associated invoices. This would affect numbering integrity.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

Cannot modify the initial number because the series has associated invoices. This would affect numbering integrity.

No se puede modificar el número inicial porque tiene facturas asociadas. Esto afectaría la integridad de la numeración.

No es pot modificar el número inicial perquè la sèrie té factures associades. Això afectaria la integritat de la numeració.

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_BE_UNMARKED

Cannot unmark the default series. Set another series as default 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

ENTITY_TYPE_INCONSISTENT_WITH_NIF

The entity type ‹value› does not match the NIF ‹value›: an individual is identified by a DNI or NIE, and a company or entity by a NIF that starts with a legal-form letter

SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES