Live API, Exporter und WooCommerce Plugin einrichten.

Download Area

Downloads enthalten keinen persönlichen API-Key. Der mandantengebundene Key wird im Dashboard erzeugt und danach lokal in der jeweiligen Konfiguration gespeichert.

Live-API-Key erzeugen

Wawision-Fix2 / Mandantenschlüssel: Im IFX-Dashboard unter Einstellungen > Live API zuerst die Live API freischalten, als Quelle Wawision wählen und API-Key erzeugen anklicken. Den nur einmal vollständig angezeigten Schlüssel in der lokalen config.php des Exporters bei api_key eintragen. InvoiceFlowX bestimmt den Mandanten ausschließlich aus diesem Schlüssel; die E-Mail ist nicht die Berechtigungsgrundlage.

Die Live API kostet 69,00 EUR netto pro Jahr und enthält 100 API-Generierungen. Danach kostet jede API-Generierung 0,09 EUR netto aus dem IFX Wallet. Ist das Wallet leer, antwortet die API mit wallet_insufficient_funds.

Wawision-Exporter installieren

Übertragen werden Rechnungen mit Belegnummer, Status versendet und versendet = 1. Das jeweils passende PDF kommt aus dem Wawision-PDF-Archiv. Erfolgreiche Übertragungen werden in einer State-Datei vermerkt und nicht doppelt versendet; --force übergeht diesen Schutz bewusst.

<?php
return array(
    "endpoint" => "https://app.invoiceflowx.de/api/import-document.php",
    "api_key" => "IFX_LIVE_KEY_HIER_EINTRAGEN",
    "email" => "name@firma.tld",
    "source" => "Wawision",
    "log_file" => __DIR__ . "/logs/exporter.log",
    "state_file" => dirname(__DIR__) . "/userdata/ifx_export_state.json"
);

Testlauf und Cronjob

# Test ohne Upload
/usr/bin/php /var/www/Dein-WaWision/www/ifx-wawision-exporter/ifx-wawision-exporter.php --dry-run --since=2026-07-07

# Einzelne interne Wawision-Rechnungs-ID erneut senden
/usr/bin/php /var/www/Dein-WaWision/www/ifx-wawision-exporter/ifx-wawision-exporter.php --id=123 --force

# /etc/cron.d/ifx-wawision-exporter (System-Crontab mit Benutzerfeld)
*/5 * * * * www-data /usr/bin/php /var/www/Dein-WaWision/www/ifx-wawision-exporter/ifx-wawision-exporter.php --since=2026-07-07 >> /var/www/Dein-WaWision/www/ifx-wawision-exporter/logs/cron.log 2>&1

Für eine persönliche crontab -e entfällt das Benutzerfeld root. Dateien unter /etc/cron.d/ werden von Debian-Cron automatisch neu eingelesen; systemctl reload cron ist nicht erforderlich. Der ausführende Benutzer benötigt Lesezugriff auf Wawision-Konfiguration und PDF-Archiv sowie Schreibzugriff auf Log- und State-Datei.

Optionen und Fehleranalyse

• --dry-run: Treffer und PDF-Zuordnung prüfen, ohne hochzuladen.
• --since=YYYY-MM-DD, --limit=20 und --id=123: Auswahl begrenzen.
• --force: bereits in der State-Datei markierte Rechnung erneut übertragen.
• Exporter-Log: logs/exporter.log; Cron-Log: logs/cron.log.
• Auf älteren Debian-Systemen nutzt der Exporter für TLS ausdrücklich /etc/ssl/certs/ca-certificates.crt.

Xentral- und Datei-Exporter

Die Datei-Exporter für andere Systeme arbeiten weiterhin mit einem konfigurierten outbox_dir. Dieses Modell ist vom oben beschriebenen direkten Wawision-Datenbankzugriff getrennt.

WooCommerce Plugin

1. ifx-live-invoices-for-woocommerce.zip in WordPress unter Plugins > Installieren hochladen und aktivieren.
2. Unter WooCommerce > IFX Live Invoices Endpoint, Live-API-Key, Webhook Secret und Dashboard-Link eintragen.
3. Wartezeit setzen, z. B. 900 Sekunden. Bei 0 Sekunden geht die erste WooCommerce-Mail sofort raus; die IFX eRechnung folgt später per zweiter Mail.

Bei neuen Live-API-Keys ordnet InvoiceFlowX den Import serverseitig über den Key dem richtigen Dashboard-Mandanten zu. Eine vom externen System mitgesendete E-Mail wird dafür nicht benötigt.