Glosario VeriFactu

Organismo encargado de la gestión del sistema tributario estatal en España.

En el contexto de OkVerifactu, es la entidad a la que finalmente se registran las facturas mediante el sistema VeriFactu.

Las facturas tienen validez legal.

Se usan API Keys de producción.

El QR de VeriFactu se muestra al cliente en sus PDFs.

Se envían notificaciones reales y se guardan evidencias válidas ante AEAT.

Se recomienda activarlo solo cuando:

• La representación esté validada.

• Se hayan hecho pruebas previas en modo Test.

Las facturas no tienen validez legal.

Se usa la API Key de Test.

Los clientes normalmente no ven el QR en su área de cliente.

Permite probar todo el flujo sin afectar a la contabilidad real.

Ideal para:

• Configurar el módulo de PrestaShop.

• Verificar payloads, estados y webhooks.

• Simular errores y reintentos.

Conjunto de endpoints HTTP que OkVerifactu expone para que otros sistemas (como PrestaShop o un ERP propio) puedan enviar facturas, consultar estados, etc.

• Se accede mediante API Keys.

• Devuelve respuestas en JSON.

• Permite automatizar completamente la comunicación con el sistema VeriFactu.

Cada emisor tiene normalmente una API Key de Test y otra de Producción.

Se deben tratar como contraseñas: no publicarlas ni compartirlas.

En el módulo de PrestaShop, se pegan en la configuración del módulo.

• Aún no se ha enviado correctamente a VeriFactu/AEAT, o

• El estado no cumple los requisitos de integridad y registro.

Objetivo: garantizar que el cliente solo pueda descargar facturas ya registradas o correctamente procesadas según la normativa.

• Permite al cliente o a la administración verificar la factura escaneándola.

• Enlaza a una URL de verificación donde se comprueba la validez y el registro.

• OkVerifactu lo genera automáticamente cuando la factura se procesa correctamente.

En PrestaShop:

• El módulo lo inyecta en los PDF de factura.

• En el back-office suele verse siempre.

• En el área de cliente se muestra según el modo (Test/Producción) y estado de la factura.

Permite verificar la autenticidad del documento accediendo a la sede electrónica.

En el contexto de VeriFactu, puede estar presente junto con el QR y el hash como parte de las evidencias de registro.

Muestra métricas de facturas enviadas, registradas y con errores.

Ofrece gráficos de evolución, estados y tipos de factura.

Informa del uso de plan y alertas (límites, exceso, etc.).

Es el "panel de mando" para ver de un vistazo la salud de la integración.

En OkVerifactu y en el módulo de PrestaShop:

• Las devoluciones se registran como facturas rectificativas.

• Se asocian a un pedido/factura original.

• Generan un flujo VeriFactu específico (tipos R1–R5).

Puede ser una empresa (SL, SA…) o un autónomo.

Se identifica por su NIF.

En OkVerifactu cada emisor tiene:

• Sus datos fiscales.

• Sus API Keys.

• Su plan / suscripción.

• Su configuración de ambiente (Test/Producción).

Es la unidad básica de configuración en OkVerifactu.

• pending – Documento creado, pendiente de envío.

• sending – Enviando a OkVerifactu.

• enviada_verifactu – Enviado a VeriFactu, pendiente de confirmación.

• registrada_aeat – Registrada correctamente en la AEAT (estado final correcto).

• rechazada_aeat – AEAT rechaza la factura (datos incorrectos u otra causa).

• error, error_temporal, error_aeat, invalid – Diferentes tipos de error técnico o de validación.

Se usan para:

• Bloquear/permitir descargas.

• Mostrar el estado en PrestaShop y en el panel de OkVerifactu.

• Decidir si se puede reintentar el envío.

• `registrada_aeat`: factura aceptada y registrada correctamente.

• `parcialmente_correcta`: aceptada con avisos o advertencias.

• `rechazada_aeat`: no aceptada por error crítico (requiere corrección o rectificativa).

OkVerifactu:

• Guarda estos estados como parte de las evidencias.

• Los envía a la tienda (por ejemplo, PrestaShop) mediante webhooks.

• Permite consultarlos desde el panel por factura.

• JSON enviado al sistema que actúa como SIF.

• JSON de respuesta.

• Hash de la factura.

• Hash encadenado (`chain_previous_hash`).

• QR y/o CSV.

• Estados devueltos por la AEAT (si aplica).

• Timestamps de eventos (envío, registro, rechazo, reintentos).

En OkVerifactu:

• Se guardan de forma centralizada por factura.

• Son clave para auditorías, inspecciones y trazabilidad legal.

Datos completos del emisor y del cliente.

Desglose de bases imponibles e impuestos.

Obligatoria en la mayoría de operaciones B2B.

En el sistema VeriFactu se identifica normalmente como tipo F1.

Debe cumplir los requisitos legales (contenido, formato, firma o sistema de control).

Con OkVerifactu, la factura se genera en tu sistema (por ejemplo, PrestaShop) y se registra electrónicamente en la AEAT mediante VeriFactu.

Menor nivel de trazabilidad.

Menor nivel de garantías ante inspecciones.

La tendencia normativa es a sustituir estas facturas por facturas verificables.

Incluye QR, hash y/o CSV.

Permite confirmar que el contenido no ha sido alterado y que está registrado.

Es el objetivo del sistema VeriFactu, y lo que OkVerifactu implementa junto con la AEAT.

• R1 – Rectificación por errores en la factura.

• R2 – Rectificación por modificación de la base imponible.

