FreeInvoice API

You need a WordPress site with WooCommerce installed and an active FreeInvoice API account. You can sign up at cloudfinance.it.

Yes. The plugin uses the WooCommerce Additional Checkout Fields API to add the private-customer invoice opt-in and fiscal fields to both the classic checkout and the WooCommerce Checkout Block. For private customers, fiscal fields appear when “Richiedo fattura” is selected and then adapt by customer type. For companies/entities/professionals, invoicing is mandatory: the opt-in checkbox is hidden/forced on and saved fiscal data is shown directly in a preview card with “Modifica”. WooCommerce Blocks currently expose only the contact, address, and order Additional Checkout Fields locations, so the plugin places these fields in the supported order location rather than forcing an unsupported slot between shipping and payment.

HPOS (High-Performance Order Storage) is WooCommerce’s modern order data storage system. This plugin fully supports HPOS and works correctly with it enabled or disabled.

The plugin supports three document types:
* SDI Invoices (fatture elettroniche) — sent through the SDI, for companies and private individuals with a fiscal code.
* Ordini (orders) — sent through the FreeInvoice document flow, for companies and private individuals with a fiscal code.
* Ricevute (receipts) — sent through the FreeInvoice document flow, for private individuals without a fiscal code.

When a private customer leaves “Richiedo fattura” off at checkout, the plugin can route the document as a ricevuta. The FreeInvoice backend creates or matches a Lead receiver using the customer’s email address — no fake fiscal code is used. If the customer turns “Richiedo fattura” on as a private customer, a valid fiscal code is required.

For private customers, only when they select the dedicated “Richiedo fattura” checkbox at checkout. When a private customer leaves it off, saved fiscal profile data such as CF, PIVA, SDI, or PEC is not used for current order routing, and the order remains eligible for the safe ricevuta/non-invoice path. For companies/entities/professionals, invoicing is mandatory and the fiscal data is used for the order.

Yes. Enable sandbox mode in the plugin settings to test the entire invoice and document flow against the FreeInvoice sandbox environment. No real invoices will be transmitted.

Yes, if auto-send is enabled in the settings, the plugin will automatically send the appropriate invoice or document when a WooCommerce order is marked as completed. You can also send manually from the order admin screen at any time; the admin selector can choose between SDI invoice, ordine, and ricevuta when the order fiscal data supports those send types.

Invoice and document status is updated in real time via webhook. You can see the current status in the WooCommerce order admin screen and in the orders list.

Yes. In the plugin settings you can enable or disable electronic invoicing for private individuals. When disabled, the fiscal fields will not appear for private customers during checkout.

In the plugin settings (WooCommerce → Settings → FreeInvoice API) you can select your business tax regime from a drop-down list.

No. The plugin generates FatturaPA XML and transmits it through the FreeInvoice service. PDF invoices are available on your FreeInvoice account.

Yes. The plugin settings include a dedicated section for managing 0% VAT rates with their corresponding FatturaPA natura codes.

Invoice numbering settings are available in the plugin settings. You can choose between automatic or manual numbering.