GoFactoX: Facture électronique Factur-X for WooCommerce

Changelog

1.6.0

Read before updating

• Pro: check your SUPER PDP client secret. In 1.5.x, saving the settings page without typing the secret again erased it and stopped the transmissions (fixed in this version). After updating, open WooCommerce > Settings > GoFactoX (Factur-X), check that the secret is shown as saved (enter it again if not) and click “Test connection”. Documents issued while the secret was missing were not sent: in the GoFactoX dashboard, choose the “Never sent” filter, then “Send these documents to the PA”.
• Nothing is generated, and no invoice number is consumed, while the company information is incomplete or the invoices folder cannot be written. Complete the company settings after updating: until then new orders get no invoice, an automatic generation adds an order note with the reason, and an admin notice lists what is missing (all plans). The SIRET is now required only for sellers established in France.
• New “Invoice language” setting. Invoices and credit notes are written in French on new installations and on French sites, and in the site language on an existing installation on a non-French site, so that nothing changes silently: choose French if you invoice customers established in France. The language no longer depends on who triggers the generation.
• GoFactoX admin notices now appear only where they matter: the Plugins page, the orders list, the GoFactoX dashboard and the GoFactoX settings tab, no longer on every admin screen.

Fixes

• (Pro) With WooCommerce’s default synchronous e-mails, the “Completed order” (or “Processing order”) e-mail was sent before the invoice was generated, so the invoice was never attached; refund e-mails had the same problem and did not carry credit notes. The missing document is now generated just before the e-mail, only while the order changes to the trigger status or the refund is created (an e-mail sent again later never creates an invoice), and it is transmitted to your Plateforme Agréée in the background.
• The “UBL” output format now produces a real UBL 2.1 document (Invoice, or CreditNote for credit notes) that passes the French e-invoicing rules; until now it produced CII. The conversion uses horstoeko/zugferdublbridge, by the author of the Factur-X library already used.
• CII and UBL documents are downloaded and attached as .xml files, and their buttons say “XML”.
• (Pro) The stored SUPER PDP secret is no longer erased when the settings page is saved without retyping it: WooCommerce no longer saves the secret fields itself, and the typed secret is never stored in clear text, even briefly. Client secrets are stored verbatim (characters such as “<” or “%” were altered).
• (Pro) Status polling could stop refreshing new documents. Documents that reached a final status (paid, approved) or stayed at an intermediate one kept the 20 slots of each polling pass, so after about twenty such invoices the status of newer invoices was no longer updated. Finished documents now leave the polling queue, the others are checked in rotation, and documents transmitted more than 90 days ago get one last check.
• (Pro) The “paid” status (fr:212) is still sent when the invoice reaches an approval status before the Plateforme Agréée accepts it, and it is never sent from a staging or cloned site by the status polling.
• (Pro) Documents whose automatic retries were exhausted no longer prevent other documents in error from being retried.
• (Pro) Each document is tracked through the connector that transmitted it, so switching connectors no longer marks documents in progress as coming from a previous account.
• (Pro) The GoFactoX bulk actions of the orders list require the “manage WooCommerce” capability, like every other GoFactoX action.

New: Plateforme Agréée (Pro)

• Experimental “AFNOR API” connector for another Plateforme Agréée exposing the standard AFNOR XP Z12-013 Flow API with OAuth2 client credentials. Listed as “Experimental” in the connector choice; define GOFACTOX_ENABLE_AFNOR as false to hide it. It transmits invoices and credit notes to French business customers and follows them until the platform’s technical acknowledgement; business statuses, e-reporting and the “paid” status stay on the platform. Validated with SUPER PDP only. HTTPS only, no redirect followed, the secret is revoked when the platform host changes, a document already held by the platform is compared with the local file before being tracked, and a transmission left without answer is looked up before any new upload.
• “Never sent” filter in the GoFactoX dashboard with a button to send the listed documents, and a “Send to PA” bulk action on the orders list. Sending runs in the background and follows the usual scope; documents already held by the platform or rejected are left alone.
• The order screen and an admin notice explain why transmission is unavailable (no connector, incomplete credentials, staging or cloned site). “Test connection” warns when the SUPER PDP account belongs to a different SIREN than the one on your invoices.

New for every plan

• “Preview an invoice” button in the company settings: a watermarked specimen PDF with sample data that consumes no invoice number.
• Orders list: a “Generate” link for processing and completed orders without an invoice, a “Generate the Factur-X invoice” order action, and a “GoFactoX invoice or credit note number” choice in the order search.
• Order notes when an invoice is generated and when a generation fails, with the reason.
• The seller VAT number is checked when the settings are saved: a wrong length for its country, or a French number that is not FR + key + 9 digits, is refused (the previous value is kept); a missing prefix, “GR” instead of “EL”, or a French key that does not derive from the SIRET only raises a warning (normal for a VAT group or a fiscal representative).
• “Settings” link on the Plugins page. The diagnostic now checks the invoices folder, PHP limits and extensions, the documents without a file, and whether the folder can be downloaded from the web. A notice appears when the invoices folder cannot be written.
• Deleting the plugin removes the Plateforme Agréée credentials, cached tokens and scheduled events. Invoices, credit notes, settings and numbering counters are kept: invoices must be archived for 10 years and a reinstall must never reuse an invoice number.

New and improved (Pro)

