Fremdsysteme einfach anbinden: mit Assistent, CLI und API schnell zum Ergebnis

Eine ERP-, FiBu- oder Fachanwendung an inoxision NG anzubinden, muss kein langes Integrationsprojekt sein. Event Actions NG führt vom geführten Assistenten über einen Kommandozeilen-Connector bis zur REST-API. So kann eine erste Verbindung schnell entstehen und später mit den Anforderungen wachsen.

Das Ziel ist einfach: Das vorhandene System soll Dokumente ablegen, Belege finden, Daten abrufen oder einen Bearbeitungsstand zurückmelden können. Dafür müssen Anwender nicht zuerst eine komplette API-Dokumentation durcharbeiten. Der Assistent erzeugt aus wenigen Angaben einen passenden Startpunkt.

Der Assistent macht aus einer Aufgabe einen fertigen Aufruf

Im Assistenten wird zuerst die gewünschte Aktion ausgewählt, zum Beispiel Dokument importieren, Belege suchen, eine Datei herunterladen oder einen Status aktualisieren. Danach folgen Archiv, Dokumentenklasse, Benutzer und die benötigten Felder. Diese Werte werden direkt aus der vorhandenen inoxision NG Umgebung angeboten. Tippfehler bei Archiv- oder Feldnamen lassen sich dadurch früh vermeiden.

• CLI-Befehl: direkt in einer Konsole, einem Skript oder einer bestehenden Anwendung nutzbar
• Steuerdatei: übersichtliche INI-Konfiguration für wiederkehrende Abläufe, Batch-Verarbeitung oder überwachte Ordner
• curl-Aufruf: ein fertiges Beispiel für den direkten Einstieg in die REST-API

Damit beginnt eine Integration nicht mit einer leeren Entwicklerseite, sondern mit einem getesteten Muster aus der tatsächlichen Systemkonfiguration. Wenig Komplexität am Anfang, aber alle Möglichkeiten für den späteren Ausbau.

Vier Wege, ein gemeinsames Ziel

Event Actions NG stellt nicht nur eine einzelne Schnittstelle bereit. Je nach Fremdsystem und Aufgabe kann der passende Integrationsweg gewählt werden:

Diese Wege lassen sich kombinieren. Ein Unternehmen kann mit einer Steuerdatei starten, später einzelne Funktionen direkt per API integrieren und anschließend Ereignisse in Echtzeit verarbeiten.

Praxisbeispiel: Eine freigegebene Rechnung an die FiBu übergeben

Eine Rechnung wird in inoxision NG verarbeitet und freigegeben. Danach soll die Finanzbuchhaltung die strukturierten Rechnungsdaten und das Dokument erhalten. Nach erfolgreicher Buchung meldet sie die Buchungsnummer zurück und setzt den Beleg auf „Exportiert“.

Aus Anwendersicht ist das ein durchgängiger Ablauf. Technisch kann er schrittweise umgesetzt werden: zuerst über den Connector, dann direkt per API oder vollständig ereignisgesteuert.

Schneller Start mit der Kommandozeile

Der Assistent kann beispielsweise einen Befehl erzeugen, der ein Dokument samt Metadaten archiviert:

inoxngconnect import Rechnung.pdf \
  --archiv "Buchhaltung" \
  --klasse "Eingangsrechnung" \
  --benutzer "fibu-service" \
  --feld "Belegnummer=RE-2026-4711" \
  --feld "Lieferant=Muster GmbH"

Der gleiche Connector kann suchen, herunterladen, Statuswerte aktualisieren, einen Ordner überwachen oder einen ganzen Stapel verarbeiten. Das ist besonders hilfreich, wenn eine vorhandene Software Programme starten oder Dateien bereitstellen kann, aber keine moderne REST-Integration besitzt.

Direkte Anbindung über die REST-API

Für eine tiefe Integration verwendet die Fachanwendung die Connector API. Ein Import kann beispielsweise so aussehen:

curl -X POST "https://archiv.example.de/api/connector/import" \
  -H "X-API-Key: <API-KEY>" \
  -F "user=fibu-service" \
  -F "archive=Buchhaltung" \
  -F "docClass=Eingangsrechnung" \
  -F "Belegnummer=RE-2026-4711" \
  -F "Lieferant=Muster GmbH" \
  -F "file=@Rechnung.pdf"

Die Antwort enthält eine stabile Dokument-UID. Das Fremdsystem kann diese Kennung am eigenen Vorgang speichern und später für Anzeige, Download oder Statusänderungen verwenden. Über weitere Endpunkte lassen sich Archive und Feldschemata ermitteln, Dokumente suchen, Metadaten lesen und Dateien oder einzelne Bestandteile eines E-Rechnungscontainers abrufen.

Ausgehend: inoxision NG informiert das ERP

Event Actions reagieren auf interne Ereignisse, etwa ein neu angelegtes Dokument oder einen geänderten Status. Eine Aktion kann Daten aufbereiten, Bedingungen prüfen und anschließend einen HTTP-Aufruf an das ERP oder die FiBu senden. Ein vereinfachter Webhook-Inhalt kann so aussehen:

