Zu Content springen
Deutsch
Kontakt
e2n.de
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Deine Daten, Deine Auswertungen: e2n mit der e2n API anbinden

Ob Power BI, Warenwirtschaft oder KI-Assistent: Mit der e2n API rufst Du Deine e2n Daten direkt in Deinen eigenen Systemen ab.

 

Das Wichtigste in Kürze:

  • Über die e2n API rufst Du Deine eigenen e2n Daten maschinenlesbar ab, zum Beispiel Arbeitszeiten, Schichten und Umsätze.
  • Du aktivierst die e2n API selbst im e2n Manager. Dein API Key funktioniert sofort.
  • Für jedes System legst Du einen eigenen API Key an und gibst nur die Endpunkte und Felder frei, die es braucht. Bis zu 10 API Keys sind dabei.
  • Die e2n API kostet 100 Euro im Monat zzgl. MwSt. Die Abrechnung beginnt am 1. des Folgemonats. Eine Mindestlaufzeit gibt es nicht.
  • Die e2n API liest Daten. Daten nach e2n schreiben kannst Du damit nicht.
  • Die e2n API ist aktuell nur in Deutschland verfügbar.

 

Inhalt:

1 Was ist die e2n API?

2 Wofür Du die e2n API nutzen kannst

3 e2n API aktivieren

4 API Key anlegen

5 Welche Standorte übertragen werden

6 Preis und Abrechnung

7 e2n API deaktivieren

8 Du nutzt noch den BI Connector?

9 Sicherheit

10 Hilfe und Kontakt

 

 

1 Was ist die e2n API?

Die e2n API ist eine Schnittstelle, über die Du Deine e2n Daten in andere Systeme überträgst. Technisch ist sie eine REST-API, die Daten im Format JSON ausgibt.

Abrufen kannst Du unter anderem:

  • Mitarbeitende
  • Arbeitszeiten
  • Abwesenheiten
  • Schichten
  • Umsätze

Die Daten sind über eindeutige IDs miteinander verknüpft, zum Beispiel standortUID und mitarbeiterUID. So kannst Du sie in Deinem System sauber zusammenführen. Alle Endpunkte und Felder findest Du in der API-Dokumentation.

 

2 Wofür Du die e2n API nutzen kannst

Mit der e2n API baust Du Dir eigene Auswertungen oder verbindest e2n mit Deinen eigenen Systemen. Dafür brauchst Du heute nicht mehr unbedingt eine eigene IT. Viele nutzen dafür auch ihr bevorzugtes KI-Tool. Ein paar Beispiele:

  • Auswertungen in Power BI: Eine Unternehmen mit 40 Filialen lädt über die e2n API jede Nacht Arbeitszeiten und Ist-Umsätze in Power BI und vergleicht so die Produktivität aller Standorte.
  • Eigenes Data Warehouse: Ein Hotel führt die Personalstunden aus e2n mit seinen Belegungsdaten zusammen und plant so die Housekeeping-Stunden je belegtem Zimmer.
  • KI-Assistent: Die Geschäftsführung einer Bäckerei fragt ihren KI-Assistenten, wer letzte Woche die meisten Krankheitstage hatte. Der Assistent holt sich die Daten direkt über die e2n API.
  • Warenwirtschaft: Ein Restaurant gibt seiner Warenwirtschaft einen eigenen API Key, der nur Schichten und Umsätze sieht, und plant damit die Bestellmengen.

 

3 e2n API aktivieren

  1. Öffne Benutzername oben rechts > Verwaltung > REST API > Zur neuen e2n API:

  2. Klicke auf e2n API aktivieren.
  3. Wähle den bestehenden e2n Vertrag aus, über den die e2n API abgerechnet werden soll.
  4. Bestätige die Aktivierung.


Die e2n API ist jetzt sofort nutzbar. Du bekommst automatisch eine Bestellbestätigung per E-Mail. Darin stehen der Beginn der Abrechnung sowie Deine Vertrags- und Kundennummer.

ℹ️ Gut zu wissen:

Für die e2n API brauchst Du keinen eigenen Vertrag. Sie wird immer über einen bestehenden e2n Vertrag abgerechnet und gilt für Deinen gesamten Mandantenkreis.

 

4 API Key anlegen

Mit einem API Key greift ein System auf Deine Daten zu. Lege am besten für jedes System einen eigenen API Key an. So bestimmst Du genau, welches System welche Daten sieht.

  1. Öffne Benutzername oben rechts > Verwaltung > REST API > Zur neuen e2n API.
  2. Klicke auf das blaue Plus oben rechts.
  3. Gib dem API Key einen Namen, an dem Du das System erkennst, zum Beispiel „BI“ oder „Lohnbüro“.
  4. Wähle die Endpunkte und Felder aus, die dieses System lesen darf.
  5. Klicke auf Neuen API Key erstellen.

