Aleix Pellicer

Freefactu is a free, open-source helper plugin for WooCommerce that provides technical tools to assist with invoicing workflows related to Spain’s AEAT VeriFactu framework.
The plugin offers functionality to generate digitally signed electronic invoice data, manage invoice records, and interact with AEAT environments based on publicly available technical specifications.
Freefactu is not certified, not approved, and not endorsed by the Agencia Tributaria (AEAT). The use of this plugin does not guarantee compliance with any legal, tax, or regulatory obligations. Users are solely responsible for ensuring that their invoicing practices comply with applicable laws and regulations.
This plugin does not constitute legal, tax, or accounting advice.
<h3>Key Features</h3>
<ul>
<li>Technical tools to generate electronic invoice data based on VeriFactu specifications</li>
<li>Digital signature support using user-provided PKCS#12 certificates (.p12 / .pfx)</li>
<li>QR code generation derived from invoice data for verification purposes</li>
<li>Hash chaining mechanisms between invoice records</li>
<li>Configurable invoice numbering series</li>
<li>Support for corrective (rectificativa) invoice data structures (R1–R5)</li>
<li>Generation of draft “Declaración Responsable” documents and SIF archives</li>
<li>Test and production environment configuration options</li>
<li>Export of invoice-related data to CSV or XML formats</li>
<li>Local PDF rendering of invoice representations</li>
<li>Error reporting and retry workflows based on AEAT responses</li>
<li>Snapshot-based storage of invoice data at creation time</li>
</ul>
<h3>System Requirements</h3>
<ul>
<li>WordPress 5.8 or higher</li>
<li>WooCommerce 6.0 or higher</li>
<li>PHP 8.2 or higher</li>
<li>PHP Extensions:
<ul>
<li>OpenSSL (required)</li>
<li>DOM (required)</li>
<li>GD or Imagick (recommended)</li>
<li>ZipArchive (recommended; fallback to PclZip)</li>
</ul>
</li>
<li>Spanish digital certificate in .p12 or .pfx format</li>
<li>HTTPS-enabled website (required for AEAT communication)</li>
</ul>
<h3>How It Works</h3>
<ol>
<li>Configure business identification details (name, NIF)</li>
<li>Upload a valid digital certificate provided by the user</li>
<li>Configure invoice numbering series</li>
<li>Generate draft SIF documentation if required</li>
<li>Generate invoice data from WooCommerce orders</li>
<li>Optionally transmit invoice data to AEAT environments</li>
</ol>
All steps require correct configuration and validation by the user.
<h3>VeriFactu Framework Reference</h3>
This plugin is developed with reference to publicly available technical documentation, including:
<ul>
<li>Real Decreto 1007/2023</li>
<li>Orden HFP/1177/2024</li>
</ul>
Implementation of these specifications does not imply certification, validation, or approval by the Agencia Tributaria (AEAT). Interpretation of regulatory requirements and compliance decisions remain the responsibility of the user.
<h3>AEAT Communication</h3>
When enabled and configured by the user, the plugin may transmit invoice-related data directly from the user’s WordPress installation to AEAT servers.
The plugin developer does not monitor, intercept, validate, or store transmitted data. Users are solely responsible for:
<ul>
<li>Accuracy and legality of submitted information</li>
<li>Maintaining valid digital certificates</li>
<li>Selecting the appropriate AEAT environment</li>
<li>Any fiscal, legal, or administrative consequences resulting from submitted data</li>
</ul>
<h3>Data Handling</h3>
All invoice data is stored locally in the user’s WordPress database. No data is collected, processed, or transmitted by the plugin developer.
Communication, when enabled, occurs directly between the user’s server and AEAT servers.
<h3>Legal Disclaimer</h3>
This plugin is provided “as is”, without warranty of any kind, express or implied, including but not limited to warranties of correctness, fitness for a particular purpose, legal compliance, or uninterrupted operation.
The authors and contributors shall not be liable for any damages, penalties, fines, data loss, business interruption, or legal consequences arising from the use or misuse of this software.
Use of this plugin is entirely at your own risk.
<h3>External Services</h3>
This plugin connects to the following external services when configured and enabled by the user:
<h4>AEAT VeriFactu API (Agencia Tributaria – Spain)</h4>
This plugin sends invoice data to Spain’s Tax Agency (AEAT) for electronic invoice validation under the VeriFactu system.
<ul>
<li>What the service is: Official Spanish Tax Agency electronic invoicing validation system (AEAT – Agencia Estatal de Administración Tributaria)</li>
<li>What it is used for: Submitting signed invoice records for tax compliance under Spain’s VeriFactu regulations</li>
<li>Data sent: Invoice number, date, amounts, tax breakdown, company NIF, customer NIF (if provided), cryptographic hash, digital signature, and invoice chain reference</li>
<li>When data is sent: Each time an invoice is generated and the user has enabled AEAT submission in the plugin settings</li>
<li>Service provider: Agencia Estatal de Administración Tributaria (AEAT) – Spanish Tax Agency</li>
<li>Terms of Service: <a href="https://sede.agenciatributaria.gob.es/Sede/avisos-legales.html" rel="nofollow ugc">https://sede.agenciatributaria.gob.es/Sede/avisos-legales.html</a></li>
<li>Privacy Policy: <a href="https://sede.agenciatributaria.gob.es/Sede/avisos-legales/privacidad.html" rel="nofollow ugc">https://sede.agenciatributaria.gob.es/Sede/avisos-legales/privacidad.html</a></li>
</ul>
API Endpoints (all operated by AEAT, all subject to the Terms of Service and Privacy Policy linked above):
<ul>
<li>
Test Environment (for development/testing — domain: <code>prewww1.aeat.es</code> and <code>prewww2.aeat.es</code>):
<ul>
<li>SOAP VeriFactu endpoint: <code>https://prewww1.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP</code></li>
<li>QR Verification endpoint: <code>https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR</code></li>
</ul>
</li>
<li>
Production Environment (for live submissions — domain: <code>www3.agenciatributaria.gob.com.es</code> and <code>www2.agenciatributaria.gob.es</code>):
<ul>
<li>SOAP VeriFactu endpoint: <code>https://www3.agenciatributaria.gob.com.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP</code></li>
<li>QR Verification endpoint: <code>https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR</code></li>
</ul>
</li>
</ul>
All four domains above (<code>prewww1.aeat.es</code>, <code>prewww2.aeat.es</code>, <code>www3.agenciatributaria.gob.com.es</code>, <code>www2.agenciatributaria.gob.es</code>) are operated by the Agencia Tributaria and are subject to their Terms of Service (<a href="https://sede.agenciatributaria.gob.es/Sede/avisos-legales.html" rel="nofollow ugc">https://sede.agenciatributaria.gob.es/Sede/avisos-legales.html</a>) and Privacy Policy (<a href="https://sede.agenciatributaria.gob.es/Sede/avisos-legales/privacidad.html" rel="nofollow ugc">https://sede.agenciatributaria.gob.es/Sede/avisos-legales/privacidad.html</a>).
<h4>QR Code Generation</h4>
QR codes are generated locally using the Endroid QR Code library bundled with the plugin. No external API calls are made for QR generation. The QR codes contain verification URLs pointing to AEAT’s ValidarQR service (documented above).
<h3>Open Source Libraries</h3>
<ul>
<li>DOMPDF (LGPL-2.1)</li>
<li>Endroid QR Code (MIT)</li>
<li>Verifactu-PHP (MIT)</li>
</ul>
<h3>Trademark Notice</h3>
“VeriFactu” and “AEAT” are trademarks of the Agencia Estatal de Administración Tributaria. This plugin is an independent implementation and is not affiliated with or endorsed by AEAT.

Freefactu – Toolkit para Verifactu

Free, open-source helper plugin providing technical tools related to AEAT VeriFactu invoicing workflows. Not certified software.

easy-verifactu

Easy Verifactu connects your WooCommerce store to your Easy Verifactu account so 
that the invoices for your orders are generated, stored, and reported to the 
Spanish Tax Agency (AEAT) under the Verifactu system, without you leaving WordPress.
The plugin does not generate or store invoices itself. WooCommerce sends each 
confirmed order and refund to Easy Verifactu, and Easy Verifactu does the fiscal 
work: it issues the invoice, signs it, keeps the immutable record required by 
Verifactu, and submits it to AEAT.
An active Easy Verifactu account is required. You can create one at 
https://easyverifactu.com. After installing the plugin you connect it to your 
account with a pairing token from your Easy Verifactu dashboard.
<h4>What the plugin does</h4>
<ul>
<li>Sends orders and refunds to Easy Verifactu. When an order is confirmed, 
updated, or refunded, the plugin notifies Easy Verifactu so the corresponding 
invoice or correction is issued and reported to AEAT.</li>
<li>Collects invoicing details at checkout. Buyers can request a full invoice 
and enter their tax ID (NIF/CIF). Works on both the WooCommerce Blocks 
checkout and the classic (shortcode) checkout.</li>
<li>Requires a tax ID for larger orders. When an order total reaches the 
configured invoice threshold for euro-priced stores, the tax ID becomes 
required at checkout.</li>
<li>Validates tax IDs in real time. The NIF/CIF entered at checkout is checked 
against Easy Verifactu so buyers get immediate feedback before they pay.</li>
</ul>
<h3>External services</h3>
This plugin relies on the Easy Verifactu service to do its work, so it sends data 
to Easy Verifactu (operated by the company behind https://easyverifactu.com). No 
other third-party services are contacted.
It connects to two Easy Verifactu endpoints:
<ol>
<li>
Easy Verifactu API (<code>https://woo.easyverifactu.com</code>) 
Used to verify your pairing token and to validate tax IDs entered at 
checkout.
<ul>
<li>When: when you connect the plugin in the settings page, and each time a 
buyer enters a tax ID (NIF/CIF) during checkout.</li>
<li>Data sent: your pairing token; and, for tax-ID validation, the buyer’s 
tax ID (NIF/CIF), name or company name, and billing country.</li>
</ul>
</li>
<li>
Easy Verifactu order ingest (<code>https://woo-ingest.easyverifactu.com</code>) 
Used to notify Easy Verifactu of order and refund activity so invoices are 
issued and reported.
<ul>
<li>When: when an order is created, updated, status-changed, or refunded.</li>
<li>Data sent: your pairing token, the WooCommerce order ID, the order 
number, and the order’s creation and last-modified timestamps. No customer 
names, addresses, line items, or payment data are sent in these events.</li>
</ul>
</li>
</ol>
Easy Verifactu may also call your store back on an authenticated endpoint to 
read the installed plugin version, so it can let you know when an update is 
available. This requires your pairing token; the version is never exposed 
publicly.
By connecting the plugin to your Easy Verifactu account you agree to the 
Easy Verifactu Terms and Conditions and Privacy Policy:
<ul>
<li>Terms and Conditions: https://www.easyverifactu.com/terminos-y-condiciones</li>
<li>Privacy Policy: https://www.easyverifactu.com/politica-de-privacidad</li>
</ul>
<h3>License</h3>
This plugin, all of its included libraries, and any other included assets are 
licensed under the GNU General Public License version 2 or later (GPL-2.0-or-later), 
or are under a GPL-compatible license.
The plugin’s own code is GPL-2.0-or-later. Bundled JavaScript is built on the 
WordPress and WooCommerce packages (GPL-2.0-or-later) provided by WordPress 
core, together with first-party code and tooling under GPL-compatible licenses 
(such as MIT). The distributed package contains no third-party PHP libraries.
A copy of the GPLv2 is included in license.txt and is available at 
https://www.gnu.org/licenses/gpl-2.0.html.
<h3>Source code and build process</h3>
This plugin ships with its complete, human-readable source code. The compiled 
JavaScript in <code>assets/js/build/</code> is generated from the source in the <code>client/</code> 
directory:
<ul>
<li><code>assets/js/build/settings-page.js</code> is built from <code>client/settings-page/index.jsx</code></li>
<li><code>assets/js/build/legacy-checkout.js</code> is built from <code>client/legacy-checkout/index.js</code></li>
</ul>
The build uses @wordpress/scripts (webpack and Babel). The configuration is in 
the bundled <code>webpack.config.js</code>, <code>babel.config.js</code>, and <code>package.json</code>.
To rebuild the assets from source, from the plugin directory run:
<ol>
<li>Install dependencies: <code>npm install</code> (or <code>pnpm install</code>)</li>
<li>Build: <code>npm run build</code> (or <code>pnpm build</code>)</li>
</ol>
No third-party PHP libraries are bundled.

Easy Verifactu

Issue Verifactu-compliant invoices for your WooCommerce orders with Easy Verifactu, reported automatically to the Spanish Tax Agency (AEAT).

Freefactu – Toolkit para Verifactu vs Easy Verifactu