=== Syneo Kontozz Sync ===
Contributors: patriksyeno1031
Tags: woocommerce, invoicing, kontozz, billing, invoices
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 8.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WooCommerce store to the Kontozz invoicing platform.

== Description ==

**Syneo Kontozz Sync – WooCommerce Invoicing** connects WooCommerce with the Kontozz invoicing platform and allows invoices to be generated from WooCommerce orders.

The plugin sends order and billing data from WooCommerce to Kontozz through the Kontozz API and provides invoice management tools directly in the WordPress admin area.

---

### Features

**Kontozz API Integration**
Connect your Kontozz account using API credentials and transmit invoice data directly from WooCommerce.

**Invoice Generation Modes**
Choose when invoices should be generated:
* On order creation
* On payment received
* On order completion
* Manually from the admin panel

**Invoice Configuration**
Configure invoice generation settings including:
* Invoice block / series selection
* Payment method mapping
* Billing and shipping address handling
* Tax and VAT settings
* Invoice notes
* Shipping as separate invoice line item

**Invoice Management**
Manage generated invoices from the WordPress admin:
* Filter invoices by order
* View invoice in Kontozz
* Download invoice PDF
* Resend invoice email
* Review invoice status

**Logging and Error Handling**
Failed invoice generation attempts are logged for troubleshooting.

---

### Technical Details

* WooCommerce compatible
* HPOS (High Performance Order Storage) supported
* REST API communication with Kontozz
* Built-in logging
* Multisite compatible

### Useful Links

* Kontozz website: https://kontozz.hu
* Kontozz API documentation: https://kontozz.hu/docs
* Plugin support forum: https://wordpress.org/support/plugin/syneo-kontozz-sync

== Installation ==

= Automatic Installation =

1. Log in to WordPress admin
2. Go to **Plugins → Add New Plugin**
3. Search for **Syneo Kontozz Sync**
4. Click **Install Now**
5. Activate the plugin

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins → Add New Plugin → Upload Plugin**
3. Upload the ZIP file
4. Activate the plugin

= Configuration =

1. Go to **WooCommerce → Kontozz Invoicing**
2. Enter your Kontozz API key
3. Select invoice settings and generation mode
4. Save settings

== Frequently Asked Questions ==

= Do I need a Kontozz account? =

Yes. An active Kontozz account is required.

= Where do I find my API key? =

Generate your API key in your Kontozz account under the integrations/settings area.

= Can I generate invoices for past orders? =

Yes. Invoices can be generated manually for previous orders.

= What happens if invoice generation fails? =

The error is logged and the invoice can be retried manually.

= Can I manage invoice blocks? =

Yes. Available Kontozz invoice blocks can be selected and configured.

= Will the plugin send invoice emails to customers? =

Yes, if configured accordingly.

= Is the plugin GDPR compliant? =

The plugin transmits invoice-related customer and order data to Kontozz solely for invoice generation purposes. Site owners are responsible for ensuring their use complies with local privacy regulations.

= What is WooCommerce HPOS? =

HPOS is WooCommerce’s High Performance Order Storage system. This plugin supports it.

== Changelog ==

= 1.0.0 =
* Initial public release
* Automatic invoice generation
* Manual invoice generation
* Invoice block selection
* PDF download
* Invoice resend
* Invoice view link
* Error logging
* HPOS support

== Upgrade Notice ==

Back up your site before updating the plugin.

== External Services ==

This plugin connects to the Kontozz API to create and manage invoices for WooCommerce orders.

It is required for the core functionality of the plugin, as invoice generation is handled by the Kontozz invoicing platform.

Data sent to this service includes:

* Store and API authentication credentials (API key)
* Customer billing information
* Customer shipping information (if applicable)
* Order items and product data
* Tax and VAT information
* Payment method information
* Order totals and invoice metadata

Data is sent when:

* An invoice is generated automatically based on plugin settings
* An invoice is generated manually by an administrator
* Invoice/account unit data is synchronized from Kontozz
* A generated invoice PDF is requested for download

This service is provided by Kontozz:

* Terms of Service: https://kontozz.hu/static/terms-of-service
* Privacy Policy: https://kontozz.hu/static/privacy-policy
* API Documentation: https://kontozz.hu/web-api