Pennylane

This plugin sends the invoices and credit notes of your shop to Pennylane, the French accounting software, as Factur-X files. Your sales land in your books on their own, and the plugin takes care of the French e-invoicing reform: Pennylane is an approved platform (PA), so the invoices of your French business customers go out over the e-invoicing network, and the sales to private customers and abroad are in Pennylane for its e-reporting.

• Sends each invoice to Pennylane as soon as the order reaches one of the statuses you choose (for instance "confirmed" and "shipped").
• The invoice sent is the Factur-X PDF of the PDF Invoice plugin: the same document, number and amounts as the invoice your customer gets, with the EN 16931 data the reform requires inside it.
• Creates your customer in Pennylane on their first order, as a company (with its SIREN and VAT number) or as an individual, and uses it again for their next orders.
• Hands the invoices of your French business customers to the e-invoicing network, through Pennylane. The others stay in Pennylane, which reports them in the e-reporting.
• Lets Pennylane match the payment to the invoice on its own: an order paid with Stripe carries its Stripe payment, an order paid by bank transfer the order number your customer puts in the transfer's label. The orders paid otherwise, with PayPal for instance, which Pennylane cannot match, are marked as paid.
• Reads the SIREN of your business customers from their VAT number, or from the SIREN field of the PDF Invoice plugin for those without a VAT number, and adds it to a customer already in Pennylane who did not have it.
• Sends the credit note when an order is refunded, linked to its invoice in Pennylane, and over the network when the invoice went that way.
• Can put the sales of your products on the revenue account of your choice (707 for goods, 706 for services...).
• Never sends an order twice: what was sent is kept on the order, and an invoice sent before an interruption is found again in Pennylane rather than sent a second time.
• What could not be sent (Pennylane unreachable, for instance) is tried again by the HikaShop cron, and a "Send to Pennylane" button on the order page lets you send or retry it at once.
• Can send the orders invoiced since a date of your choice, for a shop that starts with Pennylane in the middle of the year.
• The order page of your backend shows the Pennylane invoice, its e-invoicing status, its credit note and the last error, if any.

• 1. An order reaches a Pennylane status and gets its invoice number.
• 2. The plugin finds or creates the customer in Pennylane.
• 3. The PDF Invoice plugin draws the Factur-X invoice, and the plugin imports it into Pennylane.
• 4. For a French business customer, Pennylane sends it over the e-invoicing network.
• 5. The invoice is marked as paid, and a refund later sends its credit note.

• 1) Install the PDF Invoice plugin, version 5.2.1 or later, turn Factur-X on in its settings, and fill your company's details in it: company name, SIREN, VAT number, address and the three legal mentions French law requires on every invoice. If some of your business customers have no VAT number, add a SIREN field to the addresses and choose it in its "SIREN field of the customer" setting.
• 2) In Pennylane, open Settings, Connectivity, Developers, and generate an API token with read and write access to Customer invoices and Customers. Pennylane offers it from its Essentiel plan, to the company's administrator or director: if the Developers page is missing, your plan has no API (the Collaboratif plan an accountant offers has none).
• 3) Install this plugin, enable it in Extensions > Plugins, and paste the token in its settings.
• 4) In HikaShop, go to System > Order statuses and tick, in the "Pennylane" column, the statuses that send the invoice.
• 5) Set up the HikaShop cron, so that what could not be sent is tried again.

• Pennylane API token: the token of step 2. To try the plugin first, make the token in your Pennylane sandbox (your profile, Test environment): it then sends to the sandbox.
• Send to the e-invoicing network: have Pennylane send the invoices of your French business customers over the network. Leave it on: the reform requires it.
• Mark the invoices as paid: marks the invoice as paid in Pennylane when the order is paid and Pennylane cannot match the payment itself (PayPal, cheque...). The payment methods listed in the PDF Invoice plugin's "Payment methods paid after the invoice" setting are left unpaid. Stripe and bank transfer orders are never marked: Pennylane matches them with the money it receives.
• Revenue account of the products: the number of the ledger account your product sales go to, for instance 707. Empty, Pennylane chooses.
• Send the orders invoiced since: also sends the orders invoiced since this date that are not in Pennylane yet, twenty at each run of the cron.
• Debug mode: writes every call to Pennylane to the HikaShop log file.

• The last error of an order is shown on its page in the backend, and written to the HikaShop log file. Your API token is never written to the log.
• "The PDF Invoice plugin did not give the Factur-X file": install or update the PDF Invoice plugin (5.2.1 or later) and turn Factur-X on in its settings.
• An invoice to a foreign company, or to a private customer, is "not for the network": it is in Pennylane, and in its e-reporting, as the reform wants.
• Imported invoices wait in Pennylane's inbox for your accountant to check them, as any invoice imported into Pennylane does.

• Compatible with all the editions of HikaShop
• Requires the PDF Invoice plugin 5.2.1 or later, installed, published, with Factur-X on
• The matching of Stripe and bank transfer payments needs HikaShop 6.7.0 (and Stripe Checkout 1.5.7)
• Requires the PHP cURL extension
• Compatible with Joomla (not tested on WordPress yet)
• Requires a Pennylane subscription that includes the API: Essentiel or above. The Collaboratif plan an accountant offers, Starter and Basique have no API access, and the token cannot be made there
• No limit of time
• No limit of use

1.0.0 on the 3rd of October 2026

• First version.