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.
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:
HR und Lohnabrechnung — Personio, HR WORKS, Sage HR, Zoho People, DATEV LODAS, Taxmaro
CRM und Vertrieb — HubSpot, Salesforce
Issue- und Ticket-Tracking — Jira, Linear, Memtime
Hinweis: Der Schnittstellen Marktplatz ist in allen Produktlinien verfügbar. Die Konnektoren sind enthalten und werden vor der Nutzung aktiviert. 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. 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.