Das ist eine für den Ausdruck optimierte Ansicht des gesamten Kapitels inkl. Unterseiten. Druckvorgang starten.

Zur Standardansicht zurückkehren.

REST-API

FLOWWER verfügt über ein umfangreiches REST-API, was den Datenaustausch direkt auf Systemebene ermöglicht.

Zweck der API

FLOWWER soll häufig in die bestehende Infrastruktur integriert werden. Um Drittsoftware effizient an FLOWWER anbinden zu können, haben wir jedem FLOWWER-Konto ein REST-API (Programmierschnittstelle) hinzugefügt.

Über das FLOWWER REST-API können Softwaresysteme ihre Daten direkt mit FLOWWER austauschen, ohne die grafische Benutzeroberfläche nutzen zu müssen. Besonders nützlich ist das, wenn eine Datenschnittstelle zur Anbindung an eine kundenspezifische Softwarelösung entwickelt werden soll.

Auch für einfache Aufgaben (z. B. den regelmäßigen Upload oder Download von Dokumenten) ist das FLOWWER REST-API sehr effizient.

API-Format

Das FLOWWER-API folgt der OpenAPI-Specification - einem Standard zur Beschreibung REST-konformer Programmierschnittstellen.

Damit wird die Nutzung von API-Tools wie z.B.

Beschreibung der API

Jedes FLOWWER-Konto verfügt über eine eigene REST-API, welche unter Verwendung der FLOWWER-Kontokennung erreichbar ist.

Alle Funktionen der REST-API werden per ‘Swagger UI’ für den Browser sichtbar:

https://*Ihre-FLOWWER-Kontokennung*.flowwer.de/swagger

Das optionale FLOWWER-Feature „REST-API“ (früher „alternativer Download“) ermöglicht es, freigegebene Dokumente an weitere Ziele (zusätzlich zu DATEV Unternehmen Online) zu übertragen. Der Upload von Daten in das FLOWWER-System ist auch ohne Aktivierung des Features möglich.

Authentifizierung

Zugriffe auf die REST-API erfolgen mit dem API-Key eines API-Benutzers oder mit einem persönlichen REST-API-Token; Details unter Sicherheit.

Berechtigungen und Sichtbarkeit

Die REST-API arbeitet mit den Rechten des angemeldeten Benutzers bzw. API-Benutzers. Dokumente, die dieser Benutzer nach den Regeln der Sichtbarkeit von Dokumenten nicht sieht, liefert sie nicht aus.

Endpunkte, die ein einzelnes Dokument verändern, verlangen zusätzlich dasselbe Recht wie die entsprechende Aktion in der Benutzeroberfläche:

Fehlt die Sichtbarkeit oder das Recht, antwortet die API mit dem Status 403. Für die Export-Endpunkte freigegebener Dokumente (Download, „verarbeitet“ setzen) gelten weiterhin die Berechtigungen Freigegebene Dokumente auf alternativem Weg herunterladen bzw. Zugriff auf Freigegebene Dokumente.

Beispieldokumente

Dokumente aus den Beispieldaten bietet die API nicht zur Abholung an: GetApprovedDocuments und FindDocumentsByTargetState sowie die Endpunkte GetApproved und FindByTargetState des FLOWWER-Agents liefern sie nicht. Andere lesende Abfragen, OData und MCP liefern Beispieldokumente mit; ein eigenes Kennzeichen dafür enthalten die Dokumentdaten der API derzeit nicht.

Reporting über OData

Für schreibgeschützte Auswertungen in Excel, Power Query und Power BI steht zusätzlich der OData-Reporting-Endpunkt zur Verfügung. Über OData-Verbindung einrichten im Startmenü oder auf der Filterseite lassen sich die Verbindungsdaten erzeugen.

KI-Assistenten über MCP

Über den MCP-Server fragen KI-Assistenten FLOWWER-Daten lesend in natürlicher Sprache ab. Der MCP-Server muss in den Systemeinstellungen aktiviert werden.

Dokumente anhand eines Filterpfads finden

Ein auf der FLOWWER-Filterseite zusammengestellter Filterpfad kann über die Find-API für Filterpfade verwendet werden. Damit lassen sich passende Dokumente aus einer eigenen Integration heraus ermitteln und weiterverarbeiten.

