GoFactoX E-Invoicing for WooCommerce

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): transmission to your Plateforme Agréée through SUPER PDP. Enter the client ID and secret of your own SUPER PDP application; every invoice and credit note is then pushed automatically (or manually from the order screen). B2B invoices are routed to the customer’s platform and reported to the DGFiP, B2C invoices feed e-reporting automatically, and the “paid” lifecycle status is sent for paid orders. Transmission scope (B2B only or all documents), sandbox/production environment (in the sandbox a copy of the document issued by the SUPER PDP test company is sent, the archived document is untouched), deferred “paid” status until the PA has processed the invoice, no duplicate upload of a document the PA already holds, “Test connection” and “Validate last document” tools, status badge on the order and in the dashboard, automatic retries with backoff, hourly retry and 15-minute status polling, new webhook topic gofactox.document.pa_status_changed and pa_* fields in the REST API.
• Fix (compliance): the seller SIRET is now written with the ISO 6523 scheme 0009 (0002 designates a SIREN); the seller SIREN (BT-30) is always written, no longer only when an RCS city is set; the buyer SIREN captured at checkout is now written as legal registration identifier (BT-47), the buyer SIRET as BT-46 with scheme 0009. These identifiers are mandatory for domestic B2B invoices and were rejected by Plateformes Agréées.
• Fix (compliance): electronic addresses. French sellers and B2B buyers are now addressed with scheme 0225 (e-invoicing address = SIREN, or a suffixed address set in the new “E-invoicing address” setting), which makes the invoice routable through the PA network. B2C buyers keep the email (EM) address and carry the BAR/B2C note.
• Fix (compliance): the “cadre de facturation” (BT-23) now uses the DGFiP codes B1/S1/M1 (goods/services/mixed) derived from the operation category, with an option for “invoice already paid” (B2/S2/M2, which also fills the prepaid amount). The Chorus Pro A-codes remain available for B2G deposits. A1 was rejected by the French schematron for B2B invoices.
• Fix (compliance): the three coded legal mentions required by rule BR-FR-05 are now carried as notes in the XML: late payment penalties (PMD), fixed recovery indemnity (PMT) and early payment discount (AAB).
• Change: the default Factur-X profile is now EN 16931. The Basic profile is not accepted by the French reform (“no validator for this format”) and is kept as an explicit legacy choice.
• Improved (Business): FEC export now splits VAT collected per rate (one 445710 line per rate), assigns a continuous and stable EcritureNum to each document (re-exports keep the same numbers), and uses one auxiliary account per customer (SIREN, else customer id). The VAT breakdown and buyer identity are persisted at generation time.
• Improved: SIREN, SIRET and VAT numbers typed at checkout are normalized (spaces removed, length checked), the SIREN is derived from the SIRET when missing, and cleared fields no longer keep a stale value. The buyer SIREN is printed on the PDF.
• Removed: the Chorus Pro B2B scaffold (never functional). Its options are cleaned up on update.
• Compatibility: tested up to WordPress 7.1 and WooCommerce 11.1 (HPOS).
• Dev: PHPUnit test suite (unit tests with WordPress stubs, live schematron validation against the public SUPER PDP validator, optional sandbox end-to-end test), Composer scripts composer test and composer test:live.

1.4.2

• New: operation category (catégorie de l’opération: supply of goods, supply of services, or mixed), one of the new mandatory mentions of the French e-invoicing reform. It is auto-detected from the order (virtual or downloadable products count as services, shippable products as goods, a mix is reported as “mixte”) or can be set manually in the settings. The mention appears on the invoice and credit note PDF and is carried in the Factur-X XML.
• New: “cadre de facturation” (Chorus Pro invoicing framework, EN 16931 BT-23). Every invoice now carries the safe default A1 (standard supplier invoice); A2, A9 and A12 are also selectable, and emission can be turned off. This value is required when depositing an invoice to a public administration (B2G) through Chorus Pro, and is harmless for ordinary B2B/B2C sales.
• New: delivery address (EN 16931 BG-15) on the invoice and credit note PDF and in the Factur-X XML, shown only when the shipping address differs from the billing address. Another new mandatory mention of the French e-invoicing reform.
• New: optional “VAT paid on debits” legal mention (option pour le paiement de la TVA d’après les débits), toggled in the settings for sellers who have opted to pay VAT on debits. Shown on the PDF and carried in the XML.

