SERIES_UNASSIGNED_TYPE_NOT_ALLOWED
Set the series' document type. Unassigned series can no longer be created: corrective invoices need a series of their own.
Category: Account settings
| HTTP status | 422 Unprocessable Content |
| Retry | After fixing the cause |
When it happens
The request creates a series with document_type: UNASSIGNED, or moves an existing series to it. UNASSIGNED only survives on series created before types existed.
How to fix it
Send STANDARD, SIMPLIFIED, CORRECTIVE or PROFORMA. Corrective invoices need a CORRECTIVE series of their own.
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.
Rules that cite this code
- NUM-005 Simplified invoices are numbered in their own series
- NUM-006 Corrective invoices are numbered in their own series
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_UNASSIGNED_TYPE_NOT_ALLOWED",
"title": "SERIES_UNASSIGNED_TYPE_NOT_ALLOWED",
"detail": "Set the series' document type. Unassigned series can no longer be created: corrective invoices need a series of their own.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "SERIES_UNASSIGNED_TYPE_NOT_ALLOWED",
"message": "Set the series' document type. Unassigned series can no longer be created: corrective invoices need a series of their own.",
"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
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
Keep exploring
SERIES_TYPE_CHANGE_LEAVES_TYPE_UNCOVERED
Cannot change the type of this series: it is the default for ‹value›, and that type still has other active series that would be left without a default. Set another ‹value› series as default first
SERVICE_UNAVAILABLE
The service is temporarily unavailable. Please try again in a few seconds.