Modulo Integration for Verifactu

Descripción

Modulo Integration for Verifactu connects your WooCommerce store to Verifactu Módulo for Spanish tax compliance: Verifactu (national electronic invoicing), TicketBAI (Basque Country), and related AEAT requirements. Sell in Spain or to Spanish B2B customers with fewer manual steps—orders can trigger invoice registration and customers receive official QR codes for verification.

Important: Sandbox first, production after upgrade

When you connect this plugin for the first time, your Verifactu Módulo account runs on the Sandbox plan: test invoices only, for integration checks. You cannot issue official production invoices until you upgrade your subscription inside app.verifactumodulo.com (Billing / Plans—Lite, Basic, Pro, Enterprise, etc.). The WordPress plugin does not change your plan or billing; you must complete that step in the web app. After upgrading, switch to Production / live mode there as guided by Verifactu Módulo.

The plugin is built for merchants who need WooCommerce + Spain workflows: online shops, marketplaces, and agencies managing Spanish VAT (IVA), NIF/CIF, and electronic invoice rules without building a custom AEAT integration.

Note: Verifactu is a regulation-based electronic invoicing system from the Spanish Tax Agency (AEAT). This plugin helps you meet those requirements through Verifactu Módulo; it does not replace legal or tax advice.

Why use this plugin?

  • WooCommerce + Verifactu / TicketBAI in one flow: connect once, then automate eligible orders.
  • AEAT-oriented output: invoice metadata and QR codes aligned with compliance workflows.
  • Hosted configuration: company data, environment (production/sandbox), and regions are managed in app.verifactumodulo.com—WordPress stays lean.
  • HPOS compatible: works with WooCommerce High-Performance Order Storage.

Key features

  • Automatic invoice registration for configured order statuses (e.g. processing/completed)
  • QR code display on thank-you page, customer order view, and relevant emails
  • One-click onboarding with Verifactu Módulo (no heavy setup inside wp-admin)
  • Retry handling for failed submissions (scheduled + manual retry from the order screen)
  • Sandbox by default on first connect; production invoicing after you upgrade the plan in the web app (not in WordPress)

Regions & tax systems

  • Verifactu (Spain – national)
  • TicketBAI (Bizkaia, Gipuzkoa, Álava)
  • IGIC context (Canary Islands) where applicable via your Módulo configuration

Requirements

  • WordPress 5.8+
  • WooCommerce 5.0+
  • PHP 7.4+
  • HTTPS (SSL) recommended for production
  • Active Verifactu Módulo account — verifactumodulo.com

Español (resumen)

Integración WooCommerce con Verifactu y TicketBAI: cumplimiento fiscal en España, registro ante la AEAT y códigos QR para tus clientes. La configuración avanzada se gestiona en app.verifactumodulo.com. Las cuentas nuevas empiezan en Sandbox; para facturación real, mejora el plan en la aplicación web.

External services

This plugin relies on external services for compliance and QR rendering:

  1. Verifactu Módulo (app.verifactumodulo.com, API on ogjjcksexxbvguygexsk.supabase.co)

    • Purpose: Store onboarding, invoice registration, and metadata for Verifactu/TicketBAI workflows.
    • Data sent: Order identifiers, totals, taxes, line items, billing fields (name, company, email, phone), and store identifiers when you connect or when orders are processed.
    • When: During onboarding and when eligible WooCommerce orders are sent for invoicing.
    • Terms: https://verifactumodulo.com/terms
    • Privacy: https://verifactumodulo.com/privacy
  2. QRServer (api.qrserver.com)

    • Purpose: Generate QR images for AEAT verification links on the storefront and emails.
    • Data sent: The verification URL encoded in the image request.
    • When: When a page or email renders a Verifactu QR block.
    • Terms: https://goqr.me/legal/tos-api.html
    • Privacy: https://goqr.me/privacy-safety-security/

Privacy Policy

This plugin sends order data to the Verifactu Módulo API for tax compliance. Data can include:

  • Order identifiers, totals, and tax amounts
  • Billing name, company, email, phone
  • Line item names, quantities, and prices

See the Verifactu Módulo Privacy Policy for details.

Support

Credits

Developed by PEKI AS.

Instalación

Automatic installation

  1. Log in to your WordPress admin.
  2. Go to Plugins Add New.
  3. Search for Modulo Integration for Verifactu (or “Verifactu WooCommerce”).
  4. Click Install Now, then Activate.

Manual installation

  1. Download the plugin ZIP.
  2. Go to Plugins Add New Upload Plugin.
  3. Choose the ZIP and install, then Activate.

