Abby for WooCommerce — orders into Abby invoices

Abby FR for WooCommerce sends WooCommerce orders to your Abby account (abby.fr), the invoicing and bookkeeping service for French freelancers and micro-entrepreneurs. One order becomes a customer and a draft invoice in Abby with every line, shipping and fees, so web orders no longer have to be retyped. The module works through the public Abby API with your own key.

What the free version does

The order screen gets an Abby FR box with a “Send to Abby” button (the same action sits in the order actions menu). The module finds or creates the customer in Abby: a private person, or a business customer when the order has a company name and a SIRET. It then creates a draft invoice: every product, shipping and fees as separate lines, discounts already applied, each line with the VAT code of its rate (2.1, 5.5, 8.5, 10 or 20 %, or no VAT). The invoice gets a note with the order number and the payment method. The total Abby computes is compared with the order total. The “Invoice PDF” button opens the PDF straight from Abby. Pressing the button again duplicates nothing, and when Abby refuses, the reason stays in the box and in the order notes and the send can be continued from the same point. After a refund the order gets a note to book the credit note in Abby.

What Pro adds

Automatic sending when an order reaches a status you choose, with three attempts on failure. Finalising the invoice in Abby and marking it as paid with the payment method of the order. An e-mail to the customer with the invoice PDF as soon as it is finalised; the same PDF is attached to the “Order details” e-mail sent by hand. A credit note (avoir) made from the invoice on a full or partial refund. Products are added to the Abby catalogue the first time they are sold. A bulk action in the order list for past orders and a list of failed sends with a retry button.

Good to know before you start

• The Abby API is part of some Abby plans only. If Abby refuses the key, check in your account that your plan includes the API.
• By default prices go to the invoice without tax (HT) and Abby adds the VAT. In a shop that enters prices with VAT the total can differ by 1 cent because of rounding. The invoice then stays a draft: the module says so on the order and never finalises or e-mails it automatically.
• The “With tax (TTC)” mode matches totals to the cent, but Abby accepts it only when prices with tax are enabled in your account.
• Abby has French VAT rates only. An order with another rate (a sale to another EU country at its rate, for example) or in another currency is not sent; the order shows the reason.
• A finalised invoice cannot be edited in Abby: only a credit note corrects it.
• The module sends data from the shop to Abby. It does not read changes made in Abby back into the shop.

How it works, step by step

1. In Abby open Settings → Integrations and create an API key. Copy it at once: Abby shows it only when it is created.
2. In WooCommerce → Abby FR paste the key and save. The connection is verified straight away.
3. Choose the document language, the price mode, the code for lines without VAT and the payment method.
4. Open an order and press “Send to Abby”. Check the draft in Abby and finalise it there, or switch on the Pro automation.

Under the hood

• Each step of a send is remembered, so a repeat or a send that failed halfway never creates a second invoice.
• The same e-mail address or SIRET always lands on the same Abby customer.
• The PDF is not stored on the site: it is fetched from Abby each time.
• The module adds nothing to the cart or checkout. HPOS compatible; languages: English, français.

How to install

1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
2. WooCommerce → Abby FR: paste the API key and save.
3. Check the invoice settings.
4. Try one order before you switch the automation on.

The module is not on wordpress.org yet: the free version and Pro are one archive from this page. Without a key it works as the free version.