Vodič za državne sustave

Registracija gostiju radi u svakoj državi u kojoj je Vezpa dostupna, i nastavlja raditi. Ono što nije svugdje uključeno jest automatsko povezivanje s nadležnim tijelom: prosljeđivanje podataka koji su već uneseni.

Gdje povezivanje još nije aktivno, na vrhu zaslona Konfiguracija → Državna prijava nalazi se informativni okvir koji to kaže: automatsko slanje nadležnom tijelu te države je u testiranju, a registracija gostiju radi normalno. Samo obavijest: ništa ne blokira, nema što potvrditi i nema što odbaciti, a okvir se pojavljuje i kada za vašu državu još uopće nema povezivanja koje bi se moglo postaviti.

Okvir sam nestaje kada povezivanje vaše države postane aktivno: ne morate učiniti ništa i nijednu postavku ne treba naknadno dirati. Odjeljci u nastavku opisuju kako se postavlja svaki sustav; obavijest govori gdje sve to stoji.

Što zapravo znači «Konfigurirano»

Na zaslonu Konfiguracija → Državna prijava gornja kartica nosi naziv sustava vaše države i riječ «Konfigurirano» ili «Nije konfigurirano». Ne ovisi samo o spremanju: «Konfigurirano» znači da su podaci za prijavu spremljeni i da je prekidač «Automatsko slanje» uključen. S isključenim prekidačem zaslon ostaje na «Nije konfigurirano» i kada ste sve ispunili, brojači posljednjih 30 dana i kartica «Statistike» se ne prikazuju, a «Testiraj vezu» odgovara da podaci za prijavu nisu postavljeni.

Ostali odjeljci govore kome Vezpa prijavljuje i s kojim podacima za prijavu. Ovaj govori kada, jer je odluka smještaja i donosite je vi: otvorite Konfiguracija → Državna registracija i u kartici «Kada slati nadležnim tijelima» odaberite jedan od tri ritma. Vrijedi u svakoj državi: u Italiji upravlja prijavnicama za Questuru (servis Alloggiati Web Polizije di Stato, odnosno mjesnu policijsku upravu), drugdje slanjima povezivanja vaše države.

• «Svaka 4 sata» — šest prolaza na dan. Prijavite gosta i više ne mislite na to.
• «U 23:15» — samo jedan prolaz, na kraju dana.
• «Ručno» — odlazi samo ono što odaberete i pošaljete vi.

Košara «Za slanje»

Čim odaberete ručni ritam, u istoj kartici pojavljuje se stavka «Za slanje»: to je košara rezervacija koje čekaju, grupiranih po danu dolaska. Označite one koje želite prijaviti i pritisnete «Pošalji odabrane». U druga dva ritma te stavke nema, i ništa ne manjka: nema što odabirati, sve odlazi samo.

Autorizirati nije poslati, i razlika nije cjepidlačenje. Kada pritisnete, dopuštenje se zapisuje prije odlaska, a jedan pritisak može odnijeti samo dio posla: u tom slučaju stranica vam to kaže — «autorizirane, ali slanje još nije dovršeno» — i nudi «Dovrši sada». Pritisnete ponovno i nastavlja odande gdje je stalo: to nije greška. Iz istog razloga na zaslonu nikada ne čitate riječ poslana: rezervacija je «Autorizirana» kada dopuštenje postoji, a je li ju nadležno tijelo doista prihvatilo govori ishod, jedan po jedan.

ISTAT i PayTourist slijede Questuru

Tu nema što odlučivati i nema drugog prekidača: ISTAT i PayTourist idu za Questurom, sami. Ako je rezervacija prijavljena Questuri, prijavljuju ju i oni; ako nije, ne prijavljuju ju. Tako je napravljeno, a na ručno to ima posljedicu koju je dobro znati unaprijed: noć koju još niste poslali dolazi u ISTAT kao zatvorena soba. Uključite ručni ritam samo ako ste spremni redovno slati, inače će se vaši podaci o zauzetosti promijeniti iz razloga koji nema ništa s vašim smještajem.

Na ručno Questura prima samo danas i jučer

To nije naš odabir, to je portal: Alloggiati Web prima kao datum dolaska samo danas ili jučer, a iza te granice prijavnica se odbija. Nije formalnost, jer prijavnica sa starim datumom sama po sebi izjavljuje da je poslana nakon roka. Zato košara ima prozor: s ručnim ritmom odgoditi dva dana nije odgoditi, nego izgubiti.

Pregled dana

