Softwareanbieter
Eigene SaaS-, ERP- oder Buchhaltungssoftware kann eRechnungserzeugung integrieren, ohne ein eigenes XRechnung-/ZUGFeRD-Modul zu entwickeln.
InvoiceFlowX Live API
XRechnung und ZUGFeRD direkt in Software, ERP und Shops integrieren.
Die IFX Live API nimmt Rechnungs-PDFs aus Xentral, Wawision, WooCommerce oder eigener Software entgegen, erzeugt eRechnungs-Artefakte und meldet fertige Ergebnisse per Webhook zurueck.
Wofuer die API gedacht ist
ERP und Warenwirtschaft
Xentral, Wawision und aehnliche Systeme senden Ausgangsrechnungen automatisiert an IFX und erhalten verarbeitete Dateien zurueck.
WooCommerce Shops
Das IFX WooCommerce Plugin kann Kundenmails warten lassen, bis die IFX eRechnung vorliegt, und dann die IFX PDF statt der Original-PDF anhaengen.
Ablauf
API-Key erzeugen
Im Dashboard Live API buchen, Quelle waehlen und mandantengebundenen Key erzeugen.
PDF senden
Das Quellsystem uebertraegt PDF, Referenz, Rollenangaben und optional eine Webhook-URL.
IFX verarbeitet
InvoiceFlowX erzeugt XRechnung, ZUGFeRD-PDF und Pruefberichte in der Anlieferung.
Webhook zurueck
Das Quellsystem laedt die fertigen Artefakte per Job-Download-Endpunkt ab.
Abrechnung und Wallet
Lizenz
Die Live API kostet 49 EUR netto pro Jahr. Die Lizenz schaltet API-Zugang, Key-Verwaltung, Status, Downloads und Webhooks frei.
Freikontingent
Pro Lizenzjahr sind 25 API-Generierungen enthalten. Doppelte Imports mit derselben Quellen-ID werden idempotent behandelt.
Folgepreis
Nach dem Freikontingent kostet jede weitere API-Generierung 0,35 EUR netto und wird aus dem IFX Wallet gebucht.
Wenn das Wallet leer ist, nimmt die API keine neuen Dokumente an und antwortet mit wallet_insufficient_funds. Angebundene Shops koennen dann den Admin informieren und, falls konfiguriert, die Originalrechnung als Fallback versenden.
API Beispiel
POST /api/import-document.php
Authorization: Bearer ifx_live_woocommerce_DEIN_KEY
source=woocommerce
source_id=order_5787
document_type=erechnung
invoice_role=ausgangsrechnung
webhook_url=https://shop.example/wp-json/ifx/v1/invoice-webhook
pdf=@rechnung.pdf