FreeInvoice API
·
Generate and send Italian electronic invoices (FatturaPA) and FreeInvoice documents (ordini, ricevute) from WooCommerce orders via the FreeInvoice API …
FreeInvoice API connects your WooCommerce store to the FreeInvoice service, automating the generation and transmission of Italian electronic invoices and commercial documents.
Key Features
- SDI Invoices — Generate FatturaPA XML and send invoices through the SDI (Sistema di Interscambio) with full status tracking (states 4–9).
- FreeInvoice Documents — Send ordini and ricevute through the FreeInvoice document flow with status tracking (states 17 and 33).
- Ricevute for private customers — Private customers without a fiscal code are automatically routed to ricevute using the FreeInvoice Lead receiver — no fake fiscal code needed.
- WooCommerce Checkout Block support — Full compatibility with the WooCommerce Checkout Block via the Additional Checkout Fields API, including conditional fiscal fields based on customer type.
- Classic checkout support — Works with both the traditional WooCommerce checkout and the Checkout Block.
- HPOS compatible — Full support for WooCommerce High-Performance Order Storage.
- Auto-send on order completion — Optionally send invoices or documents automatically when an order is marked as completed.
- Manual send from admin — Send invoices or documents on demand from the order admin screen with dedicated actions.
- Webhook status tracking — Receive real-time status updates from the FreeInvoice service via webhook integration.
- Conditional checkout fields — Fiscal fields (VAT number, fiscal code, recipient code / PEC) appear dynamically based on whether the customer selects “Individual” or “Company/Professional”.
- Guest checkout — Fiscal fields are collected during checkout and stored on the order; no user account required.
- Sandbox mode — Test the entire flow in the FreeInvoice sandbox environment before going live.
- Invoice numbering — Automatic or manual invoice numbering with configurable settings.
- 0% VAT rate management — Configure natura codes for 0% VAT rates according to FatturaPA requirements.
- Admin order list — View invoice/document status directly in the WooCommerce orders list with clear labels and Auto/Manual badges.
- Italian and English UI — The plugin interface is available in both Italian and English.
Prerequisites
- An active FreeInvoice API account
- WooCommerce installed and active