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 in diesem Untermenüpunkt. 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. Eine Zubuchung ist nicht erforderlich, die Schnittstelle wird lediglich aktiviert.
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 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 ist in allen Produktlinien enthalten. Eine Zubuchung ist nicht erforderlich, die Schnittstelle wird lediglich aktiviert.
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 bietet er ausschließlich die Konnektoren der Kategorie Human Resources an. Tidely ist ab ZEP Operations 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.