• Credit notes are attached to the refund e-mails and listed in My Account, in the orders table and on the order page.
• The dashboard shows the net revenue excl. VAT (invoices minus credit notes) of the month and in total, and a paginated document list. A button such as “Download September 2026 (ZIP)” gives every invoice and credit note of the month with a summary file for your accountant.
• “Generate missing invoices” panel: asks for a start date, shows exactly what will be generated (invoices dated today, numbered in order-date order), also creates the missing credit notes of their refunds, runs in batches, never transmits unless you tick the box, and lists the documents that received a number without a file (interrupted generation).
• The invoice column of the orders list also shows the credit notes of each order and the Plateforme Agréée status of every document, and flags “Missing” the orders that should have been invoiced automatically. Order notes record each Plateforme Agréée status change (sent, accepted, rejected, error).
• The bulk “Generate” action reports the generated, already invoiced and failed orders with the first reason, and rebuilds at the same number the invoices whose file is missing.

1.5.1

• Fix: fatal error on PHP 8.0 (a PHP 8.1 keyword slipped into 1.5.0). The plugin runs on PHP 8.0 to 8.5 again.
• Fix: invoice and credit note numbers are now reserved with an atomic database increment, and document creation is locked per order, so two simultaneous triggers (payment gateway notification + status change, bulk + webhook) can no longer produce duplicate numbers or duplicate documents.
• Fix: “Regenerate” keeps the document and its number and rebuilds the PDF/XML in place; it is refused, with an explanation, once the document has been transmitted to the Plateforme Agréée (issue a credit note instead). A confirmation is asked before regenerating.
• Fix: guest customers (no account) can download their invoice from the signed link on the thank-you page and in e-mails; they used to get a 403.
• Security: updated dompdf (3.1.6), FPDI (2.6.8), symfony/yaml and horstoeko/zugferd (1.0.132); composer audit is clean.
• Compliance: EU business customers identified by an intra-community VAT number are now invoiced with reverse charge (category AE, VATEX-EU-AE) and transmitted as B2B; exports outside the EU carry the VATEX-EU-G exemption; negative fees keep a consistent VAT rate; the delivery address (BG-15) is emitted when address line 2 or the company differs; credit notes carry their reason as a coded note; the early payment discount mention (AAB) is configurable.
• New (Pro): e-mail alert when a document is rejected by the Plateforme Agréée or fails to be transmitted (one per document), persistent admin notice while documents are in error, “Failed” filter in the dashboard, “Copy diagnostic” button for support.
• New (Pro): transmission is paused on staging/development sites and on cloned sites (URL changed), documents transmitted with a previous PA account are flagged, an unreadable client secret (site keys changed) is reported instead of silently failing.
• Improved: SIRET and IBAN are validated (Luhn, mod 97) in the settings, SIREN/SIRET typed at checkout get a notice when the check digit is wrong, the next invoice number can no longer be lowered below numbers already issued.
• Improved: status polling is locked against overlapping runs and processes 20 documents per pass; “paid” (fr:212) is now a terminal status; temporary files are purged daily; a notice appears when WP-Cron is disabled and no status check ran for two hours.
• Improved: dashboard statistics come from one aggregated query (cached 5 minutes), FEC export reads documents in pages of 500, ZIP export is capped at 200 orders per action, spreadsheet formulas are neutralised in FEC text cells, invoice folder protected with Require all denied (Apache 2.4).
• Improved: settings and menus renamed “GoFactoX (Factur-X)”, late payment section renamed, backup reminder, B2C e-reporting hint on the transmission scope, French translations completed.
• Dev: unit tests for numbering, downloads, identifiers, alerts, polling locks, staging guard; GitHub Actions matrix PHP 8.0/8.2/8.4; release build refuses vulnerable dependencies and PHP 8.1 syntax.

1.5.0

• New (Pro): automatic transmission of invoices and credit notes to your Plateforme Agréée through your own SUPER PDP account, with status tracking, retries and “paid” status.
• Compliance: SIRET and SIREN identifiers, 0225 electronic addresses, invoicing framework codes B1/S1/M1 and coded legal notes now pass the French PA validation; EN 16931 is the default profile.
• Improved (Business): FEC export with VAT split per rate and a stable entry number.

1.4.2

• New: the mandatory mentions of the French reform: operation category (goods, services, mixed), delivery address, optional “VAT on debits” mention, and the invoicing framework (BT-23).

1.4.1

• WordPress 7.0 compatibility and zero Plugin Check errors.
• Fixes: credit note download from the dashboard, French translations, end-of-month payment terms aligned with the Code de commerce (L441-10).

1.4.0

• New: company logo, IBAN/BIC and payment terms, SEPA QR code, purchase order number at checkout, B2B fields in the block checkout, coupons as structured discounts.
• New: electronic addresses (BT-34/BT-49), Comfort (EN 16931) profile, WooCommerce Subscriptions billing period.
• New: FEC export, REST API and webhooks, GDPR export and erase, developer filters, invoice button on the order confirmation page.

1.3.0

• New: Factur-X credit notes (avoirs) for WooCommerce refunds, with their own numbering, “AVOIR” watermark and automatic generation (Pro).
• Improved: clear error messages when the company information is incomplete.

1.2.1

• Fix: permission error during plugin registration on some installations.
• Improved: B2B checkout fields shown higher in the checkout form.

1.2.0

• New: Pro plan with automation features.
• Improved: WooCommerce 10 compatibility.

1.1.1

• New: French translation, WPML, Polylang and LearnDash compatibility, cleaner invoice layout.

1.1.0

• Renamed to GoFactoX E-Invoicing for WooCommerce, library updates and coding standards improvements.

1.0.0

• First release: Factur-X, CII and UBL invoices from WooCommerce orders, French legal mentions, B2B checkout fields, sequential numbering.

Full details of these versions: changelog.txt in the plugin folder.