VeriFactu

Para qué sirve y para quién

VeriFactu es el final de la cadena fiscal: cada factura o tique que emite Facturación se convierte aquí en un registro de facturación encadenado (cada registro lleva la huella del anterior), con su QR de cotejo, que se envía a la Agencia Tributaria (AEAT). Si no puede salir en ese momento, se queda en la cola y sale solo después, en orden. Sirve igual a la peluquería y al restaurante: todo es común.

Quién la usa:

• El empleado consulta los registros, la cola, los eventos y el estado de la cadena.
• El responsable, además, envía un registro concreto, procesa y reintenta la cola, consulta lo que tiene la AEAT y prueba la conexión.
• El propietario y el administrador, además, eligen quién remite (su certificado o ERPlora), pasan a producción o vuelven a pruebas, subsanan o anulan un registro, recuperan la cadena y crean la factura de prueba.
• El sistema, sin nadie delante, registra cada factura en la misma operación que la emite y envía la cola.

No emite ni rectifica facturas (eso es Facturación) ni calcula impuestos (llegan decididos en la factura). El certificado propio del negocio, si lo usa, se sube aquí y se guarda cifrado en la base de datos del hub.

Referencia adoptada

Aquí la referencia no es un competidor: es la norma de la AEAT.

• Real Decreto 1007/2023 (Reglamento de los sistemas informáticos de facturación) y la Orden HAC/1177/2024: registro de alta y de anulación, encadenamiento por huella SHA-256, QR cotejable, identificación del sistema informático, remisión voluntaria con incidencia y declaración responsable.
• «Detalle de las especificaciones técnicas para generación de la huella o hash de los registros de facturación» v0.1.2 (27/08/2024): el orden exacto de los campos de la huella y sus tres casos oficiales, que la app reproduce en sus tests.
• Los esquemas oficiales SuministroLR.xsd y SuministroInformacion.xsd de la AEAT: todo registro se valida contra ellos antes de sellarse o enviarse.
• La modalidad VERI*FACTU únicamente: cada registro se remite a la AEAT; por eso no hay registro de eventos de la modalidad NO VERI*FACTU, y «Eventos» es trazabilidad propia.
• Preguntas frecuentes VeriFactu de la AEAT: un registro generado tiene que llegar a la AEAT; lo que sale tarde por una incidencia se declara con Incidencia = S; el sistema respeta el TiempoEsperaEnvio que devuelve la AEAT entre envíos y agrupa hasta 1.000 registros de un mismo obligado por envío.
• Del mercado (Odoo l10n_es_edi_verifactu, Holded, Sage, Square) se copia el reparto de pantallas: una lista de envíos con su estado y su QR, la ficha con la respuesta de la AEAT, un botón de enviar ahora y uno de anular, y la elección de la vía (certificado propio o el proveedor en tu nombre).

Antes de empezar

• Al encender VeriFactu se enciende con ella Facturación (la requiere): sin facturas no hay nada que registrar. Encender VeriFactu en el Hub es activarla: desde ese momento registra cada factura que se emite. No hay otro interruptor.
• El emisor es el de Facturación (Facturación → Emisor): VeriFactu toma de cada factura su NIF y su razón social, no los pide otra vez.
• El entorno empieza en pruebas (la AEAT de pruebas): nada de lo que se emite cuenta ante Hacienda hasta pasar a producción (VERIFACTU-F08).
• La vía de envío: o ERPlora remite en tu nombre con su sello (para producción necesita tu autorización firmada, el Anexo I, aprobada por ERPlora), o remites tú con tu propio certificado. La autorización (el otorgamiento de representación) se firma y se sube aquí, en «Lo remite ERPlora», y la revisa ERPlora; el certificado se sube aquí, en «Mi certificado». Aquí se elige cuál usar.
• Los datos del productor del software (ERPlora) van fijos en cada registro (los declara su declaración responsable), también «Da servicio a varios obligados», siempre «S» (contradicción 7, cerrada).

Configuración inicial, paso a paso:

1. En Facturación → Emisor, completa la razón social, el NIF y el domicilio.
2. Enciende VeriFactu en las apps del Hub.
3. Emite una factura de prueba (VeriFactu → Ajustes → Crear factura de prueba, VERIFACTU-F11) y comprueba en VeriFactu → Registros que aparece su registro con su QR.
4. Cuando la vía esté lista, Ajustes → Pasar a producción (VERIFACTU-F08).

Pantallas

Seis pestañas en el pie de cada página de VeriFactu (las del menú, en este orden): Registros, Contingencia, Eventos, Recuperación, Configuración y Ajustes. Todas se ven con el permiso de consulta; los botones que la persona no puede usar no aparecen.

Registros

Menú VeriFactu → Registros. Título «Registros VeriFactu». Tabla de 50 en 50 (tabla o tarjetas; en el móvil, tarjetas con el número de factura como título) con «Seq», «Factura», «Fecha», «Tipo» (Alta / Anulación), «F.» (F1…R5), «Emisor», «Total», «Entorno» (Pruebas / Producción) y «Estado» (Pendiente, Enviado, Aceptado, Aceptado con errores, Rechazado, en una pastilla de color). Buscador «Buscar factura, emisor o NIF…» (número de secuencia, número de factura, nombre o NIF del emisor). Filtros de estado, tipo, tipo de factura, entorno, fecha y total (en euros), tras el embudo de la tabla con su contador; un total que no es un importe, o una fecha «hasta» anterior a la «desde», se dice bajo su campo y no filtra. Lo último sellado sale arriba. Por fila: «Ver» (también al pulsar la fila) y «Cotejar en la AEAT» (abre la página de cotejo del QR). La lista se pone al día sola cuando nace, sale o cambia un registro en cualquier dispositivo. Vacía: «Todavía no hay registros. Cada factura que emitas se sella y aparece aquí.»; con búsqueda o filtro, «Sin resultados». Cargando: «Cargando…». Error: el mensaje con «Reintentar».

Ficha de registro

Se abre desde una fila de Registros (/verifactu/records/<id>). Arriba, «Registro {número}» con su estado, su entorno y «← Volver». Si no está en la AEAT (Pendiente o Enviado), el aviso «Aún no está en la AEAT» con el porqué y el cuándo (VERIFACTU-F17). Si fue rechazado, el aviso «La AEAT lo ha rechazado» con qué hacer (VERIFACTU-F24). Bloques: - Factura: «Factura», «Fecha de expedición», «Fecha de operación» (si es otra), «Tipo de factura», «Emisor», «NIF del emisor», «Cliente» y «NIF del cliente» (si los hay), «Rectifica a» / «Sustituye a», «Base», «Cuota» y «Total». - Cadena de huellas: «Seq», «Generado el», «Huella», «Huella anterior» (o «Primer registro de la cadena»). - QR: la imagen del QR y «Cotejar en la AEAT». - Respuesta de la AEAT: «Enviado el», «CSV», «Código de respuesta», «Mensaje de respuesta», «Intentos», «Próximo intento» y la «Huella de la entrega» («ID de transmisión», «Digest del sobre (SHA-256)»; «Aún sin estampar» mientras no ha salido). - XML: el sobre que se envía (o «El XML se construye cuando lleguen los datos del productor.»). Botones según el estado y el permiso: «Enviar ahora» (VERIFACTU-F25), «Subsanar» (VERIFACTU-F24) y «Anular registro» (VERIFACTU-F30). Un rechazo sale justo encima de los botones. Error al abrir: «Registro no encontrado» o el mensaje del fallo, con «← Volver».

