DEVELOPERS / INTEGRATIONEN

Gute Arbeit.
Gut verbunden.

Einsätze entstehen nicht im luftleeren Raum. Wir denken darüber nach, wie Vororto künftig mit den Werkzeugen zusammenarbeiten kann, die deinen Betrieb heute schon begleiten.

WO VERBINDUNGEN HELFEN KÖNNTEN

Weniger doppelt pflegen.
Mehr zusammenbringen.

Drei denkbare Integrationen für den Alltag. Noch nicht umgesetzt; konkrete Anforderungen bestimmen den nächsten Schritt.

01 / STAMMDATEN

Aus einem Auftrag
wird ein Einsatz.

Kunden, Objekte und Aufgaben aus einem bestehenden System übernehmen. Vor einer Umsetzung müssen Zuständigkeit, Datenabgleich und Konflikte zwischen Änderungen klar geregelt sein.

02 / NACHWEISE

Der Abschluss
geht weiter.

Bestätigte Berichte als Grundlage für nachgelagerte Abläufe nutzen. Denkbar ist eine Übergabe an Dokumentenverwaltung oder Auftragssoftware, mit kontrolliertem Zugriff auf das Original.

03 / EREIGNISSE

Reagieren, wenn
etwas erledigt ist.

Andere Systeme über einen abgeschlossenen Vorgang informieren. Denkbar sind überprüfbare Ereignisse mit Wiederholungslogik, damit ein Übertragungsfehler keine doppelte Verarbeitung auslöst.

EIN BLICK AUF DAS DATENMODELL

Ein Einsatz.
Ein verständlicher
Zusammenhang.

Arbeitszeit, Leistung und Bestätigung gehören zum selben Vorgang. Eine mögliche Schnittstelle sollte diesen Zusammenhang erhalten, statt lose Dateien und Datensätze zu erzeugen.

Das Beispiel ist frei illustriert. Feldnamen und Struktur sind kein freigegebenes Schema und können sich vollständig ändern. Es enthält keine echten Kunden- oder Zugangsdaten.

ILLUSTRATIVES DATENOBJEKTJSON
{
  "example": true,
  "job": {
    "reference": "MUSTER-001",
    "service": "Fenster prüfen und einstellen",
    "workedMinutes": 84
  },
  "report": {
    "status": "confirmed",
    "confirmationMethod": "signature",
    "document": {
      "type": "application/pdf",
      "access": "authenticated"
    }
  }
}
TECHNISCHE LEITLINIEN

Verbindungen brauchen
klare Grenzen.

Die folgenden Prinzipien sollen eine mögliche öffentliche Schnittstelle leiten. Sie sind noch kein verbindlicher API-Vertrag.

Zugriff mit klarem Umfang.

Eine Integration sollte nur die Daten lesen oder ändern dürfen, die für ihren Zweck erforderlich sind. Berechtigungen, Zuordnung zum Arbeitsbereich und Widerruf müssen ausdrücklich geregelt werden.

02

Wiederholen ohne Duplikate.

Netzwerkfehler gehören zum Alltag. Idempotente Schreibvorgänge können verhindern, dass derselbe Auftrag durch einen erneuten Versuch zweimal angelegt wird.

03

Änderungen nachvollziehbar halten.

Versionierung, Konflikterkennung und verständliche Fehlermeldungen sollen helfen, parallele Änderungen sicher zu behandeln. Ein bestätigter Nachweis darf dabei nicht stillschweigend verändert werden.

04

Private Dokumente bleiben privat.

Berichte benötigen einen kontrollierten Zugriff. Das heutige Produkt archiviert Original-PDFs ohne öffentliche Downloadtokens. Eine künftige Integration muss dieses Schutzprinzip bewahren.

VON DER IDEE ZUR INTEGRATION

Mit einem echten
Anwendungsfall anfangen.

  1. 01

    Bedarf verstehen.

    Welches System nutzt du? Welche Daten sollen wann und in welche Richtung fließen?

  2. 02

    Umfang definieren.

    Berechtigungen, Datenzuordnung und Fehlerfälle gemeinsam beschreiben, bevor eine Verbindung gebaut wird.

  3. 03

    Umsetzung bewerten.

    Machbarkeit und Priorität prüfen. Eine Anfrage ist noch keine Zusage für Entwicklung oder einen Termin.

ENTWICKLERFRAGEN

Der aktuelle
Stand.

Wo bekomme ich einen API-Schlüssel?

Derzeit werden keine API-Schlüssel ausgegeben. Es gibt noch keine öffentliche Entwicklerplattform. Schreib uns, wenn du einen konkreten Integrationsbedarf hast.

Sind Webhooks oder ein SDK verfügbar?

Nein. Ereignisbasierte Integrationen, Webhooks und ein Entwickler-SDK sind mögliche zukünftige Themen. Es gibt dafür aktuell weder einen veröffentlichten Funktionsumfang noch einen verbindlichen Zeitplan.

Kann ich die internen App-Schnittstellen verwenden?

Die internen Schnittstellen unterstützen die Vororto-App und sind kein öffentlich unterstützter Integrationsvertrag. Für externe Integrationen gibt es derzeit keine dokumentierte oder freigegebene Anbindung.

Welche Informationen helfen bei einer Anfrage?

Nenne dein bestehendes System, den gewünschten Ablauf und die benötigten Datenarten. Sende uns dabei bitte keine Zugangsdaten oder echten Kundenunterlagen. Ein anonymisiertes Beispiel genügt für das erste Gespräch.

DEIN SYSTEM. DEIN ABLAUF.

Was soll mit
Vororto sprechen?

Eine konkrete Aufgabe ist ein guter Anfang. Erzähl uns, wo heute Daten doppelt erfasst werden und wie ein besserer Ablauf für dich aussehen würde.

Anwendungsfall besprechen Zum heutigen Funktionsumfang