Na vrhu stranice «Za slanje» otvara se «Pregled dana»: gdje stojite danas, u tri broja — «Današnji gosti», «Autorizirani» i «Odabrani za slanje». Stranica je samo za čitanje: odavde se ništa ne dodaje i ne uklanja, u košaru se vraća s «Dodaj ili ukloni rezervacije». Dva mjesta koja pišu isti popis bila bi dva različita popisa.

Dva su reda koja treba pogledati, jer su to oni na koje se djeluje:

• Odabrani gosti koji se još ne mogu prijaviti — manjka njihova prijava. Neće otići: prijavite ih i vraćaju se u prijavu.
• Gosti čiji je odabir izašao iz prozora — neće otići, odabir se više ne može ukloniti, i iz aplikacije više nema što raditi: za te dane ide se preko portala nadležnog tijela. Broje se odvojeno od odabranih, ne među njima, i ovaj pregled je jedino mjesto koje vam ih još pokazuje.

Stranica s podacima za prijavu nije za sve isti obrazac. Sustav ne odabirete vi: određuje ga država vašeg smještaja, a stranica sama iscrtava polja koja to tijelo traži. Osim zajedničkih — korisničko ime, lozinka, identifikator smještaja, adresa usluge — svaka država dodaje dodatna polja koja traži njezino tijelo, skupljena pod «Dodatne postavke»: otvorite Konfiguracija → Državna prijava i ispunite ono što vidite. Oznake tih polja nose službeni naziv koji je dalo nadležno tijelo i nisu prevedene, pa ih nepromijenjene nalazite na portalu s kojeg prepisujete vrijednosti. Gdje tijelo nudi testno okruženje, dobivate i prekidač «Testno okruženje» za njegovu upotrebu. Polje koje ne vidite ne manjka zabunom: vaša država ga ne traži.

Već spremljena tajna — lozinka, ključ, certifikat — nikada se ne vraća na zaslon: polje ostaje prazno, a ispod njega redak kaže da je vrijednost već pohranjena. Ostaviti prazno ju ne briše; za zamjenu upišite novu. «Testiraj vezu» poziva uslugu nadležnog tijela i kaže da ona odgovara: ne dokazuje da su vaši podaci za prijavu točni, jer svaki odgovor koji nije greška poslužitelja računa se kao uspjeh.

Zatim postoji nešto što se ne može pogoditi: neki podaci za prijavu nisu podaci smještaja, nego pojedine jedinice. Gdje tijelo dodjeljuje identifikator po jedinici, ispod zajedničkih polja pojavljuje se dodatna kartica, Podaci za prijavu po smještaju. Odaberite jedinicu iz menija i ispunite samo ono što je kod nje drugačije: ono što ostavite prazno uzima vrijednost smještaja i ne treba ga ponavljati. Ako se ta kartica ne pojavi, vaša država ju ne traži i sve vrijedi za cijeli smještaj.

Ako račun ima više objekata, izbornik kartice najprije nudi po jednu stavku za svaki objekt, „…: svi smještaji”: podaci koje ondje spremite upisuju se za svaki njegov smještaj. Korisno je kad vam je tijelo dodijelilo jedan identifikator po adresi, a ne po apartmanu: unosite ga jednom, a pojedini smještaj i dalje možete ispraviti odabirom u izborniku.

Svaki smještaj u Italiji dužan je prijaviti podatke o gostima Questuri, lokalnoj policijskoj upravi, putem usluge Alloggiati Web Polizia di Stato. Vezpa prijavnice šalje sama: ne u trenutku kada unesete gosta, nego prvim automatskim prolazom, a oni se pokreću svakih pola sata.

Prozor je zakonom uzak, ne našim odabirom: Alloggiati Web kao datum dolaska prihvaća samo današnji ili jučerašnji dan. Zato Vezpa starije dane ne dovlači sama — prijavnicu sa starim datumom bi odbili, a poslati ju značilo bi ući u evidenciju: ti dani su bili nepokriveni.

Kako doći do podataka za prijavu

1. Registrirajte se na alloggiatiweb.poliziadistato.it
2. Podnesite zahtjev za aktivaciju lokalnoj Questuri
3. Podatke za prijavu dobivate e-poštom: Korisničko ime, Lozinka i WS Token
4. Upišite podatke za prijavu u Vezpu: Konfiguracija → Soba → soba → Policijska registracija
5. Uključite prekidač «Omogućeno» i spremite

Automatski tijek

Obvezna polja za Questuru