Contingencia

Menú VeriFactu → Contingencia. Título «Cola de contingencia» y botón «Procesar cola» («Procesando…» mientras trabaja). Tabla de los registros que aún no están en la AEAT: «Factura», «Entorno», «Intentos», «Estado», «Próximo intento» y «Último error», en el orden en que salen (cada columna se ordena); buscador «Buscar factura o error…». Por fila: «Reintentar» (lo pone a salir en la siguiente pasada) y «Ver». Debajo de la tabla, el resultado de la última pasada a mano. Vacía: «Cola vacía: todo está en la AEAT.». Cargando: «Cargando…». Error: el mensaje encima de la tabla.

Eventos

Menú VeriFactu → Eventos. Título «Eventos de auditoría». Tabla, lo más reciente primero: «Cuándo», «Severidad» (Depuración, Información, Aviso, Error, Crítico), «Tipo» (Registro creado, Envío aplazado, Envío aceptado, Aceptado con errores, Envío fallido, Cola procesada, Registro reprogramado, Cadena verificada, Cadena rota, Consulta a la AEAT, Cadena recuperada, Prueba de conexión, Configuración cambiada) y «Mensaje», compuesto en el idioma de quien mira. Buscador «Buscar tipo o mensaje…» que encuentra por las palabras que se ven, en español o en inglés; filtros de tipo, severidad y fecha, tras el embudo de la tabla con su contador (una fecha «hasta» anterior a la «desde» se dice bajo su campo y no filtra). Se pone al día sola. Vacía: «Sin eventos.». Cargando: «Cargando…». Error: el mensaje con «Reintentar».

Recuperación

Menú VeriFactu → Recuperación. Título «Recuperación de cadena». Campo «NIF del emisor» (rellenado con el del emisor de Facturación) y el entorno actual. Bloque «Integridad de la cadena» con el último veredicto («Cadena de huellas íntegra ✓», «Cadena de huellas ROTA ✗» con la secuencia, o «Sin validar todavía») y la nota «Recalcula las huellas SHA-256 y verifica el encadenado. No vuelve a auditar los importes.». Botones «Validar cadena», «Consultar AEAT» y «Recuperar cadena desde la AEAT». Tabla «Últimos registros en la AEAT»: «Factura», «Fecha», «Huella», «Estado», «CSV» y «Consultado el»; vacía: «Sin datos de la AEAT. Pulsa «Consultar AEAT».». Bloque «Continuar cadena manualmente (migración)» con «Última huella (64 hex)», «Nº de factura» y «Fecha» y «Continuar desde esta huella». Las dos recuperaciones piden confirmación («Confirmar recuperación» / «Cancelar»). Al terminar: «Operación completada.».

Configuración

Menú VeriFactu → Configuración. Título «Configuración de VeriFactu». Dos pestañas, las dos vías: - «Lo remite ERPlora» (abre por defecto), como el erp-verifactu-grant del módulo antiguo: «Otorgamiento de representación» con su estado («Sin firmar», «En revisión desde el {fecha}», «Aprobado el {fecha}», «Devuelto el {fecha}» con «Nota de la revisión», «Revocado el {fecha}»); «Lo que has enviado» («Envío n.º {n}, enviado el {fecha}» y los documentos: «Modelo firmado», «Copia del documento de identidad», «Muestra de firma», «Justificante de representación»); «Sus pasos» (con dos o más: cada estado que contó la cuenta, con su fecha y su motivo). En revisión o aprobado, «Volver a enviar» abre el trámite con su aviso («el envío nuevo sustituye al que está en revisión» / «sigues remitiendo con el actual») y «Cancelar». Sin firmar, devuelto o revocado, el trámite está abierto: el texto de entrada, «Obligado tributario: {razón social} ({NIF}), el emisor de Facturación.» (se lee, no se pide), «1 · Consigue el modelo oficial» con «Descargar el modelo» (el modelo en blanco del SaaS) y cómo firmarlo (a mano o con AutoFirma); con una sociedad, «Representante legal» con «Nombre y apellidos de quien firma» y «NIF/NIE de quien firma» (un autónomo firma él mismo y no se le pide); la información básica del art. 13 RGPD antes de pedir ningún documento; «2 · Sube el modelo firmado» con «Documento de identidad» (DNI / NIE) y los adjuntos, cada uno un PDF de 5 MB como máximo: «Adjuntar el modelo firmado (PDF)», «Adjuntar copia del documento de identidad (PDF)», con NIE «Adjuntar muestra de firma (PDF)» y con sociedad «Adjuntar el justificante de representación (PDF)»; «Enviar a revisión». Sin emisor en Facturación o mientras la cuenta no haya vinculado el negocio, lo dice y no envía. Solo quien configura VeriFactu ve el trámite. Si la cuenta aún no ha enviado nada, «Tu cuenta de ERPlora todavía no ha enviado este dato.». - «Mi certificado»: «Certificado del negocio (.p12 / .pfx)» con «Cargado» / «Sin cargar», «Titular», «NIF del titular», «Tipo», «Subido el» y «Caduca el» (con el aviso «Caduca en {n} días: sube aquí el renovado.» a 30 días o menos y «El certificado ha caducado. Sube uno vigente para poder enviar a la AEAT.»). Quien configura VeriFactu ve «Elegir el fichero .p12 / .pfx», «Contraseña del certificado», «Subir el certificado» y, con uno cargado, «Quitar» (pregunta antes, en una tarjeta). Nota: «El certificado y su contraseña se guardan cifrados en este Hub y solo viajan a la pasarela de ERPlora al enviar a la AEAT; no se vuelven a mostrar.».

Ajustes

Menú VeriFactu → Ajustes. Título «Ajustes de VeriFactu». Tres bloques: - «Envío»: «Usar mi propio certificado» (interruptor, con su explicación según la vía) y «Entorno AEAT» con la pastilla «Pruebas (AEAT Test)» o «Producción» y, según el caso, «Pasar a producción» (con «Todavía no puede pasar a producción:» y lo que falta, si falta algo) o «Volver a pruebas» con su explicación y su confirmación; en producción, «Las ventas y facturas nuevas se rechazan hasta que se resuelva:» y el motivo, si no hay ruta a la AEAT, y «Los registros están esperando:» y por qué, si esperan. - «Prueba en vivo»: «Probar la conexión» y «Crear factura de prueba»; debajo, el resultado de la última prueba («Se remite», «Entorno», «Pasarela de ERPlora», «Emisor», «Puede enviar»), o «Aún no has ejecutado ninguna prueba.». - «Declaración responsable»: «Leer la declaración firmada», «Versión de la declaración» y los «Datos identificativos de este sistema» (Productor, NIF del productor, Nombre del sistema, Código del sistema, Versión instalada, Número de instalación, Solo VERI*FACTU, Puede dar servicio a varios obligados, Da servicio a varios obligados: siempre «S»). Avisos de la pantalla: el resultado de cada acción en una franja arriba (verde si fue bien, roja si no).