Dokumentarchiv importieren und exportieren

Abgeschlossene Dokumentbestände können einschließlich ihrer Eigenschaften, Belegaufteilungen, Notizen und Protokolldaten als Archiv exportiert und wieder importiert werden.

Abwesenheitszeitpläne pflegen

Über die REST-API lassen sich Abwesenheitszeitpläne lesen und pflegen, etwa aus einem Personal- oder Urlaubsverwaltungssystem:

  • GET, PUT und DELETE /api/v1/users/substitution-schedule – Zeitplan des angemeldeten Benutzers
  • GET, PUT und DELETE /api/v1/users/{UserGuid}/substitution-schedule – Zeitplan eines anderen Benutzers; erfordert Benutzer verwalten

PUT ersetzt alle Einträge (höchstens 100) und übernimmt den Zeitplan sofort. Ungültige Einträge, z. B. ohne Vertretung oder mit überschneidenden Zeiträumen, weist die API mit dem Status 400 und den Fehlern je Eintrag zurück; für die Auswahl der Vertretung gelten dieselben Regeln wie in der Oberfläche.
DELETE beendet die Steuerung per Zeitplan; die aktuell hinterlegte Vertretung bleibt als einzelne Abwesenheit bestehen.

1 - Dokumente über Filterpfade finden

Mit der FLOWWER-REST-API Dokumente anhand eines auf der Filterseite erstellten Filterpfads finden.

Überblick

Die Find-API ermöglicht es, Dokumente anhand eines Filterpfads über die FLOWWER-REST-API zu finden. Der Filterpfad verwendet dieselbe Abfragelogik wie die Filterseite und kann dort ohne manuelles Zusammensetzen erstellt und geprüft werden. Die Funktion eignet sich beispielsweise, wenn eine eigene Integration regelmäßig genau die Dokumente abrufen soll, die einer fachlich zusammengestellten Filterkombination entsprechen.

Filterpfad erstellen

  1. Öffnen Sie die Filterseite.
  2. Wählen Sie die benötigten Merkmale und Werte aus.
  3. Prüfen Sie die Ergebnisliste in FLOWWER.
  4. Übernehmen Sie den Filterpfad aus der Adresszeile für den API-Aufruf.

Auch Mehrfachauswahlen und ODER-Gruppen sind Bestandteil des Filterpfads und werden bei der Abfrage berücksichtigt.

Abfrage über die REST-API

Die Find-Aktion für Filterpfade ist in der Swagger-Oberfläche des jeweiligen FLOWWER-Kontos dokumentiert:

https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/swagger

Dort finden Sie die für Ihre FLOWWER-Version gültige Route, HTTP-Methode und Request-Struktur. Übergeben Sie den zuvor erstellten Filterpfad an die dort beschriebene Aktion.

Für den Zugriff gelten die normale Authentifizierung der FLOWWER-REST-API und die Berechtigungen des verwendeten API-Benutzers. Zurückgegeben werden nur Dokumente, auf die dieser Benutzer zugreifen darf.

Typischer Ablauf

  1. Fachlichen Filter in FLOWWER zusammenstellen und testen.
  2. Filterpfad in die eigene Integration übernehmen.
  3. Find-API mit den Zugangsdaten eines geeigneten API-Benutzers aufrufen.
  4. Die gefundenen Dokumente in der eigenen Anwendung weiterverarbeiten.

Derzeitige Abgrenzung

Dieser Endpunkt verarbeitet Filterpfade der Filterseite. Gespeicherte Suchen und Abfragen der Erweiterten Suche können derzeit nicht über dieselbe Find-Aktion ausgeführt werden. Für tabellarische Reporting-Auswertungen in Excel oder Power Query steht alternativ der OData-Reporting-Endpunkt zur Verfügung.

2 - OData-Reporting mit Excel und Power BI

FLOWWER-Dokumentdaten über den schreibgeschützten OData-Endpunkt in Excel, Power Query und Power BI auswerten.

Überblick

FLOWWER stellt unter /odata/reporting einen schreibgeschützten OData-Endpunkt für Auswertungen bereit. Excel (Power Query), Power BI und andere OData-fähige Werkzeuge können ihn direkt als OData-Feed einbinden und die Daten bei Bedarf aktualisieren.

