內容簡介
Freefactu 是一款免費的開源外掛，專為 WooCommerce 設計，提供與西班牙 AEAT VeriFactu 框架相關的發票工作流程技術工具。此外掛能生成數位簽名的電子發票數據，協助管理發票紀錄，並與 AEAT 環境互動。
【主要功能】
• 根據 VeriFactu 規範生成電子發票數據
• 支援使用者提供的數位簽名證書
• 生成 QR 碼以供驗證用途
• 配置發票編號系列
• 支援修正發票數據結構 (R1–R5)
• 將發票數據匯出為 CSV 或 XML 格式
外掛標籤
開發者團隊
② 後台搜尋「Freefactu – Toolkit para Verifactu」→ 直接安裝（推薦）
原文外掛簡介
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.
Key Features
Technical tools to generate electronic invoice data based on VeriFactu specifications
Digital signature support using user-provided PKCS#12 certificates (.p12 / .pfx)
QR code generation derived from invoice data for verification purposes
Hash chaining mechanisms between invoice records
Configurable invoice numbering series
Support for corrective (rectificativa) invoice data structures (R1–R5)
Generation of draft “Declaración Responsable” documents and SIF archives
Test and production environment configuration options
Export of invoice-related data to CSV or XML formats
Local PDF rendering of invoice representations
Error reporting and retry workflows based on AEAT responses
Snapshot-based storage of invoice data at creation time
System Requirements
WordPress 5.8 or higher
WooCommerce 6.0 or higher
PHP 8.2 or higher
PHP Extensions:
OpenSSL (required)
DOM (required)
GD or Imagick (recommended)
ZipArchive (recommended; fallback to PclZip)
Spanish digital certificate in .p12 or .pfx format
HTTPS-enabled website (required for AEAT communication)
How It Works
Configure business identification details (name, NIF)
Upload a valid digital certificate provided by the user
Configure invoice numbering series
Generate draft SIF documentation if required
Generate invoice data from WooCommerce orders
Optionally transmit invoice data to AEAT environments
All steps require correct configuration and validation by the user.
VeriFactu Framework Reference
This plugin is developed with reference to publicly available technical documentation, including:
Real Decreto 1007/2023
Orden HFP/1177/2024
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.
AEAT Communication
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:
Accuracy and legality of submitted information
Maintaining valid digital certificates
Selecting the appropriate AEAT environment
Any fiscal, legal, or administrative consequences resulting from submitted data
Data Handling
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.
Legal Disclaimer
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.
External Services
This plugin connects to the following external services when configured and enabled by the user:
AEAT VeriFactu API (Agencia Tributaria – Spain)
This plugin sends invoice data to Spain’s Tax Agency (AEAT) for electronic invoice validation under the VeriFactu system.
What the service is: Official Spanish Tax Agency electronic invoicing validation system (AEAT – Agencia Estatal de Administración Tributaria)
What it is used for: Submitting signed invoice records for tax compliance under Spain’s VeriFactu regulations
Data sent: Invoice number, date, amounts, tax breakdown, company NIF, customer NIF (if provided), cryptographic hash, digital signature, and invoice chain reference
When data is sent: Each time an invoice is generated and the user has enabled AEAT submission in the plugin settings
Service provider: Agencia Estatal de Administración Tributaria (AEAT) – Spanish Tax Agency
Terms of Service: https://sede.agenciatributaria.gob.es/Sede/avisos-legales.html
Privacy Policy: https://sede.agenciatributaria.gob.es/Sede/avisos-legales/privacidad.html
API Endpoints (all operated by AEAT, all subject to the Terms of Service and Privacy Policy linked above):
Test Environment (for development/testing — domain: prewww1.aeat.es and prewww2.aeat.es):
SOAP VeriFactu endpoint: https://prewww1.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP
QR Verification endpoint: https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR
Production Environment (for live submissions — domain: www3.agenciatributaria.gob.com.es and www2.agenciatributaria.gob.es):
SOAP VeriFactu endpoint: https://www3.agenciatributaria.gob.com.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP
QR Verification endpoint: https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR
All four domains above (prewww1.aeat.es, prewww2.aeat.es, www3.agenciatributaria.gob.com.es, www2.agenciatributaria.gob.es) are operated by the Agencia Tributaria and are subject to their Terms of Service (https://sede.agenciatributaria.gob.es/Sede/avisos-legales.html) and Privacy Policy (https://sede.agenciatributaria.gob.es/Sede/avisos-legales/privacidad.html).
QR Code Generation
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).
Open Source Libraries
DOMPDF (LGPL-2.1)
Endroid QR Code (MIT)
Verifactu-PHP (MIT)
Trademark Notice
“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.
