Schnittstellen
Drei Wege führen von außen an die Daten. Zwei davon stehen Kunden offen, der dritte ist dem Betrieb der Plattform vorbehalten.
Was geht damit?
Die Kunden-API liest und schreibt Beschäftigte, Objekte, Abwesenheiten und die ausgewertete Arbeitszeit. Typische Fälle sind der Export in die Lohnbuchhaltung und der Abgleich der Liegenschaften mit dem Verwaltungsprogramm. Die MCP-Schnittstelle bindet Claude oder ChatGPT mit den Rechten der angemeldeten Person an. Die onOffice-Anbindung liest die Immobilien einmal täglich, nur lesend.
| Weg | Wofür | Anmeldung |
|---|---|---|
| Kunden-API `/api/v1` | Fremdsysteme: Lohnbuchhaltung, Controlling, Terminals, Verwaltungsprogramm | Schlüssel je Firma |
| MCP `/api/mcp` | KI-Werkzeuge wie Claude und ChatGPT | persönliches Token oder OAuth |
| Plattform-API | nur der Betreiber: Mandanten anlegen und verwalten | Plattform-Token |
- Schlüssel je Firma
Kunden-API
REST, Schlüssel je Firma, 14 Endpunkte. OpenAPI-Datei offen abrufbar.
- persönliches Token oder OAuth
KI-Zugriff (MCP)
Connector statt Token, eigene Rechte statt Vollzugriff, beschnittene Personaldaten.
Warum das hier offen steht
Wer prüft, ob eine Anbindung überhaupt geht, soll das in fünf Minuten beantworten können und nicht erst einen Zugang beantragen müssen. Aus demselben Grund liegt die maschinenlesbare Beschreibung nach OpenAPI 3.1 ohne Schlüssel offen: openapi.json. Ein Client lässt sich daraus erzeugen, bevor der erste Schlüssel existiert.
Was keine Schnittstelle herausgibt
Bankverbindung, Sozialversicherungsnummer, Steuer-ID, Notfallkontakt und Homeoffice-Koordinaten gehen über keinen dieser Wege nach außen. Über MCP kommen zusätzlich Stundenlohn, private Kontaktdaten und das rohe Geburtsdatum nicht heraus, nur das Kennzeichen, ob jemand minderjährig ist. Daran hängen arbeitszeitrechtliche Regeln.
Anbindung geplant?
Sagen Sie uns, welches Zielsystem gefüttert werden soll. Wir sagen Ihnen, ob die vorhandenen Endpunkte reichen.
Antwort innerhalb eines Werktags. Danach ein Testzugang mit Ihren eigenen Objekten.