E-Invoicing for PrestaShop

How it Works

Automatic Conversion

The module automatically converts every invoice PDF into a fully compliant e-invoice – without manual rework and without changes to your workflows. No additional action is required: all invoice PDFs leaving the shop are ZUGFeRD-compliant e-invoices, whether downloaded manually, as a bulk export, or as an email attachment.

Scenario	Covered
Invoice download in the back office	✓
Invoice download in the customer account	✓
Invoice attachment in the order confirmation email	✓
Invoice attachment in status update emails	✓
Bulk PDF download in the back office	– *
Delivery notes and return documents	–

How is it converted?

The module integrates into the PrestaShop document creation process and uses the Codebarista E-Invoicing Service: the required data is collected in the module, transferred to the E-Invoicing Service, processed there in a privacy-compliant manner, and the finished ZUGFeRD PDF is then returned to your shop.

ZUGFeRD and XRechnung

The ZUGFeRD 2 format combines PDF and XML in a hybrid document. The invoice remains human-readable while machine-readable XML data is embedded simultaneously, which can be processed directly by accounting software. The embedded XML file conforms to the XRechnung standard and the European format EN 16931.

Administration

System Requirements

The module requires at least PHP version 7.2.5 and PrestaShop version 8.

License

The settings can be found in the PrestaShop back office under Modules > Module Manager, then click Configure for the module.

The module requires an active license to generate e-invoices. You can try it for free, without providing payment information.

On the configuration page, enter your shop domain (1), email address (2), and company name (3), then click Start Free Trial (4). Note that the license is tied to your shop domain. After submitting your details, you will receive a confirmation email within a few minutes. Click the link in it to activate the trial.

If you already have a license for this domain, you can activate it via Enter Existing License Key (5).

Configuration

The settings can be found in the PrestaShop back office under Modules > Module Manager, then click Configure for the module.

The module uses information from the order, shop settings, and module settings to create the e-invoice.

Shop / Seller Information

Enter your company details here.

The legal name (1) is the legal name of your company. It must match the name you provided when purchasing the license. The country code (2) must be entered as an ISO code, e.g. DE, AT, CH.

Payment Details

The payment information entered here is embedded into the e-invoice. Make sure it matches the payment information on your PDF invoices.

For bank transfers, IBAN and BIC (1.1, 1.2) are required. If you collect payments via SEPA direct debit, the SEPA Creditor ID (2) is also required. Also enter your payment terms (3), e.g. Payable within 30 days.

Create E-Invoice

The e-invoice module integrates seamlessly into the order detail page.

To create an e-invoice, click the download link (2) for an existing invoice in the documents table (1). The module generates the ZUGFeRD PDF in the background.

A dialog shows the progress; once complete, the download starts automatically. If the dialog does not appear, go to the settings and check whether an active license is present.

Every generated e-invoice is automatically checked for compliance with the XRechnung standard using the KoSIT Validator.

The validation result is displayed in the dialog immediately after the download and stored in the E-Invoice card.

If the generated e-invoice is not valid, the found issues are listed (1). Review the result and adjust the configuration if necessary.

The E-Invoice card on the order detail page shows the status of the last e-invoice created for this order. Clicking the validation result (1) opens the report.

Special Tax Rules

You can also map intra-community supply and reverse charge with the e-invoice module. To do this, you need to configure the tax rules in your shop accordingly and select which of the two tax liability reversal procedures should be used.

Configure Shop

To apply a 0% tax rate to orders from other EU countries, you need to configure the tax rules in PrestaShop accordingly. It is recommended to import the tax rules for the respective country via International > Localization: select the country from the list and click Import.

Then open International > Taxes > Tax Rules and adjust the rules for each relevant tax rate to a 0% tax rate.

Tax Exemption Treatment

For line items with a 0% tax rate to be processed correctly, you need to select how this tax rate should be handled.

Select a treatment (1) from the list: Choose intra-community supply (Category K) or reverse charge (Category AE) as appropriate. For both options, the corresponding tax exemption reason is used automatically. No treatment means that line items with a 0% tax rate receive category Z for zero rated goods.

FAQ

What invoice formats does the module generate?

The module generates e-invoices in the ZUGFeRD 2 format with the XRechnung profile. This is a hybrid PDF format: the invoice remains human-readable but also contains an embedded XML file that conforms to the German XRechnung standard and the European standard EN 16931.

Does the e-invoice replace my existing PDF invoice?

No. The module extends the PDF document created by PrestaShop by embedding XRechnung XML in it.

Do I need to adjust my existing processes?

No. The module integrates into the existing PrestaShop process. You continue to create invoices as usual – as soon as you download an invoice, the module automatically generates the corresponding e-invoice.

Can I also create e-invoices retroactively for older orders?

Yes. Once the module is installed and an active license is in place, an e-invoice is generated for every invoice as soon as you click its download link – regardless of when the order was placed.

How can I test the module?

You can test the module for free without providing payment information. To do so, enter your shop domain, email address, and company name in the License section of the configuration page and click Start Free Trial. You will receive a confirmation email with an activation link within a few minutes.

What data is transferred to the Codebarista E-Invoicing Service?

To create the e-invoice, the order data relevant to the invoice (e.g. invoice recipient, line items, amounts, taxes) as well as the configured shop and payment information are transferred to the Codebarista E-Invoicing Service. You can find details in our privacy policy.

What happens if validation fails?

After creation, every e-invoice is automatically checked using the KoSIT Validator. If validation fails, the found issues are displayed in the dialog. In most cases this can be resolved by adjusting the module settings – after which the e-invoice can be regenerated.

Are intra-community supply and reverse charge supported?

Yes. The module supports both intra-community supply (tax exemption category K) and reverse charge (category AE). To use this, you first need to configure your tax rules in PrestaShop accordingly (see Configure Shop) and then specify in the Tax Exemption Treatment section which of the two tax liability reversal procedures should be applied to line items with a 0% tax rate. An overview of both concepts can be found in the Special Tax Rules chapter.

Roadmap

Change Requests

Does the functionality not cover your use case? Do you have comments or questions? Write to us! We are happy to develop the module further with you.

Version History

Version	Date	Changes
1.0.0		Initial version for PrestaShop