Tropratik e-Facture
| 开发者 | tropratik |
|---|---|
| 更新时间 | 2026年9月29日 22:55 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Automatic generation of Factur-X / ZUGFeRD invoices (PDF/A-3 with embedded EN 16931 XML).
- Manual or automatic transmission to Chorus Pro for the public sector.
- Manual or automatic transmission to Super PDP for B2B and B2C flows.
- Automatic tracking of submission, acceptance, and rejection statuses.
- Configurable numbering: prefix, dynamic tags, periodic reset, and starting number.
- Customization of the logo, colors, font, and invoice template.
- Direct connection to PISTE or connection through a self-hosted VPS proxy.
- Encryption of PISTE, Chorus Pro, Super PDP, and proxy secrets in the database.
- Compatibility with WooCommerce HPOS and classic order storage.
- Read-only
tropratik_ef_invoicefield in the WooCommerce REST API.
- For Chorus Pro: a PISTE account, OAuth2 credentials, a Chorus Pro technical account, and a registered API connection.
- For Super PDP: a Super PDP account and an OAuth2 application associated with the company.
安装:
- Make sure WooCommerce is installed and active, and that the server runs PHP 8.1 or later.
- Install the plugin from the WordPress “Plugins” screen or upload its folder to
/wp-content/plugins/. - Activate the plugin from the “Plugins” menu.
- Open WooCommerce → Tropratik e-Facture to configure the issuer, numbering, and invoice appearance.
- Configure the Chorus Pro or Super PDP tab as needed, then use the test buttons before the first transmission.
屏幕截图:
常见问题:
Does the plugin send my invoices automatically?
Only if you enable automatic transmission for the relevant platform. Chorus Pro handles public-sector invoices; Super PDP handles B2B and B2C invoices. Manual transmission remains available from the orders list.
What invoice format is generated?
Invoices are generated in Factur-X PDF/A-3 format with XML compliant with the EN 16931 profile. The issuer remains responsible for tax rules and the information entered in WooCommerce.
My hosting provider is blocked by PISTE with a 403 error. What can I do?
The Chorus Pro tab provides a “Via VPS proxy” connection. Install the proxy on a server you control, enter its settings, and then use the test button. This test does not depend on the PISTE credentials or the technical account.
Can I customize the invoice layout?
Yes. The “Invoice appearance” tab lets you set the logo, colors, and font. You can also place a custom invoice.php template in wp-content/themes/your-theme/tropratik-e-facture/ to preserve the customization during updates.
Is the plugin compatible with HPOS?
Yes. The plugin is compatible with High-Performance Order Storage (HPOS) and classic order storage.
Can I retrieve invoices through the WooCommerce REST API?
Yes. The plugin adds a read-only tropratik_ef_invoice field to order responses. It includes the number, dates, customer type, Factur-X profile, PDF hash, and Chorus Pro and Super PDP statuses. It never exposes the file path on the server.
How are sensitive credentials and passwords stored?
PISTE, Chorus Pro, Super PDP, and proxy secrets are encrypted in the database with libsodium, or with AES-256-GCM through OpenSSL as a fallback. They are decrypted only during API calls.
The key is derived from the security salts in wp-config.php. If these salts are regenerated, the secrets must be entered again. To use an independent key during a migration or restoration, define the following in wp-config.php:
define( 'TROPRATIK_EF_ENCRYPTION_KEY', 'a-long-random-and-secret-string' );
Credentials stored in plain text by an earlier version are encrypted the next time the form is saved.
更新日志:
- New: OAuth2 connection to Super PDP in sandbox and production, with credential testing and secret encryption.
- New: manual or automatic transmission of B2B/B2C invoices to Super PDP, status tracking, and reporting of received payments.
- New: twice-daily synchronization of Chorus Pro and Super PDP statuses, with order updates.
- New: Super PDP statuses added to the WooCommerce REST API
tropratik_ef_invoicefield. - New: BAR/B2C marker added to consumer invoices and checked before submission.
- Fix: VAT categories and breakdowns now use the actual WooCommerce rates, including decimal reduced rates, the zero rate, shipping, and fees.
- Fix: the buyer type no longer forces an incorrect VAT exemption; EN 16931 inconsistencies now block generation.
- Fix: automatic transmission is attempted again when an invoice already exists, particularly for orders created in the admin area.
- Fix: the company name entered at checkout is explicitly saved, and the customer type is preserved during regeneration.
- New: configurable starting number for continuing an existing sequence. It applies only to the next invoice, after which automatic numbering resumes.
- New: server-side validation prevents a starting number lower than the current sequence maximum.
- New: live preview of the formatted invoice number in the settings.
- Fix: the logo width setting from 10 to 80 mm is correctly applied to the generated PDF.
- Change: default logo width reduced from 60 to 30 mm and centralized in a constant.
- Fix: BT-23 billing mode labels aligned with the DGFiP v3.2 specifications; codes absent from the specification removed.
- Fix: PHP parse error that prevented access to the appearance settings.
- Fix: compatibility declared with WordPress 7.1.
- New: configurable BT-23 billing mode based on the French reform process codes.
- New: mandatory French legal notices added to the Factur-X XML in accordance with BR-FR-05.
- New: handling of prepaid amounts, net amount due, and due date for already-paid modes.
- Fix: BT-30 and BT-47 use the 9-digit SIREN in accordance with BR-FR-10 and BR-FR-32.
- Fix: BT-32 tax identifier added for sellers under the French VAT exemption scheme.
- Fix: prohibited exemption amounts and reasons removed from line-level VAT breakdowns.
- New: PEPPOL
0225addressing for BT-34 and BT-49 with SIREN, SIREN+SIRET, suffix, or routing code formats. - New: seller BT-29 and buyer BT-46
GlobalIDidentifiers, buyer reference BT-10, date BT-72, and delivery address BG-15. - New: required SIRET and PEPPOL fields for B2B customers, with a preview of the calculated address.
- Fix: BT-2 uses the invoice generation date, and BT-95 uses
Efor a seller under the French VAT exemption scheme. - Fix: minimum WordPress version raised to 6.2.
- Fix: BT-34 and BT-49 electronic addresses now use a valid French EAS identifier.
- Fix: IBAN and BIC added for bank transfers in accordance with BR-61.
- Fix: VATEX codes added to BT-121 according to the exemption reason.
- Fix: WooCommerce payment methods mapped to the appropriate UNTDID 4461 codes.
- Fix: secured migration of the numbering table from versions 1.0.x.
- Fix: WooCommerce REST API HTTP 500 error caused by a method missing from the 1.1.1 package.
- Change: the formatted REST API number moves from
numbertoformatted_number;numbernow contains the integer position in the legal sequence. - New:
file_slug,file_name, andfacturx_profileadded to the REST API invoice field.
- New: read-only
tropratik_ef_invoicefield in the WooCommerce orders REST API. - New: customer type exposed with the values
individual,business, orpublic_sector. - Fix: issuer name position on the PDF when no logo is set.
- Initial release.
- Generation of Factur-X EN 16931 invoices.
- Manual or automatic transmission to Chorus Pro through PISTE.
- Configurable numbering and appearance, optional VPS proxy, and HPOS compatibility.