Stempla

Für Betriebe

Datenexport und Anbieterwechsel

Stand: 16. November 2026

Kurz gesagt: Du kannst Stempla jederzeit verlassen und deine Daten kostenlos mitnehmen, als JSON- und CSV-Dateien mit deinen Bildern. Den Export bekommst du auch ohne Kündigung. Wechsel, Export und Löschung kosten nichts.

1. Anbieterwechsel in Kürze

Verbindlich ist die Anlage „Anbieterwechsel und Datenexport“ zu den Bedingungen für Betriebe. Sie setzt Kapitel VI der Verordnung (EU) 2023/2854 („Data Act“) um.

2. Datenformate

Dieser Abschnitt ist unser Register der Datenstrukturen und Datenformate. Er beschreibt Format „stempla-business-export“, Version 1.

Aufbau der ZIP-Datei

Du bekommst eine Datei stempla-betriebsexport-<betrieb>-<datum>.zip mit diesem Inhalt:

Offene Schnittstelle

Regeln für alle Bereiche

Typen

uuid
Kennung im Format 8-4-4-4-12 (z. B. 3f2b…)
text
Zeichenkette
integer
Ganzzahl
number
Dezimalzahl
boolean
true oder false
date
Datum JJJJ-MM-TT
time
Uhrzeit hh:mm:ss
timestamp
Zeitpunkt nach ISO 8601 mit Zeitzone
json
verschachtelter Wert; in der CSV als JSON-Text

Bereiche und Felder

Ein Abschnitt je Bereich in data. „Liste“ heißt: ein Eintrag je Zeile, auch als CSV. „Objekt“ heißt: nur in export.json.

