=== Evoliz FR for WooCommerce ===
Contributors: catcodestudio
Tags: evoliz, facturation, invoice, accounting, woocommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sends WooCommerce orders to Evoliz: the customer, an order and a draft invoice with the order lines, shipping and fees, in your own Evoliz company.

== Description ==

French web shops that keep their invoices in Evoliz end up retyping web orders. This plugin does it through the public Evoliz API with your own API keys:

* **Order to invoice in one click** — from the order edit screen (the Evoliz FR box or the order actions menu) the plugin creates the customer in Evoliz, an order and a draft invoice with every order line, shipping and fee.
* **Prices as in the shop** — prices with or without VAT as your shop holds them, the VAT rate of each line, discounts already applied, quantities kept. A coupon booked as a negative fee becomes a discount on the document.
* **Customers, private and business** — a private individual or, for a French business, the SIRET, SIREN and VAT number you collect at checkout (you tell the plugin which order field holds them). The same e-mail address always lands on the same Evoliz client. The contact is created so Evoliz can send the invoice.
* **No double documents** — the plugin looks for the customer, the article and the order by your own references before it creates anything, and it remembers each step, so pressing the button again, or a send that failed halfway, never creates a second one.
* **Failures are visible** — the reason Evoliz gave is written to the order notes and shown in the box.
* **Refunds** — a refund on a sent order leaves a note to book the credit note in Evoliz.
* HPOS (custom order tables) supported. French translation included.

// @pro-begin
= Pro =

The Pro version is sold on [catcode.com.ua](https://catcode.com.ua/modules/evoliz-fr-woocommerce/), with a 7-day trial that never starts by itself:

* **Automatic sending** when an order reaches the statuses you choose, with retries.
* **Finalising** of the invoices in Evoliz.
* **Payment recorded** against the invoice with the payment method of the order.
* **One Evoliz article per WooCommerce product**, created the first time it is sold.
* **E-invoicing**: a finalised invoice for a French business is handed to the approved platform when the buyer has one electronic address that can receive it.
* **Credit notes** for WooCommerce refunds.
* **Bulk action** in the order list.

The licence runs for 1-5 years and includes updates and support for that term; a purchased licence keeps its Pro features after the term ends.
// @pro-end

= Not accounting advice =

The plugin sends what your shop and your settings describe. Check the invoices in Evoliz before you rely on them for bookkeeping or for tax purposes. Evoliz is a trademark of its owner; this plugin is made by CatCode and is not made or endorsed by Evoliz.

== Installation ==

1. Install and activate the plugin. WooCommerce must be active.
2. In Evoliz open Applications, then Available Connectors, enable the Evoliz API connector and create an API key (a public key and a secret key). Give the API user access to customers, contacts, orders and invoices.
3. WooCommerce → Evoliz FR: enter your customer number (bottom-left corner in Evoliz, under your name) and the two keys, then save.
4. Open an order and press "Send to Evoliz".

== Frequently Asked Questions ==

= Where do I find the customer number? =

In Evoliz, bottom-left corner, under your first and last name: the first part is your customer number.

= Does it work with another currency than euro? =

Evoliz documents are created in the currency of your Evoliz company. An order in another currency is not sent, and the order note says why.

= How do I invoice a French business? =

Evoliz needs the SIRET, the SIREN and the VAT number of a French business customer. Collect them at checkout, then give the plugin the order meta key that holds the SIRET (and the VAT number) in the settings. A customer with a company name but no SIRET is created as a private individual.

= Does it create credit notes for refunds? =

A refund leaves a note on the order so it is not forgotten, and the credit note is booked in Evoliz.
// @pro-begin
The Pro version creates the credit note for you.
// @pro-end

= Is the invoice final? =

The free version leaves a draft invoice that you check and finalise in Evoliz. A finalised invoice cannot be edited or deleted in Evoliz, only corrected by a credit note.

== Changelog ==

= 1.0.0 =
* First release: customer, order and draft invoice from a WooCommerce order.
// @pro-begin
* Pro: automatic sending with retries, finalising, payment recording, an Evoliz article per WooCommerce product, e-invoicing, credit notes for refunds, bulk action.
* Pro: updates from catcode.com.ua.
// @pro-end