Estados de cada pantalla

Flujos

VERIFACTU-F01 Activar VeriFactu

Estado: hecho — encender la app en el Hub es activarla (la activación por hub llega con la fase 2) Actor: administrador Pantalla: Hub: Apps Pasos: 1. En las apps del Hub, enciende VeriFactu (se enciende Facturación con ella). 2. Desde ese momento cada factura que emite Facturación se registra (VERIFACTU-F13) en el entorno de pruebas. Entra: nada más que la orden. Sale: la app activa; sin interruptor propio. Si falla: lo dice la página de apps del Hub. Implicados: INVOICE-F01

VERIFACTU-F02 Subir el certificado propio del negocio

Estado: hecho — en el Hub; cifrado en la BD del hub con FISCAL_CERTIFICATE_KEY Actor: propietario y administrador (configurar) Pantalla: Configuración Pasos: 1. En VeriFactu → Configuración, pestaña «Mi certificado», pulsa «Elegir el fichero .p12 / .pfx» y elige el certificado del negocio (como mucho 1 MB). 2. Escribe su contraseña en «Contraseña del certificado» y pulsa «Subir el certificado». 3. El Hub lo abre con la contraseña, lee titular, NIF, tipo y caducidad y lo guarda cifrado (Fernet) junto con la contraseña en la base de datos del hub. Sale «Certificado subido: {titular} ({NIF}).» y la pestaña pasa a «Cargado». Subir otro sustituye al anterior. Entra: el .p12/.pfx en base64 y su contraseña (verifactu.certificate.upload). Sale: el certificado guardado (OwnCertificate), un evento «Certificado propio de … subido» y el aviso verifactu.config.changed. El fichero y la contraseña no se vuelven a mostrar: ni en la API, ni en el admin, ni en la foto, ni en los registros del servidor. Si falla: el certificado no se guarda (409): - sin clave de almacenamiento en el servidor, «Este servidor aún no puede guardar certificados: ERPlora tiene que configurar su clave de almacenamiento.» (verifactu.certificate_storage_unavailable); - sin emisor, «Configura antes el emisor en Facturación → Emisor.» (verifactu.issuer_missing); - contraseña mala o fichero que no es un .p12, «El fichero no es un certificado .p12/.pfx que abra esta contraseña.»; sin uso de autenticación de cliente, «El certificado no permite la autenticación de cliente, así que no puede conectar con la AEAT.»; caducado, «El certificado caducó el {fecha}: sube uno vigente.» (todos verifactu.certificate_invalid); - titular distinto del emisor de Facturación, «El certificado es de {NIF}, no del emisor de este negocio, {NIF}.» (verifactu.certificate_holder_mismatch): por la vía propia se presentaría en nombre de otro. Implicados: VERIFACTU-F04, VERIFACTU-F34

VERIFACTU-F03 Quitar el certificado propio

Estado: hecho — en el Hub Actor: propietario y administrador (configurar) Pantalla: Configuración Pasos: 1. En «Mi certificado», con uno cargado, pulsa «Quitar»; una tarjeta pregunta «¿Quitar el certificado?». 2. Al confirmar, el certificado se borra de la base de datos del hub, sale «Certificado quitado.» y la pestaña pasa a «Sin cargar». 3. Si la vía era «mi certificado», los registros dejan de poder salir hasta subir otro o elegir ERPlora (VERIFACTU-F04): esperan en la cola con el motivo «tu certificado propio no está cargado o ha caducado». Entra: nada (verifactu.certificate.remove). Sale: el certificado borrado, un evento «Certificado propio de … quitado» y el aviso verifactu.config.changed. Si falla: sin permiso de configurar, 403. Implicados: VERIFACTU-F04

VERIFACTU-F04 Elegir quién remite: mi certificado o ERPlora

Estado: hecho Actor: administrador Pantalla: Ajustes Pasos: 1. En VeriFactu → Ajustes, el interruptor «Usar mi propio certificado» enseña la vía actual con su explicación: «ERPlora remite tus registros a Hacienda en tu nombre, con su propio sello. No necesitas certificado.» o «Envías tú directamente a Hacienda con el certificado de tu negocio, subido en Configuración → Mi certificado.». 2. Cámbialo. 3. Sale «Listo: a partir de ahora envías con tu propio certificado.» o «Listo: a partir de ahora remite ERPlora en tu nombre.». Entra: la vía elegida; el certificado subido (VERIFACTU-F02) y el estado de la autorización, de la cuenta. Sale: la vía guardada; los registros siguientes salen por ella (avisa verifactu.config.changed). Si falla: sin certificado vigente, «No hay ningún certificado válido cargado: súbelo en VeriFactu → Configuración → Mi certificado.»; en producción y por la vía de ERPlora sin autorización aprobada, «Para que ERPlora remita en producción falta que apruebe tu autorización firmada.». El interruptor vuelve a la vía real. Implicados: VERIFACTU-F02, VERIFACTU-F05

VERIFACTU-F05 Firmar y subir el otorgamiento de representación para que remita ERPlora

Estado: hecho — se sube en el Hub (como el módulo antiguo), lo revisa el staff en el SaaS y el estado vuelve en la foto (ronda §25, PLAN-SAAS §4) Actor: administrador (permiso «configurar») Pantalla: Configuración Pasos: 1. En VeriFactu → Configuración, pestaña «Lo remite ERPlora», el estado dice «Sin firmar». 2. «Descargar el modelo» baja el modelo oficial en blanco (Anexo I del Convenio 17, el del SaaS); se rellena y se firma fuera de la pantalla: a mano (y se escanea a PDF, con el sello si es una sociedad) o con AutoFirma. 3. Una sociedad escribe su representante legal (nombre y NIF/NIE); un autónomo firma él mismo. 4. Se elige el documento de identidad (DNI o NIE) y se adjuntan los PDF: el modelo firmado, la copia del documento, con NIE una muestra de la firma y, con sociedad, el justificante de representación. 5. «Enviar a revisión»: el Hub comprueba los documentos y los reenvía tal cual al SaaS; queda «En revisión». 6. Una persona de ERPlora lo revisa en el SaaS; la cuenta manda al Hub el estado nuevo: «Aprobado», «Devuelto» (con el motivo) o «Revocado». Entra: el emisor de Facturación (obligado tributario), el representante, el tipo de documento y los PDF en base64 (verifactu.representation.submit); el modelo, de verifactu.representation.model. Sale: POST /internal/hubs/{id}/representation al SaaS; «En revisión» (uno aprobado sigue vigente y remitiendo hasta que se apruebe el nuevo), su huella en «Lo que has enviado» y en el registro de auditoría (número, fecha, tipo de documento y qué documentos; nunca su contenido) y el aviso verifactu.config.changed. El Hub no guarda ningún documento. Aprobado, abre la vía de ERPlora en producción (VERIFACTU-F08). Si falla: antes de llamar, con los códigos del SaaS (422): falta el modelo («Adjunta el modelo firmado.»), no es un PDF («El modelo firmado tiene que ser un PDF — escanéalo o fírmalo con AutoFirma.»), falta la copia del documento, con NIE la muestra de firma, con sociedad el representante o el justificante, un fichero de más de 5 MB («Cada fichero puede ocupar 5 MB como máximo.»); el rechazo del SaaS, con su código fiscal.* y sus campos tal cual; sin emisor, 409 verifactu.issuer_missing; sin la foto de la cuenta (el Hub aún no sabe su id en ERPlora) o un negocio que el SaaS no conoce, 409 verifactu.hub_unregistered («ERPlora todavía no ha vinculado este negocio.»); sin el SaaS, 503 verifactu.saas_unreachable («ERPlora no ha podido atenderlo ahora mismo. Inténtalo en unos minutos.»). Implicados: VERIFACTU-F08

