{"id":384121,"date":"2026-10-17T05:41:47","date_gmt":"2026-10-17T05:41:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/efacture-fr-for-woocommerce\/"},"modified":"2026-10-17T05:49:01","modified_gmt":"2026-10-17T05:49:01","slug":"factella","status":"publish","type":"plugin","link":"https:\/\/tzm.wordpress.org\/plugins\/factella\/","author":23583454,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.3.0","stable_tag":"0.3.0","tested":"7.1.3","requires":"6.4","requires_php":"8.1","requires_plugins":null,"header_name":"Factella \u2013 French E-Invoicing for WooCommerce","header_author":"Barbaros B\u00fcber","header_description":"Prepares WooCommerce stores for the French e-invoicing mandate: Factur-X invoices and credit notes (PDF\/A-3 with embedded EN 16931 XML), B2B identifiers at checkout, and gap-free invoice numbering.","assets_banners_color":"4d70be","last_updated":"2026-10-17 05:49:01","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":82,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.3.0":{"tag":"0.3.0","author":"roborock61","date":"2026-10-17 05:49:01","revision":3751445}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3751430,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3751430,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3751430,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3751430,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.3.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3751430,"resolution":"1","location":"assets","locale":"","width":1100,"height":868},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3751430,"resolution":"2","location":"assets","locale":"","width":1569,"height":656},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3751430,"resolution":"3","location":"assets","locale":"","width":595,"height":842}},"screenshots":{"1":"Seller settings and the readiness check under WooCommerce &gt; Settings &gt; Factella, including the SUPER PDP connection.","2":"The invoice box on the order screen: Factur-X download and the SUPER PDP transmission status (sent, delivered, accepted).","3":"A generated Factur-X invoice (PDF\/A-3 with embedded EN 16931 XML)."}},"plugin_section":[],"plugin_tags":[225611,226218,9085,12480,286],"plugin_category":[45],"plugin_contributors":[287183],"plugin_business_model":[],"class_list":["post-384121","plugin","type-plugin","status-publish","hentry","plugin_tags-e-invoicing","plugin_tags-factur-x","plugin_tags-france","plugin_tags-invoice","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-roborock61","plugin_committers-roborock61"],"banners":{"banner":"https:\/\/ps.w.org\/factella\/assets\/banner-772x250.png?rev=3751430","banner_2x":"https:\/\/ps.w.org\/factella\/assets\/banner-1544x500.png?rev=3751430","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/factella\/assets\/icon-128x128.png?rev=3751430","icon_2x":"https:\/\/ps.w.org\/factella\/assets\/icon-256x256.png?rev=3751430","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/factella\/assets\/screenshot-1.png?rev=3751430","caption":"Seller settings and the readiness check under WooCommerce &gt; Settings &gt; Factella, including the SUPER PDP connection."},{"src":"https:\/\/ps.w.org\/factella\/assets\/screenshot-2.png?rev=3751430","caption":"The invoice box on the order screen: Factur-X download and the SUPER PDP transmission status (sent, delivered, accepted)."},{"src":"https:\/\/ps.w.org\/factella\/assets\/screenshot-3.png?rev=3751430","caption":"A generated Factur-X invoice (PDF\/A-3 with embedded EN 16931 XML)."}],"raw_content":"<!--section=description-->\n<p>From 1 September 2026 every French VAT-registered business must be able to receive electronic invoices, and from 1 September 2027 small and medium businesses must issue B2B invoices electronically and report B2C sales to the tax administration.<\/p>\n\n<p>Factella prepares small WooCommerce shops for that mandate.<\/p>\n\n<ul>\n<li>Adds optional SIRET and VAT number fields at checkout (block and classic checkout).<\/li>\n<li>Validates SIREN, SIRET and French VAT numbers.<\/li>\n<li>Numbers invoices and credit notes in one gap-free chronological sequence (PPF-compatible, max 20 characters).<\/li>\n<li>Creates an invoice when an order is paid or completed, and a credit note for every refund.<\/li>\n<li>Generates a <strong>Factur-X<\/strong> file for each invoice and credit note: a PDF\/A-3 with embedded EN 16931 CII XML, including the French mandatory mentions and the 2026 national rules (BR-FR). Validated against the official FNFE-MPE validator.<\/li>\n<li>Uses the exact WooCommerce VAT rate per line, and handles standard VAT, mixed rates, reduced rates, shipping and fees.<\/li>\n<li>Covers the French exemption cases: <em>franchise en base<\/em> (VATEX-FR-FRANCHISE), intra-EU reverse charge (category K \/ VATEX-EU-IC) and export outside the EU (category G \/ VATEX-EU-G).<\/li>\n<li>Branded, French, human-readable PDF with your logo and accent colour.<\/li>\n<li>Attaches the PDF to the customer's order emails and offers a download from the customer account.<\/li>\n<li>Bulk generation and ZIP export for past orders, plus a <code>wp factella generate<\/code> WP-CLI command.<\/li>\n<li>Exposes the invoice data (read-only) on the WooCommerce orders REST API.<\/li>\n<li>Readiness check and a period report (B2B, B2C by VAT rate, refunds) with CSV export.<\/li>\n<li>Optional transmission of B2B \/ B2BInt invoices and credit notes to the <strong>SUPER PDP<\/strong> platform with your own SUPER PDP account (manual button or automatic, with status tracking). B2C sales are never transmitted \u2014 they belong to e-reporting.<\/li>\n<li>Looks up the company name from a SIRET at checkout against the French public business register.<\/li>\n<\/ul>\n\n<p>Factella is an independent project and is not affiliated with or endorsed by WooCommerce, Automattic or the French tax administration (DGFiP).<\/p>\n\n<h3>External services<\/h3>\n\n<p>These connections are optional. No data is transmitted until you enter your own credentials and either click a send button or enable automatic sending.<\/p>\n\n<p><strong>SUPER PDP (approved e-invoicing platform).<\/strong> When you connect your own SUPER PDP account and send an invoice (manually or automatically), Factella authenticates with SUPER PDP using OAuth2 (client_credentials) and transmits the document.\n* Data transmitted: your SUPER PDP client ID and client secret (for authentication), and, for each sent document, the Factur-X PDF and its invoice data (seller and buyer legal name, address, SIREN\/SIRET, VAT number, line items and amounts), the invoice number (as the external reference), and status\/payment events.\n* When: only when you click \"Test connection\", \"Send to SUPER PDP\", or have enabled automatic sending; and periodically to read back the lifecycle status of documents already sent.\n* Endpoints: https:\/\/api.superpdp.tech\/oauth2\/token and https:\/\/api.superpdp.tech\/v1.beta\/\n* Terms of use: https:\/\/www.superpdp.tech\/ \u2014 Documentation: https:\/\/www.superpdp.tech\/documentation<\/p>\n\n<p><strong>Annuaire des Entreprises (recherche-entreprises.api.gouv.fr).<\/strong> At checkout, when a SIRET is entered, Factella asks this free public French government service for the matching company's legal name to help fill the company field.\n* Data transmitted: the SIREN (the first 9 digits of the SIRET). No customer personal data is sent.\n* When: only while a SIRET is being entered on the checkout; results are cached for one day and the request is rate-limited.\n* Endpoint: https:\/\/recherche-entreprises.api.gouv.fr\/search\n* Terms: https:\/\/api.gouv.fr\/les-api\/api-recherche-entreprises \u2014 the data is the open public business register (data.gouv.fr).<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>Factella does not send any data to its developer or to any Factella-operated server. Invoice transmission goes from your site directly to <strong>your own<\/strong> SUPER PDP account; the buyer's invoice data (name, address, SIREN, amounts) is shared only with SUPER PDP, under your account and your agreement with them. The company-name lookup sends only a SIREN (public identifier) to a French government open-data service. All platform credentials are stored encrypted in your own database.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin to <code>\/wp-content\/plugins\/<\/code> and activate it.<\/li>\n<li>Go to WooCommerce &gt; Settings &gt; Factella and fill in your legal name, SIREN, VAT number, VAT regime and bank details.<\/li>\n<li>Place a test order and set it to the configured status; the invoice and its Factur-X PDF are created automatically.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20send%20my%20invoices%20to%20the%20tax%20platform%3F\"><h3>Does this send my invoices to the tax platform?<\/h3><\/dt>\n<dd><p>No. Factella generates compliant Factur-X files and lets you download and email them. Transmission to an approved platform is not included.<\/p><\/dd>\n<dt id=\"which%20invoice%20format%20is%20produced%3F\"><h3>Which invoice format is produced?<\/h3><\/dt>\n<dd><p>Factur-X (EN 16931 \/ \"EN16931 Comfort\" profile): a PDF\/A-3 with the structured CII XML embedded, which is the format required by the French reform.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.3.0<\/h4>\n\n<ul>\n<li>New: transmit B2B \/ B2BInt invoices and credit notes to the SUPER PDP platform with your own account (OAuth2 client_credentials). Manual \"Send\" button and opt-in automatic sending, queued with Action Scheduler and retried with backoff on transient failures.<\/li>\n<li>New: transmission status on the order screen and list (sent \/ accepted \/ rejected), polled periodically; clear French error messages (invalid credentials, company not verified, invalid invoice, rate limit, platform unavailable).<\/li>\n<li>New: SUPER PDP connection settings (sandbox \/ production, encrypted secret, \"Test connection\"), plus connection\/verification\/sandbox lines in the readiness check.<\/li>\n<li>New: company-name auto-fill from a SIRET at checkout via the French public business register (cached, rate-limited, non-blocking).<\/li>\n<li>B2C sales are never transmitted (they belong to e-reporting) and are shown as such on the order.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Correctness: per-line VAT rate read from WooCommerce (not derived); fees added as invoice\/credit-note lines; total reconciled to the order total via the rounding amount (BT-114); unit price with 4 decimals.<\/li>\n<li>VAT categories: intra-EU reverse charge (K \/ VATEX-EU-IC) and export outside the EU (G \/ VATEX-EU-G), in addition to standard, zero and franchise en base.<\/li>\n<li>Pre-generation EN 16931 validation blocks an inconsistent invoice.<\/li>\n<li>New: readiness check on the settings tab, and a period report (B2B \/ B2C by VAT rate \/ refunds) with CSV export.<\/li>\n<li>Logo can be picked from the media library; WP-CLI command renamed to <code>wp factella generate<\/code>.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Business identifiers at checkout, gap-free numbering, invoice and credit note records.<\/li>\n<li>Factur-X (PDF\/A-3 + EN 16931 CII) generation, validated against the FNFE-MPE validator.<\/li>\n<li>Branded French PDF, email attachment, customer download, bulk generation, ZIP export and REST API field.<\/li>\n<\/ul>","raw_excerpt":"Prepare your WooCommerce store for French e-invoicing: Factur-X invoices and credit notes, business identifiers at checkout, gap-free numbering.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/384121","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=384121"}],"author":[{"embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/roborock61"}],"wp:attachment":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=384121"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=384121"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=384121"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=384121"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=384121"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=384121"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}