EU e-Invoicing: XRechnung, Factur-X/ZUGFeRD & Peppol-ready UBL

It depends on your buyer. German public sector buyers (Leitweg-ID) expect XRechnung, usually through their portal or Peppol. Businesses in Belgium and many other countries receive Peppol BIS 3.0 through their access point. In France and Germany, Factur-X / ZUGFeRD is widely accepted because it is a readable PDF and an e-invoice at the same time. The add-on gives you all four from the same document; your tax advisor can tell you what applies to you.

Factur-X (called ZUGFeRD 2 in Germany) is a PDF/A-3 file with the structured invoice data (factur-x.xml, EN 16931 profile) inside. Software reads the XML, people read the PDF. Our test suite checks the PDF part with veraPDF and the XML with the official rules.

Not on its own: sending needs an account with a Peppol access point, and providers differ by country and price. You can download the Peppol UBL file and upload it to your provider, or install a driver for your provider (see Developer notes) and send with one click or automatically.

The rules your store data can break: seller and buyer IDs and addresses, electronic addresses, VAT categories and their required IDs, payment details (IBAN for credit transfer), totals, and the extra rules of XRechnung (contact phone and e-mail, buyer reference) and Peppol (electronic addresses, Belgian enterprise number and GLN check digits). The file structure is generated to the specifications and tested with the official validators.

No. Consumers have no Peppol address, so a Peppol file cannot be sent to them. Use Factur-X or XRechnung for such orders; the Peppol card matters only for business buyers that receive through Peppol.

XRechnung and Peppol require a buyer reference. Public buyers in Germany must give their Leitweg-ID, which they enter in the Buyer reference / Leitweg-ID field at checkout. For other buyers the add-on uses the order number (setting Buyer reference when the buyer gave none).

Yes. e-Invoices use net amounts per line; the add-on removes the tax of each line (the stored tax, or by the rate), splits order discounts over the VAT rates, adds shipping and the payment surcharge with their own tax, and recalculates the VAT per rate. If CS-Cart rounded the order total differently, the difference is written as rounding so the amount due matches what the customer paid.

When a buyer with a VAT ID from another EU country orders without tax being charged, the lines get the category Intra-community supply (K, goods) or Reverse charge (AE, services; setting). With EU VAT Number Validation, its decision for the order is used. Sales without tax to buyers outside the EU are exports (G). The required exemption reasons and codes are added automatically.

Fix the data and use Rebuild from order on the document page; the number and date stay the same. Once your buyer has received the document, correct it with a credit note and a new invoice instead.

Yes, and they are made for each other: the e-invoice uses the same number and date as the PDF invoice, and every credit note there (full, partial, return, wallet refund) becomes an e-credit note with the credited lines. Without it, this add-on numbers its own e-invoices and creates full credit notes on cancellation.

Yes. Checked VAT IDs and the reverse-charge decision come from EU VAT Number Validation; measured quantities and units (kg, m, l ...) from Sell by Weight & Length.

Yes. The add-on adds nothing to cached pages; customer download links are on the account order page only.

No. The e-invoice is created when the order reaches the configured status, in a few milliseconds; files are generated only when someone downloads them or an e-mail attachment is due.

Without a valid license (no key after the 14-day start period, an invalid or revoked key, a domain the license does not cover, or no successful check for 14 days), no new e-invoices or e-credit notes are created, nothing is attached to e-mails and nothing is sent over Peppol; e-invoices created so far stay downloadable for you, your vendors and your customers. Once the license is valid again, everything works again.

Open Add-ons → Manage add-ons → EU e-Invoicing → Settings → License. The status line says what is wrong: no key, a key for another add-on, a revoked license, or a domain that the license does not cover. Fix it and click Check now. See License.

Yes. Subdomains of your licensed domain (for example staging.yourstore.com) and local development hosts (localhost, private IP addresses, .local, .test) are covered by the same license.

No. The check runs in the admin panel or from cron, once a day. The storefront never runs it.