Datenexport – Schema

Schema-Version: 1.0

Der Kontoinhaber kann unter „Mein Konto“ alle Daten des Kontos als ZIP-Datei herunterladen. Die ZIP-Datei enthält eine README.txt, je Datenkategorie eine CSV-Datei, die Datei data.json mit allen Kategorien sowie die Datei schema.json mit der Beschreibung der Felder.

  • CSV: UTF-8 mit BOM, Trennzeichen Semikolon (;).
  • Datum: JJJJ-MM-TT, Uhrzeit: HH:MM, Zeitstempel: ISO 8601 (Europe/Berlin).
  • Boolesche Werte: true oder false.
  • Eine leere Zelle bedeutet: kein Wert.
  • Textzellen in CSV-Dateien, die mit = + - @ beginnen, erhalten ein vorangestelltes ' (Schutz vor Formeln in Tabellenkalkulationen).

Nicht enthalten sind: Passwörter, Zahlungs- und Stripe-Kennungen, Einladungslinks, Rechnungen (diese stellt Stripe bereit) sowie IP-Adresse und Browserkennung der Zustimmungsnachweise.

profiles.csv

Nutzerprofile des Kontos (Inhaber und Mitarbeiter, auch deaktivierte). Passwörter sind nicht enthalten.

Feld Typ Beschreibung
id integer Kennung des Profils
email text E-Mail-Adresse
first_name text Vorname
last_name text Nachname
role text Rolle: owner (Inhaber) oder staff (Mitarbeiter)
preferred_language text Spracheinstellung (de oder en)
subdivision text Arbeitsort (Bundesland-Kürzel)
work_weekends boolean Arbeitet am Wochenende
is_active boolean Profil ist aktiv (false = entfernt)
initial_leave_days decimal Urlaubsansatz im Eintrittsjahr (Tage)
annual_leave_days decimal Jährlicher Urlaubsanspruch (Tage)
created_at datetime Zeitpunkt der Erstellung

working_hours.csv

Erfasste Arbeitszeiten.

Feld Typ Beschreibung
profile_id integer Kennung des Profils (siehe profiles)
workday date Arbeitstag
time_arrived time Arbeitsbeginn (HH:MM)
time_departed time Arbeitsende (HH:MM)
lunch_duration_minutes integer Pausendauer in Minuten
submitted boolean Eintrag abgeschlossen
created_at datetime Zeitpunkt der Erstellung

leave.csv

Abwesenheiten: Jahresurlaub, Sonderurlaub und Krankmeldungen.

Feld Typ Beschreibung
id integer Kennung der Abwesenheit
profile_id integer Kennung des Profils (siehe profiles)
category text Kategorie: annual, special oder sick
date_start date Erster Tag
date_end date Letzter Tag
leave_type text full_day (ganztägig) oder half_day (halbtägig)
status text Status: pending, approved, denied, completed oder withdrawn
approved_by_profile_id integer Kennung des entscheidenden Profils
approved_at datetime Zeitpunkt der Entscheidung
created_at datetime Zeitpunkt der Erstellung

leave_year_balances.csv

Berechnete Urlaubssalden pro Profil und Jahr (Tage).

Feld Typ Beschreibung
profile_id integer Kennung des Profils (siehe profiles)
year integer Jahr
entitlement_days decimal Urlaubsanspruch
carried_over_days decimal Übertrag aus dem Vorjahr
carryover_used_days decimal Genommener Resturlaub
carryover_expired_days decimal Verfallener Resturlaub
annual_leave_taken_days decimal Genommener Jahresurlaub gesamt
current_year_used_days decimal Genommener Urlaub aus dem laufenden Jahr
remaining_days decimal Verbleibender Urlaub
calculated_at datetime Zeitpunkt der Berechnung

business_details.csv

Unternehmensdaten.

Feld Typ Beschreibung
name text Name des Unternehmens
local_tax_id text Steuernummer / USt-IdNr.
country text Land (ISO-Code)

account.csv

Kontostatus und Abonnement (ohne Zahlungsdaten und Rechnungen).

Feld Typ Beschreibung
account_status text Status: trial, active, grace, cancelled oder locked
subscription_plan text Plan-Schlüssel
trial_start_date datetime Beginn der Testphase
trial_end_date datetime Ende der Testphase
subscription_start_date datetime Beginn des Abonnements
current_period_end datetime Ende des aktuellen Abrechnungszeitraums
locked_at datetime Zeitpunkt der Sperrung
created_at datetime Zeitpunkt der Erstellung

invitations.csv

Einladungen an Mitarbeiter (ohne Einladungslink).

Feld Typ Beschreibung
email text E-Mail-Adresse der eingeladenen Person
status text Status: pending, accepted, expired oder revoked
invited_by_profile_id integer Kennung des einladenden Profils
expires_at datetime Gültig bis
created_at datetime Zeitpunkt der Erstellung

subdivision_history.csv

Verlauf des Arbeitsorts (Bundesland) pro Profil.

Feld Typ Beschreibung
profile_id integer Kennung des Profils (siehe profiles)
subdivision text Bundesland-Kürzel
effective_from date Gültig ab

work_weekends_history.csv

Verlauf der Einstellung zur Wochenendarbeit pro Profil.

Feld Typ Beschreibung
profile_id integer Kennung des Profils (siehe profiles)
work_weekends boolean Arbeitet am Wochenende
effective_from date Gültig ab