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 non-invoice private customers — Private customers who do not opt in to an invoice are 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. In Blocks, the fiscal section uses the supported order location.
• Classic checkout support — Works with both the traditional WooCommerce checkout and the Checkout Block.
• Explicit invoice opt-in for private customers — “Richiedo fattura” is the opt-in for private customers. For companies/entities/professionals the invoice is mandatory: the checkbox is hidden/forced on and saved fiscal data is shown directly in a preview card with “Modifica”.
• 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 — SDI invoices receive real-time status updates from the FreeInvoice service via webhook integration. Ordini and ricevute reach their final state as soon as they are sent.
• Conditional checkout fields — Private customers see fiscal fields only after selecting “Richiedo fattura”; companies/entities/professionals use the mandatory fiscal section directly, with fields adapting to “Individual” or “Company/Entity/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 interface — The plugin interface is in Italian, matching the Italian e-invoicing workflow it automates.

Prerequisites

• An active FreeInvoice API account
• WooCommerce installed and active

Documentation

• FreeInvoice Plugin Documentation