Der Endpunkt dient ausschließlich der Auswertung. Dokumente oder Dokumenteigenschaften lassen sich darüber nicht ändern.

Datenmengen

MengeEine Zeile jeGeeignet für
DocumentsDokumentÜbersichten nach Lieferant, Betrag, Status, Fristen oder Bezahlstatus
ReceiptSplitLinesPosition der BelegaufteilungAuswertungen nach Konto, Kostenstelle, Kostenträger, BU-Schlüssel oder Steuersatz

Documents enthält unter anderem Dokument-ID und -nummer, Dokumentart und Dokumenttyp, Freigabestatus, Bezahlstatus und Bezahlart, Gutschrift- und Korrekturkennzeichen, Währung, E-Rechnungs-Herkunft, Unternehmen, Floww, Lieferant, Netto- und Bruttobetrag sowie die Datumsfelder (Dokumentdatum, Eingang, Fälligkeit, Skontofrist, Leistungszeitraum, Bezahlt am, Ablaufdatum).

ReceiptSplitLines enthält dieselben Dokumentspalten und zusätzlich je Position Buchungstext, Kostenstelle 1 und 2, Konto und BU-Schlüssel (jeweils Nummer und Bezeichnung), Steuersatz, Betrag und das Kennzeichen „keine Vorsteuer“. Dokumente ohne Belegaufteilung erscheinen mit genau einer Zeile, bei der IsWithoutReceiptSplits gesetzt ist. Ein Dokument mit mehreren Positionen erscheint entsprechend mehrfach.

Die frühere Menge DocumentsWithReceiptSplits ist durch ReceiptSplitLines ersetzt. Abfragen, die noch die alte Menge verwenden, müssen umgestellt werden.

Vorzeichen: Gutschriften zählen immer negativ, Korrekturrechnungen positiv. Beträge stehen in der Dokumentwährung; addieren Sie keine Beträge verschiedener Währungen.

Benutzerdefinierte Datenfelder sind im OData-Reporting nicht enthalten.

Quellen

Ohne weitere Angabe liefern beide Mengen alle nicht gelöschten Dokumente, die der Benutzer des Tokens sehen darf. Die Menge lässt sich auf eine Quelle einschränken:

QuelleÜbergabe
Filterpfad der FilterseiteQuery-Parameter path oder Funktion GetDocumentsByPath bzw. GetReceiptSplitLinesByPath
Gespeicherte SucheQuery-Parameter savedSearch oder Funktion GetDocumentsBySavedSearch bzw. GetReceiptSplitLinesBySavedSearch
Systemsuche, z. B. „Freigabeliste“ oder „Aktive Dokumente“Query-Parameter systemList

Eine private gespeicherte Suche findet nur ihr Ersteller. Für einen API-Benutzer muss die Suche systemweit gespeichert sein. Systemsuchen beziehen sich auf den Benutzer des Tokens; für einen API-Benutzer bleiben benutzerbezogene Listen wie die Freigabeliste in der Regel leer.

Verbindung einrichten

Am einfachsten richten Sie die Verbindung mit dem Dialog OData-Verbindung einrichten ein. Er ist im Startmenü (Desktop) und auf der Filterseite erreichbar; von der Filterseite aus übernimmt er den aktuellen Filterpfad als Quelle.

1. Quelle konfigurieren

  • Benutzer: Ihr eigenes Konto mit einem persönlichen OData-Token oder ein API-Benutzer. API-Benutzer stehen nur mit der Berechtigung Benutzer verwalten zur Auswahl.
  • OData-Token: Für das eigene Konto erzeugen Sie hier ein persönliches OData-Token. Es steht im Dialog zur Verfügung, solange die Sitzung läuft; Excel und Power BI speichern es nach der ersten Anmeldung selbst.
  • Quelle: Alle Dokumente, Filterpfad, gespeicherte Suche oder Systemsuche.
  • Ressource: Documents oder ReceiptSplitLines.
  • Übergabe (bei Filterpfad und gespeicherter Suche): Query-Parameter oder OData-Funktion. Beide liefern dasselbe; die Funktion erscheint zusätzlich im Navigator von Excel und Power BI.
  • Erweiterte Einstellungen: $top, $select, $orderby, $filter und $count.

2. Ausgabe erzeugen

