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.
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 BenutzersGET, 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
- Öffnen Sie die Filterseite.
- Wählen Sie die benötigten Merkmale und Werte aus.
- Prüfen Sie die Ergebnisliste in FLOWWER.
- Ü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
- Fachlichen Filter in FLOWWER zusammenstellen und testen.
- Filterpfad in die eigene Integration übernehmen.
- Find-API mit den Zugangsdaten eines geeigneten API-Benutzers aufrufen.
- 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.
Beta
Das OData-Reporting befindet sich in der Beta-Phase. Spalten können ergänzt werden; bestehende Abfragen bleiben in der Regel lauffähig.
Datenmengen
| Menge | Eine Zeile je | Geeignet für |
|---|
Documents | Dokument | Übersichten nach Lieferant, Betrag, Status, Fristen oder Bezahlstatus |
ReceiptSplitLines | Position der Belegaufteilung | Auswertungen 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 Filterseite | Query-Parameter path oder Funktion GetDocumentsByPath bzw. GetReceiptSplitLinesByPath |
| Gespeicherte Suche | Query-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
| Ergebnisformat | Verwendung |
|---|
| Excel / Power BI: konkreter Feed + Basic Auth | In 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 + Header | Den 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 + Header | Wie oben, öffnet aber den gesamten Dienst; Quelle und Optionen werden nicht übernommen. |
| Direkte Feed-URI mit Token in der Query | Nur 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:
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:
| Zugang | Geeignet für | Einrichtung |
|---|
| Persönliches MCP-Token | den eigenen KI-Assistenten eines Benutzers | Persönliche Einstellungen › Anmeldung / Sicherheit › Persönliche API-Tokens, Verwendung MCP (KI-Assistenten) |
| API-Benutzer | einen 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:
| Angabe | Wert |
|---|
| Adresse | https://<Ihre-FLOWWER-Kontokennung>.flowwer.de/api/mcp |
| Authentifizierung | Header 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.
| Werkzeug | Zweck |
|---|
search_documents | Dokumente suchen, z. B. per Volltext (auch im OCR-Text), Rechnungsnummer, Betrag, Lieferant oder Freigabestatus |
get_document | Details eines Dokuments mit Freigabestatus, Freigaben und offenen Freigebern |
list_waiting_documents | Dokumente in der Freigabe, die am längsten wartenden zuerst, mit Wartetagen und den Benutzern, die noch freigeben können |
get_document_statistics | Auswertungen 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_documents | erweiterte 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üssel | Geeignet für | Einrichtung |
|---|
| API-Key eines API-Benutzers | Integrationen und dauerhafte technische Zugänge, z. B. FLOWWER-Agent, FTP oder InvoiceFetcher | API-Benutzer in der Benutzerverwaltung |
| Persönliches REST-API-Token | eigene Skripte eines Benutzers, mit allen Rechten dieses Benutzers | Persö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.