Codis d'error de Series
Tots els codis d'error de l'API pública que emet Series, amb el seu estat HTTP, el seu type i una pàgina per codi.
Codis d'error que emet Series. Cada code enllaça a la seva pròpia pàgina amb la causa i l'acció a prendre.
| Code | Type | HTTP | Descripció |
|---|---|---|---|
cannot_archive_last_default_series | invalid_request_error | 422 | La sèrie és l'única activa del seu tipus de document. Arxivar-la deixaria l'empresa sense numeració disponible i congelaria aquest tipus de document. |
document_type_required_for_ambiguous_code | invalid_request_error | 422 | Aquest codi de sèrie existeix per a més d'un tipus de document, així que per si sol no identifica una única sèrie. |
invalid_series_code | invalid_request_error | 422 | El codi de la sèrie és buit, massa llarg, o porta caràcters que no corresponen a un prefix fiscal. |
invalid_series_name | invalid_request_error | 422 | El nom de la sèrie és buit o supera la longitud permesa. |
invalid_series_number | invalid_request_error | 422 | El número inicial no és vàlid: no és un enter positiu, o queda a l'últim número ja emès o per sota, cosa que reemetria números ja consumits. |
invalid_series_template_assignment | invalid_request_error | 422 | L'assignació de plantilla PDF enviada per a la sèrie és incoherent: la selecció o la seva versió no són vàlides. |
invalid_series_uuid | invalid_request_error | 400 | L'identificador de sèrie de la ruta o del payload no és un UUID vàlid. |
invalid_series_year | invalid_request_error | 422 | L'exercici no és un any de quatre xifres vàlid per a una sèrie de numeració. |
monthly_requires_month_segmented_format | invalid_request_error | 422 | El comptador es reinicia cada mes però la màscara de numeració no segrega per mes, així que dos mesos arrencarien al mateix correlatiu i produirien números duplicats dins de l'any. |
series_already_archived | invalid_request_error | 422 | La sèrie ja estava arxivada, i l'arxivat no es repeteix: una segona crida indica que el client ha perdut l'estat real. |
series_code_immutable_with_documents | invalid_request_error | 422 | Canviar el prefix d'una sèrie que ja va emetre documents reescriuria retroactivament el seu identificador fiscal, mentre els clients i l'AEAT tenen el número original. |
series_default_kind_change | invalid_request_error | 422 | La sèrie és la predeterminada del seu propòsit (invoice_kind): la sèrie per defecte ho és per empresa, tipus i propòsit, així que canviar-li el propòsit deixaria aquest propòsit sense sèrie predeterminada. |
series_format_immutable_with_documents | invalid_request_error | 422 | La màscara de numeració d'una sèrie es pot canviar fins a la primera emissió: després, el PDF i el registre de l'AEAT dels documents ja emesos porten el número amb el format original. |
series_has_documents | invalid_request_error | 422 | La sèrie ja va numerar documents, així que no es pot eliminar: la seqüència correlativa ha de seguir sent auditable. |
series_immutable | invalid_request_error | 405 | Una sèrie no s'elimina per l'API: conserva els documents que va numerar i el seu codi no s'allibera. PUT i DELETE no són operacions sobre una sèrie. |
series_initial_number_creates_gap | invalid_request_error | 422 | El número inicial salta més enllà del següent correlatiu natural havent-hi documents de l'any en curs, i aquest buit a la seqüència no és admissible per a l'AEAT. |
series_invoice_kind_invalid | invalid_request_error | 422 | El propòsit de la sèrie queda fora del catàleg complete, simplified, corrective, simplified_corrective, o s'ha indicat en una sèrie que no és de factures. |
series_invoice_kind_locked | invalid_request_error | 422 | El propòsit de la sèrie (invoice_kind) es fixa en crear-la i deixa de ser editable tan bon punt té alguna factura: canviar-lo barrejaria tipus de factura en una mateixa numeració correlativa. |
series_invoice_kind_mismatch | invalid_request_error | 422 | Les sèries de factures tenen un propòsit fix (invoice_kind): complete per a factures completes, simplified per a simplificades, corrective per a rectificatives i simplified_corrective per a rectificatives de simplificades. Una factura només es numera en una sèrie del seu mateix propòsit (arts. 6.1.a, 7.1.a i 15 del RD 1619/2012), i la sèrie indicada és d'un altre. |
series_locked_by_verifactu | invalid_request_error | 422 | Com a mínim una factura de la sèrie té un registre de facturació acceptat per l'AEAT, cosa que congela el prefix, l'any i la base de numeració de la sèrie. |
series_not_found | not_found_error | 404 | L'identificador no resol a cap sèrie de numeració de l'empresa autenticada. |
series_template_access_denied | authorization_error | 403 | La credencial o l'usuari no té permís per canviar la plantilla PDF d'aquesta sèrie. |
series_template_incompatible | invalid_request_error | 422 | La plantilla no admet el tipus de document, el propòsit (invoice_kind) o el format de numeració de la sèrie. |
series_template_precondition_failed | conflict_error | 412 | L'ETag enviat a If-Match ja no coincideix amb el recurs de plantilla de la sèrie, que va canviar després de llegir-lo. |
series_template_precondition_required | invalid_request_error | 428 | El canvi de la plantilla de la sèrie no va indicar la versió o la precondició del recurs en què es basa. |
series_template_unavailable | invalid_request_error | 422 | La plantilla està arxivada o no es pot seleccionar per a aquesta empresa, de manera que no es pot assignar a la sèrie. |
series_template_version_conflict | conflict_error | 409 | L'assignació de plantilla PDF de la sèrie va canviar després de llegir-la. |
series_type_invalid | invalid_request_error | 422 | El tipus de document de la sèrie queda fora del catàleg invoice, quote, delivery_note, proforma, purchase_invoice, recurring_invoice. |
series_year_locked | invalid_request_error | 422 | La sèrie ja va emetre documents en el seu any vigent. Moure l'any deixaria aquests documents apuntant a un exercici buit mentre la seva base imposable és en un altre. |
Relacionat
Codis d'error per categoria
Localitza un error per la categoria que l'emet.
Taula de referència completa
Tots els codis, estats HTTP, tipus i descripcions en una referència.
Model d'errors
Interpreta la resposta d'error i gestiona els errors per codi.