Configuración del módulo OkVerifactu en PrestaShop

1Acceso a la configuración

Una vez instalado el módulo, lo primero es configurarlo para empezar a hacer las pruebas.

1. Modo de Operación: Se debe configurar si se quiere empezar en modo test o en modo producción.
2. Recomendación: Siempre se recomienda empezar en modo test para hacer diferentes pruebas de factura, factura rectificativa y devoluciones, y comprobar que todo funciona correctamente. Una vez verificado, se puede pasar a modo producción.
3. Funcionamiento del Modo Test: El modo test genera exactamente el mismo proceso: genera el QR, genera el hash y se envía a la plataforma de desarrollo de Verifactu. Las facturas enviadas en modo test no tienen ninguna validez, pero sirve para comprobar que la factura se envía correctamente al sistema de la Agencia Tributaria.

2API Keys

Una vez seleccionado el modo de operación, debemos introducir las API Keys de OkVerifactu.

1. Ubicación: Las API Keys se encuentran en nuestro panel de OkVerifactu, en la sección donde pone apicase.
2. Copiar Claves: En esta sección se encuentran dos tipos de API Key: la de producción y la de test. Se deben copiar las dos y pegarlas en el campo correspondiente del módulo de PrestaShop.
3. API Endpoint: La información del endpoint de la API (la URL a donde se enviará toda la información) es solamente informativa y no es modificable.

3Configuración del webhook

El Webhook URL es la dirección donde OkVerifactu enviará a PrestaShop el estado de la factura (si está correcta, incorrecta o registrada) una vez que Verifactu (Hacienda) le responda.

• Este webhook se puede configurar dentro del emisor en la plataforma.
• Para la primera instalación, la forma más sencilla es configurarlo automáticamente al verificar la conexión.
• Haz clic en Guardar y verificar. Si la conexión es correcta (y no hay errores en las API Keys), el sistema enviará la información a nuestro SaaS y registrará automáticamente la URL del webhook para que funcione correctamente.
• Una validación confirmará que todo está correcto y activo.

4Configuración de la serie de facturas

Es muy importante tener las series de las facturas correctamente configuradas.

Para configurar las series, ve a Pedidos > Facturas en el backoffice de PrestaShop:

1. Facturas normales: Configura el prefijo de la factura (la serie) para las facturas normales generadas con un nuevo pedido. La legislación española exige que la numeración empiece desde cero o uno cada año, por lo que se recomienda incluir el año en la serie.
2. Facturas rectificativas (abono): Es crucial configurar una serie distinta para las facturas rectificativas o de abono. Esto evita que se pisen los números de factura (ej. que una factura normal sea la 1 y la rectificativa también sea la 1 si usan la misma serie).
   • Si tu PrestaShop está recién instalado, es posible que no tenga un prefijo en las de abono.
   • Puedes configurar un prefijo como DEVOLUCIÓN o RD rectificativa 2025. Esta serie será distinta a las facturas que se crean cuando un cliente compra.
3. Guardar configuración: Una vez configuradas las series generales y las de abono, guarda la configuración.