ErgebnisformatVerwendung
Excel / Power BI: konkreter Feed + Basic AuthIn Excel Daten abrufen › Aus anderen Quellen › Aus OData-Feed bzw. in Power BI Desktop Daten abrufen › OData-Feed die Feed-URL eintragen. Als Authentifizierung Basic wählen (in der deutschen Excel-Oberfläche Standard): Benutzername <Kontokennung>+ApiKeyUser, Passwort ist das OData-Token.
Excel Power Query: konkreter Feed + HeaderDen erzeugten M-Code in Power Query im erweiterten Editor einfügen. Das Token wird im Header X-FLOWWER-ODataKey übertragen.
Excel Power Query: Service Root + HeaderWie oben, öffnet aber den gesamten Dienst; Quelle und Optionen werden nicht übernommen.
Direkte Feed-URI mit Token in der QueryNur für Tests mit einem API-Benutzer. Persönliche Tokens werden in der URL grundsätzlich abgelehnt.

Excel und Power BI speichern die Anmeldedaten selbst, nicht in der Datei. Wählen Sie dabei den Service Root als Ebene, gelten sie für alle Abfragen auf Ihr FLOWWER-Konto.

Zugang und Sichtbarkeit

Der Abruf erfolgt immer im Namen eines Benutzers:

  • mit einem persönlichen OData-Token: Sie sehen genau die Dokumente, die Sie auch in FLOWWER sehen;
  • mit einem API-Benutzer: es gelten dessen Rechte und Unternehmenszuordnungen.

Das Token wird im Header X-FLOWWER-ODataKey oder als Passwort bei Basic Auth übergeben, nie als Teil der URL. Persönliche Tokens werden in den persönlichen Einstellungen verwaltet und widerrufen.

Direkter Zugriff auf den Dienst

https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/odata/reporting
https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/odata/reporting/$metadata
https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/odata/reporting/Documents
https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/odata/reporting/ReceiptSplitLines
  • Unterstützt werden $filter, $select, $orderby, $top, $skip und $count. FLOWWER wertet sie direkt in der Datenbank aus.
  • Große Ergebnisse liefert der Dienst in Seiten zu 5.000 Zeilen mit einem nextLink; Excel, Power Query und Power BI folgen ihm automatisch.
  • $count=true kann bei großen Datenmengen die Laufzeit verlängern.

Aktualisierung und Power BI

Power Query und Power BI können die Abfrage jederzeit erneut ausführen. So bleibt eine einmal eingerichtete Arbeitsmappe mit den aktuellen FLOWWER-Daten verbunden.

Power BI Desktop hält das Datenmodell des Dienstes im Cache. Fehlen nach einem FLOWWER-Update neue Spalten oder Mengen, entfernen Sie den Eintrag unter Datenquelleneinstellungen und starten Power BI neu.

Abgrenzung zu FlexReport und MCP

  • FlexReport wertet Dokumente direkt in FLOWWER aus, auch gruppiert mit Summen, und exportiert nach Excel oder CSV.
  • Das OData-Reporting eignet sich, wenn eine Auswertung in Excel oder Power BI dauerhaft mit FLOWWER verbunden bleiben und regelmäßig aktualisiert werden soll.
  • Über den MCP-Server fragen KI-Assistenten FLOWWER-Daten in natürlicher Sprache ab.

3 - Dokumente als Archiv exportieren und importieren

Verarbeitete oder gelöschte FLOWWER-Dokumente einschließlich ihrer Daten als Archiv exportieren und in ein Zielunternehmen oder einen Zielfloww importieren.

Überblick

FLOWWER kann Dokumente einschließlich der zugehörigen Informationen als Archiv exportieren und später wieder importieren. Die Funktion steht über die REST-API und über die entsprechenden Befehle des FLOWWER-Agent zur Verfügung.

Der Export eignet sich beispielsweise für die Übernahme abgeschlossener Dokumentbestände in ein anderes FLOWWER-Konto oder für eine gezielte Übergabe auf Unternehmens- beziehungsweise Floww-Ebene.

Welche Dokumente werden exportiert?

Exportiert werden ausschließlich Dokumente in den Zuständen:

  • Verarbeitet
  • Gelöscht

