Codis d'error de VeriFactu

Codis d'error que emet VeriFactu. Cada code enllaça a la seva pròpia pàgina amb la causa i l'acció a prendre.

Code	Type	HTTP	Descripció
`alta_record_not_found`	`not_found_error`	404	La factura no té registre d'alta, així que l'operació que en depèn no té sobre què treballar.
`anulacion_record_already_exists`	`conflict_error`	409	La factura ja té un registre d'anul·lació a la cadena, i l'anul·lació es declara una sola vegada.
`certificate_expired`	`invalid_request_error`	422	El certificat està fora de la seva finestra de validesa: ha caducat, o encara no és vàlid.
`certificate_nif_mismatch`	`invalid_request_error`	422	El NIF del titular del certificat no coincideix amb el de l'empresa. Els registres AEAT es signen en nom de l'empresa, així que tots dos han de ser el mateix.
`certificate_not_found`	`not_found_error`	404	L'empresa no té cap certificat FNMT que correspongui a l'identificador, o no en té cap de pujat.
`certificate_too_large`	`invalid_request_error`	422	El fitxer supera el límit de 100 KB, quan un certificat FNMT real pesa uns pocs kilobytes.
`chain_position_conflict`	`conflict_error`	409	Dos registres de la mateixa empresa van intentar prendre alhora la mateixa posició de la cadena d'empremtes i els reintents automàtics no van resoldre la col·lisió.
`clock_drift_exceeded`	`invalid_request_error`	422	El rellotge del servidor es va desviar de l'NTP per sobre del marge permès. La marca de temps de generació entra a l'empremta AEAT, així que un rellotge desincronitzat produiria registres que l'AEAT rebutja.
`declaracion_already_exists`	`conflict_error`	409	L'empresa ja té presentada la declaració responsable del SIF d'aquest període.
`declaracion_not_found`	`not_found_error`	404	L'empresa no té presentada la declaració responsable del SIF del període sol·licitat.
`event_already_processed`	`invalid_request_error`	422	Aquest esdeveniment del SIF ja consta a la cadena d'esdeveniments, i cada esdeveniment es processa exactament una vegada.
`invalid_certificate_format`	`invalid_request_error`	422	El fitxer no és un contenidor PKCS#12: els seus primers bytes no corresponen a l'estructura ASN.1 que exigeix el format, digui el que digui l'extensió.
`invalid_certificate_password`	`invalid_request_error`	422	La contrasenya no obre el fitxer del certificat.
`invalid_representation`	`invalid_request_error`	422	La representació incompleix una regla: falta l'annex I signat o el justificant de l'apoderament, el document no és un PDF vàlid o supera els 5 MB, `signer_name`, `power_of_attorney_reference` o el motiu de la revocació (`reason`, de 3 a 500 caràcters) no respecten la seva longitud, `valid_until` és anterior a `granted_on` o la supera en més de 5 anys, o la representació ja està revocada (o no n'hi ha cap de vigent per revocar).
`max_retries_exceeded`	`invalid_request_error`	422	Només s'aplica als ESDEVENIMENTS del mode NO VERI*FACTU (`POST /v1/companies/{company}/verifactu/events/{id}/retry`): l'esdeveniment va esgotar els seus intents de transmissió. Els registres de facturació NO tenen topall de reintents —l'art. 16.4 de l'Ordre HAC/1177/2024 exigeix reintentar almenys una vegada per hora mentre duri la incidència—, així que cap reintent d'un registre retorna ja aquest codi.
`mode_switch_blocked_until_year_end`	`invalid_request_error`	422	El mode VeriFactu es va activar en aquest exercici i ja es va emetre com a mínim un registre de facturació. Fer marxa enrere degradaria la integritat d'una cadena ja declarada a l'AEAT.
`record_already_accepted`	`invalid_request_error`	422	L'AEAT ja va acceptar el registre. L'acceptació és terminal i el seu contingut queda congelat com a part de la cadena d'empremtes.
`record_immutable`	`invalid_request_error`	422	El registre pertany a un ledger de només-addició: un cop escrit, el seu contingut fiscal queda tancat a modificacions i a esborrat.
`record_not_rejected`	`invalid_request_error`	422	Només es pot esmenar un registre d'alta que l'AEAT va acceptar (o va acceptar amb errors) o va rebutjar. Aquest registre està en un altre estat —pendent de remetre, enviat sense resposta o en error tècnic—, que cobreix el reintent i no l'esmena.
`record_not_subsanable`	`invalid_request_error`	422	El registre no admet esmena: no és un registre d'alta, no és l'ÚLTIMA alta de la seva factura (una altra esmena posterior el substitueix), la factura està anul·lada, és un rebutjat l'alta corregida del qual ja espera reenviar-se, o no té factura d'origen des de la qual regenerar-ne les dades.
`representation_required`	`invalid_request_error`	422	El mode de remissió demana a Factuarea que remeti els teus registres a l'AEAT en nom teu, i l'empresa no té una representació vigent —ni revocada ni caducada— del tipus que aquest mode necessita (l'annex I signat per a `social_collaborator`, l'apoderament inscrit per a `power_of_attorney`).
`requires_annulment`	`invalid_request_error`	422	El contingut regenerat canvia un camp que entra a l'empremta —NIF de l'emissor, sèrie i número, data d'expedició, tipus de factura, quota o import total— i la cadena no es pot reescriure.
`signing_certificate_unavailable`	`invalid_request_error`	422	L'empresa té VeriFactu activat en mode NO VERI*FACTU, on cada registre de facturació es signa (Ordre HAC/1177/2024, arts. 6.c i 14), i no hi ha amb què signar-lo. `error.param` diu QUÈ falta, i és estable: `certificate` = el certificat de l'empresa falta, està caducat o revocat, porta el NIF d'una altra empresa o el seu fitxer `.p12` no es pot llegir (malmès, o amb una contrasenya desada que ja no és vàlida); `representation` = en els modes de remissió per tercer, la representació que habilita Factuarea a signar en nom de l'empresa no està activa; `system_certificate` = el certificat de Factuarea no està disponible o no es pot llegir. Sense signatura no hi ha registre vàlid, i una factura emesa o anul·lada no pot quedar sense el seu, així que l'operació es rebutja abans d'executar-se.
`sii_excluded`	`invalid_request_error`	422	L'empresa està registrada al SII, i els obligats al SII queden exclosos del reglament VeriFactu.
`social_collaborator_unavailable`	`invalid_request_error`	422	L'acord de col·laboració social amb l'AEAT encara no està en vigor en aquesta instància, així que no es pot triar el mode `social_collaborator`.
`system_certificate_unavailable`	`api_error`	500	El certificat de Factuarea que remet els registres en els modes de tercer falta, ha caducat o ha estat revocat. És un problema nostre, no de la teva petició.
`verifactu_already_submitted`	`invalid_request_error`	422	La factura ja té el seu registre d'alta. Existeix exactament una alta per factura, així que una segona trencaria la idempotència de la cadena.
`verifactu_mode_invalid`	`invalid_request_error`	422	El mode queda fora del catàleg `verifactu` / `no_verifactu`.
`verifactu_not_eligible`	`invalid_request_error`	422	La factura no es pot registrar ara mateix a l'AEAT: l'empresa no està en mode VeriFactu, no té certificat actiu, o el certificat està revocat o emès per a un altre NIF. En emetre o anul·lar, el mateix codi amb el subcodi `signing_certificate_unavailable` indica que l'empresa, amb VeriFactu activat en mode NO VERI*FACTU, no té amb què signar el registre (`error.param`: `certificate`, `representation` o `system_certificate`, segons el que falti), i amb altres `error.param` que una dada de la factura no cap al registre d'alta (llegeix `error.param` i `error.message`).
`verifactu_record_not_found`	`not_found_error`	404	L'identificador no correspon a cap registre de facturació de l'empresa autenticada.
`verifactu_transmission_failed`	`invalid_request_error`	422	L'enviament del registre a l'AEAT no es va completar: l'endpoint era inaccessible o va respondre amb una incidència.

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.

Codis d'error de VeriFactu

Relacionat

En aquesta pàgina