Polje	Opis
Prezime, ime	Osobni podaci gosta
Spol	M / Ž (obvezno samo u Italiji)
Datum i mjesto rođenja	S ISTAT šifrom općine
Državljanstvo	Šifra države Alloggiatiweb
Vrsta i broj dokumenta	Dostupno je 95 vrsta (putovnica, osobna iskaznica itd.)
Vrsta gosta	Samac (16), Nositelj obitelji (17), Vodič grupe (18)

U Italiji turističku statistiku prikuplja dvadeset različitih regionalnih sustava. Vezpa upravlja svima: sedamnaest potpuno automatski, tri datotekom koju preuzmete i ručno učitate na regionalni portal.

Regije s automatskim slanjem (sedamnaest)

Za te regije Vezpa šalje podatke sama, jednom na dan, u četiri ujutro po vremenskoj zoni smještaja. Ne prijavljuje dan koji je upravo završio: prijavljuje dan od pet dana prije, kako bi premještaji između jedinica imali vremena sjesti prije prosljeđivanja. Potrebni su samo regionalni podaci za prijavu.

ID	Regija	Protokol	Podaci za prijavu
0	Piemonte	SOAP v2	Korisničko ime + Lozinka
1	Toscana	SOAP v2	Korisničko ime + Lozinka
2	Basilicata	SOAP v1	Korisničko ime + Lozinka
3	Liguria	SOAP v2	Korisničko ime + Lozinka
4	Abruzzo	SOAP v2 (Turismo5)	Korisničko ime + Lozinka
5	Veneto	SOAP v2	Korisničko ime + Lozinka
6	Emilia-Romagna	SOAP v2	Korisničko ime + Lozinka
7	Marche	ROSS1000	Korisničko ime + Lozinka
8	Lombardia	Turismo5	Korisničko ime + Lozinka
9	Calabria	SOAP v2	Korisničko ime + Lozinka
10	Sardegna	ROSS1000	Korisničko ime + Lozinka
11	Lazio	ROSS1000	Korisničko ime + Lozinka
12	Molise	ROSS1000	Korisničko ime + Lozinka
13	Sicilia	REST XML	PMS User + HotelCode
14	Campania	REST JSON (Sinfonia)	CUSR + API Key
17	Trentino	SOAP DTU C59	Korisničko ime + Lozinka
19	Valle d'Aosta	SOAP VIT (INVA)	User + Lozinka + Property ID

Regije s preuzimanjem datoteke (tri)

Za te regije Vezpa izrađuje datoteku koju morate preuzeti iz aplikacije i ručno učitati na regionalni portal.

ID	Regija	Format	Portal za učitavanje
15	Umbria	TXT (ROSS 1000)	Turismatica
16	Friuli Venezia Giulia	TXT (ROSS 1000)	WebTur
18	Puglia	XML (SPOT)	www.dms.puglia.it (SPID)

Kako se postavlja ISTAT

1. Otvorite Konfiguracija → Soba iz Uprave, iz menija s tri točke, i dotaknite sobu
2. Otvorite odjeljak «ISTAT» i uključite prekidač «Omogućeno»
3. Odaberite «Regija» iz padajućeg menija
4. Upišite podatke za prijavu koje je dao regionalni portal
5. Upišite «ISTAT šifra» smještaja
6. Spremite. Prvo automatsko slanje izlazi sljedećim noćnim prolazom

PayTourist je neobvezna platforma koja u mnogim talijanskim općinama automatizira prikupljanje i plaćanje turističke takse. Vezpa se povezuje izravno na PayTourist i podatke o gostima šalje istim noćnim prolazom kao ISTAT, s istim danom na koji se odnose: onim od pet dana prije.

Potrebni podaci za prijavu

Polje	Odakle dolazi
PayTourist ID	Registracija na paytourist.it (samostalno)
API Token	PayTourist nadzorna ploča nakon registracije

Digitalni potpis program prikuplja i iz Flutter aplikacije (tijekom unosa gosta) i iz web samostalne prijave (površina na kojoj se crta dodirom). Potpis se sprema kao PNG slika u karticu gosta.

Potpis gosta nudi se samo u zemljama u kojima ga zakon traži na obrascu za prijavu: u Njemačkoj, Austriji, Francuskoj i Španjolskoj. I ondje je neobavezan — u aplikaciji i pri online prijavi — jer gost obrazac može potpisati na papiru po dolasku; ni u jednoj zemlji potpis se ne šalje tijelima, objektu služi kao dokaz. U ostalim zemljama odjeljak za potpis se ne prikazuje, a gdje Vezpa zna izraditi obrazac, PDF se ipak generira, s retkom za potpis na papiru.

