Docs/Integrationen/PrestaShop
PrestaShop

PrestaShop Integration

Live für PrestaShop 8+

E-Rechnungen direkt aus PrestaShop — XRechnung, ZUGFeRD und PDF heute live, sieben weitere Formate ab Q3 2026. Kostenfreies MIT-Modul, kostenpflichtiger E-Rechnungs-Service.

Heute live

  • PDF (alle 11 Länderprofile)
  • XRechnung 3.0.2 für Deutschland — BIS 3.0 / EN 16931
  • ZUGFeRD 2.3/2.4 für DE/AT — Hybrid-PDF/A-3 mit eingebetteter XML

Ab Q3 2026

  • Factur-X (FR)
  • FatturaPA (IT)
  • Facturae (ES)
  • ebInterface (AT)
  • UBL (BE/NL/BG/RO)
  • ISDOC (CZ)
  • NAV (HU)

Funktionen

Modul kostenfrei, Service kostenpflichtig

MIT-lizenziert, kostenfrei auf GitHub und addons.prestashop.com. Die Wertschöpfung liegt im invoice-api.xhub.io-Service-Abo — gleiches Modell wie bei Stripe, PayPal, Mollie.

Drei Formate live, sieben weitere ab 2026

PDF, XRechnung 3.0.2 und ZUGFeRD 2.3/2.4 sind heute verfügbar. Die übrigen länderspezifischen Formate erscheinen automatisch im Dropdown sobald die API sie unterstützt — kein Modul-Update nötig.

§14 UStG-konforme Rechnungsnummerierung

Lückenlose, race-safe Sequenznummern über eine eigene DB-Tabelle. Token-Format 2026-{seq:0000} für rechtskonformen Produktivbetrieb — auch unter hohem Multi-Shop-Last.

PrestaShop-Hook-System

actionOrderStatusUpdate und actionEmailSendBefore sind die primären Trigger. Sprachunabhängiges OrderState-Flag-Mapping — das Modul funktioniert in allen PrestaShop-Locales ohne Neukonfiguration.

Eigene Rechnungs-Templates

Layout in der Console gestalten, Template-UUID kopieren, in die Moduleinstellungen einfügen. Per-Order-Override für Sonderdesigns einzelner Großkunden wird zum Generierungszeitpunkt aufgelöst.

DSGVO-friendly Storage

Rechnungsdateien liegen lokal im Modul-Storage-Pfad. Beim Deinstallieren mit Datenlöschung werden beide Modultabellen (Sequenz + Meta) sauber gedroppt — keine verwaisten Kundendaten.

PrestaShop-Hook-Events

E-Rechnungs-Erzeugung direkt aus dem PrestaShop-Bestelllebenszyklus triggern. Das Modul registriert zwei primäre Hooks und reagiert auf Standard-OrderState-Flags — kein Custom-JavaScript, kein zusätzlicher Service.

actionOrderStatusUpdate

Feuert bei jedem Bestellstatus-Wechsel. Das Modul prüft die konfigurierten Trigger-States und erzeugt die Rechnung bei Übereinstimmung.

actionEmailSendBefore

Feuert vor dem Versand jeder Transaktions-E-Mail. Wird genutzt um die generierte E-Rechnung als PDF an die Bestellbestätigung des Kunden anzuhängen.

OrderState-Flag-Mapping

Beliebige OrderState-IDs der Rechnungserzeugung zuordnen — sprachunabhängig, funktioniert über alle installierten Sprachen und Multi-Shop-Kontexte ohne zusätzliche Konfiguration.

Kein Code nötig

Alle Hook-Registrierungen erfolgen automatisch bei der Modulinstallation. Trigger-States über das Modul-Einstellungsformular konfigurieren — kein PHP-Editing nötig.

Screenshots

Modul-Manager — "Invoice-api.xhub for PrestaShop" Listing
Konfigurationsseite — Generate-Karte + History-Tabelle
Grüne Success-Karte mit Template-UUID + API-Hash Diagnose
History-Tabelle mit Spalten Template + API-Hash
Einstellungsformular mit allen befüllten Feldern
E-Rechnung an Kunden-E-Mails anhängen Toggle in den Einstellungen

Wie es funktioniert

Modul über den PrestaShop-Modul-Manager installieren (ZIP hochladen oder auf addons.prestashop.com finden), Account auf invoice-api.xhub.io anlegen, API-Key in das Einstellungsformular einfügen, Land, Format und Trigger-OrderState wählen. Sobald eine Bestellung den konfigurierten State erreicht, feuert actionOrderStatusUpdate, das Modul POSTet die Order an die API, und die fertige Rechnung landet im Modul-Storage — pro Order in einer Meta-Tabelle indiziert. Der Auto-Install-Docker-Stack (docker-compose.yml enthalten) lässt eine vollständige PrestaShop 8 Entwicklungsumgebung in unter zwei Minuten aufsetzen.

