SERIES_DEFAULT_NOT

You have no default invoice series. Create a series in settings before issuing invoices.


HTTP status	`422` Unprocessable Content
Retry	After fixing the cause

When it happens

The request did not send series_id, and the company has no default series for standard invoices. The default series for simplified and corrective invoices are created on first use, so this is only about STANDARD. This is account configuration, not a problem with the request. error.details.expected_document_type says which type was needed.

How to fix it

Check which defaults are missing with GET /v1/companies/{company_id}/series/defaults, then create the missing ones with PUT on the same path, or create a series of that type and make it the default. Or send an explicit series_id.

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.

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/SERIES_DEFAULT_NOT_FOUND",
  "title": "SERIES_DEFAULT_NOT_FOUND",
  "detail": "You have no default invoice series. Create a series in settings before issuing invoices.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "SERIES_DEFAULT_NOT_FOUND",
    "message": "You have no default invoice series. Create a series in settings before issuing invoices.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

You have no default invoice series. Create a series in settings before issuing invoices.

No tienes ninguna serie de facturación predeterminada. Crea una serie en la configuración antes de emitir facturas.

No tens cap sèrie de facturació predeterminada. Crea una sèrie a la configuració abans d'emetre factures.

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

Other errors in this category

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

FISCAL_IDENTITY_LIVE_ONLY

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

SERIES_DEFAULT_NOT_FOUND