Export údajov

Táto stránka opisuje samoobslužný export údajov firmy v službe HejSpoko a odovzdanie údajov pri prechode k inej službe podľa bodu 9a obchodných podmienok. Export jednotlivého hosťa podľa e-mailu je opísaný v zmluve o spracúvaní.

Kto a kde export stiahne

Export stiahne vlastník účtu v aplikácii: Nastavenia → Údaje zákazníkov → Export všetkých údajov. Manažér export nedostane. Export je dostupný vo všetkých stavoch účtu — počas skúšky, s predplatným, pri omeškanej platbe, v obmedzenom režime aj pri prekročenom počte prevádzok. Každý export sa zapíše do auditného záznamu na tej istej obrazovke.

Export obsahuje všetky údaje, ktoré firma v čase exportu uchováva, bez obmedzenia históriou programu. Údaje vymazané na žiadosť hosťa alebo po uplynutí lehoty uchovávania v ňom už nie sú; z takého podnetu ostáva anonymné hodnotenie, kategórie a dátum.

Formát

Export je jeden archív ZIP s názvom hejspoko-export-<firma>-<dátum>.zip. Obsahuje JSON súbory podľa typov údajov, znenie textov súhlasu a jeden CSV súbor podnetov.

JSON je v kódovaní UTF-8. Každý súbor okrem company.json je pole objektov.
Časy sú vo formáte ISO 8601 s časovým pásmom, napríklad 2026-10-16T08:03:56.123+00:00.
Identifikátory sú UUID. Väzby medzi súbormi idú cez ne: venue_id, qr_source_id, feedback_id.
Prázdna hodnota je null.
CSV je v kódovaní UTF-8 so značkou BOM, oddeľovač je bodkočiarka a každé pole je v úvodzovkách — súbor sa otvorí v Exceli so slovenskou alebo českou diakritikou.

Hodnotenie je číslo 1 až 4. Stav podnetu je new (nový), in_progress (rieši sa), handled (spracovaný) alebo invalid (neplatný).

Súbory a polia

company.json

Pole	Obsah
`id`	Identifikátor firmy.
`name`	Názov firmy.
`slug`	Skratka firmy v adresách.
`settings`	Nastavenia firmy (napríklad lehota uchovávania údajov).
`accepted_terms_version`	Verzia podmienok, ktorú firma prijala.
`accepted_terms_at`	Čas prijatia tejto verzie.
`created_at`	Čas založenia firmy.

venues.json

Pole	Obsah
`id`	Identifikátor prevádzky.
`name`	Názov prevádzky.
`slug`	Skratka prevádzky.
`venue_type`	Typ prevádzky.
`logo_url`	Adresa loga.
`default_locale`	Náhradný jazyk textov prevádzky.
`timezone`	Časové pásmo prevádzky.
`public_review_enabled`	Či hodnotiaca stránka ponúka verejnú recenziu.
`review_links`	Odkazy na verejné recenzie: `platform` a `url`.
`intro_text`	Úvodný text pre hosťa po jazykoch.
`thanks_text`	Text poďakovania po jazykoch.
`feedback_prompts`	Otázky na druhej obrazovke po jazykoch.
`negative_threshold`	Prah hodnotenia pre upozornenie.
`escalation_minutes`	Minúty do pripomienky, keď nikto nereaguje.
`quiet_hours_start`	Začiatok tichých hodín.
`quiet_hours_end`	Koniec tichých hodín.
`discount_validity_days`	Platnosť zľavového kódu v dňoch.
`manager_can_send_discount`	Či smie manažér priložiť zľavový kód.
`default_discount_text`	Predvolený text zľavy.
`discount_presets`	Prednastavené ponuky zľavy.
`created_at`	Čas vytvorenia prevádzky.
`deleted_at`	Čas zatvorenia prevádzky, ak je zatvorená.

Heslo prevádzky na uplatnenie zľavy sa neexportuje.

qr_sources.json

Pole	Obsah
`id`	Identifikátor QR kódu.
`venue_id`	Prevádzka.
`label`	Označenie kódu (napríklad stôl).
`placement`	Typ umiestnenia.
`slug`	Kód v adrese hodnotiacej stránky.
`is_active`	Či je kód aktívny.
`created_at`	Čas vytvorenia.

feedbacks.json

Všetky podnety vrátane podnetov bez e-mailu, neplatných a anonymizovaných.

Pole	Obsah
`id`	Identifikátor podnetu.
`venue_id`	Prevádzka.
`qr_source_id`	QR kód, z ktorého podnet prišiel.
`created_at`	Čas hodnotenia.
`completed_at`	Čas odoslania druhej obrazovky, ak ju hosť odoslal.
`rating`	Hodnotenie 1 až 4.
`comment`	Komentár hosťa.
`comment_removed`	Či bol komentár vymazaný.
`locale`	Jazyk, v ktorom hosť hodnotil.
`status`	Stav podnetu.
`contact_email`	E-mail hosťa, ak ho zadal.
`wants_reply`	Či hosť žiadal odpoveď.
`marketing_consent`	Súhlas s marketingom udelený pri tomto podnete.
`marketing_consent_version`	Verzia textu súhlasu, ktorý hosť videl; prázdne bez súhlasu.
`marketing_consented_at`	Čas udelenia súhlasu.
`internal_note`	Interná poznámka.
`first_response_at`	Čas prvej reakcie.
`handled_at`	Čas spracovania.
`escalated_at`	Čas pripomienky.
`anonymized_at`	Čas výmazu osobných údajov.
`country_code`	Krajina zariadenia.
`device_type`	Typ zariadenia.

