Der offizielle, leichtgewichtige PHP-Client für die E-Rechnung API.
🔍 Kostenloser Online-Validator: Teste und validiere deine ZUGFeRD- & XRechnung-Dateien direkt im Browser ohne Registrierung: e-rechnung-cloud.de/validator
Erstelle, verarbeite und validiere rechtskonforme elektronische Rechnungen nach EN 16931 (ZUGFeRD 2.2 / Factur-X & XRechnung) in WordPress, WooCommerce, Shopware, Laravel oder nativen PHP-Applikationen.
composer require andregrunert-ctrl/zugferd-client(Erfordert PHP >= 7.4 oder PHP 8.x und hat keine schweren externen Abhängigkeiten, da nativer cURL-Support genutzt wird).
Dank des integrierten öffentlichen Test-Keys kannst du sofort ohne API-Key oder Registrierung starten:
<?php
require_once 'vendor/autoload.php';
use Zugferd\ZugferdClient;
// Initialisierung (nutzt automatisch den kostenlosen Test-Key)
$client = new ZugferdClient();
// Rechnungsdaten gemäß EN 16931
$invoiceData = [
'invoice_number' => 'RE-2026-001',
'issue_date' => '2026-10-10',
'currency' => 'EUR',
'seller' => [
'name' => 'Muster GmbH',
'street' => 'Hauptstraße 1',
'zip_code' => '10115',
'city' => 'Berlin',
'country' => 'DE',
'vat_id' => 'DE123456789',
'iban' => 'DE12345678901234567890'
],
'buyer' => [
'name' => 'Kunden AG',
'street' => 'Nebenstraße 2',
'zip_code' => '80331',
'city' => 'München',
'country' => 'DE'
],
'line_items' => [
[
'description' => 'Web-Entwicklung & E-Rechnung Integration',
'quantity' => 10,
'unit_price' => 120.00,
'tax_rate_percent' => 19
]
]
];
// 1. ZUGFeRD PDF/A-3 Rechnung generieren und speichern
$pdfBytes = $client->generateInvoice($invoiceData, 'rechnung.pdf');
echo "✅ ZUGFeRD-Rechnung erfolgreich gespeichert!\n";
// 2. Rechnung validieren
$report = $client->validate('rechnung.pdf');
if ($report->isValid()) {
echo "✅ Konform nach EN 16931 (" . $report->getFormat() . ")\n";
} else {
echo "❌ Fehler: " . implode(', ', $report->getErrors()) . "\n";
}Generiert ein vollständiges, druckfertiges deutsches PDF/A-3 mit eingebetteter factur-x.xml.
Bettet das XML verlustfrei in ein bestehendes Kunden-PDF ein (z. B. aus Dompdf, TCPDF oder mPDF).
$client->embedInvoice('mein_shop_beleg.pdf', $invoiceData, 'zugferd_fertig.pdf');Erstellt reines XML ohne PDF (Pflicht für deutsche Behörden / B2G, unterstützt buyer_reference / Leitweg-ID BT-10).
Prüft jede PDF- oder XML-Rechnung auf Einhaltung der europäischen Norm EN 16931 und offizielle XSD-Schemata.
Für produktive Rechnungen ohne Test-Wasserzeichen übergibst du deinen persönlichen Key oder setzt die Umgebungsvariable ZUGFERD_API_KEY:
$client = new ZugferdClient('zg_live_mein_api_key');- Live-Web-Validator: https://e-rechnung-cloud.de/validator (Kostenlos Dateien im Browser prüfen)
- Interaktive API-Dokumentation (Swagger): https://e-rechnung-cloud.de/docs
- Preise & Tarife: https://e-rechnung-cloud.de/#pricing
- PHP & Laravel Tutorial: https://e-rechnung-cloud.de/tutorials/php-zugferd
- WooCommerce Guide: https://e-rechnung-cloud.de/tutorials/woocommerce-e-rechnung
zugferd-client is the official PHP SDK for the E-Rechnung API, built to ensure seamless European electronic invoicing compliance (EN 16931) for PHP applications, frameworks (Laravel, Symfony), and CMS/E-Commerce systems (WordPress, WooCommerce, Shopware, Magento):
- PDF/A-3 Hybrid Generation: Create invoices with embedded
factur-x.xml(ZUGFeRD 2.2 / Factur-X) in MINIMUM, BASIC, EN 16931 (COMFORT), or EXTENDED profiles. - XRechnung (XML-only): Generate pure CII XML required for German public sector mandates (B2G).
- Validation Engine: Validate incoming PDF/A-3 and XML invoices against official XSD schemas and EN 16931 business rules.
- Free Online Validator: Test your invoices instantly in your browser at e-rechnung-cloud.de/validator.
- Lightweight: Native cURL implementation with zero third-party composer dependencies.
MIT License - Siehe LICENSE für Details.
ZUGFeRD ist eine eingetragene Marke der AWV e.V. (Arbeitsgemeinschaft für wirtschaftliche Verwaltung e.V.) / FeRD. Dieses Projekt (zugferd-client) ist ein unabhängiges Open-Source-Projekt und steht in keiner geschäftlichen oder offiziellen Verbindung zur AWV e.V. oder dem Forum elektronische Rechnung Deutschland. Die Nennung der Marke erfolgt ausschließlich zur beschreibenden Angabe der Formatkompatibilität im Sinne von § 23 Abs. 1 Nr. 3 MarkenG.