List nastaje iz kartice rezervacije dotikom «Dokument za registraciju»: izlazi već ispunjen podacima gosta, na jeziku države smještaja, spreman za potpis i čuvanje. Gumb se sam pojavljuje tamo gdje Vezpa može izraditi list, a do tada ostaje isključen — s porukom koja navodi razlog — dok osoba odgovorna za rezervaciju nije unesena.

Za smještaje u jednoj od država u nastavku Vezpa može automatski poslati podatke o gostima u nacionalni državni sustav. Postavka je pod Konfiguracija → Državna prijava, a ta stranica postoji samo za te države: drugdje kaže da nema dostupnog povezivanja, i to nije greška. Ako povezivanje vaše države još nije aktivno, aplikacija vam to kaže obavijesti na vrhu stranice: vidi Kako stoji povezivanje.

Kada se slanje događa. Ne kada unesete gosta: obavljaju ga dva automatska prolaza. Za policijske evidencije jedan prolaz na sat skuplja nedavno unesene goste; za statističke sustave prolaz jednom na dan. Stvarno prosljeđivanje zatim počinje unutar pola sata. Prekidač «Automatsko slanje» vlada svime: isključen, ništa ne izlazi.

🇪🇸 Španjolska — SES.Hospedajes

Obvezno od 2. prosinca 2024. (Real Decreto 933/2021). Registro de viajeros pri Ministerio del Interior.

Podatak za prijavu	Odakle dolazi
API Key	seshospedajes.es (samostalno)
Establishment ID	SES portal nakon registracije smještaja

🇭🇷 Hrvatska — eVisitor

Nacionalni mrežni sustav kojim upravlja Hrvatska turistička zajednica (HTZ).

Podatak za prijavu	Odakle dolazi
Korisničko ime + Lozinka	evisitor.hr (samostalno)
API Key	eVisitor portal nakon registracije
Facility Code	Dodijeljen pri registraciji

🇭🇺 Mađarska — NTAK

Nacionalni sustav NTAK (Nemzeti Turisztikai Adatszolgáltatási Központ). Vezpa se povezuje preko posrednika NTAK.guru da bi uključivanje bilo jednostavnije.

Podatak za prijavu	Odakle dolazi
Bearer Token	ntak.guru (samostalno)
Accommodation ID	NTAK.guru portal nakon registracije

NTAK je statistički sustav. Za policijsku stranu Mađarska ima drugi sustav, VIZA, koji se ne uključuje sam: postavlja se zasebno, s vlastitim podacima za prijavu, a tko ga preskoči ostaje samo s NTAK-om.

🇵🇹 Portugal — SIBA

Boletim de Alojamento, propisan zakonom Lei br. 23/2007 (čl. 15-16).

Podatak za prijavu	Odakle dolazi
Korisničko ime + Lozinka	siba.ssi.gov.pt
Šifra Estabelecimento	SIBA registracija

🇨🇿 Češka — UbyPort

Obvezna evidencija stranih gostiju kojom upravlja Cizinecká policie (policija za strance).

Od 9. listopada 2026. Vezpa je odobrena od strane češke policije (Ředitelství služby cizinecké policie, RSCP) kao softver za automatsko slanje podataka o stranim gostima u UbyPort. Slanje se pokreće samo, u prolazu svakih sat vremena. Ako gostu nedostaju podaci ili policija odbije zapis, dobit ćete obavijest «Provjerite podatke gosta» s imenom gosta i razlogom: odbijeni zapis ne ponavlja se sam, nego se ponovno šalje kad ispravite podatke.

Podatak za prijavu	Odakle dolazi
Korisničko ime + Lozinka	Račun za robotsko slanje podataka (účet pro robotické zasílání dat), izdaje ga RSCP
IDUB	Dodjeljuje RSCP pri registraciji objekta
Zkratka	Kratica objekta, dodjeljuje se zajedno s IDUB-om (neobavezna, preporučena)

Kako dobiti račun. Ne stvara se automatski; postoje tri slučaja:

