Príručka k vládnym systémom
Questura, ISTAT, PayTourist a európske konektory — konfigurácia, prihlasovacie údaje a automatické odosielanie
Obsah
Ako ďaleko je prepojenieUpozornenie, ktoré aplikácia zobrazuje, a čo znamená
Registrácia hostí funguje v každej krajine, kde je Vezpa dostupná, a funguje ďalej. Čo nie je zapnuté všade, je automatické prepojenie s úradom: odosielanie údajov, ktoré ste už zaznamenali.
Tam, kde prepojenie ešte nie je aktívne, v hornej časti Profil → Vládna registrácia nájdete informačný rámček, ktorý to hovorí: automatické odosielanie úradu danej krajiny sa testuje a registrácia hostí funguje normálne. Je to len informácia: nič neblokuje, nie je čo potvrdzovať ani zatvárať, a rámček sa objaví aj vtedy, keď pre vašu krajinu zatiaľ žiadny konektor na nastavenie nie je.
Rámček zmizne sám, keď sa prepojenie pre vašu krajinu stane aktívnym: nemusíte nič robiť a žiadne nastavenie netreba meniť. Oddiely nižšie opisujú, ako sa každý systém nastavuje; upozornenie hovorí, ako ďaleko je.
Kedy odchádza to, čo ste autorizovaliTri rytmy, košík „Na odoslanie“ a prehľad dňa
Ostatné časti hovoria, komu Vezpa hlási a akými prihlasovacími údajmi. Táto hovorí, kedy, pretože rozhodnutie patrí objektu a robíte ho vy: otvorte Konfigurácia → Vládna registrácia a v rámčeku „Kedy odosielať úradom“ zvoľte jeden z troch rytmov. Platí v každej krajine: v Taliansku riadi hlásenia policajnému riaditeľstvu Questura cez službu Alloggiati Web štátnej polície Polizia di Stato, inde odosielania konektora vašej krajiny.
- „Každé 4 hodiny“ — šesť prechodov za deň. Zaregistrujete hosťa a ďalej na to nemyslíte.
- „O 23:15“ — jediný prechod, na konci dňa.
- „Ručne“ — odchádza len to, čo vyberiete a odošlete vy.
Košík „Na odoslanie“
Len čo zvolíte ručný rytmus, v tom istom rámčeku sa objaví položka „Na odoslanie“: je to košík rezervácií, ktoré čakajú, zoskupených podľa dňa príchodu. Zaškrtnete tie, ktoré chcete nahlásiť, a stlačíte „Odoslať vybrané“. Pri ostatných dvoch rytmoch tam tá položka nie je a nič nechýba: nie je čo vyberať, všetko odíde samo.
Autorizovať nie je odoslať a ten rozdiel nie je malichernosť. Keď stlačíte, povolenie sa zapíše pred odchodom a jediné stlačenie môže odniesť len časť práce: vtedy vám to stránka povie — „autorizované, ale odoslanie ešte nie je dokončené“ — a ponúkne „Dokončiť teraz“. Stlačíte znova a pokračuje tam, kde sa zastavilo: nie je to chyba. Z rovnakého dôvodu na obrazovke nikdy nečítate slovo odoslaná: rezervácia je „Autorizovaná“, keď povolenie existuje, a či ju úrad skutočne prijal, hovorí výsledok, jeden po druhom.
ISTAT a PayTourist idú za Questurou
Tu nie je čo rozhodovať a nie je žiadny druhý vypínač: ISTAT a PayTourist idú za Questurou samy. Ak bola rezervácia nahlásená Questure, nahlásia ju aj ony; ak nebola, nenahlásia ju. Tak je to postavené a pri ručnom rytme to má následok, ktorý je dobré poznať dopredu: noc, ktorú ste ešte neodoslali, dorazí do ISTAT ako zatvorená izba. Ručný rytmus zapnite len vtedy, ak ste pripravení odosielať pravidelne, inak sa vaše údaje o obsadenosti zmenia z dôvodu, ktorý nemá s vašimi izbami nič spoločné.
Ručne Questura prijme len dnešok a včerajšok
Nie je to naša voľba, je to portál: Alloggiati Web berie ako dátum príchodu len dnešok alebo včerajšok a za touto hranicou je hlásenie odmietnuté. Nie je to formalita, pretože hlásenie so starým dátumom samo o sebe ohlasuje odoslanie po termíne. Preto má košík okno: pri ručnom rytme odložiť o dva dni nie je odložiť, ale stratiť.
Prehľad dňa
Z hornej časti stránky „Na odoslanie“ sa otvára „Prehľad dňa“: kde dnes stojíte, v troch číslach — „Dnešní hostia“, „Autorizovaní“ a „Vybraní na odoslanie“. Stránka je len na čítanie: odtiaľ sa nič nepridáva a nič neodoberá, do košíka sa vraciate cez „Pridať alebo odobrať rezervácie“. Dve miesta, ktoré píšu ten istý zoznam, by boli dva rôzne zoznamy.
Dva riadky, na ktoré sa treba pozrieť, sú tieto, pretože na ne sa reaguje:
- Vybraní hostia, ktorých ešte nemožno nahlásiť — chýba ich registrácia. Neodídu: zaregistrujte ich a vrátia sa do hlásenia.
- Hostia, ktorých výber vyšel z okna — neodídu, výber sa už nedá odobrať a z aplikácie nie je čo robiť: na tie dni sa ide cez portál úradu. Počítajú sa oddelene od vybraných, nie medzi nimi, a tento prehľad je jediné miesto, ktoré vám ich ešte zobrazuje.
Prihlasovacie údaje sa menia podľa krajinyPolia, ktoré žiada úrad, a tie, ktoré platia pre jednotku
Stránka s prihlasovacími údajmi nie je pre všetkých rovnaký formulár. Okrem spoločných polí — používateľské meno, heslo, identifikátor zariadenia, adresa služby — každá krajina uvádza ďalšie polia, ktoré jej úrad vyžaduje, a stránka ich vykreslí sama: otvorte Profil → Vládna registrácia, vyberte systém a vyplňte to, čo vidíte. Popisy nesú oficiálny názov, ktorý im dáva úrad, a neprekladajú sa, aby ste ich našli bez zmeny v portáli, odkiaľ hodnoty kopírujete. Tam, kde úrad ponúka testovacie prostredie, je aj prepínač na jeho použitie: umožní overiť nastavenie skôr, než sa čokoľvek naozaj odošle. Pole, ktoré nevidíte, nechýba omylom: vo vašej krajine sa nevyžaduje.
A potom je tu niečo, čo človeka nenapadne: niektoré údaje nepatria zariadeniu, ale jednotlivej ubytovacej jednotke. Tam, kde úrad prideľuje identifikátor každému ubytovaciemu zariadeniu, sa pod spoločnými poľami objaví karta navyše: Prihlasovacie údaje podľa ubytovacej jednotky. Vyberte jednotku z ponuky a vyplňte len to, čo sa líši: čo necháte prázdne, prevezme hodnotu zariadenia a netreba to opakovať. Ak sa karta neobjaví, vo vašej krajine nie je potrebná a všetko platí pre celé zariadenie.
Ak má účet viac nehnuteľností, ponuka karty najprv ukáže jednu položku pre každú z nich, „…: všetky ubytovacie jednotky“: prihlasovacie údaje, ktoré tam uložíte, sa zapíšu pri každej jej jednotke. Hodí sa to, keď vám úrad pridelil jeden identifikátor na adresu, a nie na každý apartmán: zadáte ho iba raz a jednotlivú jednotku môžete stále opraviť tak, že ju vyberiete v ponuke.
Questura (Alloggiati Web)Odosielanie hlásení o hosťoch na Polizia di Stato
Všetky talianske ubytovacie zariadenia sú povinné oznamovať údaje hostí policajnému riaditeľstvu Questura prostredníctvom služby Alloggiati Web štátnej polície Polizia di Stato. Vezpa odosiela údaje hostí automaticky hneď po ich zaregistrovaní.
Ako získať prihlasovacie údaje
- Zaregistrujte sa na alloggiatiweb.poliziadistato.it
- Podajte žiadosť o aktiváciu na svojej miestnej Questure
- Prihlasovacie údaje dostanete e-mailom: Používateľské meno, Heslo a Token WS
- Zadajte prihlasovacie údaje vo Vezpe: Profil → Konfigurácia → Questura
- Zapnite prepínač „Povolené“
Automatický priebeh
Povinné polia Questura
| Pole | Popis |
|---|---|
| Priezvisko, meno | Osobné údaje hosťa |
| Pohlavie | M / F (povinné iba pre Taliansko) |
| Dátum a miesto narodenia | S kódom ISTAT obce |
| Štátna príslušnosť | Kód krajiny Alloggiatiweb |
| Typ a číslo dokladu | 95 dostupných typov (pas, občiansky preukaz atď.) |
| Typ ubytovaného | Jednotlivý hosť (16), Hlava rodiny (17), Vedúci skupiny (18) |
ISTAT — štatistiky cestovného ruchu19 regiónov, každý s vlastným systémom
Taliansko má 19 rôznych regionálnych systémov na zber štatistických údajov o cestovnom ruchu. Vezpa spravuje všetky: väčšinu úplne automaticky, niektoré regióny vyžadujú stiahnutie súboru.
Regióny s automatickým odosielaním (16 regiónov)
Pri týchto regiónoch Vezpa odosiela údaje automaticky každý večer prostredníctvom webovej služby. Potrebujete iba regionálne prihlasovacie údaje.
| ID | Región | Protokol | Prihlasovacie údaje |
|---|---|---|---|
| 0 | Piemonte | SOAP v2 | Používateľské meno + Heslo |
| 1 | Toscana | SOAP v2 | Používateľské meno + Heslo |
| 2 | Basilicata | SOAP v1 | Používateľské meno + Heslo |
| 3 | Liguria | SOAP v2 | Používateľské meno + Heslo |
| 4 | Abruzzo | SOAP v2 (Turismo5) | Používateľské meno + Heslo |
| 5 | Veneto | SOAP v2 | Používateľské meno + Heslo |
| 6 | Emilia-Romagna | SOAP v2 | Používateľské meno + Heslo |
| 7 | Marche | ROSS1000 | Používateľské meno + Heslo |
| 8 | Lombardia | Turismo5 | Používateľské meno + Heslo |
| 9 | Calabria | SOAP v2 | Používateľské meno + Heslo |
| 10 | Sardegna | ROSS1000 | Používateľské meno + Heslo |
| 11 | Lazio | ROSS1000 | Používateľské meno + Heslo |
| 12 | Molise | ROSS1000 | Používateľské meno + Heslo |
| 13 | Sicilia | REST XML | PMS User + HotelCode |
| 14 | Campania | REST JSON (Sinfonia) | CUSR + API kľúč |
| 17 | Trentino | SOAP DTU C59 | Používateľské meno + Heslo |
| 19 | Valle d'Aosta | SOAP VIT (INVA) | Používateľ + Heslo + ID zariadenia |
Regióny so stiahnutím súboru (3 regióny)
Pri týchto regiónoch Vezpa vygeneruje súbor, ktorý budete musieť stiahnuť z aplikácie a manuálne nahrať na regionálny portál.
| ID | Región | Formát | Portál na nahranie |
|---|---|---|---|
| 15 | Umbria | TXT (ROSS 1000) | Turismatica |
| 16 | Friuli Venezia Giulia | TXT (ROSS 1000) | WebTur |
| 18 | Puglia | XML (SPOT) | www.dms.puglia.it (SPID) |
Ako nakonfigurovať ISTAT
- Otvorte Profil → Konfigurácia a vyberte svoju izbu/ubytovaciu jednotku
- V sekcii ISTAT zapnite prepínač „Povolené“
- Z rozbaľovacej ponuky vyberte svoj región
- Zadajte prihlasovacie údaje poskytnuté regionálnym portálom
- Zadajte kód ISTAT zariadenia
- Uložte. Automatické odosielanie sa spustí ešte v ten istý večer
PayTouristPlatforma pre miestny poplatok za ubytovanie
PayTourist je voliteľná platforma, ktorá automatizuje výber a odvod miestneho poplatku za ubytovanie pre mnohé talianske obce. Vezpa sa integruje priamo s PayTourist a odosiela mu údaje hostí.
Potrebné prihlasovacie údaje
| Pole | Kde ho získať |
|---|---|
| ID PayTourist | Registrácia na paytourist.it (samoobslužne) |
| API token | Dashboard PayTourist po registrácii |
Digitálny podpisZískanie podpisu hosťa počas registrácie
Digitálny podpis sa získava tak z aplikácie Flutter (počas registrácie hosťa), ako aj zo samoobslužného webového check-inu (dotykové plátno). Podpis sa uloží ako obrázok PNG do profilu hosťa.
Podpis hosťa sa ponúka len v krajinách, kde ho zákon na registračnom formulári vyžaduje: v Nemecku, Rakúsku, Francúzsku a Španielsku. Aj tam je nepovinný — v aplikácii aj pri online check-ine — pretože hosť môže formulár podpísať na papieri pri príchode; v žiadnej krajine sa podpis neodovzdáva úradom, slúži ubytovaciemu zariadeniu ako doklad. V ostatných krajinách sa sekcia podpisu nezobrazí a tam, kde Vezpa vie formulár vytvoriť, sa PDF vygeneruje aj tak, s riadkom na podpis na papieri.
Formulár sa vytvorí z detailu rezervácie klepnutím na „Registračný dokument“: vyjde už vyplnený údajmi hosťa, v jazyku krajiny ubytovania, pripravený na podpis a uchovanie. Tlačidlo sa objaví samo tam, kde Vezpa vie formulár vytvoriť, a zostáva neaktívne — so správou, ktorá to vysvetľuje — kým nie je zaregistrovaný zodpovedný hosť rezervácie.
Európske vládne konektoryAutomatické odosielanie údajov hostí pre 7 krajín + islandský register
Pri zariadeniach, ktoré sa nachádzajú v niektorej z nasledujúcich európskych krajín, môže Vezpa automaticky odosielať údaje hostí do národného vládneho systému. Konfigurácia sa nachádza v časti Profil → Vládna registrácia. Ak prepojenie pre vašu krajinu ešte nie je aktívne, aplikácia vám to povie upozornením v hornej časti stránky: pozri Ako ďaleko je prepojenie.
🇪🇸 Španielsko — SES.Hospedajes
Povinné od 2. decembra 2024 (Real Decreto 933/2021). Registro de viajeros na Ministerio del Interior.
| Prihlasovací údaj | Kde ho získať |
|---|---|
| API Key | seshospedajes.es (samoobslužne) |
| Establishment ID | Portál SES po registrácii zariadenia |
🇭🇷 Chorvátsko — eVisitor
Národný elektronický systém, ktorý spravuje Hrvatska turistička zajednica (HTZ).
| Prihlasovací údaj | Kde ho získať |
|---|---|
| Používateľské meno + Heslo | evisitor.hr (samoobslužne) |
| API Key | Portál eVisitor po registrácii |
| Facility Code | Pridelený pri registrácii |
🇭🇺 Maďarsko — NTAK
Národný systém NTAK (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). Vezpa sa pripája cez sprostredkovateľa NTAK.guru, ktorý zjednodušuje integráciu.
| Prihlasovací údaj | Kde ho získať |
|---|---|
| Bearer Token | ntak.guru (samoobslužne) |
| Accommodation ID | Portál NTAK.guru po registrácii |
🇵🇹 Portugalsko — SIBA
Boletim de Alojamento je povinný podľa Lei č. 23/2007 (čl. 15-16).
| Prihlasovací údaj | Kde ho získať |
|---|---|
| Používateľské meno + Heslo | siba.ssi.gov.pt |
| Kód Estabelecimento | Registrácia v SIBA |
🇨🇿 Česká republika — UbyPort
Povinný register cudzincov, ktorý spravuje Cizinecká policie (cudzinecká polícia).
Od 9. 10. 2026 je Vezpa schválená českou cudzineckou políciou (Ředitelství služby cizinecké policie, RSCP) ako softvér na robotické zasielanie údajov o ubytovaných cudzincoch do UbyPortu. Odosielanie prebieha samo, pri hodinovom prechode. Ak hosťovi chýbajú údaje alebo polícia záznam odmietne, dostanete oznámenie «Skontrolovať údaje hosťa» s menom hosťa a dôvodom: odmietnutý záznam sa automaticky neopakuje, odošle sa znova, keď údaje opravíte.
| Prihlasovací údaj | Kde ho získať |
|---|---|
| Používateľské meno + Heslo | Účet na robotické zasielanie dát (účet pro robotické zasílání dat), prideľuje RSCP |
| IDUB | Prideľuje RSCP pri registrácii ubytovacieho zariadenia |
| Zkratka | Skratka ubytovacieho zariadenia, pridelená spolu s IDUB (nepovinná, odporúčaná) |
Ako získať účet. Nevzniká automaticky; sú tri možnosti:
- Robotický účet už máte (napr. z iného PMS): s políciou nemusíte nič riešiť, účet je prenosný. Zadajte do Vezpa existujúce prihlasovacie údaje.
- Máte IDUB, ale nie robotický účet: napíšte RSCP cez datovú schránku (ID ybndqw9) alebo e-mailom na [email protected] a požiadajte o účet na robotické zasielanie dát. Uveďte IDUB, názov a úplnú adresu zariadenia, výrobcu a názov programu, ktorý musí byť presne «Vezpa»: s iným názvom žiadosť schválená nebude.
- Nemáte IDUB ani účet: podajte bežnú žiadosť o registráciu nového ubytovacieho zariadenia (Žádost o registraci nového ubytovacího zařízení) na ubyport.pcr.cz, zvoľte «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» a ako názov programu uveďte «Vezpa».
Vzorový text žiadosti (v češtine): «Žádám o přihlašovací údaje do Ubyport Webová služba pro ubytovací zařízení <název>, <adresa>, IDUB: <IDUB>, které budu zasílat prostřednictvím programu Vezpa, výrobce Vezpa.» Viac na oficiálnej stránke českej polície.
Vo Vezpa, v Konfigurácia → Vládna registrácia: používateľské meno a heslo robotického účtu, IDUB do poľa «Kód ubytovania», Zkratku do «Ďalšie nastavenia» a potom zapnite «Automatické odosielanie». Endpoint nechajte prázdny a «Testovacie prostredie» vypnuté: slúži len na testovacie účty vývojárov. Viac zariadení s rôznymi IDUB: použite «Prihlasovacie údaje podľa ubytovacej jednotky».
🇦🇹 Rakúsko — Meldeamt
Gaestemeldung je povinné podľa zákona Meldegesetz. Každá spolková krajina (Bundesland) má vlastný systém; Vezpa podporuje všetkých 9 Bundeslaender s nastaviteľným endpointom.
| Prihlasovací údaj | Kde ho získať |
|---|---|
| Používateľské meno + Heslo alebo API Key | Portál vlastnej spolkovej krajiny (feratel Deskline, GMS atď.) |
| Betriebsnummer | Pridelené regionálnym úradom Meldeamt |
| Endpoint URL | Špecifická pre každú spolkovú krajinu |
🇸🇮 Slovinsko — eTurizem (AJPES)
Registrácia turistov je povinná a spravuje ju AJPES. Vyžaduje sa kvalifikovaný digitálny certifikát vydaný akreditovaným slovinským poskytovateľom.
| Prihlasovací údaj | Kde ho získať |
|---|---|
| Digitálny certifikát PEM | SIGEN-CA, Halcom, NLB alebo iná akreditovaná autorita |
| ID Nastanitvenega Obrata | Portál AJPES po registrácii |
🇮🇸 Island — Gistiskrá (register hostí)
Podľa islandského zákona o ubytovacích zariadeniach (Lög um veitingastaði, gististaði og skemmtanahald) musí každé zariadenie viesť register hostí (gistiskrá) s údajmi všetkých hostí. Register musí byť k dispozícii na kontrolu islandskej polícii (Lögreglan).
Vezpa automaticky zaznamenáva všetky požadované údaje počas check-inu. Nie je potrebná žiadna konfigurácia prihlasovacích údajov — údaje sú vždy dostupné v aplikácii a kedykoľvek sa dajú exportovať alebo vytlačiť.
| Povinné pole | Popis |
|---|---|
| Celé meno | Meno a priezvisko hosťa |
| Dátum narodenia | Úplný dátum |
| Štátna príslušnosť | Krajina občianstva |
| Doklad | Typ a číslo (pas alebo občiansky preukaz) |
| Bydlisko | Úplná adresa |
| Dátumy pobytu | Príchod a odchod |
Stiahnutie súboru ISTATPre regióny s manuálnym nahrávaním (Umbria, FVG, Puglia)
Regióny Umbria, Friuli Venezia Giulia a Puglia nemajú webovú službu na automatické odosielanie. Pre tieto regióny Vezpa vygeneruje súbor, ktorý budete musieť stiahnuť a nahrať manuálne.
Ako stiahnuť súbor
- Otvorte konfiguráciu zariadenia (Profil → ťuknutie na izbu)
- V sekcii ISTAT skontrolujte, či je vybraný správny región
- Ťuknite na tlačidlo „Stiahnuť súbor ISTAT“
- Vyberte dátum začiatku a dátum konca obdobia
- Ťuknite na „Vygenerovať a stiahnuť súbor“
- Súbor sa vygeneruje a môžete ho zdieľať (e-mail, WhatsApp, uloženie do súborového systému)
Formáty súborov podľa regiónu
| Región | Formát | Kam ho nahrať |
|---|---|---|
| Umbria | TXT (ROSS 1000, 338 znakov/záznam) | Turismatica |
| Friuli V.G. | TXT (ROSS 1000, 338 znakov/záznam) | WebTur |
| Puglia | XML (SPOT, formát movimentogiornaliero-0.6.xsd) | www.dms.puglia.it (prihlásenie cez SPID) |
<movimento> za každý deň zvoleného obdobia, s príchodmi, odchodmi a údajmi o zariadení (dostupné izby, lôžka, obsadené izby). Dodávateľ (vendor) sa automaticky nastaví na „Vezpa“.
Potrebujete pomoc?
Ak máte pochybnosti o konfigurácii vládnych systémov alebo sa vám nedarí získať prihlasovacie údaje, kontaktujte podporu Vezpa.