Die Schnittstelle, über die Anwendungen anderer Anbieter auf das Dokumentenmanagement Ihrer Kanzlei zugreifen: suchen, auflisten, hochladen, herunterladen, umlegen. Ohne Firewall-Öffnung.
Documents API
Die Schnittstelle, über die Anwendungen anderer Anbieter auf das Dokumentenmanagement Ihrer Kanzlei zugreifen: suchen, auflisten, hochladen, herunterladen, umlegen. Ohne Firewall-Öffnung.
Septeo CNEE
plus VAT
Die Documents API by Septeo ist die Schnittstelle, über die Anwendungen anderer Anbieter auf das Dokumentenmanagement Ihrer Kanzlei zugreifen: suchen, auflisten, hochladen, herunterladen, umlegen. Ihre Dokumente bleiben in Documents, Ihre Firewall bleibt geschlossen.
Lizenziert wird je Berufsträger, bei Insolvenzverwaltern je Insolvenzverwalter. Abgerechnet wird monatlich.
Starten Sie mit einer fertigen Anbindung. Die Lizenz wird nur zusammen mit einem bestimmten Partnerprodukt verkauft, heute Beamon.ai, bezogen über Septeo, und funktioniert ausschließlich mit diesem. Kommt später ein weiteres System dazu, wechseln Sie jederzeit auf die Volllizenz.
Binden Sie an, was Sie brauchen. Keine Begrenzung für das einzelne System oder deren Anzahl, eigene Anwendungen können Sie selbst in Ihrem Tenant registrieren. Eine Zustimmung von Septeo ist nicht erforderlich.
Einmalige Einrichtungspauschale 380 € (Installation des Connectors, Einrichtung der API und kurze Beratung, ohne Downtime). Ein vorab nötiges Documents-Update ist mit der Pauschale abgedeckt. Inklusive 50 GB Up- und Download je Berufsträger und Monat. Voraussetzung sind ein Tenant in der STP Cloud und Documents ab Version 8.8.16. Die Lizenz wird als Ergänzungsvertrag zum Documents-Vertrag abgeschlossen. Vertragslaufzeit 12 Monate. Alle Preise zzgl. MwSt.; Stand Oktober 2026, Änderungen vorbehalten.
Neue Anwendungen nehmen Ihrem Team Arbeit ab: KI-gestützte Dokumentenanalyse, Prüfungen, Auswertungen. Damit sie etwas bringen, brauchen sie Zugriff auf Ihre Dokumente. Die Documents API gibt ihn, ohne dass Sie Ihre Firewall öffnen müssen.
Wählen Sie die Systeme aus, die Ihnen helfen, statt zu warten, was Ihr Hersteller als Nächstes anbietet. Mit der Volllizenz gibt es keine Begrenzung, weder für das einzelne System noch für deren Anzahl.
Ein eingehender Port wird nicht benötigt, Ihre Firewall bleibt unverändert. Was sonst ein Change-Request und eine Sicherheitsdiskussion ist, ist hier eine Installation.
Was die angebundene Anwendung produziert, geht dorthin zurück, wo Sie es erwarten, bis in das richtige Register. Kein Sammelordner, kein Hin- und Herschieben von Dateien.
Die Dokumente liegen hinter Ihrer Firewall. Die Werkzeuge arbeiten in der Cloud. Die Documents API schafft dazwischen den vierten Weg: von innen nach außen.
Dokumente exportieren und Ergebnisse von Hand wieder einlegen
Einen Zugang von außen einrichten lassen, mit Change-Request und Sicherheitsdiskussion
Ein Connector in Ihrer Kanzlei baut die Verbindung nach außen auf, Ergebnisse landen in der Akte
Die angebundene Anwendung ruft die Cloud-Schnittstelle auf. Die STP Cloud prüft Lizenz und Berechtigungen und reicht den Auftrag an den Connector in Ihrer Kanzlei weiter. Der führt ihn im lokalen Documents aus und schickt das Ergebnis zurück. Der Connector baut nur ausgehende Verbindungen auf (HTTPS und MQTT über WebSocket, jeweils Port 443). Dateiinhalte laufen über befristete Upload- und Download-Adressen.
Ruft die API per HTTPS mit Zugriffstoken auf (OAuth 2.0).
Prüft Lizenz und Berechtigungen und vermittelt den Auftrag.
Führt den Auftrag in Documents aus. Nur ausgehende Verbindungen auf Port 443.
Die Schnittstelle ist bewusst schlank gebaut und wächst schrittweise. Heute deckt sie das Suchen, Auflisten, Hochladen, Herunterladen und Umlegen von Dokumenten ab, in beliebiger Dateigröße und bis in das richtige Register einer Akte.
containerfiling-traydocumentcontainerdocumentdocumentdocumentdocumentoperationLesen und Schreiben auf Akten, Registern und Dokumenten Ihres Dokumentenmanagements.
| Bereich | Das deckt die API ab | Methoden |
|---|---|---|
| Akten und Ordner | Suchen nach Name, Aktenzeichen oder Suchbegriff · seitenweises Durchblättern ohne Filter · Inhalte einer Akte oder eines Ordners auflisten | GET |
| Register | Registerstruktur einer Akte lesen · Dokumente eines Registers abrufen, auf Wunsch rekursiv | GET |
| Dokumente | Hochladen über befristete Upload-Adresse und Importauftrag · Herunterladen inkl. PDF-Vorschau und Versionen · neue Version einstellen · Dokument in andere Akte oder anderes Register umlegen | GETPOSTPUT |
| Vorgänge | Status asynchroner Aufträge abfragen (ausstehend, erfolgreich, fehlgeschlagen, mehrdeutig) · Idempotency-Key gegen doppelte Ausführung | GET |
| Betrieb | Verbindungszustand des Connectors Ihrer Kanzlei abfragen | GET |
Stand August 2026. Der Funktionsumfang wächst schrittweise, Änderungen vorbehalten. Die Dateigröße ist nicht begrenzt. Zugriffe, die das Dokumentenmanagement aus Rechtegründen ablehnt, antworten in der Regel mit 404 NOT_FOUND, damit nicht erkennbar ist, ob ein Dokument existiert.
Für Documents-Kanzleien und ihre Integrationspartner. Nennen Sie uns die Zahl der Berufsträger und die Anwendung, die Sie anbinden möchten. Wir melden uns mit einem Vorschlag zur Lizenzvariante und zum Einrichtungstermin.
Sie beschreiben, welche Anwendung angebunden werden soll und wer die Anbindung baut. Wir wählen mit Ihnen die passende Lizenzvariante.
Wir legen Ihren Tenant an, Sie oder unser Service installieren den Connector in Ihrer Kanzlei. Ihr Administrator weist den handelnden Konten die passende Rolle zu.
Die Anbindung baut, wer Ihnen am nächsten ist: Ihre IT, Ihr IT-Dienstleister, der Hersteller der Anwendung oder Septeo. Für Beamon.ai ist sie fertig.
Die Verbindung wird von innen nach außen aufgebaut. Ein eingehender Port ist nicht erforderlich.
Jeder Zugriff läuft im Namen eines Benutzers. Was dieser in Documents sehen und ändern darf, bestimmt weiter Ihre Berechtigungsverwaltung.
Die STP Cloud läuft bei AWS ausschließlich in der Region des Kunden, Deutschland oder Schweiz. Eine Übertragung in Drittländer findet nicht statt.
Der Zugriff eines Partners erfolgt in Ihrem Auftrag auf Grundlage eines Dienstleistungsvertrags nach § 43e BRAO in Textform, ergänzt um einen Auftragsverarbeitungsvertrag.
REST mit JSON, Anmeldung per OAuth 2.0 (Authorization Code mit PKCE) gegen die STP Cloud. Eigene Anwendungen werden im Identity Admin Ihres Tenants registriert und erhalten eine Client-ID und ein Client Secret.
Documents ab Version 8.8.16 und ein Tenant in der STP Cloud. Der Connector ist installiert, angemeldet und mit dem Dokumentenmanagement verbunden.
Rolle DmsCloudApi.ConnectorBenutzerkonten erhalten über Gruppen die Rolle zum Lesen und Ablegen oder nur zum Lesen. Das Cloud-Konto wird mit dem Documents-Benutzer verknüpft.
DmsCloudApi.User · DmsCloudApi.User.ReaderEmpfohlen ist der durchgereichte Benutzer: Jede Person meldet sich mit dem eigenen STP-Konto an, die Aktenhistorie zeigt, wer gehandelt hat. Für automatisierte Abläufe gibt es ein technisches Konto.
Token per OAuth 2.0 abholen und Endpunkte aufrufen. Download-Adressen werden je Abfrage neu erzeugt und sind etwa 15 Minuten gültig. Für produktive Integrationen sind Wiederholungen bei 429, 502, 503 und 504 vorgesehen.
Scope dms.cloud.api.standaloneDie vollständige Endpunktreferenz und die Fehlercodes erhalten Sie auf Anfrage.
Ja. Anbinden kann Ihre eigene IT, Ihr IT-Dienstleister, der Hersteller der Anwendung, die Sie einsetzen wollen, oder Septeo. Für Beamon.ai gibt es die Anbindung schon fertig.
Nein. Sie installieren eine kleine Verbindungskomponente, die die Verbindung von innen nach außen aufbaut. Ein eingehender Port wird nicht benötigt.
Der Zugriff erfolgt in Ihrem Auftrag und Ihrem Verantwortungsbereich. Grundlage ist ein Dienstleistungsvertrag nach § 43e BRAO in Textform, ergänzt um einen Auftragsverarbeitungsvertrag. Der Dienstleister verpflichtet sich darin zur Verschwiegenheit und beschränkt seinen Zugriff auf das für seine Leistung Erforderliche.
Dann beginnen Sie mit dem Partner-Bundle, für Beamon.ai inklusive fertiger Anbindung. Kommt später ein weiteres System dazu, wechseln Sie jederzeit auf die Volllizenz ohne Begrenzung.
Es gibt keine technische Grenze für Anzahl oder Größe. Im Preis enthalten sind 50 GB je Berufsträger und Monat. Wird dieses Volumen drei Monate in Folge überschritten, passen wir den Vertrag gemeinsam an.
Documents ab Version 8.8.16 sowie einen Tenant in der STP Cloud. Das Update kann Ihre IT selbst durchführen oder unser Service übernimmt es im Rahmen der Einrichtungspauschale.