Production-ready

PrestaShop-8-nativ: PSR-4-Autoload via composer.json, PHP 8.1+, Hook-Registrierung bei Installation. Atomic invoice numbering via INSERT…ON DUPLICATE KEY UPDATE hält die Nummern lückenlos auch unter Multi-Shop-Burst-Verkehr. Diagnose-Sichtbarkeit (Template-UUID + API-Hash-Spalten) direkt in der Admin-History-Tabelle eingebaut — kein Log-Wühlen nötig. Multi-Shop-fähig: jeder Shop-Kontext löst seinen eigenen API-Key und Template-Config auf.

Für wen

DACH-B2B-PrestaShop-Shops vor der 2025-XRechnung-Empfangs-Pflicht und der 2027/28-Versand-Pflicht — du brauchst ZUGFeRD oder XRechnung, nicht "irgendein PDF". Multi-Country-EU-Shops auf PrestaShop mit PDF-Bedarf heute und länderspezifischen Formaten beim Roll-out 2026. Multi-Shop-Betreiber die zentrale Rechnungserzeugung über alle Storefronts hinweg benötigen — das Modul löst die per-Shop-Config zur Laufzeit auf.

Anwendungsfälle

DACH-B2B-Compliance

XRechnung und ZUGFeRD für deutsche und österreichische B2B-Kunden mit USt-IdNr. und Netto-30-Zahlungszielen.

  1. 1B2B-Kunde mit USt-IdNr. wird auf der Bestellung erkannt
  2. 2actionOrderStatusUpdate feuert beim konfigurierten Trigger-State
  3. 3XRechnung-XML oder ZUGFeRD-Hybrid-PDF wird erzeugt
  4. 4Rechnung wird via actionEmailSendBefore an die Bestellbestätigung angehängt

Grenzüberschreitender EU-Handel

PDF-Rechnungen für alle EU-Märkte heute, automatisches Format-Upgrade auf länderspezifische Standards beim Rollout 2026.

  1. 1EU-Kunde bestellt in beliebiger Shop-Sprache
  2. 2Modul löst Länderprofil aus der Rechnungsadresse auf
  3. 3PDF wird heute erzeugt; Format-Upgrade erfolgt automatisch 2026
  4. 4OSS-konformes Archivieren im Modul-Storage

Buchhaltungs-Bridge

Standardkonforme XML/PDF aus PrestaShop, Weiterverarbeitung in DATEV, sevDesk oder Lexoffice.

  1. 1Modul erzeugt konforme XML- oder Hybrid-PDF
  2. 2GoBD-konformes lokales Archivieren im Modul-Storage-Pfad
  3. 3Export zu DATEV/sevDesk via bestehendes PrestaShop-Buchhaltungsmodul
  4. 4Automatische Konten-Zuordnung via Buchhaltungssoftware — kein doppelter Workflow

Diagnose-Sichtbarkeit

Sieh genau welche Template-UUID für jede erzeugte Rechnung wirklich an die API ging — keine stillen Fallbacks, keine Überraschungen. Template- und API-Hash-Spalten in der History-Tabelle geben dir die Tools um Layout-Änderungen sofort nachzuverfolgen und Produktiv-Renderings run-to-run zu vergleichen.

Template-Spalte in der History

Jede Zeile in der History-Tabelle zeigt die gekürzte Template-UUID die für diese Rechnung an die API gesendet wurde.

API-Hash-Spalte

Der von der API zurückgegebene Content-Hash erlaubt run-to-run-Vergleich — gleicher Input, gleicher Hash.

Diagnose-Success-Card

Nach Klick auf Generate now zeigt die grüne Success-Card Dateinamen, Byte-Größe, gesendete Template-UUID und API-Hash auf einen Blick.

Template-aware Cache-Invalidation

Der Idempotency-Cache vergleicht auch die templateId. Eine Änderung der Template-UUID erzwingt eine frische Generierung anstatt die alte Datei zu cachen.

Eigenes Template hinterlegt aber das PDF sieht trotzdem gleich aus?

Das Modul hat deine Template-UUID korrekt an die API gesendet. Wenn die erzeugte PDF immer noch wie der Standard aussieht, ist der Template-Inhalt selbst noch nicht angepasst. Öffne console.invoice-api.xhub.io/pdf/templates und passe Layout, Logo und Farben an damit der Unterschied sichtbar wird.

Plugin-Vergleich: welche PrestaShop-E-Rechnungs-Lösung passt?

Überblick über E-Rechnungs-Optionen für PrestaShop und das weitere XRechnung-API-Umfeld — Features, Preise, Compliance.

Heute starten

Modul von GitHub holen, Service-Account anlegen, in zehn Minuten die erste konforme E-Rechnung aus PrestaShop verschicken.