{"id":130499,"date":"2020-10-23T07:37:34","date_gmt":"2020-10-23T07:37:34","guid":{"rendered":"https:\/\/it.wordpress.org\/plugins\/freeinvoice-api\/"},"modified":"2026-05-14T08:10:38","modified_gmt":"2026-05-14T08:10:38","slug":"freeinvoice-api","status":"publish","type":"plugin","link":"https:\/\/pl.wordpress.org\/plugins\/freeinvoice-api\/","author":18163033,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.1","stable_tag":"1.1.1","tested":"6.9.4","requires":"5.2","requires_php":"7.2","requires_plugins":null,"header_name":"FreeInvoice API","header_author":"Cloud Finance srl","header_description":"Plugin di FreeInvoice per la fatturazione elettronica con WooCommerce.","assets_banners_color":"ffffff","last_updated":"2026-05-14 08:10:38","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.cloudfinance.it\/free-invoice-api.html","header_author_uri":"https:\/\/www.cloudfinance.it\/","rating":5,"author_block_rating":0,"active_installs":10,"downloads":2575,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"cloudfinance","date":"2021-01-20 18:38:29"},"1.0.1":{"tag":"1.0.1","author":"cloudfinance","date":"2024-05-27 08:00:20"},"1.0.2":{"tag":"1.0.2","author":"cloudfinance","date":"2024-05-27 08:06:52"},"1.0.3":{"tag":"1.0.3","author":"cloudfinance","date":"2024-05-27 08:16:44"},"1.1.0":{"tag":"1.1.0","author":"cloudfinance","date":"2026-04-29 10:49:08"},"1.1.1":{"tag":"1.1.1","author":"cloudfinance","date":"2026-05-14 08:10:38"}},"upgrade_notice":{"1.1.1":"<p>Bugfix release: fixes an incorrect split payment flag in zero-VAT\/Natura XML summaries sent to SDI.<\/p>","1.1.0":"<p>Major update: adds WooCommerce Checkout Block support, HPOS compatibility, FreeInvoice document flow (ordini\/ricevute), auto-send on order completion, and ricevute for private customers without fiscal code. Please review your plugin settings after upgrading.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"2"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3092952,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3092952,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3092952,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3092952,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.0.1","1.0.2","1.0.3","1.1.0","1.1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3092952,"resolution":"1","location":"assets","locale":"","width":1178,"height":900},"screenshot-10.jpg":{"filename":"screenshot-10.jpg","revision":3092952,"resolution":"10","location":"assets","locale":"","width":1633,"height":875},"screenshot-11.jpg":{"filename":"screenshot-11.jpg","revision":3092952,"resolution":"11","location":"assets","locale":"","width":1597,"height":898},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3092952,"resolution":"2","location":"assets","locale":"","width":845,"height":543},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3092952,"resolution":"3","location":"assets","locale":"","width":807,"height":362},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":3092952,"resolution":"4","location":"assets","locale":"","width":1158,"height":888},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":3092952,"resolution":"5","location":"assets","locale":"","width":1175,"height":871},"screenshot-6.jpg":{"filename":"screenshot-6.jpg","revision":3092952,"resolution":"6","location":"assets","locale":"","width":942,"height":602},"screenshot-7.jpg":{"filename":"screenshot-7.jpg","revision":3092952,"resolution":"7","location":"assets","locale":"","width":1183,"height":514},"screenshot-8.jpg":{"filename":"screenshot-8.jpg","revision":3092952,"resolution":"8","location":"assets","locale":"","width":672,"height":243},"screenshot-9.jpg":{"filename":"screenshot-9.jpg","revision":3092952,"resolution":"9","location":"assets","locale":"","width":1009,"height":877}},"screenshots":{"1":"General plugin settings","2":"Seller data configuration","3":"Invoice management setup","4":"0% VAT rate management","5":"Payment method configuration","6":"Invoice\/document send dialog","7":"Invoice batch purchase","8":"Invoice numbering settings","9":"Fiscal fields during WooCommerce checkout","10":"Fiscal data in WooCommerce order detail","11":"Invoice\/document status in WooCommerce orders list"}},"plugin_section":[],"plugin_tags":[171890,165100,168515,165101,286],"plugin_category":[45],"plugin_contributors":[192268],"plugin_business_model":[],"class_list":["post-130499","plugin","type-plugin","status-publish","hentry","plugin_tags-codice-destinatario","plugin_tags-fattura-elettronica","plugin_tags-fattura-xml","plugin_tags-fatturazione-elettronica","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-cloudfinance","plugin_committers-cloudfinance"],"banners":{"banner":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/banner-772x250.png?rev=3092952","banner_2x":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/banner-1544x500.png?rev=3092952","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/icon-128x128.png?rev=3092952","icon_2x":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/icon-256x256.png?rev=3092952","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-1.jpg?rev=3092952","caption":"General plugin settings"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-2.jpg?rev=3092952","caption":"Seller data configuration"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-3.jpg?rev=3092952","caption":"Invoice management setup"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-4.jpg?rev=3092952","caption":"0% VAT rate management"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-5.jpg?rev=3092952","caption":"Payment method configuration"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-6.jpg?rev=3092952","caption":"Invoice\/document send dialog"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-7.jpg?rev=3092952","caption":"Invoice batch purchase"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-8.jpg?rev=3092952","caption":"Invoice numbering settings"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-9.jpg?rev=3092952","caption":"Fiscal fields during WooCommerce checkout"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-10.jpg?rev=3092952","caption":"Fiscal data in WooCommerce order detail"},{"src":"https:\/\/ps.w.org\/freeinvoice-api\/assets\/screenshot-11.jpg?rev=3092952","caption":"Invoice\/document status in WooCommerce orders list"}],"raw_content":"<!--section=description-->\n<p><strong>FreeInvoice API<\/strong> connects your WooCommerce store to the <a href=\"https:\/\/www.cloudfinance.it\/free-invoice-api.html\">FreeInvoice<\/a> service, automating the generation and transmission of Italian electronic invoices and commercial documents.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>SDI Invoices<\/strong> \u2014 Generate FatturaPA XML and send invoices through the SDI (Sistema di Interscambio) with full status tracking (states 4\u20139).<\/li>\n<li><strong>FreeInvoice Documents<\/strong> \u2014 Send ordini and ricevute through the FreeInvoice document flow with status tracking (states 17 and 33).<\/li>\n<li><strong>Ricevute for private customers<\/strong> \u2014 Private customers without a fiscal code are automatically routed to ricevute using the FreeInvoice Lead receiver \u2014 no fake fiscal code needed.<\/li>\n<li><strong>WooCommerce Checkout Block support<\/strong> \u2014 Full compatibility with the WooCommerce Checkout Block via the Additional Checkout Fields API, including conditional fiscal fields based on customer type.<\/li>\n<li><strong>Classic checkout support<\/strong> \u2014 Works with both the traditional WooCommerce checkout and the Checkout Block.<\/li>\n<li><strong>HPOS compatible<\/strong> \u2014 Full support for WooCommerce High-Performance Order Storage.<\/li>\n<li><strong>Auto-send on order completion<\/strong> \u2014 Optionally send invoices or documents automatically when an order is marked as completed.<\/li>\n<li><strong>Manual send from admin<\/strong> \u2014 Send invoices or documents on demand from the order admin screen with dedicated actions.<\/li>\n<li><strong>Webhook status tracking<\/strong> \u2014 Receive real-time status updates from the FreeInvoice service via webhook integration.<\/li>\n<li><strong>Conditional checkout fields<\/strong> \u2014 Fiscal fields (VAT number, fiscal code, recipient code \/ PEC) appear dynamically based on whether the customer selects \"Individual\" or \"Company\/Professional\".<\/li>\n<li><strong>Guest checkout<\/strong> \u2014 Fiscal fields are collected during checkout and stored on the order; no user account required.<\/li>\n<li><strong>Sandbox mode<\/strong> \u2014 Test the entire flow in the FreeInvoice sandbox environment before going live.<\/li>\n<li><strong>Invoice numbering<\/strong> \u2014 Automatic or manual invoice numbering with configurable settings.<\/li>\n<li><strong>0% VAT rate management<\/strong> \u2014 Configure natura codes for 0% VAT rates according to FatturaPA requirements.<\/li>\n<li><strong>Admin order list<\/strong> \u2014 View invoice\/document status directly in the WooCommerce orders list with clear labels and Auto\/Manual badges.<\/li>\n<li><strong>Italian and English UI<\/strong> \u2014 The plugin interface is available in both Italian and English.<\/li>\n<\/ul>\n\n<h4>Prerequisites<\/h4>\n\n<ul>\n<li>An active <a href=\"https:\/\/www.cloudfinance.it\/free-invoice-api.html\">FreeInvoice API<\/a> account<\/li>\n<li>WooCommerce installed and active<\/li>\n<\/ul>\n\n<h4>Documentation<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/help.cloudfinance.it\/guida-online-category\/plugin-freeinvoice-wordpress-woocommerce\/\">FreeInvoice Plugin Documentation<\/a><\/li>\n<\/ul>\n\n<!--section=installation-->\n<h4>Minimum requirements<\/h4>\n\n<ul>\n<li>WordPress 5.2 or later<\/li>\n<li>PHP 7.2 or later<\/li>\n<li>WooCommerce installed and active<\/li>\n<li>An active FreeInvoice API account<\/li>\n<\/ul>\n\n<h4>Automatic installation<\/h4>\n\n<ol>\n<li>Go to Plugins \u2192 Add New in your WordPress admin.<\/li>\n<li>Search for \"FreeInvoice API\".<\/li>\n<li>Click Install Now and then Activate.<\/li>\n<\/ol>\n\n<h4>Manual installation via WordPress admin<\/h4>\n\n<ol>\n<li>Download the plugin zip file.<\/li>\n<li>Go to Plugins \u2192 Add New \u2192 Upload Plugin.<\/li>\n<li>Choose the zip file and click Install Now.<\/li>\n<li>Click Activate.<\/li>\n<\/ol>\n\n<h4>Manual installation via FTP<\/h4>\n\n<ol>\n<li>Download and unzip the plugin.<\/li>\n<li>Upload the <code>freeinvoice-api<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin from the Plugins menu.<\/li>\n<\/ol>\n\n<h4>After activation<\/h4>\n\n<ol>\n<li>Go to WooCommerce \u2192 Settings \u2192 FreeInvoice API.<\/li>\n<li>Enter your FreeInvoice API credentials.<\/li>\n<li>Configure your seller data, tax regime, and VAT rates.<\/li>\n<li>Choose whether to use sandbox or production mode.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20do%20i%20need%20to%20use%20this%20plugin%3F\"><h3>What do I need to use this plugin?<\/h3><\/dt>\n<dd><p>You need a WordPress site with WooCommerce installed and an active FreeInvoice API account. You can sign up at <a href=\"https:\/\/www.cloudfinance.it\/free-invoice-api.html\">cloudfinance.it<\/a>.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20support%20the%20woocommerce%20checkout%20block%3F\"><h3>Does this plugin support the WooCommerce Checkout Block?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20is%20hpos%20and%20is%20it%20supported%3F\"><h3>What is HPOS and is it supported?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20types%20of%20documents%20can%20i%20send%3F\"><h3>What types of documents can I send?<\/h3><\/dt>\n<dd><p>The plugin supports three document types:\n* <strong>SDI Invoices<\/strong> (fatture elettroniche) \u2014 sent through the SDI, for companies and private individuals with a fiscal code.\n* <strong>Ordini<\/strong> (orders) \u2014 sent through the FreeInvoice document flow, for companies and private individuals with a fiscal code.\n* <strong>Ricevute<\/strong> (receipts) \u2014 sent through the FreeInvoice document flow, for private individuals without a fiscal code.<\/p><\/dd>\n<dt id=\"how%20does%20the%20ricevute%20flow%20work%20for%20private%20customers%20without%20a%20fiscal%20code%3F\"><h3>How does the ricevute flow work for private customers without a fiscal code?<\/h3><\/dt>\n<dd><p>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 \u2014 no fake fiscal code is used.<\/p><\/dd>\n<dt id=\"can%20i%20test%20the%20plugin%20before%20going%20live%3F\"><h3>Can I test the plugin before going live?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20send%20invoices%20automatically%3F\"><h3>Does the plugin send invoices automatically?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"how%20do%20i%20track%20invoice%20status%3F\"><h3>How do I track invoice status?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"can%20i%20disable%20invoicing%20for%20private%20individuals%3F\"><h3>Can I disable invoicing for private individuals?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"where%20can%20i%20manage%20the%20tax%20regime%3F\"><h3>Where can I manage the tax regime?<\/h3><\/dt>\n<dd><p>In the plugin settings (WooCommerce \u2192 Settings \u2192 FreeInvoice API) you can select your business tax regime from a drop-down list.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20generate%20pdf%20invoices%3F\"><h3>Does the plugin generate PDF invoices?<\/h3><\/dt>\n<dd><p>No. The plugin generates FatturaPA XML and transmits it through the FreeInvoice service. PDF invoices are available on your FreeInvoice account.<\/p><\/dd>\n<dt id=\"can%20i%20manage%200%25%20vat%20rates%3F\"><h3>Can I manage 0% VAT rates?<\/h3><\/dt>\n<dd><p>Yes. The plugin settings include a dedicated section for managing 0% VAT rates with their corresponding FatturaPA natura codes.<\/p><\/dd>\n<dt id=\"where%20can%20i%20configure%20invoice%20numbering%3F\"><h3>Where can I configure invoice numbering?<\/h3><\/dt>\n<dd><p>Invoice numbering settings are available in the plugin settings. You can choose between automatic or manual numbering.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Fix incorrect split payment flag on zero-VAT\/Natura XML summaries sent to SDI<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Add WooCommerce Checkout Block support via Additional Checkout Fields API<\/li>\n<li>Add HPOS (High-Performance Order Storage) compatibility<\/li>\n<li>Add FreeInvoice document flow: ordini and ricevute<\/li>\n<li>Add automatic routing of private customers without fiscal code to ricevute via Lead receiver<\/li>\n<li>Add auto-send on order completion with tracking<\/li>\n<li>Add manual send for both SDI invoices and FreeInvoice documents from order admin<\/li>\n<li>Add webhook status tracking for invoices and documents<\/li>\n<li>Add conditional checkout fields based on customer type (individual\/company)<\/li>\n<li>Add guest checkout support for fiscal fields<\/li>\n<li>Add customer email to API payload for document sending<\/li>\n<li>Improve admin metabox with route-aware labels (Invia Fattura \/ Invia Ricevuta \/ Invia Ordine)<\/li>\n<li>Improve order list status display with single primary label and Auto\/Manual badge<\/li>\n<li>Fix shipping data in XML generation<\/li>\n<li>Fix admin error messages: separate SDI and document errors, no false CF blocker for ricevute<\/li>\n<li>Update Plugin URI to owner site<\/li>\n<li>Rename README.txt to readme.txt for WordPress.org compliance<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Fix invoice sending errors and WordPress 6.9 compatibility<\/li>\n<li>Fix 0% VAT rate handling<\/li>\n<li>Add user-configurable API endpoints<\/li>\n<li>Add sandbox\/production endpoint toggle<\/li>\n<li>Improve invoice error display in admin UI<\/li>\n<li>Fix address\/province error when PEC destinatario is missing<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First public release of the FreeInvoice API plugin<\/li>\n<li>Generation and sending of FatturaPA XML electronic invoices<\/li>\n<li>Fiscal checkout fields (VAT number, fiscal code, recipient code\/PEC)<\/li>\n<li>Customer data persistence on orders<\/li>\n<li>Enable\/disable invoicing for private individuals<\/li>\n<li>Dynamic checkout field management<\/li>\n<li>VAT number and fiscal code validation<\/li>\n<li>Invoice numbering (automatic\/manual)<\/li>\n<li>0% VAT rate management with natura codes<\/li>\n<li>Payment method configuration<\/li>\n<li>Sandbox mode for testing<\/li>\n<\/ul>","raw_excerpt":"Generate and send Italian electronic invoices (FatturaPA) and FreeInvoice documents (ordini, ricevute) from WooCommerce orders via the FreeInvoice API &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/130499","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=130499"}],"author":[{"embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/cloudfinance"}],"wp:attachment":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=130499"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=130499"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=130499"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=130499"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=130499"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=130499"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}