• Već imate robotski račun (npr. korišten s drugim PMS-om): s policijom ne trebate ništa, račun je prenosiv. Unesite postojeće podatke za prijavu u Vezpa.
• Imate IDUB, ali nemate robotski račun: pišite RSCP-u putem datová schránka (ID ybndqw9) ili e-poštom na [email protected] i zatražite račun za robotsko slanje podataka. Navedite IDUB, naziv i punu adresu objekta, proizvođača i naziv softvera, koji mora glasiti točno «Vezpa»: s bilo kojim drugim nazivom zahtjev neće biti odobren.
• Nemate ni IDUB ni račun: podnesite uobičajeni zahtjev za registraciju novog objekta (Žádost o registraci nového ubytovacího zařízení) na ubyport.pcr.cz (otvara se u novoj kartici), odaberite «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» i kao naziv programa navedite «Vezpa».

Predložak teksta zahtjeva (na češkom): «Žá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.» Više na službenoj stranici češke policije (otvara se u novoj kartici).

U Vezpa, pod Konfiguracija → Državna registracija: korisničko ime i lozinka robotskog računa, IDUB u polje «Šifra objekta», Zkratka u «Dodatne postavke», a zatim uključite «Automatsko slanje». Endpoint ostavite prazan, a «Testno okruženje» isključeno: služi samo za testne račune programera. Više objekata s različitim IDUB-ovima: koristite «Podaci za prijavu po smještaju».

🇦🇹 Austrija — Meldeamt

Gästemeldung propisan zakonom Meldegesetz. Svaka savezna zemlja (Bundesland) ima svoj sustav; Vezpa podržava svih 9 saveznih zemalja s podesivom krajnjom točkom.

Podatak za prijavu	Odakle dolazi
Korisničko ime + Lozinka ili API Key	Portal vlastite savezne zemlje (feratel Deskline, GMS itd.)
Betriebsnummer	Dodjeljuje regionalni Meldeamt
Endpoint URL	Vlastit za svaku saveznu zemlju

🇧🇬 Bugarska — ESTI

Prijava gostiju u jedinstveni sustav ESTI, do kojeg se dolazi preko pristupnika RegiX. Jedna prijava ispunjava i obvezu prema Ministarstvu turizma i upis stranih gostiju.

Podatak za prijavu	Odakle dolazi
Digitalni certifikat	Akreditirani bugarski pružatelj
Identifikator smještaja	ESTI evidencija nakon registracije

🇸🇮 Slovenija — eTurizem (AJPES)

Obvezna prijava gostiju kojom upravlja AJPES. Zahtijeva kvalificirani digitalni certifikat koji izdaje akreditirani slovenski pružatelj.

Podatak za prijavu	Odakle dolazi
PEM digitalni certifikat	SIGEN-CA, Halcom, NLB ili drugo akreditirano tijelo
ID Nastanitvenega Obrata	AJPES portal nakon registracije

🇮🇸 Island — Gistiskrá (Evidencija gostiju)

Prema islandskom zakonu o smještaju (Lög um veitingastaði, gististaði og skemmtanahald) svaki smještaj mora voditi evidenciju gostiju (gistiskrá) s podacima svih gostiju. Evidencija mora biti dostupna islandskoj policiji (Lögreglan) za pregled.

Vezpa pri prijavi sama prikuplja sve tražene podatke. Nema podataka za prijavu koje treba postaviti — podaci su uvijek dostupni u aplikaciji i mogu se u svakom trenutku izvući ili ispisati.

Obvezno polje	Opis
Puno ime	Ime i prezime gosta
Datum rođenja	Cijeli datum
Državljanstvo	Država državljanstva
Dokument	Vrsta i broj (putovnica ili osobna iskaznica)
Prebivalište	Puna adresa
Datumi boravka	Dolazak i odlazak

Regije Umbria, Friuli Venezia Giulia i Puglia nemaju mrežnu uslugu za automatsko slanje. Za te regije Vezpa izrađuje datoteku koju morate preuzeti i ručno učitati.

Kako preuzeti datoteku

1. Iz Uprave otvorite «Konfiguracija», grupu «Soba» i dotaknite sobu
2. U odjeljku «ISTAT» provjerite je li «Regija» točna
3. Dotaknite gumb «Preuzmi ISTAT datoteku»
4. Odaberite početni datum i završni datum razdoblja
5. Izradite datoteku
6. Datoteka nastaje i možete ju podijeliti (e-pošta, WhatsApp, spremanje u datotečni sustav)

Formati datoteka po regiji

Regija	Format	Kamo treba učitati
Umbria	TXT (ROSS 1000, 338 znakova/zapis)	Turismatica
Friuli V.G.	TXT (ROSS 1000, 338 znakova/zapis)	WebTur
Puglia	XML (SPOT, format movimentogiornaliero-0.6.xsd)	www.dms.puglia.it (prijava sa SPID-om)