SERIES_NUMBER_COLLISION

When it happens

At issue time, the number the series would assign is already used by another invoice of the same company, in this series or in another one. Nothing is issued and no number is consumed.

How to fix it

Retrying gives the same result: the series needs review. Contact support with the series and the invoice.

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.

• POST /v1/companies/{company_id}/invoices
• POST /v1/companies/{company_id}/invoices/{invoice_id}/issue
• POST /v1/companies/{company_id}/invoices/{invoice_id}/corrective
• POST /v1/companies/{company_id}/invoices/{invoice_id}/convert-to-invoice

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 400 Bad Request with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/SERIES_NUMBER_COLLISION",
  "title": "SERIES_NUMBER_COLLISION",
  "detail": "The number assigned by the series is already in use. Please contact support: the series numbering needs review",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SERIES_NUMBER_COLLISION",
    "message": "The number assigned by the series is already in use. Please contact support: the series numbering needs review",
    "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.

Other errors in this category

Keep exploring