Die Box Schnittstellen in der Administration bündelt die technischen Anbindungen Ihrer ZEP-Instanz. Sie umfasst vier Untermenüpunkte: die DATEV-Konfiguration, die SOAP-Schnittstelle, die REST-Schnittstelle sowie den Schnittstellen Marktplatz. Alle vier Untermenüpunkte stehen in allen Produktlinien zur Verfügung.
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.
In diesem Untermenüpunkt legen Sie die Authentifizierungs-Methode (Digest, Basic oder Token), die optionale IP-Beschränkung und den automatischen Versand der Zugangsdaten an Mitarbeitende fest. Eine vollständige Beschreibung aller Felder und der Entwickler-Dokumentation finden Sie im Artikel ZEP-Schnittstellen.
Hinweis: Die SOAP-Schnittstelle ist in allen Produktlinien enthalten und sofort nutzbar.
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.
In diesem Untermenüpunkt sehen Sie die Base URL und den Bearer Token, mit dem sich jede Anfrage authentifiziert, und kopieren beide. Bei Bedarf erzeugen Sie über Bearer Token neu generieren einen neuen Token. 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 ist in allen Produktlinien enthalten und sofort nutzbar.
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.
Die einzelnen Drittsystem-Anbindungen sind pro Themenbereich in eigenen Kollektionen dokumentiert:
Hinweis: Der Schnittstellen Marktplatz ist in allen Produktlinien verfügbar. In ZEP Clock zeigt er die Konnektoren der Kategorie Human Resources. Die DATEV-Anbindung erreichen Sie dort über den Untermenüpunkt DATEV. finAPI, Lexware Office und Tidely sind in ZEP Operations und ZEP Business enthalten. Einen Konnektor aktivieren Sie vor der ersten Nutzung, zusätzlich ist die jeweilige Drittsystem-Lizenz beim Anbieter Voraussetzung. Konnektoren, die noch in Vorbereitung sind, tragen im Marktplatz das Kennzeichen Coming Soon und werden auf Anfrage über den Support freigeschaltet.
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. Die Buchhaltungs-Übergabe steht in ZEP Operations und ZEP Business zur Verfügung, weil sie den Bereich Export für Buchhaltung voraussetzt. Die Lohnabrechnung steht davon unabhängig zur Verfügung.
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 allen Produktlinien verfügbar. Ab ZEP Operations gehört die DATEV-Anbindung zusätzlich zum Bereich Export für Buchhaltung. In den übrigen Produktlinien steht sie unabhängig davon zur Verfügung.