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

Documentation

• FreeInvoice Plugin Documentation