Códigos de error de VeriFactu
Todos los códigos de error de la API pública que emite VeriFactu, con su estado HTTP, su type y una página por código.
Códigos de error que emite VeriFactu. Cada code enlaza a su propia página con la causa y la acción a tomar.
| Code | Type | HTTP | Descripción |
|---|---|---|---|
alta_record_not_found | not_found_error | 404 | La factura no tiene registro de alta, así que la operación que depende de él no tiene sobre qué trabajar. |
anulacion_record_already_exists | conflict_error | 409 | La factura ya tiene un registro de anulación en la cadena, y la anulación se declara una sola vez. |
certificate_expired | invalid_request_error | 422 | El certificado está fuera de su ventana de validez: ha caducado, o todavía no es válido. |
certificate_nif_mismatch | invalid_request_error | 422 | El NIF del titular del certificado no coincide con el de la empresa. Los registros AEAT se firman en nombre de la empresa, así que ambos deben ser el mismo. |
certificate_not_found | not_found_error | 404 | La empresa no tiene ningún certificado FNMT que corresponda al identificador, o no tiene ninguno subido. |
certificate_too_large | invalid_request_error | 422 | El fichero supera el límite de 100 KB, cuando un certificado FNMT real pesa unos pocos kilobytes. |
clock_drift_exceeded | invalid_request_error | 422 | El reloj del servidor se desvió del NTP por encima del margen permitido. La marca de tiempo de generación entra en la huella AEAT, así que un reloj desincronizado produciría registros que la AEAT rechaza. |
declaracion_already_exists | conflict_error | 409 | La empresa ya tiene presentada la declaración responsable del SIF de ese período. |
declaracion_not_found | not_found_error | 404 | La empresa no tiene presentada la declaración responsable del SIF del período solicitado. |
event_already_processed | invalid_request_error | 422 | Ese evento del SIF ya está registrado en la cadena de eventos, y cada evento se procesa exactamente una vez. |
invalid_certificate_format | invalid_request_error | 422 | El fichero no es un contenedor PKCS#12: sus primeros bytes no corresponden a la estructura ASN.1 que exige el formato, diga lo que diga la extensión. |
invalid_certificate_password | invalid_request_error | 422 | La contraseña no abre el fichero del certificado. |
max_retries_exceeded | invalid_request_error | 422 | El registro agotó el presupuesto de reintentos técnicos de reenvío del XML almacenado. Reintentar el mismo contenido volvería a fallar igual. |
mode_switch_blocked_until_year_end | invalid_request_error | 422 | El modo VeriFactu se activó en este ejercicio y ya se emitió al menos un registro de facturación. Dar marcha atrás degradaría la integridad de una cadena ya declarada a la AEAT. |
record_already_accepted | invalid_request_error | 422 | La AEAT ya aceptó el registro. La aceptación es terminal y su contenido queda congelado como parte de la cadena de huellas. |
record_immutable | invalid_request_error | 422 | El registro pertenece a un ledger de solo-adición: una vez escrito, su contenido fiscal queda cerrado a modificaciones y a borrado. |
record_not_rejected | invalid_request_error | 422 | La subsanación solo aplica a registros que la AEAT rechazó por datos. Este registro está en otro estado — un fallo técnico, por ejemplo, lo cubre el reintento automático. |
record_not_subsanable | invalid_request_error | 422 | El registro no se puede subsanar: no es un registro de alta, o no tiene factura de origen desde la que regenerar su contenido. |
requires_annulment | invalid_request_error | 422 | El contenido regenerado cambia un campo que entra en la huella —NIF del emisor, serie y número, fecha de expedición, tipo de factura, cuota o importe total— y la cadena no se puede reescribir. |
sii_excluded | invalid_request_error | 422 | La empresa está registrada en el SII, y los obligados al SII quedan excluidos del reglamento VeriFactu. |
verifactu_already_submitted | invalid_request_error | 422 | La factura ya tiene su registro de alta. Existe exactamente un alta por factura, así que una segunda rompería la idempotencia de la cadena. |
verifactu_mode_invalid | invalid_request_error | 422 | El modo queda fuera del catálogo verifactu / no_verifactu. |
verifactu_not_eligible | invalid_request_error | 422 | La factura no se puede registrar ahora mismo en la AEAT: la empresa no está en modo VeriFactu, no tiene certificado activo, o el certificado está revocado o emitido para otro NIF. |
verifactu_record_not_found | not_found_error | 404 | El identificador no corresponde a ningún registro de facturación de la empresa autenticada. |
verifactu_transmission_failed | invalid_request_error | 422 | El envío del registro a la AEAT no llegó a completarse: el endpoint estaba inaccesible o respondió con una incidencia. |