business Objekt Profil des Betriebs
Feld Typ Bedeutung
id uuid Kennung des Betriebs
name text Name des Betriebs
slug text Adresse der Betriebsseite auf stempla.at (/de/betriebe/<slug>/)
category text Branche
logo_url text Adresse des Logos (Datei liegt auch in bilder/)
address text Adresse
city text Ort
zip text Postleitzahl
country text Land
phone text Telefon
email text E-Mail des Betriebs
website text Website
opening_hours json Öffnungszeiten (älteres Feld; maßgeblich sind die Standorte)
latitude number Breitengrad
longitude number Längengrad
about_de text „Über uns“ (Deutsch)
about_en text „Über uns“ (Englisch)
cover_image_url text Adresse des Titelbilds (Datei liegt auch in bilder/)
google_review_url text Link zur Google-Bewertung
feedback_enabled boolean Rückmeldungen nach dem Besuch aktiv
welcome_stamp_enabled boolean Willkommensbonus (Stempel) aktiv
welcome_stamp_card_id uuid Karte für den Willkommensbonus (älteres Feld)
welcome_stamp_count integer Stempel des Willkommensbonus
welcome_reward_config json Willkommensprämie: aktiv, Text DE/EN, Gültigkeit in Tagen
birthday_campaign_config json Einstellungen der Geburtstagsaktion
qr_template_config json Eigene Texte für das Werbematerial
is_listed boolean Im Verzeichnis sichtbar
is_coming_soon boolean Als „Bald verfügbar“ gelistet
coming_soon_until timestamp Geplanter Start bei „Bald verfügbar“
onboarding_done boolean Einrichtung abgeschlossen
trial_start timestamp Beginn der Testphase
trial_end timestamp Ende der Testphase
group_id uuid Gruppe oder Verbund (→ group.id), sonst leer
is_group_home boolean Konto der Gruppe bzw. des Verbands selbst
created_at timestamp Angelegt am
updated_at timestamp Zuletzt geändert am
locations Liste, auch CSV Standorte
Feld Typ Bedeutung
id uuid Kennung des Standorts
business_id uuid Betrieb
name text Name des Standorts
kind text fixed = fester Standort, mobile = unterwegs mit Terminen
address text Adresse
city text Ort
zip text Postleitzahl
country text Land
latitude number Breitengrad
longitude number Längengrad
phone text Telefon
email text E-Mail
website text Website
is_primary boolean Hauptstandort
is_active boolean Aktiv
sort_order integer Reihenfolge
hours_mode text fixed = feste Zeiten, appointment = nach Vereinbarung, both = beides
hours_program boolean Öffnungszeiten laut Programm
opening_hours json Wochen-Öffnungszeiten
opening_hours_base json Standard-Wochenzeiten, solange eine Saison eigene Zeiten hat
holiday_rule text Feiertage: closed = zu, custom = eigene Zeiten, as_weekday = wie Wochentag
holiday_hours json Zeiten an Feiertagen (nur bei custom)
hours_note_de text Hinweis zu den Öffnungszeiten (Deutsch)
hours_note_en text Hinweis zu den Öffnungszeiten (Englisch)
timezone text Zeitzone (Europe/Vienna)
google_review_url text Link zur Google-Bewertung des Standorts
created_at timestamp Angelegt am
updated_at timestamp Zuletzt geändert am
location_seasons Liste, auch CSV Saisons je Standort
Feld Typ Bedeutung
id uuid Kennung der Saison
location_id uuid Standort (→ locations.id)
name_de text Name (Deutsch)
name_en text Name (Englisch)
starts_on date Beginn
ends_on date Ende
repeats_yearly boolean Wiederholt sich jedes Jahr
opening_hours json Eigene Wochenzeiten der Saison
sort_order integer Reihenfolge
created_at timestamp Angelegt am
updated_at timestamp Zuletzt geändert am
location_closures Liste, auch CSV Schließtage und Saisonpausen
Feld Typ Bedeutung
id uuid Kennung des Eintrags
location_id uuid Standort (→ locations.id)
kind text closure = vom Betrieb eingetragen, season = Saisonpause
starts_on date Erster Tag
ends_on date Letzter Tag
is_closed boolean Ganz geschlossen (sonst geänderte Zeiten)
hours json Geänderte Zeiten
note_de text Hinweis (Deutsch)
note_en text Hinweis (Englisch)
repeats_yearly boolean Wiederholt sich jedes Jahr
closure_group_id uuid Gleiche Kennung = ein Eintrag für mehrere Standorte
created_at timestamp Angelegt am
updated_at timestamp Zuletzt geändert am
location_dates Liste, auch CSV Termine von Standorten unterwegs
Feld Typ Bedeutung
id uuid Kennung des Termins
location_id uuid Standort (→ locations.id)
title_de text Titel (Deutsch)
title_en text Titel (Englisch)
address text Adresse
zip text Postleitzahl
city text Ort
country text Land
latitude number Breitengrad
longitude number Längengrad
starts_on date Erster Tag
ends_on date Letzter Tag
opens_at time Beginn (Uhrzeit)
closes_at time Ende (Uhrzeit)
day_hours json Abweichende Zeiten je Tag
note_de text Hinweis (Deutsch)
note_en text Hinweis (Englisch)
link text Link zum Termin
preview_days integer Tage vorher als „Bald hier“ sichtbar
cancelled_at timestamp Abgesagt am (leer = nicht abgesagt)
series_id uuid Gleiche Kennung = gleiche Serie
created_at timestamp Angelegt am
updated_at timestamp Zuletzt geändert am
stamp_cards Liste, auch CSV Stempelkarten
Feld Typ Bedeutung
id uuid Kennung der Karte
business_id uuid Betrieb
name text Name der Karte
description text Beschreibung
stamps_required integer Stempel bis zur Prämie
reward_description text Prämie (älteres Feld)
reward_description_de text Prämie (Deutsch)
reward_description_en text Prämie (Englisch)
reward_expires_days integer Gültigkeit der Prämie in Tagen
conditions_de text Bedingungen (Deutsch)
conditions_en text Bedingungen (Englisch)
stamp_rule_type text Stempel-Regel: visit, amount, product oder custom
stamp_rule_amount number Betrag in Euro je Stempel (nur bei amount)
stamp_rule_text_de text Text der Stempel-Regel (Deutsch)
stamp_rule_text_en text Text der Stempel-Regel (Englisch)
min_stamp_interval text Mindestabstand: off, 1h, 2h, 4h oder visit_day
color text Farbe
icon text Symbol
background_image_url text Adresse des Kartenbilds (Datei liegt auch in bilder/)
is_active boolean Aktiv
sort_order integer Reihenfolge
created_at timestamp Angelegt am
updated_at timestamp Zuletzt geändert am
settings Objekt Einstellungen (drei Unterobjekte)
Feld Typ Bedeutung
notifications.notify_inactivity boolean Erinnerung an Gäste, die lange nicht da waren
notifications.notify_reactivation boolean Nachricht bei Rückkehr
notifications.inactivity_days integer Tage bis zur Erinnerung
notifications.created_at timestamp Angelegt am
notifications.updated_at timestamp Zuletzt geändert am
misuse_protection.enabled boolean Schutz vor Missbrauch aktiv
misuse_protection.updated_at timestamp Zuletzt geändert am
hazel_data_access.enabled boolean Hazel darf die eigenen Zahlen lesen
hazel_data_access.decided_at timestamp Entschieden am
team Liste, auch CSV Team, ohne E-Mail-Adressen
Feld Typ Bedeutung
team_id uuid Kennung des Teammitglieds im Betrieb (keine Konto-Kennung)
name text Anzeigename
role text owner, manager oder employee
active boolean Aktiv
joined_at timestamp Beigetreten am
deactivated_at timestamp Deaktiviert am
location_ids json Zugeordnete Standorte (Liste von locations.id)
team_notices Liste, auch CSV Hinweise an das Team mit Zeitpunkt der Anzeige (Nachweis)
Feld Typ Bedeutung
team_id uuid Teammitglied (→ team.team_id)
notice_key text Kennung des Hinweises
role text Rolle zum Zeitpunkt
shown_at timestamp Angezeigt am
app_version text App-Version
guest_cards Liste, auch CSV Kartenstand je Gast und Karte
Feld Typ Bedeutung
guest text Gast-Kennung, gilt nur in diesem Export (12 Zeichen); leer bei Geburtstagsgeschenken und automatisch vergebenen Stempeln
stamp_card_id uuid Stempelkarte (→ stamp_cards.id)
current_stamps integer Aktuelle Stempel
completed_at timestamp Zuletzt voll am
created_at timestamp Karte begonnen am
stamps Liste, auch CSV Stempelverlauf, auch Stempel dieses Betriebs auf Gruppen- oder Verbundkarten
Feld Typ Bedeutung
stamped_at timestamp Zeitpunkt
guest text Gast-Kennung, gilt nur in diesem Export (12 Zeichen); leer bei Geburtstagsgeschenken und automatisch vergebenen Stempeln
stamp_card_id uuid Stempelkarte (→ stamp_cards.id)
location_id uuid Standort (→ locations.id)
date_id uuid Termin unterwegs (→ location_dates.id)
team_id uuid Teammitglied (→ team.team_id); leer bei Systemstempeln (z. B. Willkommen, Geburtstag) und bei Stempeln anderer Betriebe
team_name text Name des Teammitglieds zum Zeitpunkt; leer wie team_id
stamp_transfers Liste, auch CSV Übertragene Papierkarten
Feld Typ Bedeutung
created_at timestamp Zeitpunkt
guest text Gast-Kennung, gilt nur in diesem Export (12 Zeichen); leer bei Geburtstagsgeschenken und automatisch vergebenen Stempeln
stamp_card_id uuid Stempelkarte (→ stamp_cards.id)
stamp_count integer Übertragene Stempel
location_id uuid Standort (→ locations.id)
team_id uuid Teammitglied (→ team.team_id); leer, wenn ein anderer Betrieb übertragen hat
rewards Liste, auch CSV Prämien samt Einlösung
Feld Typ Bedeutung
reward_id uuid Kennung der Prämie
guest text Gast-Kennung, gilt nur in diesem Export (12 Zeichen); leer bei Geburtstagsgeschenken und automatisch vergebenen Stempeln
stamp_card_id uuid Stempelkarte (→ stamp_cards.id)
source text Herkunft: stamp_card (volle Karte), birthday (Geburtstag) oder welcome (Willkommensprämie)
status text pending (offen), redeemed (eingelöst) oder expired (abgelaufen)
description_de text Prämie (Deutsch)
description_en text Prämie (Englisch)
earned_at timestamp Erhalten am
valid_from date Einlösbar ab (leer = sofort)
expires_at timestamp Gültig bis
redeemed_at timestamp Eingelöst am
redeemed_location_id uuid Standort der Einlösung
redeemed_team_id uuid Teammitglied der Einlösung (→ team.team_id); leer, wenn ein anderer Betrieb eingelöst hat
redeemed_by_business boolean In diesem Betrieb eingelöst
welcome_bonuses Liste, auch CSV Eingelöste Willkommensboni
Feld Typ Bedeutung
redeemed_at timestamp Zeitpunkt
guest text Gast-Kennung, gilt nur in diesem Export (12 Zeichen); leer bei Geburtstagsgeschenken und automatisch vergebenen Stempeln
stamp_card_id uuid Stempelkarte (→ stamp_cards.id)
stamp_count integer Stempel
reward_id uuid Willkommensprämie (→ rewards.reward_id)
feedback Liste, auch CSV Rückmeldungen der Gäste, ohne Namen und ohne Gast-Kennung
Feld Typ Bedeutung
day date Tag der Rückmeldung (Wiener Zeit, bewusst ohne Uhrzeit)
location_id uuid Standort (→ locations.id)
stamp_card_id uuid Stempelkarte (→ stamp_cards.id)
stars integer Sterne (1 bis 5)
comment text Text des Gasts
status text sent (gesendet) oder closed (erledigt)
google_opened boolean Link zur Google-Bewertung geöffnet
misuse_hits Liste, auch CSV Treffer des Missbrauchsschutzes, ohne Gast-Kennung
Feld Typ Bedeutung
visit_day date Betroffener Tag
rule text Art: same_day, employee_volume oder frequent_override
stamp_card_id uuid Stempelkarte (→ stamp_cards.id)
team_id uuid Teammitglied (→ team.team_id)
team_name text Name des Teammitglieds
event_count integer Zahl der Vorgänge
messages Liste, auch CSV Nachrichten an Gäste mit zusammengefassten Zahlen
Feld Typ Bedeutung
sent_at timestamp Gesendet am
kind text message, appearance (Termin), season_start (Saisonstart) oder cancellation (Absage)
segment text Zielgruppe
location_id uuid Standort (→ locations.id)
date_id uuid Termin unterwegs (→ location_dates.id)
title_de text Titel (Deutsch)
title_en text Titel (Englisch)
body_de text Text (Deutsch)
body_en text Text (Englisch)
targeted integer Gäste in der Zielgruppe
sent integer Zugestellt in der App
pushed integer Als Push-Nachricht gesendet
ai_assisted boolean Mit Textvorschlag von Hazel erstellt
statistics_monthly Liste, auch CSV Statistik je Monat (Wiener Zeit)
Feld Typ Bedeutung
month date Monat (erster Tag)
stamps integer Stempel, die dieser Betrieb vergeben hat
new_guests integer Neue Gäste: erster Stempel eines Gasts bei diesem Betrieb
rewards_earned integer Prämien, die bei diesem Betrieb verdient wurden
rewards_redeemed integer Prämien, die in diesem Betrieb eingelöst wurden
billing_months Liste, auch CSV Monatsabschlüsse (Beträge in Cent)
Feld Typ Bedeutung
id uuid Kennung des Abschlusses
business_id uuid Betrieb
business_name text Name des Betriebs zum Zeitpunkt
group_id uuid Gruppe (bei Abrechnung als Gruppe)
group_name text Name der Gruppe
unit_kind text business oder group
month date Monat (erster Tag)
phase text trial, contract oder inactive
billable boolean Monat wird verrechnet
stammgast_count integer Stammgäste
return_visits integer Wiederbesuche
active_locations integer Aktive Standorte
unit_cents integer Preis je Stammgast
min_cents integer Mindestbetrag
cap_cents integer Höchstbetrag (Deckel) des Monats
cap_first_cents integer Deckel erster Standort
cap_addon_cents integer Deckel-Aufschlag je weiterem Standort
has_override boolean Eigene Preise vereinbart
is_fixed boolean Fixpreis vereinbart
fixed_price_cents integer Fixpreis
fixed_price_included_locations integer Im Fixpreis enthaltene Standorte
fixed_price_location_addon_cents integer Aufschlag je weiterem Standort beim Fixpreis
calc_amount_cents integer Betrag laut Rechnung vor einem Erlass
amount_cents integer Geltender Betrag
is_min boolean Mindestbetrag angewendet
is_capped boolean Deckel angewendet
waived_min boolean Mindestbetrag erlassen
waived_all boolean Monat ganz erlassen
outage_days integer Ausfalltage
outage_reduction_cents integer Minderung wegen Ausfall
outage_min_waived boolean Mindestbetrag wegen Ausfall entfallen
rest_month boolean Ruhemonat, Mindestbetrag entfällt
rest_kind text Grund: season, no_appearances oder closure
rest_manual boolean Ruhemonat von uns gesetzt oder aufgehoben
rest_reduction_cents integer Minderung wegen Ruhemonat
currency text Währung
price_plan_id uuid Preisliste
terms_version text Fassung der Bedingungen
contract_start date Vertragsbeginn
contract_end date Vertragsende
trial_end_date date Ende der Testphase
computed_at timestamp Berechnet am
recompute_count integer Zahl der Neuberechnungen
exported_at timestamp Für die Rechnung übernommen am
created_at timestamp Angelegt am
billing_month_regulars Liste, auch CSV Stammgäste je Monatsabschluss, ohne Gast-Kennung
Feld Typ Bedeutung
billing_month_id uuid Monatsabschluss (→ billing_months.id)
qualifying_day date Tag, an dem der Gast zum Stammgast wurde
location_name text Standort
visit_days_in_month integer Besuchstage im Monat
return_visits integer Wiederbesuche im Monat
contract Objekt Vertragsdaten (Beträge in Cent; leer, wenn keine vereinbart)
Feld Typ Bedeutung
business_id uuid Betrieb
contract_start date Vertragsbeginn
contract_end date Vertragsende
price_plan_id uuid Preisliste
fixed_price_cents integer Fixpreis
fixed_price_included_locations integer Im Fixpreis enthaltene Standorte
fixed_price_location_addon_cents integer Aufschlag je weiterem Standort beim Fixpreis
fixed_price_until date Fixpreis gilt bis
unit_cents_override integer Eigener Preis je Stammgast (leer = Preisliste)
min_cents_override integer Eigener Mindestbetrag (leer = Preisliste)
cap_first_cents_override integer Eigener Deckel erster Standort (leer = Preisliste)
cap_addon_cents_override integer Eigener Deckel-Aufschlag (leer = Preisliste)
trial_bonus_months integer Zusätzliche Testmonate
monthly_mail_enabled boolean Mail „Dein Monat bei Stempla“ aktiv
created_at timestamp Angelegt am
updated_at timestamp Zuletzt geändert am
location_confirmations Liste, auch CSV Bestätigungen beim Anlegen oder Schließen von Standorten (Vertragsdaten)
Feld Typ Bedeutung
created_at timestamp Zeitpunkt
action text Art der Änderung, z. B. add (Standort dazu)
location_name text Name des Standorts
location_id uuid Standort (→ locations.id)
source text Weg, z. B. app oder admin
confirmed_by_name text Name der Person, die bestätigt hat
role text Rolle dieser Person
old_active_locations integer Aktive Standorte vorher
new_active_locations integer Aktive Standorte nachher
old_cap_cents integer Deckel vorher
new_cap_cents integer Deckel nachher
is_fixed boolean Fixpreis vereinbart
in_trial boolean In der Testphase
trial_end timestamp Ende der Testphase
terms_version text Fassung der Bedingungen
accepted_terms Liste, auch CSV Entscheidungen zu Fassungen der Bedingungen
Feld Typ Bedeutung
version text Fassung
decision text accepted (angenommen) oder rejected (abgelehnt)
accepted_at timestamp Zeitpunkt der Entscheidung
accepted_by_name text Name der Person, die entschieden hat
rejected_at timestamp Abgelehnt am
source text Weg, z. B. app, admin oder antrag
hazel_usage Liste, auch CSV Fragen an Hazel je Monat
Feld Typ Bedeutung
month date Monat (erster Tag)
questions integer Fragen
hazel_assist Liste, auch CSV Übersetzen und Textvorschläge von Hazel je Monat
Feld Typ Bedeutung
month date Monat (erster Tag)
kind text translate (Übersetzen) oder suggest (Textvorschlag)
used integer Genutzt
group Objekt Nur bei Gruppen und Verbünden
Feld Typ Bedeutung
id uuid Kennung der Gruppe
name text Name
kind text company (Gruppe) oder federation (Verbund)
is_group_home boolean Dieser Export betrifft das Konto der Gruppe bzw. des Verbands
locals json Lokale der Gruppe (business_id, name); bei Bühnen eines Verbunds leer
images Liste, nur JSON Bilder (Adressen; beim Export durch Stempla liegen die Dateien zusätzlich im Ordner bilder/)
Feld Typ Bedeutung
kind text logo, cover (Titelbild), card_background (Kartenbild) oder group_logo (Logo der Gruppe, nur Gruppen-Betrieb)
ref text Kennung des Betriebs bzw. der Karte
url text Ursprüngliche Adresse

