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
- Du kannst jederzeit verlangen, zu einem anderen Anbieter oder auf eigene Systeme zu wechseln, deine Daten löschen zu lassen oder beides. Eine E-Mail an support@stempla.at genügt. Das Verlangen gilt zugleich als Kündigung zum nächstmöglichen Termin. In einer Gruppe geht das auch für einzelne Lokale.
- Die Frist ist deine Kündigungsfrist, höchstens zwei Monate. Das gilt auch in der Testphase.
- Wir stellen die Daten spätestens 30 Kalendertage nach Ende der Frist bereit, meist schon früher, dir oder einem Anbieter, den du uns von der E-Mail-Adresse deines Betriebskontos nennst. Nach Ende der Frist läuft Stempla für dich und deine Gäste bis zur Bereitstellung ohne Entgelt weiter.
- Du kannst die Daten mindestens 30 Kalendertage erneut abrufen, in jedem Fall bis zur Löschung deines Betriebs 6 Monate nach dem Kündigungstermin.
- Danach löschen wir alle exportierbaren Daten deines Betriebs. Wir bewahren nur auf, was ein Gesetz verlangt, vor allem Abrechnungsbelege 7 Jahre.
- Wechsel, Export und Löschung sind kostenlos.
- Den Export bekommst du auch ohne Kündigung jederzeit kostenlos. Als Inhaber:in erstellst du ihn selbst in der App: Einstellungen → Rechtliches → Deine Daten → Betriebsdaten exportieren (ab App 2.2.0). Oder du forderst ihn per E-Mail an; dann bekommst du ihn an die Adresse deines Betriebskontos oder als Download-Link. Löschst du dein Betriebskonto selbst in der App, sind die Daten danach weg; exportiere sie vorher.
- Daten zu Stempla mitnehmen: Stempel von Papierkarten überträgst du in der App je Gast beim Stempeln. Einen Massen-Import aus einem anderen System gibt es nicht.
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:
-
export.json: alle Daten in einer Datei, UTF-8. Oben stehenformat(stempla-business-export),version(1),created_at,business_idundbusiness_name, darunter indatadie Bereiche unten. LIESMICH-README.txt: kurze Erklärung auf Deutsch und Englisch.-
csv/<bereich>.csv: jeder Bereich, der eine Liste ist und mindestens einen Eintrag hat, noch einmal als Tabelle. UTF-8 mit BOM, Komma als Trennzeichen, Kopfzeile mit den Feldnamen, Zeilenende CRLF. Verschachtelte Werte stehen als JSON-Text in der Zelle. Beginnt ein Text mit=,+,-,@, Tabulator oder Wagenrücklauf, steht ein'davor, damit Tabellenprogramme ihn nicht als Formel ausführen. Zahlen bleiben unverändert. Einzelne Objekte wiebusinessstehen nur inexport.json. -
bilder/<art>-<kennung>.<endung>(nur beim Export durch Stempla): Logo, Titelbild und Kartenbilder, z. B.bilder/logo-<kennung des betriebs>.png. Ließ sich ein Bild nicht laden, steht seine Adresse inbilder/FEHLT.txt. Im Export aus der App stehen die Bilder als Adressen im Bereichimages.
Offene Schnittstelle
-
Dieselben Daten gibt es kostenlos über eine Schnittstelle:
POST /rest/v1/rpc/business_data_exportmit dem Inhalt{"p_business_id": "<kennung des betriebs>"}. -
Anmeldung: das Anmelde-Token einer Inhaber:in des Betriebs
(
Authorization: Bearer …) und der öffentliche App-Schlüssel (apikey). Die Adresse des Servers und den öffentlichen Schlüssel nennen wir auf Anfrage an support@stempla.at. -
Antwort: JSON
{"found": true, "export": {…}};exporthat den Aufbau vonexport.jsonoben. Ein Export je Betrieb und 10 Minuten, sonst Fehlertoo_many_requests. Ohne Inhaber-Rolle: Fehlernot authorized. - Für einen neuen Anbieter ist der Regelweg die Datei: Du erstellst sie in der App und gibst sie weiter. Gib deine Zugangsdaten nicht weiter.
Regeln für alle Bereiche
- Leere Werte sind in JSON
nullund in der CSV eine leere Zelle. - Felder, die auf
_centsenden, sind Euro-Beträge in Cent. -
Monats- und Tageswerte wie
monthoderdaygelten in Wiener Zeit. Zeitpunkte tragen ihre Zeitzone mit. -
Gast-Kennung (
guest): Sie ist zufällig und gilt nur in diesem Export. Innerhalb der Datei steht derselbe Gast immer mit derselben Kennung; in einem späteren Export hat er eine andere. Namen, E-Mail-Adressen, Geburtstage und Konto-Kennungen von Gästen sind nicht enthalten. Geburtstagsgeschenke und automatisch vergebene Stempel (ohne Teammitglied) stehen ohne Gast-Kennung darin (guestleer), weil sich sonst der Geburtstag ablesen ließe. -
Gruppe: Das Konto der Gruppe (Gruppenkarten, Kartenstand, Abrechnung) und jedes Lokal (seine
Stempel) haben je einen eigenen Export. Verbund: Im Export des Verbands fehlen die Bereiche zu
einzelnen Gästen (
guest_cards,stamps,stamp_transfers,rewards,welcome_bonuses,feedback,misuse_hits). Instatistics_monthlyundmessagessind Zahlen von 1 bis 4 ausgeblendet (null). Ein Hinweis steht dann indataim Textfeldnote. -
Neue Felder und Bereiche kommen nur dazu; bestehende behalten Name und Bedeutung.
Ändert sich etwas nicht rückwärtsverträglich, erhöhen wir
version.
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 | |
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
- Wegen des Datenschutzes, der vorgeht: Daten, die deine Gäste als Personen erkennbar machen, etwa Name, E-Mail, Geburtstag und Konto-Kennung; das Protokoll des Missbrauchsschutzes mit einzelnen Stempelvorgängen (die Treffer bekommst du); die E-Mail-Adressen deines Teams. Für die Gastkonten sind wir allein verantwortlich.
- Weil sie Geschäftsgeheimnisse berühren und für den internen Betrieb von Stempla nötig sind: Prüfregeln des Missbrauchsschutzes, Zugangs- und Einladungscodes sowie technische Server- und Zugriffsprotokolle. Sie behindern den Wechsel nicht.
- Was nicht aus deiner Nutzung entsteht: Vorlagen, Programmcode und Gestaltung von Stempla selbst sowie unsere internen Notizen.
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
- Es gibt keine Wechselentgelte und keine Entgelte für den Export.
- Übergang, Verlängerung des Übergangs, Abruf und Löschung kosten nichts.
- Es gibt keine Strafen und keine Gebühren für eine Kündigung.
- Was Stempla laufend kostet, steht bei den Preisen für Betriebe.