{
  "event": "{{event.type}}",
  "documentUid": "{{document.uid}}",
  "archive": "{{archive.name}}",
  "status": "{{document.statusField.newValue}}"
}

HTTP-Aufruf, Transformation, Bedingung, Verzögerung, Protokollierung und Variablen stehen als Bausteine zur Verfügung. Zugangsdaten werden als Secrets verwaltet und müssen nicht in den Ablauf geschrieben werden.

Eingehend: Ein Listener nimmt die Rückmeldung an

Ein Listener stellt einen gezielten Webhook-Endpunkt bereit. Die Finanzbuchhaltung kann darüber beispielsweise melden, dass der Beleg gebucht wurde:

curl -X POST "https://archiv.example.de/api/hooks/fibu-rueckmeldung" \
  -H "X-API-Key: <LISTENER-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "documentUid": "194e7604-3e41-4bcd-af9a-c5648a92c693",
    "bookingId": "BU-2026-1234",
    "status": "Exportiert"
  }'

Der Listener kann die Daten prüfen, umformen und an den vorgesehenen Prozess übergeben. Damit muss kein System regelmäßig nach Änderungen fragen: Die Information fließt genau dann, wenn sie entsteht.

Nicht nur Daten übertragen, sondern Oberflächen einbetten

Eine gute Integration soll Anwendern den Wechsel zwischen Programmen ersparen. Die Connector API kann deshalb zeitlich begrenzte Links auf eine Trefferliste, ein einzelnes Dokument oder einen Ablagedialog erzeugen. Ein ERP kann damit Schaltflächen wie „Beleg anzeigen“, „Dokumente zum Vorgang“ oder „Unterlage ablegen“ anbieten.

Beim Ablagedialog können Felder vorbelegt, schreibgeschützt oder unsichtbar übergeben werden. Der Anwender ergänzt nur, was tatsächlich noch fehlt. Nach erfolgreicher Ablage verfällt der Einmal-Link. So verbindet sich die Oberfläche des Fremdsystems mit den Dokumentfunktionen von inoxision NG, ohne diese Funktionen im ERP neu entwickeln zu müssen.

Sicherheit passend zur angebundenen Software

Für jede angebundene Software kann ein eigener Connector-Schlüssel ausgestellt werden. Der Zugriff lässt sich auf bestimmte Archive sowie auf einzelne IP-Adressen oder IP-Bereiche begrenzen. Zusätzlich gelten die Rechte des verwendeten Archivbenutzers.

• Eigener Schlüssel je ERP-, FiBu- oder Fachanwendung
• Einschränkung auf die wirklich benötigten Archive
• Zugriff nur aus freigegebenen Netzen oder von definierten Systemen
• Rate Limits gegen übermäßige Anfragen
• Automatische Sperren nach wiederholt fehlerhaften Anmeldeversuchen
• Ausführungsprotokolle zur Kontrolle und Fehlersuche

Damit kann eine Integration gezielt freigeschaltet werden, ohne einer Anwendung pauschal Zugriff auf die gesamte Umgebung zu geben. Welche Rechte, Netze und Grenzwerte sinnvoll sind, richtet sich nach dem konkreten Einsatz und sollte bei der Einrichtung festgelegt werden.

Einfach beginnen, professionell ausbauen

Die Stärke von Event Actions NG liegt nicht in einem einzelnen Endpunkt. Entscheidend ist der durchgängige Weg: Der Assistent liefert sofort ein verwendbares Ergebnis, der Kommandozeilen-Connector überbrückt bestehende Systeme, die REST-API ermöglicht eine tiefe Integration und Event Actions sowie Listener machen daraus einen ereignisgesteuerten Prozess.

Fachliche Verantwortliche können den Ablauf verstehen und testen. Administratoren erhalten kontrollierbare Zugänge. Entwickler finden dokumentierte Endpunkte, strukturierte Antworten und maschinenlesbare API-Beschreibungen. Diese Verbindung aus einfachem Einstieg und technischer Tiefe macht inoxision NG zu einer leistungsfähigen Integrationsplattform für Dokumente, Daten und Unternehmensprozesse.

Der beste Einstieg ist ein klarer Anwendungsfall

Ein geeigneter erster Schritt ist bewusst klein: Belege aus einer Anwendung archivieren, freigegebene Rechnungen an die FiBu übergeben oder Dokumente direkt aus einer ERP-Maske anzeigen. Der Assistent erzeugt dafür die benötigte Konfiguration. Ist der Weg getestet, können Rückmeldungen, Listener, Ereignisse und weitere Prozessschritte ergänzt werden.

Weiterführend: Offene Schnittstellen für integrierte Prozesse, Prozesse auf der inoxision NG Plattform gestalten und inoxision NG im Überblick.

Produktinformationen, Stand: August 2026. Verfügbare Funktionen hängen von Version, Lizenz, Konfiguration und Systemumgebung ab. Die konkrete Anbindung und Absicherung sollte mit einem autorisierten inoxision Fachhandelspartner abgestimmt werden.