Opas viranomaisjärjestelmiin
Questura, ISTAT, PayTourist ja eurooppalaiset liittymät — asetukset, tunnukset ja automaattinen lähetys
Sisällys
Missä yhteys meneeSovelluksen näyttämä ilmoitus ja mitä se tarkoittaa
Vieraiden rekisteröinti toimii jokaisessa maassa, jossa Vezpa on saatavilla, ja toimii jatkossakin. Se, mikä ei ole kaikkialla päällä, on automaattinen yhteys viranomaiseen: jo kirjattujen tietojen lähetys.
Siellä missä yhteys ei ole vielä aktiivinen, Profiili → Viranomaisrekisteröinti -sivun yläosassa on tietolaatikko, joka kertoo sen: automaattista lähetystä kyseisen maan viranomaiselle testataan, ja vieraiden rekisteröinti toimii normaalisti. Se on pelkkää tietoa: se ei estä mitään, mitään ei tarvitse vahvistaa tai sulkea, ja laatikko näkyy myös silloin, kun maallesi ei ole vielä lainkaan liitintä asetettavaksi.
Laatikko katoaa itsestään, kun maasi yhteys muuttuu aktiiviseksi: sinun ei tarvitse tehdä mitään eikä mitään asetusta tarvitse päivittää. Alla olevat osiot kertovat, miten kukin järjestelmä asetetaan; ilmoitus kertoo, missä mennään.
Milloin valtuutettu lähteeKolme rytmiä, ”Lähetettävät”-kori ja päivän yhteenveto
Muut osiot kertovat, kenelle Vezpa ilmoittaa ja millä tunnuksilla. Tämä kertoo, milloin, koska päätös kuuluu majoituskohteelle ja sen teet sinä: avaa Asetukset → Viranomaisrekisteröinti ja valitse laatikosta ”Milloin lähetetään viranomaisille” yksi kolmesta rytmistä. Pätee joka maassa: Italiassa se ohjaa Questuralle (paikallinen poliisilaitos) menevät ilmoitukset Polizia di Staton Alloggiati Web -palvelun kautta, muualla oman maasi liittimen lähetykset.
- ”4 tunnin välein” — kuusi ajoa päivässä. Kirjaat vieraan, eikä sinun tarvitse ajatella sitä enää.
- ”Klo 23:15” — yksi ainoa ajo, päivän päätteeksi.
- ”Käsin” — lähtee vain se, minkä valitset ja lähetät itse.
”Lähetettävät”-kori
Heti kun valitset käsin-rytmin, samaan laatikkoon ilmestyy kohta ”Lähetettävät”: se on odottavien varausten kori, ryhmiteltynä saapumispäivän mukaan. Rastitat ne, jotka haluat ilmoittaa, ja painat ”Lähetä valitut”. Kahdessa muussa rytmissä kohtaa ei ole, eikä mitään puutu: ei ole mitään valittavaa, kaikki lähtee itsestään.
Valtuuttaminen ei ole lähettämistä, eikä ero ole pikkuseikka. Kun painat, lupa kirjoitetaan ennen lähtöä, ja yksi painallus voi viedä mukanaan vain osan työstä: silloin sivu kertoo sen — ”valtuutettu, mutta lähetys ei ole vielä valmis” — ja tarjoaa ”Viimeistele nyt”. Painat uudelleen, ja se jatkaa siitä, mihin pysähtyi: tämä ei ole virhe. Samasta syystä et lue ruudulta koskaan sanaa lähetetty: varaus on ”Valtuutettu”, kun lupa on olemassa, ja sen, onko viranomainen todella hyväksynyt sen, kertoo tulos, yksi kerrallaan.
ISTAT ja PayTourist seuraavat Questuraa
Täällä ei ole mitään päätettävää eikä toista kytkintä: ISTAT ja PayTourist seuraavat Questuraa itsestään. Jos varaus on ilmoitettu Questuralle, ne ilmoittavat sen myös; jos ei ole, ne eivät ilmoita. Niin se on rakennettu, ja käsin-rytmissä sillä on seuraus, joka on hyvä tietää etukäteen: yö, jota et ole vielä lähettänyt, saapuu ISTATiin suljettuna huoneena. Kytke käsin-rytmi päälle vain jos olet valmis lähettämään säännöllisesti, muuten käyttöasteesi muuttuu syystä, jolla ei ole mitään tekemistä huoneidesi kanssa.
Käsin Questura ottaa vain tämän päivän ja eilisen
Tämä ei ole meidän valintamme vaan portaalin: Alloggiati Web ottaa saapumispäiväksi vain tämän päivän tai eilisen, ja tuon rajan takana ilmoitus hylätään. Se ei ole muodollisuus, sillä vanhaa päivämäärää kantava ilmoitus ilmoittaa itsestään myöhässä lähetetyksi. Siksi korilla on ikkuna: käsin-rytmissä kahden päivän lykkääminen ei ole lykkäämistä vaan menettämistä.
Päivän yhteenveto
Sivun ”Lähetettävät” ylälaidasta avautuu ”Päivän yhteenveto”: missä olet tänään, kolmena lukuna — ”Päivän vieraat”, ”Valtuutetut” ja ”Lähetettäväksi valitut”. Sivu on vain luettavissa: täältä ei lisätä eikä poisteta mitään, koriin pääset takaisin kohdasta ”Lisää tai poista varauksia”. Kaksi paikkaa, jotka kirjoittavat saman luettelon, olisivat kaksi eri luetteloa.
Kaksi riviä kannattaa katsoa, sillä ne ovat ne, joihin voi vaikuttaa:
- Valitut vieraat, joita ei voi vielä ilmoittaa — heidän kirjauksensa puuttuu. He eivät lähde: kirjaa heidät, ja he tulevat takaisin ilmoitukseen.
- Vieraat, joiden valinta on poistunut ikkunasta — he eivät lähde, valintaa ei voi enää poistaa, eikä sovelluksesta ole enää mitään tehtävissä: niiden päivien osalta mennään viranomaisen portaalin kautta. Heidät lasketaan valittujen ulkopuolella, ei niiden joukossa, ja tämä yhteenveto on ainoa paikka, joka vielä näyttää heidät sinulle.
Tunnukset vaihtuvat maan mukaanViranomaisen vaatimat kentät, ja ne jotka ovat majoituskohdekohtaisia
Tunnussivu ei ole kaikille sama lomake. Yhteisten kenttien — käyttäjätunnus, salasana, kohteen tunniste, palvelun osoite — lisäksi jokainen maa ilmoittaa ne lisäkentät, joita sen viranomainen vaatii, ja sivu piirtää ne itse: avaa Profiili → Viranomaisrekisteröinti, valitse järjestelmä ja täytä se, minkä näet. Kenttien nimissä on viranomaisen antama virallinen nimi, eikä niitä käännetä, jotta löydät ne samanlaisina siitä portaalista, josta arvot kopioit. Missä viranomainen tarjoaa testiympäristön, siellä on myös kytkin sen käyttöön: sillä tarkistat asetukset ennen kuin mitään lähetetään oikeasti. Kenttä, jota et näe, ei puutu vahingossa: sinun maassasi sitä ei kysytä.
Ja sitten on jotain, mitä ei arvaisi: osa tunnuksista ei kuulu toimipaikalle vaan yksittäiselle majoituskohteelle. Missä viranomainen antaa oman tunnisteen jokaiselle majoitusliikkeelle, yhteisten kenttien alle ilmestyy yksi kortti lisää: Tunnukset majoituskohteittain. Valitse majoituskohde valikosta ja täytä vain se, mikä poikkeaa: tyhjäksi jättämäsi käyttää toimipaikan arvoa eikä sitä tarvitse toistaa. Jos kortti ei ilmesty, sinun maassasi sitä ei tarvita ja kaikki koskee koko toimipaikkaa.
Jos tilillä on useita kiinteistöjä, kortin valikossa on ensin yksi valinta kullekin, ”…: kaikki majoituskohteet”: sinne tallentamasi tunnukset kirjataan jokaiselle sen majoituskohteelle. Tästä on apua, kun viranomainen antoi yhden tunnisteen osoitetta eikä huoneistoa kohden: syötät sen kerran ja voit silti korjata yksittäisen kohteen valitsemalla sen valikosta.
Questura (Alloggiati Web)Majoittujailmoitusten lähetys Polizia di Stato -viranomaiselle
Kaikkien italialaisten majoitusliikkeiden on ilmoitettava vieraidensa tiedot Questuralle (paikallinen poliisilaitos) Polizia di Staton Alloggiati Web -palvelun kautta. Vezpa lähettää vieraiden tiedot automaattisesti heti, kun ne on rekisteröity.
Näin saat tunnukset
- Rekisteröidy osoitteessa alloggiatiweb.poliziadistato.it
- Jätä aktivointihakemus omaan paikalliseen Questuraan
- Saat tunnukset sähköpostitse: Käyttäjätunnus, Salasana ja Token WS
- Syötä tunnukset Vezpaan: Profiili → Asetukset → Questura
- Kytke päälle valitsin ”Käytössä”
Automaattinen kulku
Questuran pakolliset kentät
| Kenttä | Kuvaus |
|---|---|
| Sukunimi, Etunimi | Vieraan henkilötiedot |
| Sukupuoli | M / F (pakollinen vain Italiassa) |
| Syntymäaika ja -paikka | Kunnan ISTAT-koodin kanssa |
| Kansalaisuus | Alloggiati Webin maakoodi |
| Asiakirjan tyyppi ja numero | 95 vaihtoehtoa (passi, henkilökortti jne.) |
| Majoittujan tyyppi | Yksittäinen vieras (16), Perheen pää (17), Ryhmänjohtaja (18) |
ISTAT — Matkailutilastot19 aluetta, jokaisella oma järjestelmänsä
Italiassa on 19 erilaista alueellista järjestelmää matkailun tilastotietojen keruuseen. Vezpa hoitaa ne kaikki: suurimman osan täysin automaattisesti, muutama alue edellyttää tiedoston lataamista.
Alueet, joilla lähetys on automaattinen (16 aluetta)
Näillä alueilla Vezpa lähettää tiedot automaattisesti joka ilta verkkopalvelun kautta. Tarvitset vain alueelliset tunnukset.
| ID | Alue | Protokolla | Tunnukset |
|---|---|---|---|
| 0 | Piemonte | SOAP v2 | Käyttäjätunnus + Salasana |
| 1 | Toscana | SOAP v2 | Käyttäjätunnus + Salasana |
| 2 | Basilicata | SOAP v1 | Käyttäjätunnus + Salasana |
| 3 | Liguria | SOAP v2 | Käyttäjätunnus + Salasana |
| 4 | Abruzzo | SOAP v2 (Turismo5) | Käyttäjätunnus + Salasana |
| 5 | Veneto | SOAP v2 | Käyttäjätunnus + Salasana |
| 6 | Emilia-Romagna | SOAP v2 | Käyttäjätunnus + Salasana |
| 7 | Marche | ROSS1000 | Käyttäjätunnus + Salasana |
| 8 | Lombardia | Turismo5 | Käyttäjätunnus + Salasana |
| 9 | Calabria | SOAP v2 | Käyttäjätunnus + Salasana |
| 10 | Sardinia | ROSS1000 | Käyttäjätunnus + Salasana |
| 11 | Lazio | ROSS1000 | Käyttäjätunnus + Salasana |
| 12 | Molise | ROSS1000 | Käyttäjätunnus + Salasana |
| 13 | Sisilia | REST XML | PMS User + HotelCode |
| 14 | Campania | REST JSON (Sinfonia) | CUSR + API Key |
| 17 | Trentino | SOAP DTU C59 | Käyttäjätunnus + Salasana |
| 19 | Valle d'Aosta | SOAP VIT (INVA) | Käyttäjä + Salasana + Majoituskohteen ID |
Alueet, joilla tiedosto ladataan (3 aluetta)
Näillä alueilla Vezpa muodostaa tiedoston, joka sinun on ladattava sovelluksesta ja vietävä käsin alueelliseen portaaliin.
| ID | Alue | Muoto | Latausportaali |
|---|---|---|---|
| 15 | Umbria | TXT (ROSS 1000) | Turismatica |
| 16 | Friuli-Venezia Giulia | TXT (ROSS 1000) | WebTur |
| 18 | Apulia | XML (SPOT) | www.dms.puglia.it (SPID) |
Näin määrität ISTATin
- Avaa Profiili → Asetukset ja valitse huoneesi/majoituksesi
- Kytke ISTAT-osiossa päälle valitsin ”Käytössä”
- Valitse alueesi pudotusvalikosta
- Syötä alueellisen portaalin antamat tunnukset
- Syötä majoituskohteen ISTAT-koodi
- Tallenna. Automaattinen lähetys käynnistyy jo samana iltana
PayTouristMatkailuveron alusta
PayTourist on valinnainen alusta, joka automatisoi matkailuveron keräämisen ja tilittämisen monissa italialaisissa kunnissa. Vezpa on suoraan integroitu PayTouristiin vieraiden tietojen lähettämistä varten.
Tarvittavat tunnukset
| Kenttä | Mistä saat sen |
|---|---|
| PayTourist-tunniste | Rekisteröityminen osoitteessa paytourist.it (itsepalvelu) |
| API-token | PayTouristin hallintapaneeli rekisteröitymisen jälkeen |
Digitaalinen allekirjoitusVieraan allekirjoituksen kerääminen rekisteröinnin yhteydessä
Digitaalinen allekirjoitus kerätään sekä Flutter-sovelluksessa (vieraan rekisteröinnin aikana) että verkon itsepalvelu-check-inissä (kosketuspiirtoalue). Allekirjoitus tallennetaan PNG-kuvana vieraan profiiliin.
Vieraan allekirjoitusta pyydetään vain maissa, joissa laki edellyttää sitä rekisteröintilomakkeessa: Saksassa, Itävallassa, Ranskassa ja Espanjassa. Sielläkin se on vapaaehtoinen — sovelluksessa ja verkkosisäänkirjautumisessa — koska vieras voi allekirjoittaa lomakkeen paperilla saapuessaan; missään maassa allekirjoitusta ei lähetetä viranomaiselle, se toimii majoituspaikan todisteena. Muissa maissa allekirjoitusosio ei näy, ja missä Vezpa osaa tuottaa lomakkeen, PDF luodaan silti, ja siinä on rivi paperilla allekirjoittamista varten.
Lomake luodaan varauksen tiedoista napauttamalla ”Rekisteröintiasiakirja”: se tulee valmiiksi täytettynä vieraan tiedoilla, majoituskohteen maan kielellä, valmiina allekirjoitettavaksi ja säilytettäväksi. Painike ilmestyy itsestään siellä, missä Vezpa osaa tuottaa lomakkeen, ja pysyy pois käytöstä — selittävän viestin kanssa — kunnes varauksen vastuuhenkilö on rekisteröity.
Eurooppalaiset viranomaisliittymätVierastietojen automaattinen lähetys 7 maahan + Islannin rekisteri
Jos majoituskohteesi sijaitsee jossakin seuraavista Euroopan maista, Vezpa voi lähettää vieraiden tiedot automaattisesti kansalliseen viranomaisjärjestelmään. Asetukset löytyvät kohdasta Profiili → Viranomaisrekisteröinti. Jos maasi yhteys ei ole vielä aktiivinen, sovellus kertoo sen sivun yläosan ilmoituksella: katso Missä yhteys menee.
🇪🇸 Espanja — SES.Hospedajes
Pakollinen 2. joulukuuta 2024 alkaen (Real Decreto 933/2021). Registro de viajeros Ministerio del Interiorin alaisuudessa.
| Tunniste | Mistä saat sen |
|---|---|
| API Key | seshospedajes.es (itsepalvelu) |
| Establishment ID | SES-portaali majoituskohteen rekisteröinnin jälkeen |
🇭🇷 Kroatia — eVisitor
Kansallinen sähköinen järjestelmä, jota hallinnoi Hrvatska turisticka zajednica (HTZ).
| Tunniste | Mistä saat sen |
|---|---|
| Käyttäjätunnus + Salasana | evisitor.hr (itsepalvelu) |
| API Key | eVisitor-portaali rekisteröitymisen jälkeen |
| Facility Code | Annetaan rekisteröinnin yhteydessä |
🇭🇺 Unkari — NTAK
Kansallinen NTAK-järjestelmä (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). Vezpa yhdistyy välittäjän NTAK.guru kautta, mikä yksinkertaistaa integraatiota.
| Tunniste | Mistä saat sen |
|---|---|
| Bearer Token | ntak.guru (itsepalvelu) |
| Accommodation ID | NTAK.guru-portaali rekisteröitymisen jälkeen |
🇵🇹 Portugali — SIBA
Boletim de Alojamento on pakollinen lain Lei n.º 23/2007 (art. 15-16) nojalla.
| Tunniste | Mistä saat sen |
|---|---|
| Käyttäjätunnus + Salasana | siba.ssi.gov.pt |
| Estabelecimento-koodi | SIBA-rekisteröinti |
🇨🇿 Tšekki — UbyPort
Pakollinen ulkomaalaisrekisteri, jota hallinnoi Cizinecká policie (ulkomaalaispoliisi).
Vezpa on 9. lokakuuta 2026 alkaen Tšekin poliisin hyväksymä (Ředitelství služby cizinecké policie, RSCP) ohjelmisto ulkomaisten vieraiden tietojen automaattiseen lähettämiseen UbyPortiin. Lähetys käynnistyy itsestään tunneittaisessa ajossa. Jos vieraalta puuttuu tietoja tai poliisi hylkää tietueen, saat ilmoituksen «Tarkista vieraan tiedot», jossa on vieraan nimi ja syy: hylättyä tietuetta ei yritetä uudelleen itsestään, vaan se lähetetään uudelleen, kun olet korjannut tiedot.
| Tunniste | Mistä saat sen |
|---|---|
| Käyttäjätunnus + Salasana | Tili robottimaiseen tietojen lähettämiseen (účet pro robotické zasílání dat), RSCP:n myöntämä |
| IDUB | RSCP antaa sen majoituskohteen rekisteröinnissä |
| Zkratka | Majoituskohteen lyhenne, annetaan IDUB:n kanssa (valinnainen, suositeltava) |
Näin saat tilin. Sitä ei luoda automaattisesti; tapauksia on kolme:
- Sinulla on jo robottitili (esimerkiksi toisen PMS:n kanssa käytetty): poliisin kanssa ei tarvitse tehdä mitään, tili on siirrettävissä. Syötä nykyiset tunnuksesi Vezpaan.
- Sinulla on IDUB mutta ei robottitiliä: kirjoita RSCP:lle datová schránka -palvelun kautta (ID ybndqw9) tai sähköpostitse osoitteeseen [email protected] ja pyydä tiliä robottimaiseen tietojen lähettämiseen. Ilmoita IDUB, majoituskohteen nimi ja koko osoite, valmistaja ja ohjelmiston nimi, jonka on oltava täsmälleen «Vezpa»: millä tahansa muulla nimellä pyyntöä ei hyväksytä.
- Sinulla ei ole IDUB:ia eikä tiliä: jätä tavallinen uuden majoituskohteen rekisteröintihakemus (Žádost o registraci nového ubytovacího zařízení) osoitteessa ubyport.pcr.cz, valitse «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» ja anna ohjelman nimeksi «Vezpa».
Hakemuksen mallipohja (tšekiksi): «Žá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.» Lisää Tšekin poliisin virallisella sivulla.
Vezpassa kohdassa Asetukset → Viranomaisrekisteröinti: robottitilin käyttäjätunnus ja salasana, IDUB kenttään «Majoituskohteen koodi», Zkratka kohtaan «Lisäasetukset», ja kytke sitten «Automaattinen lähetys» päälle. Jätä endpoint tyhjäksi ja «Testiympäristö» pois päältä: se on vain kehittäjien testitileille. Useita majoituskohteita omilla IDUB:illa: käytä kohtaa «Tunnukset majoituskohteittain».
🇦🇹 Itävalta — Meldeamt
Gaestemeldung on pakollinen Meldegesetz-lain nojalla. Jokaisella Bundeslandilla on oma järjestelmänsä; Vezpa tukee kaikkia 9 Bundeslaenderia määritettävällä endpointilla.
| Tunniste | Mistä saat sen |
|---|---|
| Käyttäjätunnus + Salasana tai API Key | Oman Bundeslandin portaali (feratel Deskline, GMS jne.) |
| Betriebsnummer | Alueellisen Meldeamtin myöntämä |
| Endpoint URL | Bundeslandkohtainen |
🇸🇮 Slovenia — eTurizem (AJPES)
Pakollinen matkailijoiden rekisteröinti, jota hallinnoi AJPES. Edellyttää hyväksyttyä varmennetta, jonka myöntää slovenialainen akkreditoitu palveluntarjoaja.
| Tunniste | Mistä saat sen |
|---|---|
| PEM-muotoinen varmenne | SIGEN-CA, Halcom, NLB tai muu akkreditoitu taho |
| ID Nastanitvenega Obrata | AJPES-portaali rekisteröitymisen jälkeen |
🇮🇸 Islanti — Gistiskrá (vierasrekisteri)
Islannin majoitusliikkeitä koskevan lain (Lög um veitingastaði, gististaði og skemmtanahald) mukaan jokaisen majoituskohteen on pidettävä vierasrekisteriä (gistiskrá), joka sisältää kaikkien vieraiden tiedot. Rekisterin on oltava Islannin poliisin (Lögreglan) tarkastettavissa.
Vezpa tallentaa kaikki vaaditut tiedot automaattisesti sisäänkirjautumisen yhteydessä. Tunnuksia ei tarvitse määrittää lainkaan — tiedot ovat aina saatavilla sovelluksessa, ja ne voi viedä tiedostoon tai tulostaa milloin tahansa.
| Pakollinen kenttä | Kuvaus |
|---|---|
| Koko nimi | Vieraan etu- ja sukunimi |
| Syntymäaika | Täydellinen päivämäärä |
| Kansalaisuus | Kansalaisuusvaltio |
| Asiakirja | Tyyppi ja numero (passi tai henkilökortti) |
| Asuinpaikka | Täydellinen osoite |
| Oleskelun päivämäärät | Saapuminen ja lähtö |
ISTAT-tiedoston latausAlueille, joilla vienti tehdään käsin (Umbria, FVG, Apulia)
Umbrian, Friuli-Venezia Giulian ja Apulian alueilla ei ole verkkopalvelua automaattista lähetystä varten. Näillä alueilla Vezpa muodostaa tiedoston, joka sinun on ladattava ja vietävä portaaliin käsin.
Näin lataat tiedoston
- Avaa majoituskohteen asetukset (Profiili → napauta huonetta)
- Tarkista ISTAT-osiossa, että oikea alue on valittuna
- Napauta painiketta ”Lataa ISTAT-tiedosto”
- Valitse jakson alkupäivä ja loppupäivä
- Napauta ”Muodosta ja lataa tiedosto”
- Tiedosto muodostetaan, ja voit jakaa sen (sähköposti, WhatsApp, tallennus tiedostojärjestelmään)
Tiedostomuodot alueittain
| Alue | Muoto | Minne se viedään |
|---|---|---|
| Umbria | TXT (ROSS 1000, 338 merkkiä/tietue) | Turismatica |
| Friuli V.G. | TXT (ROSS 1000, 338 merkkiä/tietue) | WebTur |
| Apulia | XML (SPOT, muoto movimentogiornaliero-0.6.xsd) | www.dms.puglia.it (kirjautuminen SPID-tunnuksilla) |
<movimento>-elementin valitun jakson jokaista päivää kohden: saapumiset, lähdöt ja majoituskohteen tiedot (vapaat huoneet, vuodepaikat, varatut huoneet). Vendor-arvoksi asetetaan automaattisesti ”Vezpa”.
Tarvitsetko apua?
Jos sinulla on kysyttävää viranomaisjärjestelmien asetuksista tai tunnusten saaminen ei onnistu, ota yhteyttä Vezpan tukeen.