Codis d'error de VeriFactu
Tots els codis d'error de l'API pública que emet VeriFactu, amb el seu estat HTTP, el seu type i una pàgina per codi.
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. |
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. |
max_retries_exceeded | invalid_request_error | 422 | El registre va esgotar el pressupost de reintents tècnics de reenviament de l'XML emmagatzemat. Reintentar el mateix contingut tornaria a fallar igual. |
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 | L'esmena només s'aplica a registres que l'AEAT va rebutjar per dades. Aquest registre està en un altre estat — una fallada tècnica, per exemple, la cobreix el reintent automàtic. |
record_not_subsanable | invalid_request_error | 422 | El registre no es pot esmenar: no és un registre d'alta, o no té factura d'origen des de la qual regenerar-ne el contingut. |
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. |
sii_excluded | invalid_request_error | 422 | L'empresa està registrada al SII, i els obligats al SII queden exclosos del reglament VeriFactu. |
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. |
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. |