VERIFACTU-F06 Volver a enviar el otorgamiento

Estado: hecho — en el Hub, como VERIFACTU-F05 Actor: administrador (permiso «configurar») Pantalla: Configuración Pasos: 1. Devuelto o revocado, el trámite ya está abierto: se corrige lo que dice el motivo y se envía de nuevo. 2. En revisión o aprobado, «Volver a enviar» lo abre y avisa: el envío nuevo sustituye al que está en revisión; con uno aprobado, se sigue remitiendo con él mientras se revisa el nuevo. «Cancelar» lo cierra. Entra: como VERIFACTU-F05. Sale: como VERIFACTU-F05; el envío lleva el número siguiente. Si falla: como VERIFACTU-F05. Implicados: VERIFACTU-F05

VERIFACTU-F07 Solicitar o renovar la conexión segura con ERPlora

Estado: desaparece — sin identidad por hub (ronda 5); el Hub firma cada llamada con HMAC Actor: ninguno Pantalla: ninguna Pasos: 1. No hay nada que pedir ni que renovar. 2. El Hub y la cuenta de ERPlora se hablan por su canal interno firmado. Entra: nada. Sale: nada. Si falla: no aplica. Implicados: ninguno

VERIFACTU-F08 Pasar a producción

Estado: hecho — producción = despliegue prod ∧ VERIFACTU_PRODUCTION_ENABLED ∧ (vía propia con certificado válido | vía ERPlora con otorgamiento aprobado y live_paid) ∧ cuenta activa (status de la foto); el servidor lo tiene cerrado hasta que ERPlora lo abra (bajo supervisión de Ioan). En pre nunca se abre: todo va a pruebas. Un hub demo nunca pasa a producción (verifactu.go_live_forbidden). Actor: administrador Pantalla: Ajustes Pasos: 1. En VeriFactu → Ajustes, «Entorno AEAT» enseña «Pruebas (AEAT Test)» y «Tus facturas van al entorno de pruebas de la AEAT. Cuando esté todo listo, pasa a producción.». Si falta algo, debajo sale «Todavía no puede pasar a producción:» con la lista (negocio de demostración, otorgamiento sin aprobar, certificado propio que falta o ha caducado, la opción en vivo que no está en el plan, cuenta con un pago pendiente o suspendida) y «Pasar a producción» queda desactivado. 2. Pulsa «Pasar a producción» y confirma en «¿Enviar tus facturas a la AEAT de verdad?» («A partir de ahora cada registro se remite a la AEAT real. En cuanto se selle el primero ya no podrás volver a pruebas.»). 3. Sale «Tu negocio está en producción: los registros ya se remiten a la AEAT real.» y la pastilla pasa a «Producción». Entra: el emisor de Facturación; la vía y su estado; de la foto de la cuenta (verifactu.config.sync), el otorgamiento, live_paid y el estado del negocio. Sale: el entorno en producción (avisa verifactu.config.changed): los registros nuevos nacen en la cadena de producción, con el QR de la sede real; los que nacieron en pruebas siguen yendo a pruebas. Si falla: mientras ERPlora no lo abra en el servidor, «El paso a producción todavía no está abierto en este servidor: ERPlora lo abre cuando la remisión real esté lista.» (en Ajustes, en la lista de lo que falta: «ERPlora todavía no ha abierto la presentación real a la AEAT en este servidor», production_closed); sin la pasarela del SaaS en el servidor, «La pasarela de envío de ERPlora no está configurada en este servidor: nada podría llegar a la AEAT.» (verifactu.gateway_unavailable); con un certificado propio que este servidor no abre (la clave FISCAL_CERTIFICATE_KEY falta o se rotó), «Tu certificado propio no se puede abrir en este servidor: vuelve a subirlo en VeriFactu → Configuración → Mi certificado.» (verifactu.own_certificate_unreadable); en un hub demo, «Un negocio de demostración no puede pasar a producción: siempre presenta en el entorno de pruebas de la AEAT.» (verifactu.go_live_forbidden; quién es demo lo dice la plataforma, base.operations.is_demo_hub); sin emisor, «Configura antes el emisor en Facturación → Emisor.»; por la vía de ERPlora sin autorización aprobada, «Para pasar a producción por la vía de ERPlora falta que apruebe tu autorización firmada.»; por la vía de ERPlora sin la opción en vivo en el plan, «La opción en vivo de VeriFactu no está en tu plan: añádela en tu cuenta de ERPlora.» (verifactu.live_option_unpaid); con la cuenta con un pago pendiente o suspendida, «Tu cuenta de ERPlora tiene un pago pendiente o está suspendida: regulariza el pago en tu cuenta de ERPlora para pasar a producción.» (verifactu.hub_not_active); con certificado propio que falta o ha caducado, «Tu certificado propio no está cargado o ha caducado.». Todos son 409 y el entorno sigue en pruebas. Ya en producción, no hace nada. Si en producción se pierde la ruta (la foto deja de traer la opción en vivo o el otorgamiento aprobado, o caduca el certificado propio), no se vuelve a pruebas (ya hay registros de producción): no se sella nada nuevo —la venta o la factura se rechazan con 409 y el código de la ruta (verifactu.live_option_unpaid, verifactu.representation_not_approved, verifactu.own_certificate_missing) y «No se ha emitido nada: este negocio presenta en real a la AEAT y ahora no puede hacerle llegar sus registros: . Resuélvelo en VeriFactu → Ajustes y vuelve a intentarlo.»— y Ajustes lo dice bajo «Las ventas y facturas nuevas se rechazan hasta que se resuelva:» (issue_blocker). Lo ya sellado sigue saliendo sin la opción en vivo (es de la AEAT); sin otorgamiento aprobado o sin certificado válido espera, porque la pasarela no podría presentarlo. Cambiar a la vía de ERPlora en producción sin la opción se rechaza igual. Del Hub antiguo (fiscal_profile::go_live): el orden (cerrado → demo → vía → listo), el certificado propio sin otorgamiento y el 409 con el código de la causa. Nuevo por el modelo de Ioan del 2026-10-15: la opción de pago (antes VeriFactu era gratis) y el estado de la cuenta, que antes solo frenaba el token de la pasarela en el SaaS. Implicados: VERIFACTU-F05, VERIFACTU-F09