Der API Key funktioniert sofort. Hinterlege ihn in dem System, das die Daten abrufen soll.

Beispiel: Dein BI-System darf Arbeitszeiten sehen. Deine Warenwirtschaft bekommt einen eigenen API Key, der nur Umsätze sieht.

⚠️ Bitte beachte:

Behandle Deinen API Key wie ein Passwort. Wer ihn hat, sieht alle Daten, die Du für diesen API Key freigegeben hast. Hast Du den Verdacht, dass jemand Unbefugtes Deinen API Key kennt, lösche ihn sofort im e2n Manager und lege einen neuen an.

 

5 Welche Standorte übertragen werden

Ein API Key liefert die Daten aller Standorte Deines Mandantenkreises. Stillgelegte Standorte sind nie dabei.

Möchtest Du nur bestimmte Standorte abrufen, grenzt Du die Abfrage über die Bezirke ein.

💡 e2n Tipp:

Ausgeblendete Filialen sind nicht stillgelegt und werden deshalb mit übertragen. Möchtest Du geschlossene Filialen weglassen, ordne sie in e2n einem eigenen Bezirk zu, zum Beispiel „Alte Filialen“. Diesen Bezirk schließt Du dann in Deiner Abfrage aus.

 

6 Preis und Abrechnung

Die e2n API kostet 100 Euro im Monat zzgl. MwSt. Darin enthalten sind bis zu 10 API Keys. Wie viele davon Du nutzt, ändert nichts am Preis.

Abgerechnet wird über Deinen bestehenden e2n Vertrag, immer für ganze Monate im Voraus. Eine Mindestlaufzeit gibt es nicht.

Was passiert Abrechnung
Du aktivierst die e2n API. ab dem 1. des Folgemonats
Du deaktivierst die e2n API. Der laufende Monat ist bezahlt. Ab dem Folgemonat zahlst Du nichts mehr.
Du aktivierst die e2n API im selben Monat wieder. Die Abrechnung läuft ohne Unterbrechung weiter.

Beispiel

Datum Was passiert Abrechnung
15. November Aktivierung ab Dezember
10. Januar Deaktivierung Januar ist der letzte abgerechnete Monat.
20. Januar Erneute Aktivierung im selben Monat Die Abrechnung läuft ab Februar ohne Unterbrechung weiter.

ℹ️ Gut zu wissen:

Den Beginn der Abrechnung findest Du auch in Deiner Bestellbestätigung. Fragen zu Vertrag oder Rechnung beantwortet Dir unsere Buchhaltung unter buchhaltung@e2n.de.

 

7 e2n API deaktivieren

  1. Öffne Benutzername oben rechts > Verwaltung > REST API > Zur neuen e2n API.
  2. Klicke auf e2n API deaktivieren unten rechts.
  3. Oder lösche einzelne APIs aus Deiner Liste, die nicht benötigt werden.
  4. e2n zeigt Dir in einer Rückfrage das Abrechnungsende. Bestätige die Deaktivierung.

Die e2n API ist sofort deaktiviert. Deine API Keys bleiben erhalten, funktionieren aber nicht mehr. Du bekommst eine Bestätigung per E-Mail mit dem Abrechnungsende.

Brauchst Du die e2n API doch wieder, aktivierst Du sie einfach erneut.

 

8 Du nutzt derzeit den BI Connector?

Die e2n API löst den bisherigen BI Connector ab. Statt vieler Einzellösungen gibt es jetzt einen Standard für alle.

BI Connector e2n API
Einrichtung individuell über e2n selbst im e2n Manager, sofort nutzbar
Mehrere Systeme pro System ein eigener Connector pro System ein eigener API Key
Abfrage ein API Key pro Standort ein API Key für den ganzen Mandantenkreis
Verknüpfung teils über Namen und Personalnummern über eindeutige IDs
Zukunft läuft aus wird für alle weiterentwickelt

Dein BI Connector läuft noch bis zum 31. März 2027. Wir kommen rechtzeitig mit dem genauen Ablauf der Umstellung auf Dich zu. Möchtest Du schon früher umsteigen, melde Dich gern bei uns.

ℹ️ Gut zu wissen:

In Österreich und der Schweiz ist die e2n API noch nicht verfügbar. Dort nutzt Du weiterhin den BI Connector, auch über den 31. März 2027 hinaus.

 

9 Sicherheit

  • Zugriff gibt es nur mit einem gültigen API Key und über verschlüsselte Verbindungen.
  • Deine Daten werden in Deutschland gehostet.
  • Jeder Zugriff wird 90 Tage protokolliert.
  • Du bestimmst pro API Key selbst, welche Endpunkte und Felder freigegeben sind.

 

10 Hilfe und Kontakt