Prüfexport und Auskunft¶
Unter Zeiten → Prüfexport (und Einstellungen → Meine Daten) liegen zwei Exporte: der Prüfexport mit den Arbeitszeiten für eine Behörde und die Auskunft mit allem, was Soll über eine Person speichert.
Prüfexport¶
Zoll (Finanzkontrolle Schwarzarbeit, § 17 MiLoG, § 2a SchwarzArbG) und Arbeitsschutzbehörde (§ 16 Abs. 2 ArbZG, § 17 ArbZG) dürfen die Aufzeichnungen der Arbeitszeit verlangen. Der Prüfexport gibt sie für einen Zeitraum aus, als CSV für eine Tabelle und als PDF zum Ausdrucken, beide mit demselben Inhalt.
Wer was exportiert¶
| Wer | Was |
|---|---|
Inhaber, Planer, Lohnbüro (Recht zeiten:alle) |
alle Personen oder eine, auch wer den Betrieb verlassen hat |
| alle, die stempeln | die eigenen Tage |
| Externe | die eigenen Tage aus der Zeit, in der sie gestempelt haben |
Der Zeitraum geht vom ersten bis zum letzten Tag und umfasst höchstens zwei Jahre, so lange, wie die Aufzeichnungen aufzubewahren sind (§ 16 Abs. 2 ArbZG, § 17 Abs. 1 MiLoG). Die Seite beginnt mit dem Vormonat. Ist das Modul Arbeitszeit abgeschaltet, lehnt der Server den Prüfexport ab.
Der Prüfexport ist keine Auswertung je Person im Sinne von § 87 Abs. 1 Nr. 6 BetrVG: Er gibt die Aufzeichnungen aus, die das Gesetz verlangt, und rechnet keine Leistung oder Auslastung.
Inhalt¶
Eine Zeile je Person und Arbeitstag mit einer Stempelung, einer Änderung, einem Gegeneintrag oder einem Befund:
| Spalte | Inhalt |
|---|---|
| Person | Name des Kontos |
| Datum | der Arbeitstag, TT.MM.JJJJ; eine Nachtschicht gehört zum Tag, an dem sie beginnt |
| Beginn, Ende | Uhrzeit in Berlin; ein Ende an einem späteren Tag mit Datum; „offen“, solange eine Schicht kein Ende hat (Soll ergänzt nichts) |
| Pausen (Minuten), Dauer (Minuten) | ganze Minuten, wie auf dem Stundenzettel |
| Erfasst am | wann Soll die letzte Stempelung des Tages, so wie er jetzt steht, gespeichert hat: daran prüft die Behörde die sieben Tage des § 17 Abs. 1 MiLoG |
| Änderungen | jede Änderung von Hand: nachgetragen, geändert oder entfernt, von wem, wann, vorher und nachher, mit Grund; liegt eine Stempelung an einem anderen Tag als dem Arbeitstag der Zeile (das Gehen einer Nachtschicht, eine Stempelung, die auf einen anderen Tag oder in einen anderen Monat verschoben wurde), steht ihr Datum vor der Uhrzeit |
| Gegeneinträge | Korrekturen nach dem Abschluss mit Minuten, Grund, wer und wann |
| Befunde | mit Norm, z. B. „Verstoß: Ruhepause · § 4 ArbZG“ |
| Monat abgeschlossen, Prüfwert | für einen abgeschlossenen Monat Zeitpunkt und Prüfwert, sonst leer |
Ein abgeschlossener Monat erscheint so, wie er abgeschlossen wurde: genau das deckt sein Prüfwert. Mit dem Prüfwert prüft die Behörde auf der Prüfseite, ob der Monat seitdem unverändert ist. Das PDF (A4 quer, jede Person auf eigener Seite) listet unter der Tabelle die Änderungen, die Gegeneinträge und alle Monate des Zeitraums mit ihrem Prüfwert oder „nicht abgeschlossen“, dazu die Adresse der Prüfseite.
Format der CSV¶
- UTF-8 mit Byte Order Mark, Trennzeichen Semikolon, Zeilenende CRLF, Anführungszeichen nach RFC 4180: So öffnet Excel in Deutschland die Datei mit einem Doppelklick richtig.
- Mehrere Änderungen in einer Zelle stehen je auf einer eigenen Zeile.
- Beginnt eine Textzelle mit
=,+,-,@, Tab oder Wagenrücklauf, steht ein Hochkomma davor: Eine Tabellenkalkulation führt den Inhalt dann nicht als Formel aus (CSV-Injection). - Dauern in ganzen Minuten, nie als Dezimalzahl.
Auskunft nach Art. 15 DSGVO¶
Jede Person lädt unter Einstellungen → Meine Daten eine JSON-Datei mit allem, was Soll in
diesem Betrieb über sie speichert, unabhängig von Rolle und Modulen. Für eine Person, die den
Betrieb verlassen hat und sich nicht mehr anmelden kann, erteilt der Inhaber die Auskunft (Recht
auskunft:erteilen, Aufruf GET /api/v1/auskunft?nutzerId=…). Diese Auskunft enthält nur, was
der Inhaber in Soll ohnehin sieht: Name und E-Mail des Kontos, Mitgliedschaft und Einladung,
Stempelungen mit allen Fassungen und Gründen, Gegeneinträge, Abschlüsse mit Inhalt und Prüfwert,
Modelle mit Lohn und Zuschlägen, Schichten, Stundensätze, Buchungen der Projektzeit,
Personalnummer, QR-Code und NFC-Karten der Person (wann eingetragen) und die Glieder der Audit-Kette zu diesen Tabellen. Alles andere bleibt
draußen, auch jeder Teil, der später dazukommt, bis jemand ihn freigibt: Anmeldewege und Sitzungen,
Benutzername, PIN-Zustand, Geräte und Erinnerungen. Der Inhaber sieht sie sonst nirgends, und sie
verrieten dem Arbeitgeber, wo, wann und womit sich die Person anmeldet, welche Erinnerungen sie
abgeschaltet hat und auf wie vielen Geräten und in welcher Sprache sie die App nutzt (Art. 5 Abs. 1
lit. b und c DSGVO).
| Teil | Inhalt |
|---|---|
hinweise |
Zwecke, Rechtsgrundlage, Empfänger, Speicherdauer, Rechte, Herkunft, keine automatisierte Entscheidung (Art. 15 Abs. 1 lit. a bis h) |
konto, anmeldung, sitzungen |
Name, E-Mail, Benutzername; Anmeldewege und Passkeys; Sitzungen in diesem Betrieb mit Adresse und Browser |
mitgliedschaft, einladungen, pin |
Rolle und seit wann; die angenommene Einladung; ob eine PIN gesetzt und gesperrt ist |
stempelungen |
jede Fassung jeder Stempelung mit Grund, wer und wann; nichts wird überschrieben |
gegeneintraege, monatsabschluesse |
Korrekturen; Bestätigungen und Abschlüsse mit dem Inhalt des Monats und dem Prüfwert |
arbeitszeitmodelle, schichten, geraete |
zugeordnete Modelle mit Soll, Lohn und Sätzen der Zuschläge; Schichten, auch im Entwurf; Geräte mit öffentlichem Schlüssel |
ausweis |
wann und von wem der QR-Code für das Terminal ausgestellt wurde (S-801), ohne seinen Wert und Hash, sonst null |
karten |
die NFC-Karten der Person (S-802) mit Art, wann und von wem eingetragen und wann entzogen, ohne UID, Schlüssel und Lesezähler |
personalnummer |
die Personalnummer im Lohnprogramm für den DATEV-Export (S-308), sonst null |
stundensaetze |
Stundensätze, die der Betrieb für die Person festgelegt hat (Projektzeit, S-601), nicht die Sätze für alle |
projektzeiten |
die Buchungen der Stoppuhr und von Hand mit Auftrag, Tätigkeit, Beginn, Ende, Arbeitstag und Notiz, abgerechnete mit dem Satz der Abrechnung (S-602) |
auditKette |
die Glieder der Kette zu den eigenen Zeilen (wer, wann, Hash) und die Glieder, die die Person selbst geschrieben hat, nur mit Tabelle, Aktion und Zeitpunkt |
Zeitpunkte stehen als ISO 8601 in UTC. Nicht enthalten sind Kennwort, Tokens, der Hash der PIN und
der Einladung (sie schützen das Konto) und Daten anderer Personen: Von den Gliedern, die die Person
für andere geschrieben hat, nennt die Auskunft weder Zeile noch Inhalt (Art. 15 Abs. 4 DSGVO).
Stundennachweise (S-605) stehen nicht darin: Die Buchungen der Person darin stehen unter
projektzeiten, Name und Unterschrift des Kunden sind Daten eines Dritten.
Dazu kommen die Wünsche zu Erinnerungen, die gesendeten Erinnerungen und die Geräte für Push-Nachrichten (ohne Endpunkt und Schlüssel, S-307); Abwesenheiten kommen dazu, sobald es sie gibt (S-401). Ein Test hält
fest, dass jede Tabelle der Datenbank in der eigenen Auskunft steht oder mit Grund ausgenommen ist,
und für die Auskunft durch den Inhaber freigegeben oder mit Grund ausgelassen ist.
Schnittstelle¶
| Aufruf | Antwort |
|---|---|
GET /api/v1/arbeitszeit/pruefexport?von=2026-10-01&bis=2026-10-31&format=csv |
die eigenen Tage als CSV (format=pdf: als PDF) |
… &nutzerId=<id>&nutzerId=<id> |
diese Personen, für zeiten:alle |
GET /api/v1/auskunft |
die eigene Auskunft als JSON |
GET /api/v1/auskunft?nutzerId=<id> |
die Auskunft einer Person, die Mitglied ist oder war, für den Inhaber |
Ein ungültiger oder zu langer Zeitraum gibt 400, eine Person ohne Recht 403, eine Person eines anderen Betriebs 404.