• R3 – Rectificación por modificación de la cuota.

• R4 – Rectificación por crédito incobrable.

• R5 – Otros supuestos de rectificación.

En PrestaShop, las devoluciones (abonos) se convierten en facturas rectificativas que OkVerifactu envía a la AEAT como tales.

En VeriFactu / OkVerifactu:

• Se calcula a partir de los datos de la factura.

• Permite comprobar si el contenido ha sido modificado.

• Se encadena con otros registros de facturación para crear trazabilidad.

Envía automáticamente facturas y devoluciones.

Recibe estados y QR mediante webhooks.

Bloquea/permite descargas de facturas según el estado.

Añade menús de facturas, rectificativas y logs en el back-office.

Peticiones a la API.

Respuestas de OkVerifactu.

Webhooks recibidos.

Errores y estados intermedios.

Sirven para:

• Diagnosticar problemas.

• Demostrar trazabilidad técnica.

• Hacer soporte y auditoría.

• Modo VeriFactu (verificable):

- Envía los registros de facturación a la AEAT en tiempo casi real.

- Permite que el cliente verifique su factura en la Sede Electrónica.

• Modo no verificable:

- No envía automáticamente a la AEAT.

- Exige igualmente hash, encadenamiento, registro técnico y evidencias.

OkVerifactu trabaja siguiendo estos criterios técnicos y se integra con infraestructura que soporta modalidad VeriFactu cuando procede.

Usa las API Keys del emisor.

Automatiza el envío de facturas y devoluciones.

Controla la descarga de PDFs.

Gestiona estados y reintentos.

Añade el QR a las facturas.

Es la pieza que convierte la tienda en un SIF conectado a VeriFactu.

Identifica a empresas, autónomos y, en algunos casos, particulares.

Es obligatorio tanto para emisores como para determinados tipos de clientes.

La AEAT valida su formato y coherencia en el proceso VeriFactu.

En una llamada a la API.

En un webhook.

Incluye datos como:

• ID de factura.

• Número de factura.

• Importe, impuestos.

• Estado.

• Hash, QR, etc.

Es la "carga útil" de la comunicación entre sistemas.

Incluye productos, precios, impuestos, transporte y datos de cliente.

A partir del pedido se genera la factura.

El módulo de OkVerifactu enlaza cada factura con su pedido y envía la información correspondiente a la API.

Define cuántas facturas mensuales puedes enviar incluidas en el precio.

Indica el coste base (mensual o anual).

Determina el precio de las facturas extra.

Se gestiona desde la sección de Facturación / Planes en el panel.

Contiene datos clave de la operación (fecha, emisor, base imponible, impuestos, etc.).

Debe seguir el esquema técnico definido por la normativa.

En VeriFactu, cada registro se encadena mediante hashes para asegurar integridad.

Se formaliza mediante un PDF de representación.

Debe ser firmado con certificado electrónico.

OkVerifactu lo envía a la AEAT para su validación.

Es requisito para usar el ambiente de Producción.

Genera, registra y conserva facturas y registros de facturación.

Cumple los requisitos del Reglamento VeriFactu (huella, encadenamiento, registro, QR…).

OkVerifactu, junto con su módulo e integraciones, actúa como un SIF conectado a la AEAT.

Los registros de facturación se envían o están disponibles para la AEAT.

Se exige integridad, inmutabilidad y trazabilidad.

Se generan elementos como hash, QR y encadenamiento.

OkVerifactu implementa este sistema para comercios y eCommerce, automatizando la parte técnica y de comunicación con la AEAT.

Un emisor con suscripción activa puede enviar facturas al sistema.

Si la suscripción se cancela o caduca, el servicio puede verse limitado o parado.

Incluye gestión de:

• Renovaciones

• Cambios de plan

• Facturas emitidas por OkVerifactu (servicio)

Puede ser una duda, un problema técnico o una incidencia con una factura.

Permite adjuntar capturas, IDs de factura, logs, etc.

El equipo de soporte responde, pide más información si hace falta y marca el ticket como resuelto cuando se soluciona.

Quién la emitió.

Cuándo se generó.

Qué datos contenía.

Qué cambios de estado tuvo.

Si fue rechazada y corregida.

Cuándo fue registrada en AEAT.

OkVerifactu y su módulo generan:

• Logs detallados.

• Hashes encadenados.

• Evidencias descargables (QR, respuestas, etc.).

Todo esto permite defender la posición del contribuyente ante la administración.

• Facturas incluidas: límite de tu plan.

• Facturas usadas: las que has enviado en el mes.

• Facturas extra: las que superan el límite (se cobran aparte).

Se muestra en el dashboard y en las secciones de Planes / Consumo del panel de OkVerifactu.

Participa en el proceso de representación.

Gestiona el envío y validación de ciertos documentos de representación y control.

No es visible para el usuario final de la tienda, pero sí aparece en algunas evidencias y mensajes técnicos.

Cómo deben generarse y registrarse los registros de facturación.

Qué requisitos técnicos y funcionales debe cumplir un sistema SIF.

Cómo debe garantizarse la integridad, inmutabilidad y trazabilidad de los datos.

Es el marco bajo el cual opera OkVerifactu.

• Factura enviada.

• Factura registrada en AEAT.

• Factura rechazada.

• Error de procesamiento.

Se configura:

• En el panel de OkVerifactu, indicando una URL.

• En PrestaShop, el módulo expone una URL del tipo https://tutienda.com/module/dbverifactu/webhook.

Permite que tu tienda esté siempre sincronizada con el estado real de las facturas.