Je nach gewähltem Aufruf umfasst der Export:

  • alle exportierbaren Dokumente des FLOWWER-Kontos,
  • die exportierbaren Dokumente eines bestimmten Unternehmens,
  • oder die exportierbaren Dokumente eines bestimmten Flowws.

Enthaltene Daten

Das Archiv übernimmt neben den Dokumenten unter anderem:

  • Dokumenteigenschaften,
  • Belegaufteilungen,
  • FiBu-Notiz und Benutzernotiz,
  • Logbuch beziehungsweise Audit-Trail,
  • Volltextindex,
  • E-Rechnungsdaten,
  • Aufbewahrungsfrist.

Vorschau-PDFs werden beim ersten Öffnen im Zielsystem neu erzeugt.

Ziel des Imports

Ein Archiv kann importiert werden in:

  • ein ausgewähltes Zielunternehmen,
  • oder einen ausgewählten Zielfloww.

Beim Import in ein Ziel mit einer längeren Aufbewahrungsdauer kann die Aufbewahrungsfrist neu berechnet und dadurch verlängert werden. Eine bereits bestehende Aufbewahrungsfrist wird durch den Import jedoch nicht verkürzt.

Verwendung mit FLOWWER-Agent

Die folgenden Beispiele verwenden Platzhalter. Ersetzen Sie Kontokennung, API-Schlüssel und IDs durch die Werte Ihrer Umgebung.

Alle exportierbaren Dokumente exportieren

flowwer.exe exportall `
  -t <Kontokennung> `
  -a <API-Schlüssel> `
  -o C:\FLOWWER-Export

Dokumente eines Unternehmens exportieren

flowwer.exe exportfromcompany `
  -t <Kontokennung> `
  -a <API-Schlüssel> `
  --companyid=<Unternehmens-ID> `
  -o C:\FLOWWER-Export

Dokumente eines Flowws exportieren

flowwer.exe exportfromflow `
  -t <Kontokennung> `
  -a <API-Schlüssel> `
  --flowid=<Floww-ID> `
  -o C:\FLOWWER-Export

Archiv in ein Unternehmen importieren

flowwer.exe importtocompany `
  -t <Kontokennung> `
  -a <API-Schlüssel> `
  --companyid=<Unternehmens-ID> `
  -i C:\FLOWWER-Export\Export_<Zeitstempel>.zip

Archiv in einen Floww importieren

flowwer.exe importtoflow `
  -t <Kontokennung> `
  -a <API-Schlüssel> `
  --flowid=<Floww-ID> `
  --note="Importierter Dokumentbestand" `
  -i C:\FLOWWER-Export\Export_<Zeitstempel>.zip

Verwendung über die REST-API

Die Export- und Importaktionen stehen auch über die REST-API zur Verfügung. Die in Ihrer FLOWWER-Umgebung verfügbaren Aktionen und Request-Modelle finden Sie in der Swagger-Oberfläche unter:

https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/swagger

Für automatisierte Übernahmen empfiehlt sich ein eigener API-Token-Benutzer mit den dafür erforderlichen Berechtigungen.

Hinweise

  • Prüfen Sie vor einem Import, ob Zielunternehmen beziehungsweise Zielfloww korrekt ausgewählt sind.
  • Bewahren Sie Exportarchive geschützt auf, da sie Dokumente, Notizen und Protokolldaten enthalten.
  • Testen Sie größere Übernahmen zunächst mit einem begrenzten Dokumentbestand.

4 - KI-Assistenten anbinden (MCP-Server)

Über den MCP-Server von FLOWWER fragen KI-Assistenten wie Claude, ChatGPT oder Copilot Dokumente, Freigaben und Auswertungen in natürlicher Sprache ab.

Überblick

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Assistenten auf externe Systeme zugreifen. Mit dem MCP-Server von FLOWWER kann ein KI-Assistent Ihre FLOWWER-Daten abfragen, zum Beispiel:

  • „Was wartet seit mehr als sieben Tagen auf Freigabe, und bei wem?“
  • „Welche Rechnungen der Muster GmbH sind noch nicht bezahlt?“
  • „Wie hoch sind die Ausgaben pro Kostenstelle im dritten Quartal?“
  • „Gibt es eine Rechnung über 126,69 € mit der Referenz RE-2026-0815?“