1.4.1

• Tested up to WordPress 7.0 (released May 20, 2026).
• Compliance: passes WordPress Plugin Check with zero errors. Hardened output escaping, input sanitization, and inline script injection patterns.
• Fix: the “Late Payment Interest Rate” placeholder was hardcoded in French; it now respects the active site locale (translatable string).
• Fix: in the Factur-X dashboard table, clicking the PDF action on a credit note row used to open the underlying invoice instead. The link now routes correctly to the credit note PDF.
• Improved: credit notes in the dashboard table now show a small “AVOIR” badge next to the number for quick visual distinction.
• Fix: several French translations were missing or incorrect (Net 60 days, 45 days end of month, Net 15 days). All payment terms strings are now fully translated.
• Improved: end-of-month payment terms (30/45 days EOM) now follow the French majority calculation method (end of current month + N days, instead of date + N days then end of month) and carry the legally precise “à compter de la date d’émission de la facture” wording on the PDF, in line with Code de commerce L441-10.

1.4.0

• Plan alignment: credit notes (Factur-X type 381) on refunds, SEPA QR code, structured SEPA Credit Transfer mapping in the XML (BG-17), AVOIR watermark, end-of-month payment terms, and REST API are now part of the Pro plan. FEC export and PA (ex PDP) transmission remain on Business. Manual Factur-X invoice generation (Basic and Comfort profiles), the full set of French legal mentions, B2B checkout fields, payment terms (immediate to net 60), IBAN/BIC display on the PDF, GDPR exporter, WC Subscriptions compatibility, and all developer hooks remain free.
• New: B2B checkout fields (SIREN, SIRET, VAT, PO number) now also work with the modern Checkout Blocks (React-based checkout). Until 1.4.0 they only appeared on the classic checkout.
• New: seller electronic address field (EN 16931 BT-34) and buyer electronic address (BT-49) in the XML. Required by several Plateformes Agréées (PA, ex PDP) such as Chorus Pro, SuperPDP, Pennylane to send back receipt acknowledgments and rejection notices.
• New: company logo upload via the WordPress media library. The logo is rendered at the top of every invoice and credit note PDF.
• New: SEPA EPC QR code on invoices. Customers scan the QR with their banking app and the wire transfer is pre-filled (IBAN, amount, invoice number reference). Toggleable.
• New: configurable payment terms (immediate, net 15/30/45/60, end-of-month 30/45, custom). Due date is computed and propagated to PDF + Factur-X XML.
• New: IBAN/BIC/Bank Name fields in settings. Wire transfer block on the invoice PDF + structured SEPA payment means in the XML (UNTDID code 58, EN 16931 BG-17).
• New: optional “Purchase Order Number” (PO ref) field at B2B checkout. Stored on the order, rendered on the PDF, and exposed in the XML (BT-10).
• New: WooCommerce coupons applied on an order are now exported as structured document-level allowances (EN 16931 BG-20) in the XML. The PDF shows the discount lines + net before VAT.
• New: Factur-X “Comfort / EN 16931” output format option, in addition to the existing Basic profile.
• New: FEC export (Fichier des Écritures Comptables, article A47 A-1 LPF) downloadable from the Factur-X dashboard with a date-range selector. Each invoice and credit note produces an accounting entry split across customer (411), sales (707), and VAT collected (44571) accounts.
• New: REST API at /wp-json/gofactox/v1/ (invoices, credit-notes, PDF download) and WooCommerce webhook topics (gofactox.invoice.created, gofactox.credit_note.created, and their regenerated variants).
• New: “Download my Factur-X invoice” button on the WooCommerce order-received (Thank You) page.
• New: WooCommerce Subscriptions compatibility. Subscription orders carry the billing period (EN 16931 BT-73/BT-74) on the invoice PDF and XML.
• New: GDPR / RGPD personal data exporter and eraser. Customer invoices and credit notes are included in WordPress’s standard personal data export, with a note that documents are legally retained for 10 years (Code de commerce L123-22).
• New: extensibility filters for third-party developers: gofactox_invoice_data, gofactox_credit_note_data, gofactox_xml_output, gofactox_pdf_template_path, gofactox_pdf_filename.
• Improved: invoice and credit note PDFs now display the buyer’s PO number when provided.