Diese Daten gehören nicht dazu

Bekannte Einschränkungen beim Wechsel

Gedruckte QR-Codes, Aufsteller und Links zu deinem Betrieb führen nach dem Ende nicht mehr zu einer aktiven Karte. Stempel und Prämien deiner Gäste sehen die Gäste bis zur Löschung deines Betriebs; dann werden sie gelöscht. Ein anderer Anbieter kann sie nicht ohne die Gäste übernehmen. Für offene Prämien bleibst du nach den Bedingungen verantwortlich. Informiere deine Gäste rechtzeitig.

Du darfst den Export einem neuen Anbieter geben und mit deinen oder seinen Systemen nutzen, um dein Treueprogramm fortzuführen und auszuwerten. Du musst ihn erst löschen, wenn du ihn dafür nicht mehr brauchst. Ab Erhalt bist du für den Export selbst Verantwortlicher nach der DSGVO. Versuche nicht, Gäste über die Gast-Kennung zu erkennen; dafür bräuchtest du eine eigene Rechtsgrundlage (Anlage, „Daten im Export“).

Normen

Für Treueprogramme gibt es noch keine Normen oder offenen Spezifikationen im Unionsverzeichnis nach Art. 35 Data Act. Deshalb nutzen wir das hier beschriebene, offene Format aus JSON und CSV.

