Códigos de error de Series

Códigos de error que emite Series. Cada code enlaza a su propia página con la causa y la acción a tomar.

Code	Type	HTTP	Descripción
`cannot_archive_last_default_series`	`invalid_request_error`	422	La serie es la única activa de su tipo de documento. Archivarla dejaría a la empresa sin numeración disponible y congelaría ese tipo de documento.
`document_type_required_for_ambiguous_code`	`invalid_request_error`	422	Ese código de serie existe para más de un tipo de documento, así que por sí solo no identifica una única serie.
`invalid_series_code`	`invalid_request_error`	422	El código de la serie está vacío, es demasiado largo, o lleva caracteres que no corresponden a un prefijo fiscal.
`invalid_series_name`	`invalid_request_error`	422	El nombre de la serie está vacío o supera la longitud permitida.
`invalid_series_number`	`invalid_request_error`	422	El número inicial no es válido: no es un entero positivo, o queda en el último número ya emitido o por debajo, lo que reemitiría números ya consumidos.
`invalid_series_template_assignment`	`invalid_request_error`	422	La asignación de plantilla PDF enviada para la serie es incoherente: la selección o su versión no son válidas.
`invalid_series_uuid`	`invalid_request_error`	400	El identificador de serie de la ruta o del payload no es un UUID válido.
`invalid_series_year`	`invalid_request_error`	422	El ejercicio no es un año de cuatro cifras válido para una serie de numeración.
`monthly_requires_month_segmented_format`	`invalid_request_error`	422	El contador se reinicia cada mes pero la máscara de numeración no segrega por mes, así que dos meses arrancarían en el mismo correlativo y producirían números duplicados dentro del año.
`series_already_archived`	`invalid_request_error`	422	La serie ya estaba archivada, y el archivado no se repite: una segunda llamada indica que el cliente ha perdido el estado real.
`series_code_immutable_with_documents`	`invalid_request_error`	422	Cambiar el prefijo de una serie que ya emitió documentos reescribiría retroactivamente su identificador fiscal, mientras los clientes y la AEAT tienen el número original.
`series_default_kind_change`	`invalid_request_error`	422	La serie es la predeterminada de su propósito (`invoice_kind`): la serie por defecto lo es por empresa, tipo y propósito, así que cambiarle el propósito dejaría ese propósito sin serie predeterminada.
`series_format_immutable_with_documents`	`invalid_request_error`	422	La máscara de numeración de una serie se puede cambiar hasta la primera emisión: después, el PDF y el registro de la AEAT de los documentos ya emitidos llevan el número con el formato original.
`series_has_documents`	`invalid_request_error`	422	La serie ya numeró documentos, así que no se puede eliminar: la secuencia correlativa tiene que seguir siendo auditable.
`series_immutable`	`invalid_request_error`	405	Una serie no se elimina por la API: conserva los documentos que numeró y su código no se libera. `PUT` y `DELETE` no son operaciones sobre una serie.
`series_initial_number_creates_gap`	`invalid_request_error`	422	El número inicial salta más allá del siguiente correlativo natural habiendo documentos del año en curso, y ese hueco en la secuencia no es admisible para la AEAT.
`series_invoice_kind_invalid`	`invalid_request_error`	422	El propósito de la serie queda fuera del catálogo `complete`, `simplified`, `corrective`, `simplified_corrective`, o se ha indicado en una serie que no es de facturas.
`series_invoice_kind_locked`	`invalid_request_error`	422	El propósito de la serie (`invoice_kind`) se fija al crearla y deja de ser editable en cuanto tiene alguna factura: cambiarlo mezclaría tipos de factura en una misma numeración correlativa.
`series_invoice_kind_mismatch`	`invalid_request_error`	422	Las series de facturas tienen un propósito fijo (`invoice_kind`): `complete` para facturas completas, `simplified` para simplificadas, `corrective` para rectificativas y `simplified_corrective` para rectificativas de simplificadas. Una factura solo se numera en una serie de su mismo propósito (arts. 6.1.a, 7.1.a y 15 del RD 1619/2012), y la serie indicada es de otro.
`series_locked_by_verifactu`	`invalid_request_error`	422	Al menos una factura de la serie tiene un registro de facturación aceptado por la AEAT, lo que congela el prefijo, el año y la base de numeración de la serie.
`series_not_found`	`not_found_error`	404	El identificador no resuelve a ninguna serie de numeración de la empresa autenticada.
`series_template_access_denied`	`authorization_error`	403	La credencial o el usuario no tiene permiso para cambiar la plantilla PDF de esta serie.
`series_template_incompatible`	`invalid_request_error`	422	La plantilla no admite el tipo de documento, el propósito (`invoice_kind`) o el formato de numeración de la serie.
`series_template_precondition_failed`	`conflict_error`	412	El ETag enviado en `If-Match` ya no coincide con el recurso de plantilla de la serie, que cambió después de leerlo.
`series_template_precondition_required`	`invalid_request_error`	428	El cambio de la plantilla de la serie no indicó la versión o la precondición del recurso en que se basa.
`series_template_unavailable`	`invalid_request_error`	422	La plantilla está archivada o no es seleccionable para esta empresa, así que no puede asignarse a la serie.
`series_template_version_conflict`	`conflict_error`	409	La asignación de plantilla PDF de la serie cambió después de leerla.
`series_type_invalid`	`invalid_request_error`	422	El tipo de documento de la serie queda fuera del catálogo `invoice`, `quote`, `delivery_note`, `proforma`, `purchase_invoice`, `recurring_invoice`.
`series_year_locked`	`invalid_request_error`	422	La serie ya emitió documentos en su año vigente. Mover el año dejaría esos documentos apuntando a un ejercicio vacío mientras su base imponible está en otro.

Relacionado

Códigos de error por categoría

Localiza un error por la categoría que lo emite.

Tabla de referencia completa

Todos los códigos, estados HTTP, tipos y descripciones en una referencia.

Modelo de errores

Interpreta la respuesta de error y gestiona los errores por código.

Códigos de error de Series

Relacionado

En esta página