Der Zugriff ist ausschließlich lesend. Der Assistent kann keine Dokumente ändern, freigeben oder ablehnen.

Voraussetzungen

MCP-Server aktivieren

Der MCP-Server ist ein Opt-in: Ein Administrator muss ihn einmalig unter Systemeinstellungen › Basisdaten / Sicherheit aktivieren. Damit erlauben Sie grundsätzlich, dass externe Systeme über den MCP-Server auf FLOWWER-Daten zugreifen können.

Solange der MCP-Server nicht aktiviert ist, antwortet die Adresse nicht, und die Token-Art MCP wird nicht angeboten.

Zugang

Der Assistent arbeitet immer im Namen eines FLOWWER-Benutzers und sieht genau die Dokumente, die dieser Benutzer sehen darf. Dafür gibt es zwei Wege:

ZugangGeeignet fürEinrichtung
Persönliches MCP-Tokenden eigenen KI-Assistenten eines BenutzersPersönliche Einstellungen › Anmeldung / Sicherheit › Persönliche API-Tokens, Verwendung MCP (KI-Assistenten)
API-Benutzereinen gemeinsamen Assistenten mit fest definierten Rechten, z. B. „KI-Assistent“API-Benutzer in der Benutzerverwaltung anlegen und Rechte sowie Unternehmenszuordnung festlegen

Andere Schlüssel, zum Beispiel ein persönliches OData- oder REST-API-Token, nimmt der MCP-Server nicht an.

Verbindung einrichten

Tragen Sie im KI-Assistenten bzw. MCP-Client einen entfernten MCP-Server (Remote MCP Server, Streamable HTTP) mit diesen Angaben ein:

AngabeWert
Adressehttps://<Ihre-FLOWWER-Kontokennung>.flowwer.de/api/mcp
AuthentifizierungHeader Authorization: Bearer <Token>

Wo das Token eingetragen wird, hängt vom jeweiligen Client ab. Eine Anmeldung per OAuth ist derzeit nicht vorgesehen; das Token wird also im Client hinterlegt.

Was der Assistent abfragen kann

FLOWWER stellt dem Assistenten folgende Werkzeuge bereit. Der Assistent wählt sie selbst passend zur Frage aus.

WerkzeugZweck
search_documentsDokumente suchen, z. B. per Volltext (auch im OCR-Text), Rechnungsnummer, Betrag, Lieferant oder Freigabestatus
get_documentDetails eines Dokuments mit Freigabestatus, Freigaben und offenen Freigebern
list_waiting_documentsDokumente in der Freigabe, die am längsten wartenden zuerst, mit Wartetagen und den Benutzern, die noch freigeben können
get_document_statisticsAuswertungen mit Anzahl und Summen je Gruppe, bis zu drei Ebenen (z. B. Lieferant › Monat oder Kostenstelle)
get_query_catalogÜbersicht der Filtermöglichkeiten, Unternehmen, Flowws und benutzerdefinierten Datenfelder
query_documentserweiterte Abfragen, z. B. Betragsbereiche, Bezahlstatus, IBAN, Bestellnummer, benutzerdefinierte Datenfelder, auch mit ODER-Verknüpfung

Jedes Dokument im Ergebnis enthält einen Link, der es direkt in FLOWWER öffnet. Die Suche liefert höchstens 100 Dokumente je Abfrage; für Summen und Anzahlen nutzt der Assistent die Auswertung, die direkt in der Datenbank rechnet.

Die Bedeutung der Freigabestatus beschreibt das Glossar Freigabestatus; der MCP-Server verweist KI-Assistenten auf diese Seite.

Grenzen

  • Nur lesend: Änderungen, Freigaben und Ablehnungen sind über MCP nicht möglich.
  • Sichtbarkeit: Der Assistent sieht nur, was der Benutzer des Tokens sehen darf.
  • Bereinigte Dokumente sind nie enthalten.
  • Beträge stehen in der Dokumentwährung; Beträge verschiedener Währungen werden nie addiert. Gutschriften zählen in Auswertungen negativ.
  • Die Antworten des Assistenten beruhen auf diesen Daten, werden aber vom Sprachmodell formuliert. Prüfen Sie wichtige Angaben im verlinkten Dokument.

Datenschutz