Connect to Verifactu Módulo

  1. In wp-admin, open WooCommerce Verifactu Módulo.
  2. Click Connect to Verifactu Módulo and complete onboarding at app.verifactumodulo.com.
  3. When you return to WordPress, confirm the connection status on the same screen.
  4. Expect Sandbox mode until you upgrade at app.verifactumodulo.com. For real customer invoices, choose a paid plan (Lite, Basic, Pro, Enterprise, …) and enable Production there.

Detailed company, tax region, billing, and environment (Sandbox vs Production) are managed in the Verifactu Módulo web application—not inside WordPress.

Preguntas frecuentes

Is this a WooCommerce Verifactu plugin for Spain?

Yes. It is designed for WooCommerce stores that must align with Spain electronic invoicing rules (Verifactu, TicketBAI, AEAT) using Verifactu Módulo as the compliance backend.

Do I need a Verifactu Módulo account?

Yes. Register through the plugin’s connect flow or at verifactumodulo.com.

Where is the settings screen in WordPress?

After activation, go to WooCommerce Verifactu Módulo. Advanced settings live on app.verifactumodulo.com.

Why is my store in Sandbox after connecting?

New connections always start on the free Sandbox plan (test invoices, integration testing). This plugin cannot move you to production by itself. Open app.verifactumodulo.com, upgrade to a paid plan that fits your volume, and switch to Production / live invoicing there when your account is eligible.

How do I issue real invoices (not test)?

  1. Log in to app.verifactumodulo.com.
  2. Upgrade from Sandbox to a plan (Lite, Basic, Pro, Enterprise, …).
  3. Configure Production mode and company data as required by Verifactu Módulo.
    Pricing and limits are defined only in the web app, not in this plugin.

Which order statuses trigger processing?

By default, Processing and Completed orders are handled automatically (configurable in plugin behaviour).

What if an order fails?

Failed attempts are stored on the order; the plugin can retry on a schedule and you can retry manually from the order screen.

Can I test before production?

Yes. Sandbox is the default after you connect. Use it to validate the integration. When you are ready for live AEAT invoicing, upgrade your plan and enable production in app.verifactumodulo.com—not in WordPress alone.

Is data transmitted securely?

API traffic uses HTTPS. API keys are stored in WordPress options and only partially shown in the admin UI.

Where do customers see the QR code?

On the order received page, order details in “My account”, and in supported order emails when a QR URL is available.

Can I style the QR block?

Yes. Target the .verifactu-qr-container class in your theme CSS.

Reseñas

No hay reseñas para este plugin.

Colaboradores y desarrolladores

Este software es de código abierto. Las siguientes personas han contribuido a este plugin.

Colaboradores

Registro de cambios

1.0.9

  • Readme and admin UI: clarify that Sandbox is the default after connect; production invoicing requires upgrading the plan at app.verifactumodulo.com (WordPress does not change billing).
  • Dashboard: warning notice when environment is not Production; Getting Started step for Sandbox vs paid plans.

1.0.8

  • Removed load_plugin_textdomain(); WordPress 4.6+ loads translations for plugins hosted on WordPress.org automatically (Plugin Check).
  • Readme short description rewritten in standard English for the directory language check.

1.0.7

  • Text domain aligned with plugin directory slug: modulo-integration-for-verifactu-2 (PHPCS/WPCS TextDomainMismatch).
  • Renamed translation files to modulo-integration-for-verifactu-2-*.po / .pot; added explicit load_plugin_textdomain() on init.
  • PHPCS: broadened NonceVerification ignore for OAuth callback blocks (external redirect, no WP nonce).

1.0.2

  • Rebranded plugin: renamed to “Modulo Integration for Verifactu” with slug modulo-integration-for-verifactu
  • Updated text domain to “modulo-integration-for-verifactu” across all files
  • Moved all admin CSS and JavaScript from inline output to properly enqueued files via wp_enqueue_style() and wp_enqueue_script() on admin_enqueue_scripts
  • Removed all remaining inline style attributes from admin templates; moved to admin/css/admin.css
  • Added external services documentation for Verifactu Modulo API and QRServer (api.qrserver.com) in readme.txt

1.0.1

  • Branding update: Plugin name changed from “Verifactu Module for WooCommerce” to “Modulo Verifactu for WooCommerce”
  • Updated text domain from “verifactu-module-for-woocommerce” to “modulo-verifactu-for-woocommerce”
  • No functional changes

1.0.0

  • Initial release
  • One-click onboarding with app.verifactumodulo.com
  • Automatic order processing (on completed and processing status)
  • QR code display on thank you page, order details, and emails
  • Admin dashboard with statistics and connection status
  • Order meta box with invoice details and manual retry
  • Multi-region support (Verifactu, TicketBAI, IGIC)
  • Production and Sandbox environment support
  • Automatic hourly retry for failed orders
  • WooCommerce HPOS (High-Performance Order Storage) compatible