=== Invoice Maven for WooCommerce ===
Contributors: invoicemaven
Tags: invoice, israel, receipt, woocommerce, חשבונית
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 11.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatic Israeli tax invoice-receipts for every WooCommerce order, and a credit invoice for every refund - issued in Invoice Maven.

== Description ==

**Invoice Maven for WooCommerce** issues the legal document for every paid order in your [Invoice Maven](https://www.invoice-maven.co.il/?utm_source=woocommerce&utm_medium=plugin&utm_campaign=readme) account, and emails it to the customer.

* A tax invoice-receipt (חשבונית מס קבלה) for every paid order - or a receipt (קבלה) for an exempt dealer.
* A credit invoice (חשבונית זיכוי) for every refund, full or partial.
* Works with any payment gateway: the document is issued when the order is paid.
* Bank transfer, cheque and cash on delivery wait until you mark the order completed.
* The Tax Authority allocation number (מספר הקצאה) is requested automatically for business invoices above the threshold.
* English documents for customers outside Israel, in ILS, USD, EUR or GBP.
* Never issues the same order twice, and retries on its own when the connection fails.
* Compatible with WooCommerce High-Performance Order Storage.

**התוסף הרשמי של אינוויס מייבן ל-WooCommerce** - חשבונית מס קבלה אוטומטית לכל הזמנה ששולמה, וחשבונית זיכוי לכל החזר, ישירות מהחנות שלך.

== Installation ==

1. Install and activate the plugin.
2. In your Invoice Maven account, open Settings > API and copy the API key.
3. In WordPress, open WooCommerce > Settings > Invoice Maven, paste the key and save. The plugin confirms the connection.

No account yet? [Open one free](https://app.invoice-maven.co.il/register.jsf?utm_source=woocommerce&utm_medium=plugin&utm_campaign=readme).

== Frequently Asked Questions ==

= When is the document issued? =

When the order reaches "Processing" (paid), or "Completed" if you choose so. Orders paid by bank transfer, cheque or cash on delivery always wait for "Completed".

= How fast does the document appear? =

Right away: the plugin issues it at the end of the request that paid or refunded the order, after the customer's page was sent, so the checkout never waits for it.

= What happens if Invoice Maven cannot be reached? =

The plugin waits up to 15 seconds, then tries again in the background after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours. Every attempt is recorded in the order notes. You can also issue the document by hand from the order actions.

= Can the same order get two documents? =

No. Each order is sent with its own unique id, and Invoice Maven refuses a second document for the same id.

= How do I get an allocation number for a business customer? =

WooCommerce has no field for an ID or company number. If your checkout collects one, enter the order meta key where it is saved in the plugin settings.

== External services ==

This plugin connects to the Invoice Maven API (https://app.invoice-maven.co.il) to issue documents. It sends data only when an order is paid or refunded, when you issue a document by hand, and when you save the settings (a test call that saves nothing).

It sends: your API key, the store administrator's email, the order's billing name, company, email, phone and address, the order lines, totals, currency and payment method, and the refund amount and reason.

The service is provided by Maven Business Solutions Ltd.: [terms of use](https://www.invoice-maven.co.il/%D7%9E%D7%93%D7%99%D7%A0%D7%99%D7%95%D7%AA-%D7%AA%D7%A0%D7%90%D7%99-%D7%A9%D7%99%D7%9E%D7%95%D7%A9/), [privacy policy](https://www.invoice-maven.co.il/%D7%9E%D7%93%D7%99%D7%A0%D7%99%D7%95%D7%AA-%D7%A4%D7%A8%D7%98%D7%99%D7%95%D7%AA/).

== Changelog ==

= 1.0.0 =
* First release.