3. Serverstandort und Behördenzugriff

Wo unsere Server stehen und welchem Recht die Unternehmen dahinter unterliegen, je Dienst:

Dienst Infrastruktur Unternehmen, Sitz
App-Datenbank, Dateien, Serverfunktionen Supabase, Region EU West (Paris); Rechenzentren von Amazon Web Services Supabase Pte. Ltd. (Singapur); Support Supabase, Inc. (USA); Hosting Amazon Web Services, Inc. (USA)
Hazel auf der Website, Kennzahlen von Hazel, Chat Supabase, Region Frankfurt am Main wie oben
Netzwerk vor den Serverfunktionen, Spam-Schutz im Antrag Cloudflare Cloudflare, Inc. (USA)
KI-Modell für Hazel Anthropic Anthropic PBC (USA)
Push-Nachrichten Firebase Cloud Messaging, weltweite Rechenzentren von Google Google LLC (USA)
Website, Verwaltung, Kundenportal, E-Mail Hostinger Hostinger International Ltd. (Zypern)

Was wir gegen unrechtmäßigen Zugriff fremder Behörden tun

Die Datenbank mit den Daten deines Betriebs und das Kundenportal liegen in Rechenzentren in der EU. Für Push-Nachrichten und die KI-Assistentin Hazel arbeiten Dienstleister in den USA (siehe Tabelle). Die Daten sind bei der Übertragung und bei der Speicherung verschlüsselt. Unser Dienstleister für Website und Kundenportal gibt Daten laut Vertrag nur heraus, wenn ein Gesetz oder eine verbindliche behördliche Anordnung es verlangt. Wir selbst geben Daten deines Betriebs nie freiwillig an Behörden außerhalb der EU. Erreicht uns ein solches Verlangen, prüfen wir es, geben nur das rechtlich Nötige heraus und informieren dich, soweit wir dürfen. Wir speichern nur, was Stempla braucht.

Wie wir personenbezogene Daten verarbeiten, steht in der Datenschutzerklärung.

4. Entgelte