Enventa

Zweck

Der Enventa Connector bietet eine direkte Schnittstelle zum Enventa ERP-System und ermöglicht den Abruf von Geschäftsbelegen sowie der zugehörigen Bilddateien. Er dient dazu, die Dokumentenmanagement-Funktionalitäten von Enventa nahtlos in automatisierte Workflows zu integrieren.

Mit diesem Connector lassen sich folgende Aufgaben umsetzen:

• Dokumente suchen: Spezifische Belege anhand von Suchkriterien wie Belegnummer, Datumsbereichen oder Schlüsselwörtern finden.

• Belegdaten abrufen: Detaillierte Informationen zu einem bestimmten Beleg anhand seiner eindeutigen Belegnummer abfragen.

• Dokumentenbilder laden: Die zugehörigen Bilddateien (z. B. PDF oder TIF) eines Belegs herunterladen.

Praktische Anwendungshinweise

• Authentifizierung: Erfolgt automatisch durch den SOAP-Header nvLogin, der Benutzername, Passwort und Mandant enthält.

• Belegbilder: Die Aktion „Belegbild abrufen“ liefert den rohen Binärinhalt der Bilddatei zurück. Zum weiteren Umgang sollte die Datei in nachfolgenden Schritten mit passender Endung (z. B. .pdf, .tif) gespeichert werden.

• Groß-/Kleinschreibung: Bei der Suche mit der Aktion SearchBeleg kann optional festgelegt werden, ob die Suche case-sensitive erfolgt.

Authentifizierung

Der Connector verwendet folgende Konfigurationsparameter zur Erstellung des SOAP-Authentifizierungsheaders:

• URL: SOAP-Endpunkt des Enventa-Systems.

• Username: Enventa-Benutzername.

• Password: Enventa-Passwort.

• Client: Mandanten-Identifikator in Enventa.

Erwartungen an Ein- und Ausgabe

Eingabe

Die Eingabe erfolgt über ein Formular mit dynamisch an die Aktion angepassten Feldern:

• Beleg abrufen (GetBeleg): Erfordert die Angabe der Belegnummer.

• Belegbild abrufen (GetBelegPicture): Benötigt die Belegnummer und die Seite (Seitenzahl).

• Belege suchen (SearchBeleg): Erwartet einen Suchbegriff sowie optionale Filter wie Belegart, Datumsbereiche und ein Flag zur Groß-/Kleinschreibungsbeachtung.

Ausgabe

• response:

  • Bei den Aktionen „Beleg abrufen“ und „Belege suchen“ enthält die Antwort ein JSON-Objekt mit den Belegdaten.

  • Bei „Belegbild abrufen“ enthält die Antwort den rohen Binärstring der Bilddatei, der entsprechend weiterverarbeitet werden muss.

• createResponseDataStructure: Diese Aktion unterstützt das Erzeugen einer strukturierten Darstellung der Ausgabedaten für eine einfache Weiterverarbeitung in nachfolgenden Workflow-Schritten.