Códigos de error de Series
Todos los códigos de error de la API pública que emite Series, con su estado HTTP, su type y una página por código.
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_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_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 | Las series no son editables ni eliminables vía API: la continuidad legal de la numeración exige que su prefijo, su año y su contador se queden como están. |
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_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_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. |