VERIFACTU-F09 Volver a pruebas

Estado: hecho Actor: administrador Pantalla: Ajustes Pasos: 1. En producción y sin ningún registro sellado en producción, sale «Todavía no se ha sellado ningún registro en producción, así que aún puedes volver a pruebas.» y «Volver a pruebas». 2. Confirma en «¿Volver al entorno de pruebas?». 3. Sale «Tu negocio ha vuelto al entorno de pruebas.». Entra: si hay registros de producción. Sale: el entorno en pruebas (avisa verifactu.config.changed). Si falla: con un registro de producción ya sellado (una venta basta), «No se puede volver a pruebas: este negocio ya tiene registros en producción.» y el botón no aparece. Implicados: VERIFACTU-F08

VERIFACTU-F10 Probar la conexión con la AEAT

Estado: hecho — con la sonda de la pasarela del SaaS (/internal/verifactu/probe) Actor: responsable, administrador Pantalla: Ajustes Pasos: 1. En VeriFactu → Ajustes, «Prueba en vivo», pulsa «Probar la conexión» («Probando…»). 2. El Hub comprueba, sin presentar nada a la AEAT, todo lo que hace falta para enviar: el emisor, los datos del productor, la vía y su estado y, si la pasarela está configurada, le pregunta si puede presentar ahora. 3. Debajo sale el resultado, línea a línea, y «Puede enviar» o «No puede enviar: {motivo}». Entra: la configuración del Hub; la respuesta de la sonda de la pasarela. Sale: el resultado como evento «Prueba de conexión» (avisa verifactu.diagnostic.run), sin crear ningún registro ni tocar la cadena. Si falla: lo que falta, dicho en el resultado. Nunca presenta un registro de muestra: un registro remitido no se puede deshacer. Implicados: VERIFACTU-F15

VERIFACTU-F11 Crear una factura de prueba

Estado: hecho Actor: administrador Pantalla: Ajustes Pasos: 1. Con el negocio en pruebas, en VeriFactu → Ajustes, «Prueba en vivo», pulsa «Crear factura de prueba» («Creando…»). En producción el botón no aparece. 2. VeriFactu pide a Facturación un tique (F2) de una línea «Prueba VeriFactu» de 1,00 € más el 21 % de IVA en la serie TICKET, por la misma puerta que el alta manual (INVOICE-F03). 3. Sale «Factura de prueba {número} creada: su registro está en Registros.». Entra: nada que escribir. Sale: una factura real de Facturación en pruebas y su registro, que sale como cualquier otro. Si falla: el rechazo de Facturación (sin emisor, sin permiso de emitir). Implicados: INVOICE-F03

VERIFACTU-F12 Consultar la declaración responsable

Estado: hecho Actor: empleado, responsable, administrador Pantalla: Ajustes Pasos: 1. En VeriFactu → Ajustes, tarjeta «Declaración responsable», «Leer la declaración firmada» abre la publicada en erplora.com; al lado, «Versión de la declaración». 2. «Datos identificativos de este sistema» enseña los datos del productor, la versión instalada y el número de instalación (el identificador de este negocio en ERPlora). Entra: la declaración (fija en la versión del Hub). Sale: nada; es consulta. Si falla: el mensaje del fallo. Implicados: ninguno

VERIFACTU-F13 Registrar una factura emitida

Estado: hecho — Facturación lo pide por nombre dentro de su emisión; la reacción del outbox (relay de la fase 2) queda de respaldo Actor: quien emite (su propia sesión); en la reacción al aviso, el sistema Pantalla: ninguna Pasos: 1. Facturación emite una factura o un tique (al cobrar, a mano o la factura de prueba). 2. En la misma transacción que la emite, con la sesión de quien emite, Facturación pide a VeriFactu su registro (el registro lleva a ese usuario en «creado por»). Solo si la base de datos falla un momento (un cerrojo, una conexión) el documento queda «pendiente» y la reacción al aviso invoice.invoice.issued lo sella después, como el sistema. 3. VeriFactu lee la factura (número, fechas, emisor, cliente, importes, desglose por clave fiscal y la factura que rectifica o sustituye) y la comprueba: el desglose suma la base y la cuota, la cuota de cada clave cuadra con su tipo, no pasa de 12 claves (las que admite la AEAT; nunca se recorta), una factura ordinaria no suma en negativo, una completa identifica al cliente. 4. Sella el registro de alta: bloquea la fila de su cadena (NIF del emisor y entorno), le da el siguiente número, calcula su huella con la del registro anterior y fija su QR en la sede del entorno (pruebas o real). Valida siempre su XML contra el esquema oficial; con los datos del productor ya recibidos lo guarda, y sin ellos lo valida con un SistemaInformatico provisional que no se guarda (su XML se construye antes del primer envío). 5. El registro aparece en Registros como «Pendiente» y sale en la siguiente pasada (VERIFACTU-F15). Entra: la factura emitida, de Facturación (por su id). Sale: el registro sellado (avisa verifactu.record.created). Si falla: si no cuadra o el XML no pasa el esquema, no se escribe nada ni se gasta número, y la emisión entera se deshace (Facturación devuelve el número a su serie): reintentarlo fallaría igual. Una factura que ya tiene registro contesta el mismo: nunca dos registros ni dos números, tampoco con dos entregas a la vez. Una factura que no existe no hace nada. Implicados: INVOICE-F01, INVOICE-F02, INVOICE-F03, INVOICE-F04, INVOICE-F05

VERIFACTU-F14 Registrar una factura rectificativa

Estado: hecho — igual que F13 Actor: sistema Pantalla: ninguna Pasos: 1. Facturación emite una rectificativa (R1–R5, por diferencias, importes negativos): una devolución, la anulación de una venta (R5 del tique) o una corrección a mano. 2. VeriFactu la registra como un alta más, con su tipo R, TipoRectificativa = I y la factura que rectifica (NIF, número y fecha). La anulación de una venta es una rectificativa: no es un registro de anulación (eso es VERIFACTU-F30). Entra: la rectificativa emitida, de Facturación. Sale: el registro de alta de la rectificativa (avisa verifactu.record.created). Si falla: como VERIFACTU-F13. Implicados: INVOICE-F07, INVOICE-F08, INVOICE-F09, INVOICE-F10

VERIFACTU-F15 Enviar el registro a la AEAT y recoger su respuesta

