Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/gonbellido/wc-fiskaly-verifactur/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard โ Updates. Install new releases yourself, or let Git Updater track the repository.
Electronic invoicing (Verifactu) for WooCommerce via Fiskaly SIGN ES API. AEAT compliant, digital signature, QR code, and legal text on every invoice.
โจ Features
- ๐๏ธ AEAT Verifactu Compliant โ Generates legally valid electronic invoices
- โ๏ธ Digital Signature โ Fiskaly SIGN ES API cryptographic signature
- ๐ฎ Automatic Submission โ Sends invoices to AEAT on order completion
- ๐ฒ QR Code โ Verifactu QR on every invoice for verification
- ๐ฑ Email Integration โ Attaches invoice PDF to WooCommerce order emails
- ๐ Bulk Operations โ Sync all completed orders or date range
- ๐ Status Dashboard โ Track registered/pending/cancelled invoices
- ๐ Legal Text โ Mandatory Spanish legal footer on every invoice
๐ Quick Start
- Get API credentials from Fiskaly Dashboard
- Install via WordPress Admin โ Plugins โ Add New โ Upload
- Go to WooCommerce โ Settings โ Fiskaly Verifactur
- Enter API Key, API Secret, and TAC (Test/Live toggle)
- Orders auto-generate invoices on "Completed" status
๐ Tech Stack
- PHP 7.4+ โ OOP with strict typing
- Fiskaly SIGN ES REST API (
POST /api/v1/sign) - HPOS Compatible (High-Performance Order Storage)
- PDF Generation via HTML/CSS template
- WooCommerce Action Scheduler for async sync jobs
- GPL v2 licensed
๐ Structure
wc-fiskaly-verifactur/
โโโ wc-fiskaly-verifactur.php # Plugin bootstrap (HPOS + WC hooks)
โโโ includes/
โ โโโ class-fiskaly-api.php # Fiskaly REST API client + auth
โ โโโ class-fiskaly-invoice.php # Invoice data builder (XML + PDF payload)
โ โโโ class-fiskaly-pdf.php # HTML โ PDF converter
โ โโโ class-fiskaly-sync.php # Bulk sync via Action Scheduler
โ โโโ class-fiskaly-admin.php # Settings page (API keys, TAC, mode)
โ โโโ class-fiskaly-ajax.php # AJAX handlers (bulk, test, stats)
โ โโโ class-fiskaly-order-meta.php # Order metabox (status, download, QR)
โ โโโ class-fiskaly-webhook.php # AEAT callback webhook handler
โโโ assets/
โโโ css/admin.css # Admin panel styles
โโโ js/admin.js # Dashboard interactivity
๐ค Author
Gonzalo Bellido โ Fullstack Developer & WordPress Specialist