Technische Dokumentation

Live API, Exporter und WooCommerce Plugin einrichten.

Hier findest Du Downloads, Installationsschritte und Betriebslogik fuer Xentral, Wawision, WooCommerce und eigene Integrationen mit der InvoiceFlowX Live API.

Download Area

ERP / Warenwirtschaft

Xentral ExporterNachfolger von Wawision, Quelle xentral.ZIP laden Wawision ExporterBestehende Wawision-Installationen, Quelle wawision.ZIP laden

WooCommerce

IFX WooCommerce Live InvoicesWartet auf IFX Webhook und ersetzt die PDF in Kundenmails.Plugin laden WooCommerce Datei-ExporterSchmaler Exporter fuer Ablageordner/Outbox-Setups.ZIP laden

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

Live-API-Key erzeugen

Dashboard oeffnen

Im InvoiceFlowX Dashboard das Modul Einstellungen oeffnen.

Quelle waehlen

Im Bereich Live API die Quelle setzen: xentral, wawision oder woocommerce.

Key erzeugen

Live API buchen, Key erzeugen und direkt kopieren. Spaeter wird nur noch die Vorschau angezeigt.

Die Live API kostet 49 EUR netto pro Jahr und enthaelt 25 API-Generierungen. Danach kostet jede API-Generierung 0,35 EUR netto aus dem IFX Wallet. Ist das Wallet leer, antwortet die API mit wallet_insufficient_funds.

Exporter installieren

1. Entpacken

ZIP auf dem Webserver entpacken, z. B. nach /var/www/ifx-xentral-exporter.

2. Konfigurieren

config.example.php nach config.php kopieren und API-Key sowie Quelle eintragen.

3. Outbox setzen

outbox_dir muss auf den Ordner zeigen, in dem ERP oder Shop neue Rechnungs-PDFs ablegt.

Der Exporter ueberwacht nicht automatisch die gesamte ERP-/Shop-Installation. Er liest nur PDFs aus dem vereinbarten Ablageordner outbox_dir.

return [
    "endpoint" => "https://app.invoiceflowx.de/api/import-document.php",
    "api_key" => "ifx_live_xentral_DEIN_GEHEIMER_KEY",
    "source" => "xentral",
    "outbox_dir" => "/var/www/xentral.firma.endung/storage/ifx-outbox",
    "sent_dir" => "/var/www/ifx-xentral-exporter/sent",
    "failed_dir" => "/var/www/ifx-xentral-exporter/failed",
    "log_file" => "/var/www/ifx-xentral-exporter/logs/exporter.log"
];

Testlauf und Cronjob

php ifx-wawision-exporter.php --dry-run
php ifx-wawision-exporter.php
*/5 * * * * /usr/bin/php /var/www/ifx-wawision-exporter/ifx-wawision-exporter.php >> /var/www/ifx-wawision-exporter/logs/cron.log 2>&1

WooCommerce Plugin

Mail-Wartezeit

Das Plugin kann Kundenmails warten lassen, bis IFX die eRechnung per Webhook zurueckmeldet.

PDF-Erzeugung

Es nutzt konfigurierte Pfade, WordPress-Filter oder automatisch die WPO PDF-Invoices-API, wenn vorhanden.

Fallback

Bei Timeout, leerem Wallet oder API-Fehler wird der Admin informiert und die Originalrechnung kann weiter versendet werden.

  1. ifx-woocommerce-plugin.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 spaeter per zweiter Mail.

Bei neuen Live-API-Keys ordnet InvoiceFlowX den Import serverseitig ueber den Key dem richtigen Dashboard-Mandanten zu. Eine vom externen System mitgesendete E-Mail wird dafuer nicht benoetigt.