Estado: hecho — lo envía el worker por la pasarela del SaaS; sin VERIFACTU_GATEWAY_URL los registros esperan en la cola Actor: sistema Pantalla: ninguna Pasos: 1. La pasada de envío (cada minuto, VERIFACTU-F20, o «Procesar cola») toma cada cadena cuya espera de la AEAT (TiempoEsperaEnvio) ya pasó y cuyo primer registro pendiente ya toca, y junta sus registros pendientes en orden de cadena, hasta 1.000 en un envío. 2. Construye el sobre (el obligado, quien presenta si es ERPlora y, si alguno ya intentó salir antes, Incidencia = S), lo valida contra el esquema y lo manda a la pasarela de ERPlora, que lo presenta a la AEAT del entorno de los registros con el sello de ERPlora o con tu certificado y devuelve su respuesta. 3. Con la respuesta, cada registro queda «Aceptado» (con su CSV), «Aceptado con errores» (está en la AEAT; se guarda el código), o «Rechazado» (con el código y el mensaje de la AEAT; VERIFACTU-F24). Un «duplicado» (3000) de un registro que la AEAT ya tenía aceptado cuenta como aceptado. La espera que pide la AEAT se guarda en la cadena y el siguiente envío no sale antes. 4. Si no hay respuesta (la pasarela o la AEAT caídas): el registro sigue «Pendiente» con «Intentos» +1 y el próximo intento a 5, 10, 20, 40 y 60 minutos, sin límite. Si la petición salió pero no volvió nada, queda «Enviado» y se vuelve a mandar con incidencia (la AEAT dirá «duplicado» si ya lo tenía). Entra: los registros pendientes; la vía; la respuesta de la pasarela. Sale: el estado y la respuesta en cada registro (avisa verifactu.record.transmitted y, según el caso, verifactu.record.rejected o verifactu.record.accepted_with_errors, sin importes). Si falla: sin pasarela configurada, sin datos del productor o sin vía lista, no se manda nada y cada registro dice por qué espera (VERIFACTU-F17). Nunca se da por aceptado un registro sin la respuesta de la AEAT. Implicados: VERIFACTU-F20

VERIFACTU-F16 Consultar los registros y su estado

Estado: hecho Actor: empleado, responsable, administrador Pantalla: Registros Pasos: 1. Abre VeriFactu → Registros. 2. Busca por número de factura, secuencia, nombre o NIF del emisor, o filtra por estado, tipo, tipo de factura, entorno, fecha y total. 3. Cada fila enseña su estado con color: verde «Aceptado», ámbar «Pendiente» / «Enviado» / «Aceptado con errores», rojo «Rechazado»; y su entorno, para no confundir pruebas con producción. Entra: los registros. Sale: nada; es consulta. Si falla: el mensaje con «Reintentar». Implicados: INVOICE-F16

VERIFACTU-F17 Ver el detalle de un registro y por qué espera

Estado: hecho Actor: empleado, responsable, administrador Pantalla: Ficha de registro Pasos: 1. En Registros, pulsa una fila. 2. Se abre «Registro {número}» con la factura, la cadena, el QR, la respuesta de la AEAT y el XML. 3. Si no está en la AEAT, «Aún no está en la AEAT» dice por qué («La pasarela de envío de ERPlora no está configurada en este servidor», «Sin vía de envío lista», «La AEAT pidió esperar hasta las {hora}», «No se pudo contactar: {motivo}») y cuándo: «Sale solo en la próxima pasada, en orden y declarado como envío tardío si ya falló antes. No tienes que hacer nada.» con el «Próximo intento». Entra: el registro. Sale: nada; es consulta. Si falla: «Registro no encontrado» o el mensaje del fallo. Implicados: VERIFACTU-F15

VERIFACTU-F18 Cotejar el QR en la sede de la AEAT

Estado: hecho Actor: empleado, responsable, administrador, cliente Pantalla: Registros Pasos: 1. En Registros, «Cotejar en la AEAT» en la fila (o en la ficha) abre en otra pestaña la página de cotejo de la AEAT con el NIF del emisor, el número, la fecha y el importe. 2. Un registro nacido en pruebas lleva a la sede de pruebas; uno de producción, a la sede real. 3. El cliente hace lo mismo escaneando el QR de su tique o su factura. Entra: el enlace del QR fijado al sellar. Sale: nada en el Hub. Si falla: un registro que aún no ha salido se ve en la AEAT como no encontrado; uno rechazado, nunca. Implicados: VERIFACTU-F19

VERIFACTU-F19 Dar el QR y el estado fiscal al tique y a la factura

Estado: hecho (Ventas e Impresión lo piden por nombre) Actor: sistema Pantalla: ninguna Pasos: 1. Cuando Ventas, Facturación o Impresión pintan un documento, piden a VeriFactu el registro de su factura. 2. VeriFactu devuelve el más reciente: su enlace y su imagen de QR, su CSV, su estado, su tipo y su huella. Entra: el id de la factura. Sale: el registro (verifactu.record.by_invoice); sin registro, nada (el documento sale sin QR). Si falla: sin VeriFactu activa o sin permiso de consulta, el documento sale sin QR. Implicados: INVOICE-F17, INVOICE-F18

VERIFACTU-F20 Enviar después lo que no pudo salir (contingencia automática)

Estado: hecho — la corre el worker cada minuto (en la fase 1, sobre un solo hub) Actor: sistema Pantalla: Contingencia Pasos: 1. Mientras se vende nada se para por esto: si la pasarela, la AEAT o la red están caídas, el cobro sigue y el registro espera. 2. Cada minuto (tarea programada process_queue) el sistema hace la pasada de VERIFACTU-F15 en todas las cadenas a las que les toca, cada una en su entorno; si se perdieron pasadas (servidor parado), al volver se hace una sola. 3. Lo que vuelve a fallar espera más (5, 10, 20, 40 y 60 minutos), sin límite de intentos. 4. Queda el evento «Cola procesada: {enviados} enviados, {aceptados} aceptados, {rechazados} rechazados, {en espera} en espera». Entra: los registros pendientes. Sale: los envíos y sus respuestas (avisa verifactu.contingency.processed). Si falla: lo que no sale sigue en la cola con su motivo. Implicados: VERIFACTU-F15

VERIFACTU-F21 Procesar la cola a mano

Estado: hecho Actor: responsable, administrador Pantalla: Contingencia Pasos: 1. En VeriFactu → Contingencia, pulsa «Procesar cola» («Procesando…»). 2. Se hace en ese momento la misma pasada que la automática. 3. Debajo de la tabla sale el resultado; la tabla se pone al día sola. Entra: la cola. Sale: como VERIFACTU-F20. Si falla: sin pasarela, «La pasarela de envío de ERPlora no está configurada en este servidor: los registros siguen en la cola y saldrán en cuanto lo esté.». Implicados: VERIFACTU-F20

VERIFACTU-F22 Reintentar una entrada de la cola