marketing_consents.json

Dôkazy súhlasov s marketingom. Záznam vznikne pri udelení súhlasu a ostane aj po odvolaní, výmaze podnetu alebo e-mailu; zmaže sa 4 roky po ukončení súhlasu. E-mail v ňom nie je, len jeho jednosmerný odtlačok.

Pole	Obsah
`id`	Identifikátor dôkazu.
`venue_id`	Prevádzka.
`feedback_id`	Podnet, pri ktorom hosť súhlas udelil; prázdne, ak podnet už neexistuje.
`email_hash`	Odtlačok e-mailu hosťa, jedinečný pre firmu.
`text_version`	Verzia textu súhlasu.
`locale`	Jazyk textu, ktorý hosť videl.
`granted_at`	Čas udelenia.
`ended_at`	Čas ukončenia; prázdne, kým súhlas platí.
`end_reason`	`withdrawn` = hosť súhlas odvolal, `erased` = výmaz údajov hosťa, `expired` = uplynula lehota uchovávania.

marketingconsenttexts.json

Znenie každej verzie textu súhlasu v každom jazyku, aby sa text_version dal prečítať bez ďalších podkladov.

Pole	Obsah
`version`	Verzia textu.
`locale`	Jazyk.
`text`	Znenie, ktoré hosť videl pri zaškrtávacom poli.

messages.json

Pole	Obsah
`id`	Identifikátor správy.
`feedback_id`	Podnet, ku ktorému správa patrí.
`direction`	`outbound` = odpoveď prevádzky, `inbound` = správa hosťa.
`body`	Text správy.
`sent_by_name`	Kto z firmy správu odoslal.
`created_at`	Čas správy.

categories.json

Pole	Obsah
`feedback_id`	Podnet.
`category`	Kategória.
`created_at`	Čas priradenia.

compensations.json

Pole	Obsah
`id`	Identifikátor zľavového kódu.
`feedback_id`	Podnet, ku ktorého odpovedi bol kód priložený.
`venue_id`	Prevádzka.
`code`	Zľavový kód.
`value_text`	Text zľavy.
`valid_until`	Platnosť do.
`redeemed_at`	Čas uplatnenia.
`created_at`	Čas vydania.

change_log.json

História citlivých zmien. Hodnoty, ktoré sa neuchovávajú, sú nahradené ***.

Pole	Obsah
`table_name`	Typ záznamu, ktorý sa zmenil.
`record_id`	Identifikátor záznamu.
`action`	Druh zmeny.
`changed`	Zmenené polia s hodnotami `from` a `to`.
`actor_name`	Kto zmenu urobil; prázdne pri systémovej zmene.
`created_at`	Čas zmeny.

feedbacks.csv

Tie isté podnety ako feedbacks.json v tabuľke. Prevádzka a QR kód sú uvedené názvom, kategórie ako zoznam oddelený čiarkou. Konverzácie sú v messages.json.

Pole	Obsah
`id`	Identifikátor podnetu.
`created_at`	Čas hodnotenia.
`completed_at`	Čas odoslania druhej obrazovky.
`venue`	Názov prevádzky.
`qr_label`	Označenie QR kódu.
`rating`	Hodnotenie 1 až 4.
`comment`	Komentár hosťa.
`comment_removed`	Či bol komentár vymazaný.
`locale`	Jazyk hodnotenia.
`status`	Stav podnetu.
`contact_email`	E-mail hosťa.
`wants_reply`	Či hosť žiadal odpoveď.
`marketing_consent`	Súhlas s marketingom pri tomto podnete.
`marketing_consent_version`	Verzia textu súhlasu.
`marketing_consented_at`	Čas udelenia súhlasu.
`categories`	Kategórie.
`internal_note`	Interná poznámka.
`first_response_at`	Čas prvej reakcie.
`handled_at`	Čas spracovania.
`escalated_at`	Čas pripomienky.
`anonymized_at`	Čas výmazu osobných údajov.
`country_code`	Krajina zariadenia.
`device_type`	Typ zariadenia.

Čo export neobsahuje

Heslo prevádzky, prístupové kľúče a tokeny, technické odtlačky zariadenia a IP adresy slúžiace na ochranu formulára, zdrojový kód služby a údaje iných zákazníkov.

Odovzdanie pri prechode k inej službe

O prechod k inému poskytovateľovi alebo o prenos do vlastnej infraštruktúry žiada vlastník účtu e-mailom na info@hejspoko.sk. Žiadosť potvrdíme a dohodneme bezpečný spôsob odovzdania. Po výpovednej lehote podľa bodu 9a obchodných podmienok nasleduje prechodná lehota najviac 30 kalendárnych dní, počas ktorej export sprístupníme v tomto formáte. Samoobslužný export môže vlastník stiahnuť kedykoľvek aj skôr.

Za prechod ani za export neúčtujeme poplatok za zmenu poskytovateľa.

Verzia: 16. 10. 2026. Účinné od: 16. 10. 2026.