FreeInvoice API

FAQ

What do I need to use this plugin?

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

Does this plugin support the WooCommerce Checkout Block?

Yes. The plugin uses the WooCommerce Additional Checkout Fields API to add fiscal fields to both the classic checkout and the WooCommerce Checkout Block. Fields appear conditionally based on customer type.

What is HPOS and is it supported?

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.

What types of documents can I send?

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.

How does the ricevute flow work for private customers without a fiscal code?

When a private customer does not provide a fiscal code at checkout, the plugin automatically routes 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.

Can I test the plugin before going live?

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.

Does the plugin send invoices automatically?

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.

How do I track invoice status?

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.

Can I disable invoicing for private individuals?

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.

Where can I manage the tax regime?

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

Does the plugin generate PDF invoices?

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

Can I manage 0% VAT rates?

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

Where can I configure invoice numbering?

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