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 S2/S3) to the UBL generator for French e-invoicing compliance.
• 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 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).
• 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.

• 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.0.0 on the 21st of March 2026

• Initial release of the plugin.