Sirenly – Facture électronique for B2Brouter

Description

From 1 September 2026 every VAT-registered business in France must be able to receive electronic invoices, and from 1 September 2027 small and medium businesses must also issue them through an approved platform (Plateforme Agréée, PA).

This plugin connects your WooCommerce store to B2Brouter, an approved platform, so that invoices for your French business customers are issued electronically without any manual work.

How it works

  • Adds an optional SIREN field to the checkout (checked with the Luhn key) and to the order edit screen.
  • When an order with a French billing address and a valid SIREN is set to Completed, the plugin creates the invoice at B2Brouter and sends it.
  • Every invoice gets a sequential number with no gaps and no duplicates (FA-000001, FA-000002…), as required by French law, even with simultaneous orders.
  • Product lines are sent net of discounts, shipping is sent as its own line, and VAT is mapped to the matching French rate: mainland (20, 10, 5.5, 2.1 %), Corsica (13, 0.9 %) and overseas departments (8.5, 1.05 %).
  • The result (success or error message) is written in the order notes.
  • Failed sends can be retried from Order actions > « Envoyer la facture électronique (B2Brouter) ». A retry reuses the same invoice number and never creates a duplicate invoice.
  • The B2Brouter account ID is detected automatically from your API key.
  • Compatible with WooCommerce High-Performance Order Storage (HPOS).

What this plugin does not do (yet)

  • B2C and international sales (e-reporting) are not sent.
  • The block-based checkout is not supported: use the classic checkout ([woocommerce_checkout] shortcode) so that the SIREN field is shown.
  • A 0 % rate is sent as “exempt” (category E) without an exemption reason.

The plugin interface is in French.

External services

This plugin connects to the B2Brouter API (https://api.b2brouter.net), operated by B2Brouter Global S.L., to create and send electronic invoices. It is required for the plugin to work.

  • When: only when an order with a French billing address and a valid SIREN is set to Completed, or when the store manager uses the « Envoyer la facture électronique (B2Brouter) » order action. When no account ID is saved, the plugin also asks the API once for the account linked to the API key.
  • What is sent: the invoice number and date, currency, customer company or name, billing country, billing email, SIREN, and each invoice line (description, quantity, unit price, VAT rate). Your B2Brouter API key is sent in the request headers.
  • Nothing is sent for orders without a valid SIREN or with a non-French billing address.

You need a B2Brouter account. B2Brouter terms of service: https://www.b2brouter.net/fr/conditions-generales-du-service — privacy policy: https://www.b2brouter.net/fr/politique-de-confidentialite

This plugin is not affiliated with or endorsed by B2Brouter or WooCommerce.

Installation

  1. Install and activate WooCommerce.
  2. Upload the plugin from Plugins > Add New > Upload Plugin, or install it from the plugin directory, then activate it.
  3. Create a B2Brouter account. For testing, open Developers > Create Sandbox in B2Brouter: the sandbox API key starts with test_.
  4. Go to WooCommerce > Settings > Advanced > Facture électronique and paste your API key. Leave the account ID empty to have it detected automatically.
  5. Use the classic checkout so the SIREN field is shown to customers.
  6. Place a test order with a valid SIREN and a French billing address, then set it to Completed. The order notes show the result.

FAQ

Do I need a B2Brouter account?

Yes. The plugin only sends invoices to B2Brouter. A free sandbox lets you test everything before choosing a plan.

How do I test without sending real invoices?

Use a sandbox API key (starting with test_). Invoices then go to your B2Brouter sandbox and are marked as test invoices.

Which orders are sent?

Only orders with a French billing address and a valid SIREN. Other orders are ignored, and a note in the order explains why.

Where do I see what happened?

In the order notes of each order: invoice number and B2Brouter ID on success, or the error message returned by B2Brouter.

Can I resend an invoice?

Yes, from Order actions > « Envoyer la facture électronique (B2Brouter) ». An invoice already sent is never sent twice.

I already use a PDF invoice plugin.

Make sure both plugins do not issue two separate invoice number sequences for the same orders. You can change the invoice number prefix in the settings.

Does it work with the block checkout?

Not yet. Use the classic checkout shortcode [woocommerce_checkout] on your checkout page.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Sirenly – Facture électronique for B2Brouter” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.1.1

  • Plugin renamed to Sirenly – Facture électronique for B2Brouter.

0.1.0

  • First release: SIREN field, automatic send on order completion, manual retry, gap-free invoice numbering, French VAT rates including Corsica and overseas departments, automatic account detection, HPOS support.