NexTime

Datenformate

Was ein Betrieb aus NexTime mitnimmt — jede Datei, jedes Feld, Typ und Bedeutung. Die Leitung lädt alles unter Einstellungen → Daten als eine ZIP-Datei herunter. Laufend abrufen lässt es sich mit einem Leseschlüssel über /api/v1/daten, mit denselben Dateien und Feldern.

Maschinenlesbar: /api/v1/datenpaket.json · Schnittstelle: /api/v1/openapi.json

Format

Eine ZIP-Datei. Die Tabellen (.csv) für Excel und Co., daneben im Ordner daten/ jede Tabelle vollständig als JSON.
UTF-8, je Datei eine Liste von Objekten. Feldnamen = Spaltennamen der Datenbank. Zeitpunkte in ISO 8601 (UTC), Tage als JJJJ-MM-TT, Beträge in Cent.
UTF-8 mit BOM, Semikolon als Trennzeichen — öffnet sich mit Doppelklick in Excel.

Im ZIP außerdem

termine.csv: Alle Termine als Tabelle
leistungen.csv: Leistungen mit Dauer, Puffer und Preis
standorte.csv: Standorte mit Anschrift (falls vorhanden)
abwesenheiten.csv: Urlaub und Abwesenheit (falls vorhanden)
kunden.csv: Die Kartei (wenn der Betrieb eine führt)
einwilligungen.csv: Einwilligungen (wenn der Betrieb eine Kartei führt)
belege.csv: Eine Zeile je Belegposition (wenn der Betrieb Belege ausstellt)
daten/paket.json: Diese Beschreibung, maschinenlesbar.
daten/logo.*: Das Logo des Betriebs, falls hinterlegt.
kalender.ics: Alle Termine zum Einlesen in Google-, Apple- oder Outlook-Kalender.
belege/*.pdf: Jeder Beleg als PDF, wie ausgestellt.
fotos/…: Fotos aus der Kartei, je Kontakt ein Ordner.

Termine

Termine, Teilnehmende, Serien und Terminumfragen · Bereich für Leseschlüssel: termine

Termine daten/termine.json

Alle Termine und Sperrzeiten, auch abgesagte und solche im Papierkorb — mit Absage-, Verschiebe- und Bestätigungsangaben. Der feinere Verlauf je Termin steht im Änderungsprotokoll (protokoll.json, entity_id = Termin).

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
kind	string	appointment = Termin, block = SperrzeitWerte: appointment, block
service_id	uuid, kann leer sein	Kennung der Leistung (siehe leistungen.json)
service_name	string, kann leer sein	Name der Leistung zum Zeitpunkt der Buchung
duration_min	integer, kann leer sein	Dauer in Minuten
price_cents	integer, kann leer sein	Preis in Cent
customer_id	uuid, kann leer sein	Kennung des Kontakts (siehe kunden.json)
title	string, kann leer sein	Titel (bei Sperrzeiten und internen Terminen)
start_at	date-time	Beginn (ISO 8601, UTC)
end_at	date-time	Ende (ISO 8601, UTC)
status	string	held = vorgemerkt, pending = offen, confirmed = bestätigt, cancelled = abgesagt, no_show = nicht erschienen, done = erledigtWerte: held, pending, confirmed, cancelled, no_show, done
source	string	Woher der Termin kam: Website, WhatsApp, Buchungslink, von Hand, Telefon, ohne TerminWerte: online_website, online_whatsapp, online_direct, manual, phone, walk_in
expires_at	date-time, kann leer sein	Nur bei vorgemerkten Terminen: so lange ist die Zeit reserviert
idempotency_key	string, kann leer sein	Kennung des anfragenden Systems gegen doppelte Buchungen
overlap_ok	boolean	Überschneidung bewusst zugelassen
import_uid	string, kann leer sein	Kennung aus einer eingelesenen Kalenderdatei (.ics)
customer_note	string, kann leer sein	Hinweis des Kontakts bei der Buchung
fragen_antworten	JSON, kann leer sein	Antworten auf die Fragen vor der Buchung
notes	string, kann leer sein	Interne Notiz
location	string, kann leer sein	Ort des Termins
meeting_url	string, kann leer sein	Link zum Videoraum
buchungs_email	string, kann leer sein	E-Mail aus der Online-Buchung, wenn sie von der Kartei abweicht; Nachrichten zu diesem Termin gehen dorthin
color	string, kann leer sein	Farbe in der Anzeige
series_text	string, kann leer sein	Hinweis zur Wiederholung, wie angezeigt
idempotenz_schluessel	string, kann leer sein	Kennung gegen doppeltes Anlegen aus der Oberfläche
besuch_id	uuid, kann leer sein	Gemeinsame Kennung mehrerer Termine eines Besuchs; leer = einzelner Termin
manage_token_expires_at	date-time, kann leer sein	Bis wann der Verwaltungslink des Kontakts gilt
confirmed_at	date-time, kann leer sein	Bestätigt am
zusage_kundin_at	date-time, kann leer sein	Der Kontakt hat über den Link zugesagt am
cancelled_at	date-time, kann leer sein	Abgesagt am
cancelled_by	string, kann leer sein	Abgesagt von: customer = Kontakt, owner = Betrieb, system = automatischWerte: customer, owner, system
cancel_reason	string, kann leer sein	Grund der Absage
rescheduled_from_id	uuid, kann leer sein	Kennung des Termins, aus dem dieser verschoben wurde
series_id	uuid, kann leer sein	Kennung der Serie (siehe serien.json)
deleted_at	date-time, kann leer sein	In den Papierkorb gelegt am; leer = nicht gelöscht
client_tz	string, kann leer sein	Zeitzone des Geräts bei der Buchung (nur zur Fehlersuche)
created_by_user_id	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Nicht enthalten: Anmeldegeheimnis — gehört nicht in eine Datei, die weitergegeben wird.

Eingeladene zu Terminen daten/termin_teilnehmer.json

Wer aus dem Team zu einem Termin eingeladen ist und wie er geantwortet hat.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
appointment_id	uuid	Kennung des Termins (siehe termine.json)
user_id	uuid	Kennung des Zugangs (siehe zugaenge.json)
zusage	string	offen, zugesagt oder abgesagt
geantwortet_am	date-time, kann leer sein	Geantwortet am
eingeladen_am	date-time	Eingeladen am
eingeladen_von	uuid, kann leer sein	Kennung des Zugangs, der eingeladen hat

Weitere Kalender je Termin daten/termin_mitwirkende.json

Termine, die mehrere Kalender zugleich belegen (etwa eine zweite Person oder einen Raum).

Feld	Typ	Bedeutung
appointment_id	uuid	Kennung des Termins (siehe termine.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)

Serien daten/serien.json

Wiederkehrende Termine: die Regel, nach der neue Termine nachgefüllt werden.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
regel	JSON	Wiederholungsregel (Takt, Wochentage, Ende)
letzter_tag	string	Bis zu diesem Tag sind Termine angelegt
uhrzeit	string	Uhrzeit in deutscher Ortszeit (HH:MM)
dauer_min	integer	Dauer in Minuten
beendet_at	date-time, kann leer sein	Serie beendet am; leer = läuft
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Terminumfragen daten/umfragen.json

Umfragen, mit denen mehrere Personen einen gemeinsamen Termin finden.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
erstellt_von	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
titel	string	Titel
dauer_min	integer	Dauer in Minuten
ort	string, kann leer sein	Ort
hinweis	string, kann leer sein	Hinweis an die Teilnehmenden
status	string	offen, entschieden oder beendet (ohne Termin)
gewaehlt_id	uuid, kann leer sein	Kennung des gewählten Vorschlags
termin_id	uuid, kann leer sein	Kennung des Termins (siehe termine.json)
created_at	date-time	Angelegt am (ISO 8601, UTC)
entschieden_at	date-time, kann leer sein	Entschieden am

Nicht enthalten: Anmeldegeheimnis — gehört nicht in eine Datei, die weitergegeben wird.

Vorschläge in Terminumfragen daten/umfrage_vorschlaege.json

Die Zeiten, die in einer Umfrage zur Wahl stehen.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
umfrage_id	uuid	Kennung der Terminumfrage (siehe umfragen.json)
start_at	date-time	Beginn (ISO 8601, UTC)

Teilnehmende an Terminumfragen daten/umfrage_teilnehmer.json

Wer an einer Umfrage teilgenommen hat.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
umfrage_id	uuid	Kennung der Terminumfrage (siehe umfragen.json)
name	string	Name
email	string, kann leer sein	E-Mail-Adresse
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Nicht enthalten: Anmeldegeheimnis — gehört nicht in eine Datei, die weitergegeben wird.

Stimmen in Terminumfragen daten/umfrage_stimmen.json

Die Antwort jeder Person zu jedem Vorschlag.

Feld	Typ	Bedeutung
teilnehmer_id	uuid	Kennung der Person (siehe umfrage_teilnehmer.json)
vorschlag_id	uuid	Kennung des Vorschlags (siehe umfrage_vorschlaege.json)
antwort	string	ja, vielleicht oder nein

Kundenkartei

Kontakte, Einwilligungen, Fotos (Angaben), Bewertungen, Warteliste · Bereich für Leseschlüssel: kunden

Kontakte daten/kunden.json

Die Kartei: alle Kontakte mit Anschrift, Geburtstag, Sprache und Sperr- oder Aufbewahrungsangaben.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
name	string	Name
phone_e164	string	Telefonnummer im internationalen Format (+49…)
phone_raw	string, kann leer sein	Telefonnummer, wie eingegeben
email	string, kann leer sein	E-Mail-Adresse
street	string, kann leer sein	Straße und Hausnummer
zip	string, kann leer sein	Postleitzahl
city	string, kann leer sein	Ort
geburtstag	date, kann leer sein	Geburtstag (JJJJ-MM-TT)
notes	string, kann leer sein	Interne Notiz
merged_into_id	uuid, kann leer sein	Mit diesem Kontakt zusammengeführt (Kennung); leer = eigenständig
blocked_at	date-time, kann leer sein	Gesperrt am
blocked_reason	string, kann leer sein	Grund der Sperre
email_invalid_at	date-time, kann leer sein	E-Mail-Adresse als unzustellbar erkannt am
phone_invalid_at	date-time, kann leer sein	Telefonnummer als unerreichbar erkannt am
consent_sms_at	date-time, kann leer sein	Einwilligung in SMS-Erinnerungen am (Nachweis in einwilligungen.json)
aufbewahren_bis	date-time, kann leer sein	Länger aufbewahrt bis
aufbewahren_grund	string, kann leer sein	Grund der längeren Aufbewahrung
sprache	string	Sprache für Nachrichten (de oder en)
anonymized_at	date-time, kann leer sein	Anonymisiert am
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Einwilligungen daten/einwilligungen.json

Wer wann wozu zugestimmt oder die Zustimmung widerrufen hat — der Nachweis.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
customer_id	uuid	Kennung des Kontakts (siehe kunden.json)
art	string	Wofür (etwa sms)
richtung	string	erteilt oder widerrufen
wortlaut	string, kann leer sein	Der Satz, der dabei auf dem Bildschirm stand
fassung	string, kann leer sein	Fassung des Textes, als Datum
quelle	string	Woher: Buchungsseite, von Hand, Verwaltungslink
adresse	string, kann leer sein	Telefonnummer oder E-Mail-Adresse, für die zugestimmt wurde
zeitpunkt	date-time	Zeitpunkt (ISO 8601, UTC)

Fotos in der Kartei daten/kunden_fotos.json

Angaben zu jedem Foto. Die Bilder selbst liegen im ZIP im Ordner fotos/.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
customer_id	uuid	Kennung des Kontakts (siehe kunden.json)
art	string	vorher, nachher oder sonstig
notiz	string, kann leer sein	Notiz
erstellt_von	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
created_at	date-time	Angelegt am (ISO 8601, UTC)

Nicht enthalten: Das Bild selbst — im ZIP als Datei im Ordner fotos/.

Bewertungen daten/bewertungen.json

Rückmeldungen nach Terminen.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
appointment_id	uuid	Kennung des Termins (siehe termine.json)
customer_id	uuid, kann leer sein	Kennung des Kontakts (siehe kunden.json)
sterne	integer	Sterne von 1 bis 5
text	string, kann leer sein	Text der Bewertung
weiter_at	date-time, kann leer sein	Weiter zur öffentlichen Bewertung bei Google am
created_at	date-time	Angelegt am (ISO 8601, UTC)

Warteliste daten/warteliste.json

Wer auf eine frei werdende Zeit wartet.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
customer_id	uuid, kann leer sein	Kennung des Kontakts (siehe kunden.json)
name	string	Name
phone_e164	string	Telefonnummer im internationalen Format (+49…)
email	string, kann leer sein	E-Mail-Adresse
sprache	string	Sprache für Nachrichten (de oder en)
service_id	uuid, kann leer sein	Kennung der Leistung (siehe leistungen.json)
staff_id	uuid, kann leer sein	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
von_tag	date	Erster Tag (JJJJ-MM-TT)
bis_tag	date	Letzter Tag (JJJJ-MM-TT)
zeitfenster	string	egal, vormittag oder nachmittag
notiz	string, kann leer sein	Notiz
gemeldet_at	date-time, kann leer sein	Zuletzt über eine freie Zeit benachrichtigt am
meldungen	integer	Wie oft schon benachrichtigt
erledigt_at	date-time, kann leer sein	Erledigt am
erledigt_grund	string, kann leer sein	Grund der Erledigung
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Belege und Gutscheine

Belege mit Positionen, Gutscheine mit Einlösungen · Bereich für Leseschlüssel: belege

Belege daten/belege.json

Alle ausgestellten Belege mit den Angaben, wie sie auf dem Beleg stehen (Schnappschuss). Die PDFs liegen im ZIP im Ordner belege/.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
nummer	string	Belegnummer
belegdatum	date	Belegdatum (JJJJ-MM-TT)
art	string	leistung, gutschein (Verkauf), storno oder einloesung
summe_cents	integer	Betrag in Cent
aussteller_name	string	Aussteller: Name des Betriebs
aussteller_inhaberin	string, kann leer sein	Aussteller: Inhaberin oder Inhaber
aussteller_strasse	string, kann leer sein	Aussteller: Straße
aussteller_plz	string, kann leer sein	Aussteller: Postleitzahl
aussteller_ort	string, kann leer sein	Aussteller: Ort
aussteller_steuernummer	string, kann leer sein	Aussteller: Steuernummer
aussteller_ust_id	string, kann leer sein	Aussteller: Umsatzsteuer-Identifikationsnummer
empfaenger_name	string, kann leer sein	Empfänger: Name
empfaenger_strasse	string, kann leer sein	Empfänger: Straße
empfaenger_plz	string, kann leer sein	Empfänger: Postleitzahl
empfaenger_ort	string, kann leer sein	Empfänger: Ort
customer_id	uuid, kann leer sein	Kennung des Kontakts (siehe kunden.json)
steuer_hinweis	string	Steuerhinweis auf dem Beleg (etwa § 19 UStG)
storniert_beleg_id	uuid, kann leer sein	Dieser Beleg storniert den Beleg mit dieser Kennung
storniert_durch_id	uuid, kann leer sein	Storniert durch den Beleg mit dieser Kennung
storno_grund	string, kann leer sein	Grund des Stornos
erstellt_von_user_id	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
created_at	date-time	Angelegt am (ISO 8601, UTC)

Belegpositionen daten/beleg_positionen.json

Jede Zeile auf einem Beleg.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
beleg_id	uuid	Kennung des Belegs (siehe belege.json)
position	integer	Laufende Nummer auf dem Beleg
menge	integer	Menge
bezeichnung	string	Bezeichnung
einzel_cents	integer	Einzelpreis in Cent
summe_cents	integer	Betrag in Cent
termin_id	uuid, kann leer sein	Kennung des Termins (siehe termine.json)
leistungsdatum	date	Datum der Leistung (JJJJ-MM-TT)

Belegnummern je Jahr daten/beleg_nummernkreise.json

Die zuletzt vergebene Belegnummer je Jahr — für eine lückenlose Fortsetzung.

Feld	Typ	Bedeutung
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
jahr	integer	Jahr
letzte_nummer	integer	Zuletzt vergebene Nummer

Gutscheine daten/gutscheine.json

Ausgegebene Gutscheine mit Wert und Restwert.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
nummer	string	Gutscheinnummer
wert_cents	integer	Ausgabewert in Cent
restwert_cents	integer	Restwert in Cent
gueltig_bis	date, kann leer sein	Gültig bis (JJJJ-MM-TT)
ausgabe_beleg_id	uuid, kann leer sein	Kennung des Belegs, mit dem er verkauft wurde
kaeufer_name	string, kann leer sein	Name der Käuferin oder des Käufers
customer_id	uuid, kann leer sein	Kennung des Kontakts (siehe kunden.json)
notiz	string, kann leer sein	Notiz
entwertet_at	date-time, kann leer sein	Entwertet am
entwertet_grund	string, kann leer sein	Grund der Entwertung
erstellt_von_user_id	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
created_at	date-time	Angelegt am (ISO 8601, UTC)

Gutschein-Einlösungen daten/gutschein_einloesungen.json

Wann welcher Gutschein mit welchem Betrag auf welchem Beleg eingelöst wurde.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
gutschein_id	uuid	Kennung des Gutscheins (siehe gutscheine.json)
beleg_id	uuid	Kennung des Belegs (siehe belege.json)
betrag_cents	integer	Eingelöster Betrag in Cent
created_at	date-time	Angelegt am (ISO 8601, UTC)

Gutscheinnummern je Jahr daten/gutschein_nummernkreise.json

Die zuletzt vergebene Gutscheinnummer je Jahr.

Feld	Typ	Bedeutung
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
jahr	integer	Jahr
letzte_nummer	integer	Zuletzt vergebene Nummer

Kalender und Zeiten

Kalender, Leistungen, Öffnungszeiten, Ausnahmen, Feiertage, Abwesenheiten, Standorte · Bereich für Leseschlüssel: zeiten

Kalender daten/kalender.json

Die Kalender des Betriebs — je Person oder Raum einer.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
name	string	Name
user_id	uuid, kann leer sein	Kennung des Zugangs (siehe zugaenge.json)
color	string, kann leer sein	Farbe in der Anzeige
sort_order	integer	Reihenfolge in Listen (kleiner = weiter oben)
active	boolean	In Gebrauch
archived_at	date-time, kann leer sein	Archiviert am; leer = in Gebrauch
standort_id	uuid, kann leer sein	Kennung des Standorts (siehe standorte.json)
urlaubstage_jahr	integer, kann leer sein	Urlaubstage im Jahr
provision_prozent	integer, kann leer sein	Provision in Prozent (nur zur Auswertung)
buchungsseite_an	boolean	Auf der Buchungsseite wählbar
buchungsseite_leistungen	Liste	Kennungen der Leistungen, die über die Buchungsseite zu diesem Kalender gehen
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Leistungen daten/leistungen.json

Was gebucht werden kann, mit Dauer, Puffern, Preis und Buchungsregeln.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
name	string	Name
category	string, kann leer sein	Gruppe
description	string, kann leer sein	Beschreibung
duration_min	integer	Dauer in Minuten
buffer_before_min	integer	Puffer davor in Minuten
buffer_after_min	integer	Puffer danach in Minuten
price_cents	integer, kann leer sein	Preis in Cent
price_from	boolean	Preis ist ein Ab-Preis
color	string, kann leer sein	Farbe in der Anzeige
online_bookable	boolean	Online buchbar
lead_minutes	integer, kann leer sein	Mindestvorlauf in Minuten; leer = Wert des Betriebs
horizon_days	integer, kann leer sein	So viele Tage im Voraus buchbar; leer = Wert des Betriebs
sort_order	integer	Reihenfolge in Listen (kleiner = weiter oben)
fragen	JSON	Fragen vor der Buchung
video	boolean	Videotermin (bekommt einen Link zum Raum)
kapazitaet	integer	Plätze gleichzeitig (1 = gewöhnlich)
archived_at	date-time, kann leer sein	Archiviert am; leer = in Gebrauch
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Leistungen je Kalender daten/kalender_leistungen.json

Welcher Kalender welche Leistung anbietet, mit abweichender Dauer oder abweichendem Preis.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
service_id	uuid	Kennung der Leistung (siehe leistungen.json)
duration_min_override	integer, kann leer sein	Abweichende Dauer in Minuten
price_cents_override	integer, kann leer sein	Abweichender Preis in Cent

Räume und Geräte je Leistung daten/leistung_ressourcen.json

Welche Leistung zusätzlich einen Raum oder ein Gerät belegt.

Feld	Typ	Bedeutung
service_id	uuid	Kennung der Leistung (siehe leistungen.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)

Öffnungszeiten daten/oeffnungszeiten.json

Die regelmäßigen Zeiten je Kalender und Wochentag.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
weekday	integer	Wochentag (0 = Sonntag, 1 = Montag … 6 = Samstag)
windows	JSON	Zeitfenster als Liste von {von, bis} in deutscher Ortszeit (HH:MM)
valid_from	date, kann leer sein	Gilt ab (JJJJ-MM-TT); leer = schon immer
valid_until	date, kann leer sein	Gilt bis (JJJJ-MM-TT); leer = unbegrenzt
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Ausnahmen von den Öffnungszeiten daten/ausnahmen.json

Geschlossene Tage, zusätzliche oder geänderte Zeiten.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
from_date	date	Erster Tag (JJJJ-MM-TT)
to_date	date	Letzter Tag (JJJJ-MM-TT)
type	string	closed = geschlossen, extra_open = zusätzlich offen, modified = geänderte ZeitenWerte: closed, extra_open, modified
windows	JSON	Zeitfenster als Liste von {von, bis} in deutscher Ortszeit (HH:MM)
reason	string, kann leer sein	Grund
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Abweichungen an Feiertagen daten/feiertage.json

Feiertage, an denen der Betrieb anders als üblich offen oder geschlossen ist.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
day	date	Tag (JJJJ-MM-TT)
open	boolean	Geöffnet
note	string, kann leer sein	Notiz
created_at	date-time	Angelegt am (ISO 8601, UTC)

Abwesenheiten daten/abwesenheiten.json

Urlaub und Abwesenheit je Kalender.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
von_tag	date	Erster Tag (JJJJ-MM-TT)
bis_tag	date	Letzter Tag (JJJJ-MM-TT)
art	string	urlaub oder abwesend
status	string	beantragt, genehmigt, abgelehnt oder zurueckgezogen
tage	integer, kann leer sein	Anzahl Urlaubstage
beantragt_von	uuid, kann leer sein	Kennung des Zugangs, der beantragt hat
entschieden_von	uuid, kann leer sein	Kennung des Zugangs, der entschieden hat
entschieden_at	date-time, kann leer sein	Entschieden am
override_id	uuid, kann leer sein	Kennung der zugehörigen Ausnahme (siehe ausnahmen.json)
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Standorte daten/standorte.json

Standorte mit Anschrift.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
name	string	Name
street	string, kann leer sein	Straße und Hausnummer
zip	string, kann leer sein	Postleitzahl
city	string, kann leer sein	Ort
phone	string, kann leer sein	Telefonnummer
sort_order	integer	Reihenfolge in Listen (kleiner = weiter oben)
archived_at	date-time, kann leer sein	Archiviert am; leer = in Gebrauch
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Zugänge und Freigaben

Zugänge mit Rollen, Kalenderfreigaben, Freigabe-Links · Bereich für Leseschlüssel: team

Zugänge daten/zugaenge.json

Wer sich anmelden darf, mit Rolle. Ohne Passwort und zweiten Faktor.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
email	string	E-Mail-Adresse
name	string	Name
role	string	inhaberin = Leitung, helfer = Hilfe (springt ein), mitarbeit = eingeschränktWerte: inhaberin, helfer, mitarbeit
active	boolean	Eingeschaltet
must_change_password	boolean	Muss beim nächsten Anmelden ein eigenes Passwort vergeben
last_login_at	date-time, kann leer sein	Zuletzt angemeldet am
totp_aktiv_at	date-time, kann leer sein	Zweiter Faktor eingerichtet am; leer = keiner
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Nicht enthalten: Anmeldegeheimnis — gehört nicht in eine Datei, die weitergegeben wird.

Kalenderfreigaben daten/freigaben.json

Wer welchen Kalender in welcher Stufe sieht.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
user_id	uuid	Kennung des Zugangs (siehe zugaenge.json)
stufe	string	belegt = nur belegt, sehen, bearbeiten, aendern
google_details	boolean	Termine aus der Google-Anbindung mit Titel zeigen
created_at	date-time	Angelegt am (ISO 8601, UTC)
created_by	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat

Eigene Kalendernamen daten/kalendernamen.json

Wie ein Zugang einen fremden Kalender für sich benannt und eingefärbt hat.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
user_id	uuid	Kennung des Zugangs (siehe zugaenge.json)
bezeichnung	string, kann leer sein	Eigener Name
farbe	string, kann leer sein	Eigene Farbe
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Freigabe-Links daten/freigabe_links.json

Links, mit denen ein Kalender freigegeben wurde.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
stufe	string	Stufe, die der Link gewährt
created_by	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
created_at	date-time	Angelegt am (ISO 8601, UTC)
gueltig_bis	date-time	Gültig bis
eingeloest_at	date-time, kann leer sein	Eingelöst am
eingeloest_von	uuid, kann leer sein	Kennung des Zugangs, der ihn eingelöst hat
zurueckgezogen_at	date-time, kann leer sein	Zurückgezogen am

Nicht enthalten: Anmeldegeheimnis — gehört nicht in eine Datei, die weitergegeben wird.

Nachrichten

Gesendete und geplante Nachrichten, Rundschreiben · Bereich für Leseschlüssel: nachrichten

Nachrichten daten/nachrichten.json

Jede gesendete, geplante oder gescheiterte Nachricht (E-Mail, SMS, Push).

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
appointment_id	uuid, kann leer sein	Kennung des Termins (siehe termine.json)
customer_id	uuid, kann leer sein	Kennung des Kontakts (siehe kunden.json)
user_id	uuid, kann leer sein	Kennung des Zugangs (siehe zugaenge.json)
channel	string	email, sms oder pushWerte: email, sms, push
kind	string	Anlass (Bestätigung, Erinnerung, Absage, Verschiebung, Einladung, Bewertungsbitte, Warteliste, Werbung …)Werte: confirmation, reminder, cancellation_by_customer, cancellation_by_owner, reschedule, owner_new_booking, daily_digest, einladung, antwort_zugesagt, antwort_abgesagt, bewertung_bitte, warteliste_frei, werbung, werbung_bestaetigen, hinweis_andere_adresse
recipient	string, kann leer sein	Empfänger (E-Mail-Adresse oder Telefonnummer)
subject	string, kann leer sein	Betreff
body	string	Text (Links zum Verwalten eines Termins und zum Bestätigen oder Abbestellen der Neuigkeiten unkenntlich: [entfernt])
attachment_name	string, kann leer sein	Name des Anhangs
scheduled_for	date-time	Geplant für
claimed_at	date-time, kann leer sein	Versand begonnen am
sent_at	date-time, kann leer sein	Gesendet am
zugestellt_at	date-time, kann leer sein	Zugestellt am
seen_at	date-time, kann leer sein	Gelesen am
failed_at	date-time, kann leer sein	Gescheitert am
cancelled_at	date-time, kann leer sein	Nicht mehr gesendet (abgebrochen) am
attempts	integer	Versuche
last_error	string, kann leer sein	Letzte Fehlermeldung
provider_message_id	string, kann leer sein	Kennung beim Versanddienst
aussendung_id	uuid, kann leer sein	Kennung des Rundschreibens (siehe aussendungen.json)
dedupe_key	string	Kennung gegen doppelten Versand
created_at	date-time	Angelegt am (ISO 8601, UTC)

Nicht enthalten: Der Anhang selbst (Beleg-PDF oder Kalendereintrag) — Belege liegen im ZIP im Ordner belege/.

Rundschreiben daten/aussendungen.json

Nachrichten an viele Kontakte auf einmal.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
betreff	string	Betreff
text	string	Text
empfaenger	integer	Anzahl Empfängerinnen beim Abschicken
erstellt_von	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
created_at	date-time	Angelegt am (ISO 8601, UTC)

Änderungsprotokoll

Wer wann was geändert hat · Bereich für Leseschlüssel: protokoll

Änderungsprotokoll daten/protokoll.json

Wer wann was geändert hat — auch der Verlauf je Termin.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
actor_type	string	user = Zugang, customer = Kontakt, system = automatisch oder SchnittstelleWerte: user, customer, system
actor_user_id	uuid, kann leer sein	Kennung des Zugangs (bei actor_type user)
actor_label	string, kann leer sein	Name, wie er im Protokoll steht
action	string	Was geschah (etwa termin.abgesagt)
entity_type	string, kann leer sein	Art des betroffenen Eintrags (etwa appointment)
entity_id	uuid, kann leer sein	Kennung des betroffenen Eintrags
changes	JSON, kann leer sein	Was sich geändert hat
ip	string, kann leer sein	IP-Adresse der Anfrage — bei Abrufen über die Schnittstelle (schnittstelle.abruf) nach 90 Tagen geleert; die Zeile selbst bleibt 24 Monate
created_at	date-time	Angelegt am (ISO 8601, UTC)

Betrieb und Anbindungen

Stammdaten, Einstellungen, Schlüssel, Rückrufe, angebundene Kalender (ohne Geheimnisse) · Bereich für Leseschlüssel: betrieb

Betrieb daten/betrieb.json

Stammdaten und alle Einstellungen. Das Logo liegt im ZIP als Datei daten/logo.*.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
slug	string	Kurzname in der Adresse der Buchungsseite
name	string	Name
street	string, kann leer sein	Straße und Hausnummer
zip	string, kann leer sein	Postleitzahl
city	string, kann leer sein	Ort
phone	string, kann leer sein	Telefonnummer
email	string, kann leer sein	E-Mail-Adresse
website	string, kann leer sein	Webseite
logo_path	string, kann leer sein	Pfad zum Logo (ältere Ablage)
accent_color	string, kann leer sein	Akzentfarbe
imprint_url	string, kann leer sein	Adresse des Impressums
privacy_url	string, kann leer sein	Adresse der Datenschutzerklärung
owner_name	string, kann leer sein	Inhaberin oder Inhaber
vat_id	string, kann leer sein	Umsatzsteuer-Identifikationsnummer
tax_number	string, kann leer sein	Steuernummer
sms_sender_number	string, kann leer sein	Eigene Absendernummer für SMS
sms_sender_verified_at	date-time, kann leer sein	Absendernummer bestätigt am
settings	JSON	Alle Einstellungen des Betriebs (Buchungsregeln, Nachrichten, Darstellung …)
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Nicht enthalten: Das Logo selbst — im ZIP als Datei daten/logo.*.

Zugangsschlüssel der Schnittstelle daten/schluessel.json

Welche Schlüssel es gab, wer sie angelegt hat und wann sie zuletzt benutzt wurden. Ohne die Schlüssel selbst.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
name	string	Name
praefix	string	Die ersten Zeichen, zum Wiedererkennen
created_at	date-time	Angelegt am (ISO 8601, UTC)
created_by	uuid, kann leer sein	Kennung des Zugangs, der es angelegt hat
last_used_at	date-time, kann leer sein	Zuletzt benutzt am
revoked_at	date-time, kann leer sein	Widerrufen am; leer = gültig
bereiche	JSON, kann leer sein	Leserechte je Bereich; leer = Termine buchen und verwalten (Website, n8n, Agenten)

Nicht enthalten: Anmeldegeheimnis — gehört nicht in eine Datei, die weitergegeben wird.

Rückrufe daten/rueckrufe.json

Adressen, die bei Änderungen an Terminen benachrichtigt werden. Ohne das Signatur-Geheimnis.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
name	string	Name
url	string	Adresse
ereignisse	JSON	Bei welchen Ereignissen
active	boolean	Eingeschaltet
created_at	date-time	Angelegt am (ISO 8601, UTC)
last_ok_at	date-time, kann leer sein	Zuletzt erfolgreich am
last_error	string, kann leer sein	Letzte Fehlermeldung
fehler_serie	integer	Fehlschläge in Folge

Nicht enthalten: Anmeldegeheimnis — gehört nicht in eine Datei, die weitergegeben wird.

Angebundene Kalender daten/fremdkalender.json

Google-, Outlook- oder Apple-Kalender, deren Termine hier die Zeit sperren. Ohne die geheime Kalenderadresse; die Termine selbst stehen im angebundenen Kalender.

Feld	Typ	Bedeutung
id	uuid	Kennung dieser Zeile (UUID). Andere Dateien verweisen über …_id darauf.
business_id	uuid	Kennung des Betriebs (siehe betrieb.json)
staff_id	uuid	Kennung des Kalenders — einer Person oder eines Raums (siehe kalender.json)
name	string	Name
rechner	string	Rechnername der Quelle (etwa calendar.google.com)
abgerufen_at	date-time, kann leer sein	Zuletzt abgerufen am
erfolg_at	date-time, kann leer sein	Zuletzt erfolgreich am
fehler	string, kann leer sein	Letzte Fehlermeldung
belegungen	integer	Anzahl übernommener Belegungen
uebersprungen	integer	Anzahl übersprungener Einträge
mit_titel	boolean	Titel werden übernommen
created_at	date-time	Angelegt am (ISO 8601, UTC)
updated_at	date-time	Zuletzt geändert am (ISO 8601, UTC)

Nicht enthalten: Geheime Kalenderadresse — wer sie kennt, liest den Kalender.

Nicht im Paket

Anmeldungen, Geräte und Einmalcodes — technische Sicherheitsdaten ohne Inhalt für den Betrieb.
Kopien aus angebundenen Kalendern. Die Quelle ist der angebundene Kalender selbst; dort liegen sie vollständig.
Interne Betriebstechnik (Zähler, Laufprotokolle der Hintergrundaufgaben) ohne Daten des Betriebs.