Factuarea APIDevelopers

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_template_assignmentinvalid_request_error422L'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_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_default_kind_changeinvalid_request_error422La 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_documentsinvalid_request_error422La 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_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_error405Una 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_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_invoice_kind_invalidinvalid_request_error422El 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_lockedinvalid_request_error422El 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_mismatchinvalid_request_error422Les 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_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_template_access_deniedauthorization_error403La credencial o l'usuari no té permís per canviar la plantilla PDF d'aquesta sèrie.
series_template_incompatibleinvalid_request_error422La plantilla no admet el tipus de document, el propòsit (invoice_kind) o el format de numeració de la sèrie.
series_template_precondition_failedconflict_error412L'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_requiredinvalid_request_error428El canvi de la plantilla de la sèrie no va indicar la versió o la precondició del recurs en què es basa.
series_template_unavailableinvalid_request_error422La 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_conflictconflict_error409L'assignació de plantilla PDF de la sèrie va canviar després de llegir-la.
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

Et donem un cop de mà?Contactar amb suport