Zum Hauptinhalt springen

Schnittstellen – Administration

SOAP-Schnittstelle, REST-Schnittstelle, Schnittstellen Marktplatz und DATEV — zentrale technische Anbindungen der Administration.

Verfasst von Gideon Weller

Die Box Schnittstellen in der Administration aktiviert die zentralen technischen Anbindungen Ihrer ZEP-Instanz. Sie umfasst vier Untermenüpunkte: die SOAP-Schnittstelle, die REST-Schnittstelle, den Schnittstellen Marktplatz sowie die DATEV-Konfiguration. Welche Untermenüpunkte sichtbar sind, hängt von den aktiven Modulen und der Produktlinie Ihrer Instanz ab.

SOAP-Schnittstelle

Über die SOAP-Schnittstelle öffnet ZEP eine XML-basierte Web-Service-Schnittstelle, mit der externe Systeme Stammdaten, Zeitbuchungen, Projekte und weitere Inhalte programmatisch lesen oder schreiben können. SOAP ist die ältere der beiden ZEP-Schnittstellen und wird häufig für serverseitige Integrationen mit bestehenden Backend-Systemen eingesetzt.

Die Konfiguration der Adresse der Schnittstelle, der Authentifizierungs-Methode (Digest, Basic oder Token), der optionalen IP-Beschränkung sowie der automatischen Versand-Logik für Mitarbeitenden-Zugangsdaten erfolgt im Untermenüpunkt. Eine vollständige Beschreibung aller Felder und der Entwickler-Dokumentation finden Sie im Artikel ZEP-Schnittstellen.

Hinweis: Die SOAP-Schnittstelle wird über das Zusatzmodul ZEP-Schnittstellen aktiviert. Verfügbar in ZEP Clock, ZEP Compact und ZEP Professional nach Hinzubuchung über das ZEP Self-Service-Tool.

REST-Schnittstelle

Über die REST-Schnittstelle öffnet ZEP eine moderne webbasierte Schnittstelle, die sich besonders für Web- und Mobil-Anwendungen sowie für die Anbindung von Cloud-Diensten eignet. Sie ist über eine OpenAPI-Spezifikation maschinenlesbar beschrieben und für neue Integrationen die empfohlene Schnittstelle.

Im Untermenüpunkt verwalten Sie die Adresse der Schnittstelle und den Bearer-Token zur Authentifizierung jeder Anfrage. Eine vollständige Beschreibung der Felder, der Spezifikation und Hinweise für Entwicklerinnen und Entwickler finden Sie im Artikel ZEP-Schnittstellen sowie im darin verlinkten ZEP Developer Hub.

Hinweis: Die REST-Schnittstelle wird über das Zusatzmodul ZEP-Schnittstellen aktiviert. Verfügbar in ZEP Clock, ZEP Compact und ZEP Professional nach Hinzubuchung über das ZEP Self-Service-Tool.

Schnittstellen Marktplatz

Im Schnittstellen Marktplatz aktivieren Sie fertig vorbereitete Konnektoren für gängige Drittsysteme — beispielsweise für HR-Software, CRM-Werkzeuge oder Ticket-Tools. Pro Konnektor hinterlegen Sie die Zugangsdaten oder eine OAuth-Verbindung zum jeweiligen Drittsystem. Nach Aktivierung läuft der Datenaustausch automatisch im Hintergrund.

Welche Konnektoren aktuell verfügbar sind, hängt von Ihrer ZEP-Version und vom Marktplatz-Angebot ab. Die einzelnen Drittsystem-Anbindungen sind pro Themenbereich in eigenen Kollektionen dokumentiert:

Hinweis: Der Schnittstellen Marktplatz ist in ZEP Clock, ZEP Compact und ZEP Professional verfügbar. Jeder Konnektor muss vor der Aktivierung über das ZEP Self-Service-Tool lizenziert werden; zusätzlich ist die jeweilige Drittsystem-Lizenz beim Anbieter Voraussetzung.

DATEV

Im Untermenüpunkt DATEV öffnet ZEP das zentrale DATEV-Dashboard für die Anbindung Ihrer Instanz an die DATEV-Cloud beziehungsweise an DATEV Online. Über das Dashboard autorisieren Sie die OAuth-Verbindung zwischen ZEP und Ihrem DATEV-Konto einmalig und schalten anschließend die zu nutzenden DATEV-Dienste frei. Die Anbindung deckt zwei fachliche Bereiche ab:

  • Buchhaltung — Übergabe von Belegen, Buchungssätzen, Debitoren-, Kreditoren- und Stammdaten an DATEV (Buchhaltungs-Übergabe). Die Pflege der Konten, Kostenstellen und das Mapping erfolgt im Untermenüpunkt Export für Buchhaltung der Administration. Eine vollständige Beschreibung finden Sie in der Kollektion Export für Buchhaltung.

  • Lohnabrechnung — Synchronisation der Mitarbeiterstammdaten aus DATEV nach ZEP sowie Übergabe der Arbeitsstunden und Abwesenheiten von ZEP an die DATEV-Dienste Lohnimportdatenservice und Lohnergebnisdatenservice. Eine ausführliche Beschreibung der Einrichtung beschreibt der Artikel DATEV LODAS und Lohn und Gehalt.

Hinweis: Der Untermenüpunkt DATEV ist in ZEP Clock, ZEP Compact und ZEP Professional verfügbar. In ZEP Professional ist die DATEV-Anbindung enthalten, sobald der Bereich Export für Buchhaltung aktiv ist. In ZEP Clock und ZEP Compact wird die Schnittstelle als Zusatzmodul über das ZEP Self-Service-Tool zugebucht.

Hat dies deine Frage beantwortet?