Alles, was der Assistent über MCP abruft – zum Beispiel Lieferanten, Beträge, Rechnungsnummern oder Kommentare –, wird an den jeweiligen KI-Dienst übermittelt und dort verarbeitet. Prüfen Sie vor der Aktivierung, ob die Nutzung dieses Dienstes für Ihre Daten zulässig ist, insbesondere hinsichtlich Auftragsverarbeitung und Speicherort.

Ein Token lässt sich jederzeit widerrufen; wird der MCP-Server in den Systemeinstellungen deaktiviert, ist der Zugang sofort für alle gesperrt.

5 - API-Benutzer

FLOWWER sieht für technische Zugriffe auf die REST-API die Verwendung eines API-Benutzers vor.
Der API-Benutzer stellt automatisch einen API-Key zur Verfügung. Derselbe Key funktioniert auch für das OData-Reporting und den MCP-Server.

Für eigene Skripte oder die persönliche Excel-Auswertung eines Benutzers gibt es alternativ persönliche API-Tokens, die mit den Rechten dieses Benutzers arbeiten.

Vorteile

Sicherheits- und Audit-Logs

Da API-Benutzer separate Identitäten darstellen, kann ihre Nutzung in Protokollen leicht nachverfolgt und überwacht werden.
Dies erleichtert die Sicherheitsüberwachung und die Erkennung von Anomalien.

Organisation

Bewährte Praxis ist es, für jeden API-Zugreifenden (FLOWWER-Agent, FTP, InvoiceFetcher, etc.) einen eigenen API-Benutzer zu erstellen.

Langfristige API-Keys

Die API-Benutzer verwenden vom System vergebene API-Keys.
Diese sind dauerhaft gültig und somit für fortlaufende oder wiederkehrende Aufgaben ideal.

Eingeschränkte Berechtigungen

Das Konto kann so konfiguriert werden, dass es nur die für die jeweiligen API-Operationen erforderlichen Berechtigungen erhält.

Keine GUI-Abhängigkeit

API-Benutzer dürfen sich nicht an der FLOWWER-Benutzeroberfläche anmelden.
So ist sichergestellt, dass Integrationen nicht durch UI-Updates unterbrochen werden.

Minimierung menschlicher Interaktion

Da keine Benutzeroberfläche (UI) verwendet wird, gibt es weniger Möglichkeiten für Fehler oder unbefugten Zugriff durch menschliche Benutzer.

Vereinfachung

Der vergebene API-Key identifiziert den zugehörigen API-Benutzer eindeutig und ist in der FLOWWER-Benutzerverwaltung sichtbar.

Einrichtung

Zur Einrichtung: API-Benutzer

6 - Beispiele

Alle Endpunkte der REST-API mit Parametern und Beispielen finden Sie in der interaktiven API-Dokumentation Ihres FLOWWER-Kontos:

https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/swagger/

Dort können Sie Anfragen nach Klick auf Authorize auch direkt testen. Die Authentifizierung ist unter Sicherheit beschrieben.

Ausführliche Beispiele mit curl und C# enthält der Artikel Belegaufteilungen per API lesen und ersetzen. Für Dokumentmengen aus einem Filterpfad gibt es die Find-API für Filterpfade.

7 - Sicherheit

Die allermeisten Endpunkte der FLOWWER-API arbeiten im Kontext eines FLOWWER-Benutzers. Zur Authentifizierung wird ein Schlüssel im HTTP-Header X-FLOWWER-ApiKey des REST-Aufrufs übergeben:

X-FLOWWER-ApiKey: <API-Key>

Dafür gibt es zwei Arten von Schlüsseln:

SchlüsselGeeignet fürEinrichtung
API-Key eines API-BenutzersIntegrationen und dauerhafte technische Zugänge, z. B. FLOWWER-Agent, FTP oder InvoiceFetcherAPI-Benutzer in der Benutzerverwaltung
Persönliches REST-API-Tokeneigene Skripte eines Benutzers, mit allen Rechten dieses BenutzersPersönliche Einstellungen › Anmeldung / Sicherheit › Persönliche API-Tokens

Ein persönliches Token gilt 365 Tage und nur für die Verwendung, für die es erzeugt wurde. Für das OData-Reporting und den MCP-Server gibt es eigene Token-Arten mit nur lesendem Zugriff.