Datenexport & offene Schnittstelle

NotaDiem · Schema zeimedo-export-catalog-2 · Stand 13. Oktober 2026

Ihre Standortdaten stehen als vollständiges ZIP mit strukturierten JSON-Dateien und allen gespeicherten PDF-/CSV-Nachweisen zur Verfügung. Offene Stempel, strittige Korrekturen und Abwesenheiten bleiben als solche enthalten; ein Monatsabschluss ist keine Voraussetzung für den Export. Es fallen keine zusätzlichen Export-, Schnittstellen- oder Wechselgebühren an.

Maschinenlesbaren Datenkatalog herunterladen

Herunterladen und wechseln

Öffnen Sie als berechtigter Inhaber oder als berechtigte Leitung „Nachweise & Export“ und laden Sie die vollständige Sicherung herunter. Im Inhaberbereich können Sie den förmlichen Anbieterwechsel anfordern. Eine normale Kündigung eröffnet 30 Tage Downloadzugang nach Vertragsende. Beim Wechsel bleibt der Abruf während des Verfahrens und mindestens 30 Tage nach seinem tatsächlichen Abschluss verfügbar. Hilfe: info@notadiem.de.

HTTPS-Schnittstelle v2

GET /apotheken/{pharmacy_id}/export/v2/ liefert application/zip. Die Standort-ID steht in der Adresszeile Ihres Standortbereichs. Voraussetzung sind Ihr persönlicher Verwaltungszugang mit zweitem Faktor, eine aktive Sitzung sowie Export- und Gesundheitsdatenrechte für den Standort. Ohne diese erfolgt die Weiterleitung zur Anmeldung oder eine 404-Antwort. Der gleiche Download ist im Verwaltungsbereich verfügbar. Zugangsdaten oder Sitzungskennungen bitte nicht an andere Anbieter weitergeben.

Dateien und Felder

Datei	Inhalt / Felder
`apotheke.json`	id, name, business_type, address, responsible_name, recording_start, settings, settings_version, onboarding, created_at, group_id, cancellation_at, service_until, download_until
`verantwortliche-zugaenge.json`	id, username, first_name, last_name
`mitarbeitende.json`	id, name, number, export_number, job, color, active, created_at
`geraete.json`	id, name, enrolled_at, last_seen, active, author_id, created_at
`zugriffsrollen.json`	id, user_id, role, active, can_export, can_view_health, created_at
`arbeitszeitmodelle.json`	id, employee_id, effective_from, weekly_minutes, annual_vacation_days, work_model, daily_minutes, a_week_minutes, b_week_minutes, cycle_anchor, opening_balance_minutes, opening_vacation_days, author_id, created_at
`anbieterwechsel.json`	id, actor_id, requested_start, transition_until, status, customer_extended_at, completed_at, retrieval_until, events, created_at
`planzeiten.json`	id, employee_id, start, end, breaks, emergency, revision, archived, published, author_id, created_at
`planversionen.json`	id, week, version, payload, author_id, created_at
`abwesenheiten.json`	id, employee_id, kind, date_from, date_to, full_day, time_start, time_end, status, valuation, credit_minutes, vacation_days, valued_at, author_id, decided_by_id, created_at
`arbeitszeiten.json`	id, employee_id, start, end, breaks, pauses_confirmed, needs_review, source, emergency, start_event_id, end_event_id, current_revision, created_at
`originalstempel.json`	id, employee_id, terminal_id, event_type, device_time, received_at, client_instance, local_sequence, payload, offline, requires_review, review_reason, content_hash, created_at
`stundenkonten.json`	id, employee_id, amount_minutes, effective_date, kind, reason, source_key, reverses_id, author_id, created_at
`protokoll.json`	id, actor_id, employee_id, action, object_type, object_id, data, previous_hash, content_hash, created_at
`tagesgrundlagen.json`	id, employee_id, day, net_minutes, reason, author_id, created_at
`wochen-sollgrundlagen.json`	id, employee_id, week, minutes, reason, author_id, created_at
`stempelklaerungen.json`	id, employee_id, event_id, entry_id, reason, author_id, created_at
`berichtigungen.json`	id, employee_id, entry_id, old_values, proposed_values, reason, status, employee_response, responded_at, decided_at, author_id, created_at
`wochenentscheidungen.json`	id, employee_id, week, snapshot, decision, reason, revision, account_before_minutes, author_id, created_at
`stellungnahmen.json`	id, employee_id, decision_id, accepted, response, applied, created_at
`einrichtungsversionen.json`	id, version, effective_from, payload, author_id, created_at
`abrechnung-bestellungen.json` Nur rechtlicher Inhaber	id, pharmacy_reference, created_at, actor_id, terms, status, finished_at
`nachweisverzeichnis.json`	id, version, status, date_from, date_to, kind, includes_health, author_id, previous_id, created_at, payload_sha256, pdf_sha256, csv_sha256
`agb/{id}.json` Nur rechtlicher Inhaber	schema, id, group_id, party, template, template_sha256, acceptance
`avv/{id}.json` Nur rechtlicher Inhaber	schema, id, group_id, party, template, template_sha256, acceptance, scope
`nachweise/{zeitraum}-{art}-v{version}.json`	Vollständiger unveränderbarer Nachweis-Snapshot, Schema apo-evidence-1 (Arbeitszeit) oder apo-plan-1 (Wochenplan); zugehörige PDF und CSV unter gleichem Dateistamm. Der Inhalt ist pro Version gespeichert.

Formate und Zuordnung

id: UUID-String; Nutzer-/actor_id numerische Konto-ID. *_id verweist auf id der bezeichneten Datei. null bedeutet kein Bezug/kein Wert.

date: YYYY-MM-DD (Datum ohne Uhrzeit).

datetime: ISO 8601 mit Z oder UTC-Offset; Anzeige und Kalendertage Europe/Berlin. Intervalle Beginn inklusive, Ende exklusive. Sommerzeitoffset beachten.

minutes: Minuten, gegebenenfalls Dezimalzahl als JSON-String; CSV netto_sekunden in Sekunden. Urlaubstage als Dezimalzahl. Keine automatische Lohnfreigabe.

boolean: JSON true/false; keine leere Zeichenfolge.

json: Original strukturierte Fachangaben und Versions-Snapshots werden mit ihren ursprünglichen Schlüsseln erhalten. Unbekannte Felder beim Import erhalten.

Die genauen Beziehungen zwischen Dateien und die verschachtelten Felder beschreibt der verlinkte JSON-Katalog. Die Daten lassen sich mit Standardwerkzeugen für ZIP, JSON und CSV lesen. Für ein Zielsystem müssen dessen Feldzuordnungen eingerichtet werden; wir garantieren kein identisches Verhalten fremder Software. PDF dient der Ansicht und Dokumentation. CSV ist UTF-8 mit konfiguriertem Trennzeichen; potenzielle Formelausdrücke werden beim CSV-Export mit einem führenden Apostroph entschärft.

Prüfsummen und Grenzen

manifest.json enthält SHA-256 aller weiteren Archivdateien; keine Signatur-/Unverändertheitsgarantie für nach Download bearbeitete Dateien.

AGB, AVV und Bestellkopien der Inhabergruppe werden nur dem rechtlichen Inhaber mitgeliefert. Exportiert werden die eigenen Standortdaten; fremde Mandanten und Anmeldegeheimnisse sind ausgeschlossen. Ein Export ist keine Übertragung von Software- oder Drittrechten. Weder Patientendaten noch Behandlungsunterlagen gehören in NotaDiem.

Infrastruktur und Schutzmaßnahmen · AGB einschließlich Wechselbedingungen