JTL-Shop 5 · XRechnung · EN 16931 · Peppol

XRechnung for JTL-Shop: validate and send e-invoices, and check supplier invoices

A free plugin for JTL-Shop 5. JTL-Wawi can already export XRechnung and ZUGFeRD; the plugin adds what is missing: a validation of every invoice, Peppol sending and a check of received invoices. Same page in Deutsch.

Download the plugin (zip)

MIT licence, version 0.1.0 (first release) · Source on GitHub · works without an account (20 invoices a day)

Short answer: Since 1 January 2025 every business in Germany must be able to receive e-invoices; from 1 January 2027 businesses with more than €800,000 turnover in the previous year must issue domestic B2B invoices as e-invoices, and from 2028 all businesses. JTL-Wawi ships the XRechnung export template. The plugin also builds the file from the JTL-Shop order, checks it against the official rules and shows what to fix before an invoice reaches the customer.

What JTL already does and what the plugin adds

  • JTL-Wawi (native): XRechnung 3.0.x and ZUGFeRD from the invoice templates, with Wawi's own validate function.
  • Validation on every invoice: XML Schema, CEN EN 16931 Schematron and KoSIT XRechnung rules, with a fix hint per rule, in the plugin overview.
  • Peppol sending: a sandbox to test (nothing is delivered) and live sending once your account is set up. Before every send: VAT ID in VIES, Peppol reachability, sanctions lists.
  • Check supplier invoices: upload the XML and get a verdict (ok, review, hold): rules, VIES with name match, sanctions, totals, IBAN, duplicates, bank-detail changes.
  • From JTL-Shop orders: automatically on shipping or payment (Wawi pushes the status), optionally business customers only, or with one click by order number.
  • Everyday shop cases: 19% and 7%, shipping, discounts, paid orders, bank transfer with IBAN, reverse charge with a VAT ID, exports, the German small business scheme (section 19 UStG), Leitweg-ID.

Up and running in five minutes

  1. Download the zip, then in the JTL-Shop admin go to Plugins, Plugin-Manager, Available, upload the zip and activate it.
  2. Plugin settings: enter your company details, including contact name, phone and email (XRechnung requires them).
  3. Optionally paste a free API key.
  4. In the "E-Invoices" tab create one by order number: the result, errors and XML download appear in the list.

Status

First release (0.1.0). The order mapping and API logic are covered by unit tests, and the requests match those of our WooCommerce plugin. The plugin has not yet been run in a live JTL-Shop; we welcome feedback.

What it does not do

  • No attachment to JTL-Shop emails yet, no ZUGFeRD PDFs and no credit notes.
  • Not tax or legal advice: a technically valid file does not replace checking the content of your invoices.

Which data leaves your shop

To create an invoice the plugin sends the order's invoice data to the W System API (api.wsystem.dev): your seller details, the customer's name, company, address, email and VAT ID, the lines, amounts and payment method. The invoice is transmitted only if you turn Peppol on. See the privacy policy and DPA.

Price

The plugin is free (MIT). The API: 20 invoices a day without a key; a free key with 500 units a month (8 units per invoice, 5 per supplier check); Starter €19 for 5,000 units, Pro €49 for 25,000 units. Pricing

Questions

Does JTL-Wawi not already create XRechnung?

It does: JTL-Wawi 1.9.x exports XRechnung 3.0.x and ZUGFeRD from its own invoice templates. This plugin does not replace that. It adds a validation result for every invoice with a fix hint per failed rule, optional Peppol sending, and a check of invoices you receive from suppliers.

Do I need an account or API key?

No. Without a key the W System API free tier allows 20 calls per day per server IP address. A free API key (email only, no card) has 500 units a month; one e-invoice costs 8 units, so about 60 invoices a month.

Which JTL versions does it support?

JTL-Shop 5.2 or newer with PHP 8.1. JTL-Wawi pushes order status changes to the shop, and the plugin reacts to them, so Wawi-driven shipping works without extra setup.

What does the supplier invoice check do?

In the plugin you upload or paste a received XML invoice. W System checks the EN 16931 and XRechnung rules, the supplier VAT ID and name in VIES, sanctions lists, totals, dates, IBAN, duplicates, bank-detail changes and unusual amounts, and returns ok, review or hold. It costs 5 units.

Does it create ZUGFeRD PDFs?

Not in version 0.1. It creates XRechnung, EN 16931 and Peppol BIS 3 files in UBL XML. JTL-Wawi can already produce ZUGFeRD PDFs on its own.

Is it tested in a real JTL-Shop?

This first release has unit tests for the order mapping and API handling, and its requests have the same shape as our WooCommerce plugin. It has not yet been run in a live JTL-Shop. If you try it, please tell us what you find.

Related

Not affiliated with JTL-Software or KoSIT. Technical check, not legal or tax advice.