Estado: hecho Actor: responsable, administrador Pantalla: Contingencia Pasos: 1. En VeriFactu → Contingencia, pulsa «Reintentar» en la fila. 2. El registro (y los anteriores de su cadena, que salen antes que él) pasan a salir en la siguiente pasada; los intentos se conservan. Entra: el registro elegido. Sale: el registro reprogramado (avisa verifactu.contingency.retried). Si falla: un registro aceptado o rechazado no está en la cola: «Este registro no está en la cola.». Implicados: VERIFACTU-F21

VERIFACTU-F23 Descartar una entrada de la cola

Estado: desaparece — un registro generado no se descarta nunca Actor: ninguno Pantalla: ninguna Pasos: 1. Un registro que está en la cola tiene que llegar a la AEAT (FAQ §5); uno aceptado ya no está en la cola. 2. Lo único que sale de la cola sin un envío nuevo es lo que la AEAT ya tiene, preguntándoselo (VERIFACTU-F35); un rechazo se subsana con un registro nuevo (VERIFACTU-F24). Entra: nada. Sale: nada. Si falla: no aplica. Implicados: VERIFACTU-F24, VERIFACTU-F35

VERIFACTU-F24 Actuar ante un registro rechazado por la AEAT

Estado: hecho Actor: administrador Pantalla: Ficha de registro Pasos: 1. El registro sale en rojo «Rechazado» en Registros; en Eventos queda «Envío fallido» con el motivo. 2. En su ficha, «La AEAT lo ha rechazado» con el código y el mensaje literales de la AEAT y qué hacer: si el error está en los datos de la factura (un NIF de cliente que la AEAT no reconoce, un importe), se corrige en Facturación con una rectificativa; si no (un error de la cadena tras restaurar una copia, un fallo nuestro), «Subsanar». 3. «Subsanar» (con confirmación) sella un registro nuevo de la misma factura, leída otra vez, marcado como subsanación, que entra en la cola. El rechazado se queda tal cual. RechazoPrevio según la Descripción del servicio web VERI*FACTU v1.0.3: X si la AEAT no tiene ningún registro de esa factura (se rechazó el alta inicial; §9.1.3, «alta por rechazo»); S si la AEAT sí la tiene y lo rechazado fue una subsanación posterior. 4. Un «Aceptado con errores» también se puede subsanar (Subsanacion = S, RechazoPrevio = N; §9.1.2). Entra: el registro rechazado o aceptado con errores. Sale: el registro de subsanación (avisa verifactu.record.created). Si falla: solo se subsana un registro de alta rechazado o aceptado con errores, y solo el último de su factura: «Este registro no se puede subsanar.». Implicados: INVOICE-F08

VERIFACTU-F25 Reenviar un registro concreto

Estado: hecho — por la pasarela del SaaS Actor: responsable, administrador, asistente Pantalla: Ficha de registro Pasos: 1. En la ficha de un registro pendiente o enviado sin respuesta, pulsa «Enviar ahora». 2. Sale ya su cadena hasta él (los anteriores pendientes van delante, en orden), si la espera de la AEAT ya pasó. 3. El registro queda con la respuesta de la AEAT, como en VERIFACTU-F15. Entra: el registro elegido (por su id o por el número de su factura). Sale: el envío y su respuesta (avisa verifactu.record.transmitted). Si falla: sin pasarela, «La pasarela de envío de ERPlora no está configurada en este servidor: el registro sigue pendiente y saldrá en cuanto lo esté.»; ya aceptado, «Este registro ya está en la AEAT.»; con la espera de la AEAT en curso, «La AEAT pidió esperar: sale solo a las {hora}.». Nunca dice «aceptado» sin respuesta. Implicados: VERIFACTU-F15

VERIFACTU-F26 Verificar la cadena de huellas

Estado: hecho Actor: empleado, responsable, administrador Pantalla: Recuperación Pasos: 1. En VeriFactu → Recuperación, con el «NIF del emisor», pulsa «Validar cadena» («Validando…»). 2. El sistema recalcula la huella de cada registro de la cadena del entorno actual y comprueba que cada uno lleva la del anterior. 3. Sale «Operación completada.» y el veredicto: «Cadena de huellas íntegra: {total} registro(s) con su encadenado SHA-256 verificado ({nif}).» o «Cadena de huellas ROTA en la secuencia {seq} ({nif}).». Entra: los registros de la cadena. Sale: el veredicto como evento (avisa verifactu.chain.validated). Solo lee: no repara nada ni re-audita los importes. Si falla: sin registros de ese NIF, «No hay registros de ese emisor en este entorno.». Implicados: VERIFACTU-F28

VERIFACTU-F27 Consultar lo que tiene la AEAT

Estado: hecho — por la pasarela del SaaS (/internal/verifactu/query) Actor: responsable, administrador Pantalla: Recuperación Pasos: 1. En VeriFactu → Recuperación, pulsa «Consultar AEAT» («Consultando…»). 2. El sistema pregunta a la AEAT, por la pasarela, por los registros de ese emisor del mes en curso. 3. La tabla «Últimos registros en la AEAT» se llena y sale «Operación completada.». Entra: el NIF del emisor; la respuesta de la AEAT. Sale: la foto de lo que tiene la AEAT, que sustituye a la anterior (avisa verifactu.aeat.queried). No toca la cadena. Si falla: sin pasarela, el mensaje de la pasarela no configurada; un rechazo de la AEAT, su mensaje. Implicados: VERIFACTU-F28

VERIFACTU-F28 Recuperar la cadena desde la AEAT tras restaurar una copia

Estado: hecho — por la pasarela del SaaS (/internal/verifactu/query) Actor: administrador Pantalla: Recuperación Pasos: 1. Tras restaurar una copia de la base de datos (la AEAT tiene registros que la copia no), deja de emitir y abre VeriFactu → Recuperación. 2. Pulsa «Recuperar cadena desde la AEAT» y confirma («Se reconstruirá la continuidad local desde el último registro disponible en la AEAT. Verifica el NIF del emisor antes de continuar.»). 3. El sistema consulta a la AEAT y ancla la cadena del entorno actual en el último registro (por su fecha de generación) que la AEAT tiene de ese emisor en el mes en curso. Sale «Operación completada.». Entra: el NIF del emisor; la respuesta de la AEAT. Sale: un ancla nueva (avisa verifactu.chain.recovered): el siguiente registro se encadena sobre ella. Si falla: si la AEAT no tiene registros de ese emisor este mes, «La AEAT no tiene registros de ese emisor este mes: no hay nada que recuperar.» y no se ancla nada; con registros pendientes en la cadena, «Antes tienen que salir los registros pendientes de esta cadena.». Implicados: VERIFACTU-F26

VERIFACTU-F29 Continuar la cadena de otra aplicación (migración)

