=== Invoicing Integration for Fakturowo and WooCommerce ===
Contributors: devikit
Tags: woocommerce, invoice, accounting, fakturowo, vat
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.15
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

WooCommerce invoicing integration with Fakturowo.pl accounting system.

== Description ==

Integrate your WooCommerce store with Fakturowo.pl accounting system. Create invoices automatically, manage VAT numbers, and streamline your accounting workflow.

https://youtu.be/ToVlyD-DJdQ

= Features =

= Free version =

*   Manual invoice generation from order edit screen.
*   Storing invoice number in order.
*   Invoice link preview.
*   API communication logs.
*   Advanced VAT rate mapping.

= Pro Version =

A Pro version is also available with additional features:

*   Automatic invoice generation after status change.
*   Proforma invoice support.
*   Bulk document generation and email sending - Generate invoices and proformas for multiple orders at once with progress tracking.
*   Email notifications with PDF attachments.
*   WooCommerce Subscriptions compatibility.
*   Technical support.

[**Get Pro Version**](https://devikit.pl/produkt/fakturowo-woocommerce-pro/)

== Installation ==

1. Before using this plugin, activate API access (one-time fee) at: https://konto.fakturowo.pl/konto/abonament
2. Get your API Key and API URL from: https://konto.fakturowo.pl/konto (section "API parameters")
3. Upload the plugin files to `/wp-content/plugins/invoicing-integration-for-fakturowo-and-woocommerce/`
4. Activate the plugin through the 'Plugins' menu in WordPress
5. Go to WooCommerce → Fakturowo to configure the plugin
6. Enter your Fakturowo API URL and API Key
7. Test the connection and save settings

== Frequently Asked Questions ==

= Do I need a Fakturowo account? =

Yes, you need an active Fakturowo.pl account with API access enabled.

= Where do I get my API credentials? =

You can find your API Key and API URL at https://konto.fakturowo.pl/konto in the "API parameters" section.

= Is the plugin compatible with WooCommerce High-Performance Order Storage (HPOS)? =

Yes, the plugin is fully compatible with HPOS.

== External services ==

This plugin connects to the Fakturowo.pl API service to manage invoices and customer data for your WooCommerce store.

= What is Fakturowo.pl? =

Fakturowo.pl is a Polish online accounting and invoicing service. This plugin uses their API to automatically create and manage invoices for your WooCommerce orders.

= What data is sent and when? =

The plugin sends the following data to Fakturowo.pl API when you create an invoice:
* Customer information (name, email, address, VAT number if provided)
* Order details (products, prices, taxes, payment method)
* Invoice settings configured in the plugin

Data is sent in the following scenarios:
* When you manually click "Create Invoice" button on an order page
* When testing the API connection in plugin settings
* When downloading invoice PDFs

= API Endpoint =

The plugin connects to your unique Fakturowo API URL (e.g., https://yourcompany.fakturowo.pl/api/)

= Service Terms and Privacy =

* Fakturowo.pl Service: https://konto.fakturowo.pl/
* Terms of Service: https://www.fakturowo.pl/pomoc/regulamin
* Privacy Policy: https://www.fakturowo.pl/pomoc/polityka-prywatnosci

Note: You must have an active Fakturowo.pl account with API access enabled (one-time activation fee) to use this plugin. The plugin does not send any data without your explicit action (clicking invoice creation buttons).

== Screenshots ==

1. Plugin settings
2. Plugin settings
3. Plugin settings
4. Plugin settings
5. Plugin settings
6. Plugin settings
7. Plugin settings

== Changelog ==

= 1.0.15 =
* Maintenance release

= 1.0.14 =
* Updated readme

= 1.0.11 =
* Added: Total mismatch warning (order vs invoice sum) displayed in Fakturowo column on orders list
* Improved: Total validation tolerance aligned with WFirma (0.001)
* Added: 5-minute delayed email sending for automatic invoices (KSeF processing) - PRO automation
* Added: Delayed invoice email handler for Action Scheduler

= 1.0.10 =
* Fixed: Corrected JavaScript file path for Pro upgrade banner dismissal

= 1.0.9 =
* Small fixes

= 1.0.8 =
* Small fixes

= 1.0.7 =
* Updated plugin screenshots

= 1.0.6 =
* Added plugin screenshots

= 1.0.5 =
* Security improvements: Enhanced nonce verification and input sanitization
* Fixed: Proper escaping for all inline scripts
* Fixed: Removed processing of entire $_POST array

= 1.0.4 =
* Security improvements: Added nonce and user permission checks for all AJAX requests

= 1.0.3 =
* Fixed NIP field to preserve country code (e.g., DE, PL) when validation is disabled

= 1.0.2 =
* Small fixes

= 1.0.0 =
* Initial release
* Manual invoice creation
* VAT number field support
* Fakturowo API integration

== Upgrade Notice ==

= 1.0.0 =
Initial release


