SERIES_FORMAT_OVERLAPS

When it happens

The series' code and format could print a number that another series of the company, in the same environment and active or not, can also print. An invoice number must be unique per issuer.

How to fix it

Put {CODIGO}, or a literal of its own, in the format so the numbers of both series differ. The error names the other series.

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}/series
• PATCH /v1/companies/{company_id}/series/{series_id}

Rules that cite this code

• NUM-002 An issued number is never reused, even when the invoice is voided

Example response

When this error occurs, the API answers 409 Conflict with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/SERIES_FORMAT_OVERLAPS",
  "title": "SERIES_FORMAT_OVERLAPS",
  "detail": "This series' format can produce the same numbers as series '‹value›'. An invoice number must be unique per issuer: change the code or the format.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SERIES_FORMAT_OVERLAPS",
    "message": "This series' format can produce the same numbers as series '‹value›'. An invoice number must be unique per issuer: change the code or the format.",
    "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