Estado: hecho Actor: administrador Pantalla: Recuperación Pasos: 1. En VeriFactu → Recuperación, bloque «Continuar cadena manualmente (migración)», escribe la «Última huella (64 hex)» de la aplicación anterior, el «Nº de factura» y la «Fecha» de ese último registro. 2. Pulsa «Continuar desde esta huella» y confirma («La huella indicada será el antecedente del próximo registro fiscal. Usa esta opción únicamente durante una migración.»). 3. Sale «Operación completada.»; la próxima factura se encadena sobre esa huella. Entra: la huella, el número y la fecha del último registro de la aplicación anterior. Sale: un ancla nueva (avisa verifactu.chain.recovered). Si falla: una huella que no tiene 64 caracteres hexadecimales, «La huella debe tener 64 caracteres hexadecimales»; sin número o fecha, que son parte del encadenado, el campo lo pide; con registros pendientes, como VERIFACTU-F28. Implicados: ninguno

VERIFACTU-F30 Anular un registro enviado por error

Estado: hecho Actor: administrador, asistente Pantalla: Ficha de registro Pasos: 1. Solo para una factura que nunca debió emitirse (un duplicado, una prueba hecha en producción). Una devolución o una corrección no se anula: es una rectificativa en Facturación (VERIFACTU-F14). 2. En la ficha del registro de alta, pulsa «Anular registro», escribe el motivo y confirma («Se declarará a la AEAT que esta factura se emitió por error. La factura sigue en Facturación.»). 3. Se sella un registro de anulación encadenado, que sale como cualquier otro, y aparece en Registros con tipo «Anulación». Entra: el registro de alta (o el número de su factura). Sale: el registro de anulación (avisa verifactu.record.created). Si falla: un alta rechazada no se anula (no está en la AEAT); una ya anulada, tampoco: «Este registro no se puede anular.». Si la AEAT rechazó la anulación, se puede volver a anular: la nueva lleva RechazoPrevio = S (§9.2.2, «anulación por rechazo»). Implicados: INVOICE-F07

VERIFACTU-F31 Vigilar los envíos desde las pantallas

Estado: hecho; el panel de Inicio con tarjetas es de la plataforma (aún no existe) Actor: empleado, responsable, administrador Pantalla: Registros, Contingencia, Eventos Pasos: 1. Registros y Contingencia dicen qué falta por llegar; Eventos, qué pasó. Las tres se ponen al día solas. 2. Los resúmenes (pendientes, por estado, cola y últimos eventos) se pueden pedir al asistente o por la API. Entra: los registros y los eventos. Sale: nada; es consulta. Si falla: el mensaje con «Reintentar». Implicados: ninguno

VERIFACTU-F32 Impedir apagar la app con registros sin enviar

Estado: servidor listo (verifactu.stats.compliance_summary); el apagado de apps es de la plataforma (fase 2) Actor: sistema Pantalla: Hub: Apps Pasos: 1. Al apagar VeriFactu (o Facturación, que se la lleva), la plataforma pregunta a VeriFactu cuántos registros no están en la AEAT. 2. Si queda alguno, lo niega. Entra: la petición de apagar. Sale: nada si se niega. Si falla: «VeriFactu aún tiene {n} registro(s) que la AEAT no ha aceptado.». Implicados: ninguno

VERIFACTU-F33 Cesar la actividad

Estado: no hecho — la baja censal es del negocio, fuera de ERPlora Actor: administrador Pantalla: ninguna Pasos: 1. El cese ante Hacienda es la baja censal (modelo 036/037), fuera de ERPlora. 2. El software no envía nada. Entra: nada. Sale: nada. Si falla: no aplica. Implicados: ninguno

VERIFACTU-F34 Renovar el certificado propio

Estado: hecho — en el Hub (subir el renovado sustituye al anterior) Actor: propietario y administrador (configurar) Pantalla: Configuración Pasos: 1. «Mi certificado» enseña «Caduca el {fecha}» y, a 30 días o menos, «Caduca en {n} días: sube aquí el renovado.». 2. El certificado nuevo se sube como en VERIFACTU-F02 y sustituye al anterior; la cadena no cambia. Entra: el certificado renovado. Sale: el nuevo, en lugar del anterior. Si falla: caducado y con la vía «mi certificado», los registros esperan con el motivo; si el servidor cambió su clave de almacenamiento y no puede abrir el guardado, esperan con «tu certificado propio no se puede abrir en este servidor: vuelve a subirlo». Implicados: VERIFACTU-F02

VERIFACTU-F35 Preguntar a la AEAT si ya tiene un registro de la cola

Estado: hecho — en el admin de Django del Hub (soporte) y por la API; en la SPA, aún sin botón Actor: responsable, administrador (enviar); el staff de ERPlora desde el admin Pantalla: admin de Django (hubs.erplora.com/admin, Registros → «Consultar a la AEAT (sale de la cola si ya lo tiene)») Pasos: 1. Un registro se quedó «enviado, sin respuesta» (o pendiente) y puede que la AEAT ya lo tenga. 2. Se consulta a la AEAT, por la pasarela de ERPlora, el emisor del registro en el mes de su fecha de expedición (como VERIFACTU-F27, que renueva la última foto). 3. Si la AEAT devuelve ese mismo registro (mismo emisor, número y huella), sale de la cola como «Aceptado» o «Aceptado con errores», según lo que diga la AEAT, sin perder sus intentos; queda un evento con quién lo hizo. 4. Si no lo tiene (o tiene otro registro de la misma factura, p. ej. el original de una subsanación), no cambia nada: sigue en la cola y se envía en la siguiente pasada. Entra: el registro (id o número de su factura). Sale: si la AEAT lo tenía y el registro (avisa verifactu.record.reconciled; la consulta, verifactu.aeat.queried). Si falla: un registro aceptado o rechazado no está en la cola: «Este registro no está en la cola.»; sin pasarela o si la AEAT no contesta, el motivo de la pasarela, y el registro sigue en la cola. Implicados: VERIFACTU-F22, VERIFACTU-F23, VERIFACTU-F27

Servicios: lo que entra y lo que sale

Todo se puede pedir por las pantallas, el asistente (por voz o por texto, con la sesión de la propia persona) y la API, con las mismas reglas y permisos. Pensado para la voz: un registro se nombra por el número de su factura (TICKET-2026-000012) o por su secuencia; un emisor, por su NIF.

Lo que ofrece: consultas (leen, no cambian nada)

Todas se pueden seguir en vivo.

Lo que ofrece: acciones (cambian datos)

Lo que avisa

A qué reacciona

Corre como el sistema, en su propia transacción, y es idempotente: un registro de alta por factura y entorno. Es el respaldo: Facturación lo pide dentro de su emisión (contrato abajo) y el aviso de un documento ya sellado no añade nada (already).

Lo que necesita de otras apps

• Facturación (requisito): la factura emitida (Invoice), leída de su fila por su id; para la factura de prueba, su operación invoice.invoice.create. Un registro guarda su factura con PROTECT (la ley conserva las dos); lo que eso exige a las pruebas de Facturación, en «Contrato con Facturación».

Quién la usa

Quién puede qué

Los papeles llegan del SaaS con prefijo (hub_owner, hub_admin, hub_manager, hub_employee). Guardar lo que manda la cuenta (verifactu.sync_config) no es de ningún papel: solo del sistema.