SuperPDP

This plugin automatically sends UBL invoices to SUPER PDP, a French PA (Plateforme Agréée) for electronic invoicing, when HikaShop orders reach configured statuses. It relies on the PDF Invoice plugin to generate the UBL XML, then submits it to SUPER PDP via their REST API using OAuth2 authentication.

• Automatically sends UBL invoices to SUPER PDP when orders reach configured statuses (e.g. "confirmed", "shipped").
• Uses the PDF Invoice plugin's onHikashopGenerateStructuredInvoice event to generate PEPPOL BIS 3 UBL XML.
• OAuth2 client credentials authentication with automatic token caching.
• Passes PA-specific metadata (cadre de facturation) to the UBL generator for French e-invoicing compliance.
• Looks your professional customers up in the French annuaire, from the SIREN their VAT number contains, and addresses the invoice where they registered to receive it.
• Names your shop by the address SUPER PDP registered for it, which is what makes the invoice a French one rather than an international one.
• Falls back to the PEPPOL network when the French flow has nowhere to deliver the invoice, so an order is never left without one.
• Reports the payment of the invoice with the "Encaissée" life cycle message (fr:212), which is what the e-reporting of a service sale is built from.
• Duplicate prevention: orders already submitted to SUPER PDP are skipped.
• SUPER PDP invoice ID and latest status displayed in the backend order details page.
• Supports sandbox and production environments.
• Full error logging with request and response details for troubleshooting.
• Debug mode for logging all API requests and responses.

• 1. An order reaches a configured status (e.g. "confirmed").
• 2. The plugin generates a UBL invoice via the PDF Invoice plugin.
• 3. The UBL XML is submitted to SUPER PDP via their API.
• 4. SUPER PDP validates the invoice and routes it to the buyer's platform.
• 5. The payment is reported on the invoice with the "Encaissée" life cycle message.
• 6. The SUPER PDP invoice ID is stored in the order for tracking.

• 1) Make sure the PDF Invoice plugin is installed and enabled, with UBL generation configured (seller company name, SIRET, VAT number, address).
• 2) Download the SuperPDP plugin from our website.
• 3) Install it on your Joomla website via the extension manager.
• 4) Enable the plugin in Extensions > Plugins.
• 5) Configure your SUPER PDP OAuth2 credentials (client ID and client secret). You can get them from your SUPER PDP account in the Settings > Applications menu.
• 6) In HikaShop, go to System > Order statuses and configure which statuses should trigger invoice submission in the "SuperPDP" column.

• OAuth2 Client ID: Your SUPER PDP client ID.
• OAuth2 Client Secret: Your SUPER PDP client secret.
• UBL standard: UBL standard passed to the PDF Invoice plugin's UBL generator (PEPPOL BIS 3.0 or UBL.BE).
• Report the payment: Sends the "Encaissée" message of the invoice life cycle right after the invoice, so that the payment is reported to the tax administration. Leave it on unless your invoices are sent to SUPER PDP before your customers have paid them.
• Debug mode: Logs all API requests and responses to the HikaShop log file for troubleshooting.

• If an invoice submission fails (API error, network issue, etc.), the error is logged in the HikaShop log file with the full request and response details. Enable debug mode for even more detailed logging.
• To retry a failed submission, change the order status to a non-exportable status (e.g. "created") and then back to an exportable status (e.g. "confirmed"). This will retrigger the invoice generation and submission.
• If an invoice was already successfully submitted, changing the status back and forth will not create a duplicate.
• Make sure the seller information (SIRET, VAT number, company name, address) configured in the PDF Invoice plugin matches the company linked to your SUPER PDP OAuth2 credentials.
• Fill the three legal mentions (late payment penalties, recovery costs, early payment discount) in the PDF Invoice plugin. French law requires them on every invoice, and an invoice to a French company is sent over the PEPPOL network rather than through the French flow while they are missing.
• An invoice to a French company can only go through the French flow if that company is registered in the annuaire and its entry accepts the invoices of the reform. When it is not, the invoice is sent over the PEPPOL network instead, and its payment is not reported. The log says which of the two was used.
• The e-reporting of a sale to a private customer depends on the VAT regime of your company, which is set in your SUPER PDP account. SUPER PDP refuses the invoice while it is empty.

• This plugin is compatible with all the editions of HikaShop
• Requires the PDF Invoice plugin being installed, published and configured.
• Requires the PHP cURL extension
• Compatible with PHP 7.4 minimum
• Compatible with Joomla and WordPress
• A SUPER PDP account with API access is required
• No limit of time
• No limit of use

1.1.0 on the 21st of August 2026

• The payment of an invoice is now reported to SUPER PDP, with the "Encaissée" message of the invoice life cycle, sent right after the invoice itself. The tax administration builds the payment part of the e-reporting from that message, which is what a shop selling services owes, since the VAT on a service falls due on the day it is paid rather than on the day it is invoiced. Nothing has to be configured: the invoice only leaves for SUPER PDP once your order has reached one of the statuses you selected, and it already says it is paid in full, so the message follows it with the total of the invoice. A new "Report the payment" setting lets you turn this off, which is what you want if your invoices are sent to SUPER PDP before your customers have paid them. The date the payment was reported is displayed with the SUPER PDP information of the order in your backend.
• Invoices to a French customer are now sent through the French flow of the reform rather than over the PEPPOL network, which is what lets SUPER PDP extract their e-reporting and accept the message reporting their payment. An invoice to a private customer, who gave no VAT number, was refused until now. This needs version 4.1.3 of the PDF Invoice plugin, and the three legal mentions of its settings have to be filled, as French law requires them on every invoice.
• Invoices to a French company are now delivered on the French network rather than being treated as international ones. Two addresses were missing for that, and the plugin now finds both on its own, so there is no new field to fill in your shop. Your customer is looked up in the annuaire from the SIREN their VAT number contains, and the invoice is sent to the address that company published there. Your shop is named by the address SUPER PDP registered for it, which is read from your SUPER PDP account; it used to be named by its SIRET, which is what made the invoice look like an international one. A company which is not registered in the annuaire, or whose entry does not accept the invoices of the reform, is sent an invoice over the PEPPOL network instead, as are the customers of other countries, so an order is never left without an invoice.

1.0.0 on the 21st of March 2026

• Initial release of the plugin.