Factuarea API

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.

CodeTypeHTTPDescripció
cannot_archive_last_default_seriesinvalid_request_error422La 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_codeinvalid_request_error422Aquest 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_codeinvalid_request_error422El codi de la sèrie és buit, massa llarg, o porta caràcters que no corresponen a un prefix fiscal.
invalid_series_nameinvalid_request_error422El nom de la sèrie és buit o supera la longitud permesa.
invalid_series_numberinvalid_request_error422El 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_uuidinvalid_request_error400L'identificador de sèrie de la ruta o del payload no és un UUID vàlid.
invalid_series_yearinvalid_request_error422L'exercici no és un any de quatre xifres vàlid per a una sèrie de numeració.
monthly_requires_month_segmented_formatinvalid_request_error422El 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_archivedinvalid_request_error422La 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_documentsinvalid_request_error422Canviar 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_has_documentsinvalid_request_error422La sèrie ja va numerar documents, així que no es pot eliminar: la seqüència correlativa ha de seguir sent auditable.
series_immutableinvalid_request_error405Les sèries no són editables ni eliminables via API: la continuïtat legal de la numeració exigeix que el seu prefix, el seu any i el seu comptador es quedin com estan.
series_initial_number_creates_gapinvalid_request_error422El 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_locked_by_verifactuinvalid_request_error422Com 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_foundnot_found_error404L'identificador no resol a cap sèrie de numeració de l'empresa autenticada.
series_type_invalidinvalid_request_error422El tipus de document de la sèrie queda fora del catàleg invoice, quote, delivery_note, proforma, purchase_invoice, recurring_invoice.
series_year_lockedinvalid_request_error422La 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

En aquesta pàgina