Docs/Integrations/Magento
Magento

Magento Integration

Live

E-Rechnungen direkt aus Magento 2 und Adobe Commerce — XRechnung, ZUGFeRD und PDF live, sieben weitere Formate ab Q3 2026. Kostenloses Open-Source-Modul, bezahlter E-Rechnungs-Service.

Heute live verfügbar

  • PDF (alle 28 unterstützten Länder)
  • XRechnung für Deutschland — BIS 3.0 / EN 16931
  • ZUGFeRD für DE/AT — PDF/A-3 mit eingebetteter XML

Coming Q3 2026

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

Features

Kostenloses Modul, bezahlter Service

MIT/OSL, kostenlos auf GitHub und Adobe Commerce Marketplace. Einnahmen kommen aus dem invoice-api.xhub.io Service-Abo — wie bei Stripe, PayPal oder Mollie.

Drei Formate live, sieben kommen 2026

PDF, XRechnung und ZUGFeRD sind heute verfügbar. Die weiteren Länder-Formate erscheinen automatisch in der Auswahl, sobald das Backend sie unterstützt.

§14-UStG-konforme Rechnungs-Nummerierung

Lückenlose, race-sichere fortlaufende Nummern via eigener DB-Tabelle. Token-Format `2026-{seq:0000}` für den Produktivbetrieb.

Multi-Store & Multi-Website

Eigene Verkäuferdaten und Template-IDs pro Store View. Magento-native Stores → Konfiguration UI — kein Eingriff in den Store-Code nötig.

Composer-native Installation

Ein einziger `composer require`-Befehl installiert, ein `bin/magento setup:upgrade` aktiviert. Kein ZIP-Upload, keine manuelle Dateikopie.

Eigene Rechnungs-Templates

Layout in der Console gestalten, Template-ID kopieren, in Stores → Konfiguration einfügen. Per-Order-Override via Order-Attribut möglich.

Installation per Composer

Drei Terminalbefehle — kein manuelles Datei-Deployment, keine root-Rechte auf dem Webserver.

1

composer require xhubio/magento2-invoice-api-xhub

2

bin/magento module:enable Xhubio_InvoiceApiXhub

3

bin/magento setup:upgrade && bin/magento cache:flush

Observer-Event-Ablauf

Das Modul nutzt Magentos DI-fähiges Observer-System — kein Override-Spaghetti, kein Preference-Konflikt. Der `sales_order_invoice_save_after`-Observer greift erst nach dem Datenbank-Commit.

sales_order_save_after
Observer
Invoice-api.xhub API
Stored Invoice + E-Mail

Screenshots

Magento-Admin-Dashboard — Last-Orders-Widget nach Plugin-Verarbeitung zweier Test-Bestellungen
Stores → Konfiguration → Sales → Invoice-api.xhub: alle drei Sektionen ausgeklappt
General-Settings — API-Key, Land, Format, Trigger, Nummerierungsformat
Sales → Bestellungen mit abgeschlossenen Test-Orders
Bestelldetail — Invoice-api.xhub-Metabox mit Download + Re-Generate
Seller Details — IBAN / BIC / Bank / Kontoinhaber für ZUGFeRD-SEPA

So funktioniert es

Modul per Composer installieren, Account bei invoice-api.xhub.io anlegen, API-Key in Stores → Konfiguration einfügen, Land und Format wählen. Sobald eine Bestellung den konfigurierten Status erreicht, löst der Observer einen asynchronen Job aus: Bestelldaten werden an die API gepostet, die konforme Rechnungsdatei zurückgegeben, an der Bestellung gespeichert und der Kunden-E-Mail angehängt. Das Setup dauert etwa zehn Minuten.

Production-ready

DI-fähige Observer ohne Preference-Konflikte, atomare Rechnungs-Nummerierung via eigener DB-Tabelle, Multi-Store-Konfiguration per Store View, DSGVO-konformes Uninstall-Script, Idempotenz-Cache für Doppel-Trigger-Schutz und native Integration in die Magento-Admin-Oberfläche unter Stores → Konfiguration.

Für wen

DACH-B2B-Shops auf Magento 2 oder Adobe Commerce, die XRechnung empfangen müssen (seit Januar 2025) und die Versandpflicht 2027/28 vorbereiten. Grenzüberschreitende EU-Shops, die heute PDF brauchen und die Länder-Formate beim Roll-out automatisch erhalten. Enterprise-Setups mit mehreren Stores, eigener Buchhaltungsinfrastruktur und dem Bedarf an einer standardisierten, composer-verwalteten E-Rechnungslösung.

Anwendungsfälle

DACH-B2B-Shop auf Magento

XRechnung-Pflicht in Deutschland — empfangen seit Januar 2025, versenden ab 2027/28

  1. 1Modul per Composer installieren, API-Key einfügen
  2. 2Format XRechnung, Land DE in Stores → Konfiguration wählen
  3. 3Bestellung auf konfigurierten Trigger-Status setzen
  4. 4Konforme XRechnung automatisch generiert und per E-Mail versandt

Grenzüberschreitende EU-Shops

PDF heute, länderspezifische Formate automatisch beim Roll-out ab Q3 2026

  1. 1Format PDF auswählen — funktioniert für alle 28 unterstützten Länder
  2. 2Länder-spezifische Formate erscheinen automatisch in der Auswahl
  3. 3Kein Modul-Update nötig bei neuen Formaten
  4. 4Einheitliche API für alle EU-Märkte

Multi-Store Enterprise

Eigene Verkäuferdaten, Template-IDs und Trigger-Events pro Store View

  1. 1Verschiedene Stores (DE-Shop, AT-Shop, CH-Shop) im selben Magento-Instanz
  2. 2Jeder Store View hat eigene API-Einstellungen und eigene Rechnungs-Nummerierung
  3. 3XRechnung für DE, ZUGFeRD für AT, PDF als universeller Fallback für CH
  4. 4Zentrale Diagnose-Übersicht in der Magento-Admin für alle Store Views

E-Rechnungs-API-Vergleich: Welche Lösung passt für Magento?

Übersicht der gängigen E-Rechnungs-APIs für XRechnung und ZUGFeRD — Funktionen, Preise, Compliance.

Jetzt loslegen

Modul per Composer installieren, Account anlegen und in zehn Minuten die erste konforme E-Rechnung aus deinem Magento-Shop versenden.