Ghid Sisteme Guvernamentale
Questura, ISTAT, PayTourist și conectori europeni — configurare, credențiale și trimitere automată
Cuprins
Unde a ajuns conectareaAvertizarea pe care o arată aplicația și ce înseamnă
Înregistrarea oaspeților funcționează în fiecare țară în care Vezpa este disponibilă și continuă să funcționeze. Ce nu este pornit peste tot este conectarea automată cu autoritatea: transmiterea datelor pe care le-ai înregistrat deja.
Acolo unde conectarea nu este încă activă, în partea de sus a Profil → Înregistrare guvernamentală găsești o casetă informativă care ți-o spune: trimiterea automată către autoritatea acelei țări este în faza de test, iar înregistrarea oaspeților funcționează normal. Este doar o informație: nu blochează nimic, nu e nimic de confirmat sau de închis, iar caseta apare și atunci când pentru țara ta încă nu există niciun conector de configurat.
Caseta dispare singură atunci când conectarea pentru țara ta devine activă: nu trebuie să faci nimic și nicio setare nu trebuie actualizată. Secțiunile de mai jos descriu cum se configurează fiecare sistem; avertizarea spune unde a ajuns.
Când pleacă ceea ce ai autorizatCele trei cadențe, coșul „De trimis” și rezumatul zilei
Celelalte secțiuni spun cui declară Vezpa și cu ce date de acces. Aceasta spune când, pentru că decizia este a unității și o iei tu: deschide Configurare → Înregistrare guvernamentală și, în caseta „Când se trimite către autorități”, alege una dintre cele trei cadențe. Este valabil în orice țară: în Italia comandă fișele către Questura (direcția de poliție locală) prin serviciul Alloggiati Web al Polizia di Stato, în alte părți trimiterile conectorului țării tale.
- „La fiecare 4 ore” — șase treceri pe zi. Înregistrezi oaspetele și nu te mai gândești la asta.
- „La 23:15” — o singură trecere, la sfârșitul zilei.
- „Manual” — pleacă doar ce selectezi și trimiți tu.
Coșul „De trimis”
Imediat ce alegi cadența manuală, în aceeași casetă apare rândul „De trimis”: este coșul rezervărilor care așteaptă, grupate după ziua de sosire. Bifezi pe cele care vrei să le declari și apeși „Trimite selecția”. În celelalte două cadențe rândul nu există, și nu lipsește nimic: nu e nimic de ales, totul pleacă singur.
A autoriza nu este a trimite, și diferența nu este un amănunt. Când apeși, permisiunea se scrie înainte de plecare, iar o singură apăsare poate duce doar o parte din muncă: atunci pagina ți-o spune — „autorizate, dar încă nu au plecat complet” — și îți oferă „Finalizează acum”. Apeși din nou și reia de unde s-a oprit: nu este o eroare. Pentru același motiv pe ecran nu citești niciodată cuvântul trimisă: o rezervare este „Autorizată” când permisiunea există, iar dacă autoritatea a acceptat-o cu adevărat o spune rezultatul, unul câte unul.
ISTAT și PayTourist urmează Questura
Aici nu e nimic de decis și nu există un al doilea comutator: ISTAT și PayTourist merg după Questura, singure. Dacă o rezervare a fost declarată la Questura, o declară și ele; dacă nu a fost, nu o declară. Așa este construit, iar în manual asta are o consecință pe care e bine să o știi din timp: o noapte pe care încă nu ai trimis-o ajunge la ISTAT ca cameră închisă. Pornește cadența manuală doar dacă ești pregătit să trimiți cu regularitate, altfel datele tale de ocupare se vor schimba dintr-un motiv care nu are nimic de-a face cu camerele tale.
În manual Questura acceptă doar astăzi și ieri
Nu este o alegere a noastră, este portalul: Alloggiati Web ia ca dată de sosire doar astăzi sau ieri, iar dincolo de acea limită fișa este respinsă. Nu este o formalitate, fiindcă o fișă cu o dată veche declară de la sine o trimitere peste termen. De aceea coșul are o fereastră: cu cadența manuală, a amâna două zile nu este a amâna, este a pierde.
Rezumatul zilei
Din partea de sus a paginii „De trimis” se deschide „Rezumatul zilei”: unde ai ajuns astăzi, în trei numere — „Oaspeții zilei”, „Autorizați” și „Selectați pentru trimitere”. Pagina este numai pentru citire: de aici nu se adaugă și nu se scoate nimic, la coș te întorci cu „Adaugă sau scoate rezervări”. Două locuri care scriu aceeași listă ar fi două liste diferite.
Cele două rânduri de privit sunt acestea, pentru că pe ele se acționează:
- Oaspeți selectați care încă nu pot fi declarați — lipsește înregistrarea lor. Nu vor pleca: înregistrează-i și reintră în declarație.
- Oaspeți a căror selecție a ieșit din fereastră — nu vor pleca, selecția nu se mai poate scoate, și din aplicație nu mai este nimic de făcut: pentru acele zile se trece prin portalul autorității. Sunt numărați separat de cei selectați, nu între ei, iar acest rezumat este singurul loc care ți-i mai arată.
Datele de acces se schimbă cu țaraCâmpuri cerute de autoritate, și cele care sunt pe unitate
Pagina datelor de acces nu este același formular pentru toată lumea. Pe lângă câmpurile comune — nume de utilizator, parolă, identificatorul structurii, adresa serviciului — fiecare țară declară câmpurile suplimentare pe care le cere autoritatea ei, iar pagina le desenează singură: deschide Profil → Înregistrare guvernamentală, alege sistemul și completează ce vezi. Etichetele poartă numele oficial dat de autoritate și nu sunt traduse, ca să le regăsești identice în portalul de unde copiezi valorile. Unde autoritatea oferă un mediu de test, există și un comutator pentru el: îți permite să verifici configurarea înainte ca ceva să plece cu adevărat. Un câmp pe care nu îl vezi nu lipsește din greșeală: în țara ta nu se cere.
Și mai e ceva la care nu te gândești: unele date de acces nu sunt ale structurii, ci ale unității în sine. Unde autoritatea emite un identificator pentru fiecare unitate de cazare, sub câmpurile comune apare un card în plus: Date de acces pe unitate. Alege unitatea din meniu și completează doar ce diferă pentru ea: ce lași gol folosește valoarea structurii și nu trebuie repetat. Dacă acel card nu apare, în țara ta nu e nevoie și totul e valabil pentru întreaga structură.
Dacă contul are mai multe proprietăți, meniul cardului afișează întâi câte o opțiune pentru fiecare, „…: toate unitățile”: datele de acces salvate acolo se scriu pentru fiecare dintre unitățile ei. Este util când autoritatea v-a dat un identificator pe adresă, nu pe apartament: îl introduceți o singură dată și puteți corecta oricând o unitate alegând-o din meniu.
Questura (Alloggiati Web)Trimiterea fișelor de cazare către Polizia di Stato
Toate structurile de cazare din Italia sunt obligate să comunice datele oaspeților către Questura prin serviciul Alloggiati Web al Polizia di Stato. Vezpa trimite automat datele oaspeților imediat ce acestea sunt înregistrate.
Cum obții credențialele
- Înregistrează-te pe alloggiatiweb.poliziadistato.it
- Depune cererea de activare la Questura locală
- Primești credențialele prin e-mail: Nume utilizator, Parolă și Token WS
- Introdu credențialele în Vezpa: Profil → Configurare → Questura
- Activează comutatorul „Activat”
Flux automat
Câmpuri obligatorii Questura
| Câmp | Descriere |
|---|---|
| Nume, Prenume | Datele de identificare ale oaspetelui |
| Sex | M / F (obligatoriu doar pentru Italia) |
| Data și locul nașterii | Cu codul ISTAT al localității |
| Cetățenie | Cod de țară Alloggiatiweb |
| Tipul și numărul documentului | 95 de tipuri disponibile (pașaport, carte de identitate etc.) |
| Tip de cazat | Oaspete individual (16), Cap de familie (17), Șef de grup (18) |
ISTAT — Statistici turistice19 regiuni, fiecare cu propriul sistem
Italia are 19 sisteme regionale diferite pentru colectarea datelor statistice privind turismul. Vezpa le gestionează pe toate: cea mai mare parte complet automat, iar unele regiuni necesită descărcarea unui fișier.
Regiuni cu trimitere automată (16 regiuni)
Pentru aceste regiuni, Vezpa trimite datele automat în fiecare seară prin web service. Ai nevoie doar de credențialele regionale.
| ID | Regiune | Protocol | Credențiale |
|---|---|---|---|
| 0 | Piemonte | SOAP v2 | Nume utilizator + Parolă |
| 1 | Toscana | SOAP v2 | Nume utilizator + Parolă |
| 2 | Basilicata | SOAP v1 | Nume utilizator + Parolă |
| 3 | Liguria | SOAP v2 | Nume utilizator + Parolă |
| 4 | Abruzzo | SOAP v2 (Turismo5) | Nume utilizator + Parolă |
| 5 | Veneto | SOAP v2 | Nume utilizator + Parolă |
| 6 | Emilia-Romagna | SOAP v2 | Nume utilizator + Parolă |
| 7 | Marche | ROSS1000 | Nume utilizator + Parolă |
| 8 | Lombardia | Turismo5 | Nume utilizator + Parolă |
| 9 | Calabria | SOAP v2 | Nume utilizator + Parolă |
| 10 | Sardegna | ROSS1000 | Nume utilizator + Parolă |
| 11 | Lazio | ROSS1000 | Nume utilizator + Parolă |
| 12 | Molise | ROSS1000 | Nume utilizator + Parolă |
| 13 | Sicilia | REST XML | PMS User + HotelCode |
| 14 | Campania | REST JSON (Sinfonia) | CUSR + Cheie API |
| 17 | Trentino | SOAP DTU C59 | Nume utilizator + Parolă |
| 19 | Valle d'Aosta | SOAP VIT (INVA) | Utilizator + Parolă + ID structură |
Regiuni cu descărcare de fișier (3 regiuni)
Pentru aceste regiuni, Vezpa generează fișierul pe care va trebui să îl descarci din aplicație și să îl încarci manual pe portalul regional.
| ID | Regiune | Format | Portal de încărcare |
|---|---|---|---|
| 15 | Umbria | TXT (ROSS 1000) | Turismatica |
| 16 | Friuli Venezia Giulia | TXT (ROSS 1000) | WebTur |
| 18 | Puglia | XML (SPOT) | www.dms.puglia.it (SPID) |
Cum configurezi ISTAT
- Deschide Profil → Configurare și selectează camera/unitatea ta de cazare
- În secțiunea ISTAT, activează comutatorul „Activat”
- Selectează regiunea din meniul derulant
- Introdu credențialele furnizate de portalul regional
- Introdu codul ISTAT al structurii
- Salvează. Trimiterea automată va porni chiar din seara aceea
PayTouristPlatformă pentru taxa de ședere
PayTourist este o platformă opțională care automatizează colectarea și virarea taxei de ședere pentru multe localități din Italia. Vezpa se integrează direct cu PayTourist pentru a trimite datele oaspeților.
Credențiale necesare
| Câmp | De unde îl obții |
|---|---|
| ID PayTourist | Înregistrare pe paytourist.it (self-service) |
| Token API | Panoul PayTourist după înregistrare |
Semnătură digitalăColectarea semnăturii oaspetelui în timpul înregistrării
Semnătura digitală este colectată atât din aplicația Flutter (în timpul înregistrării oaspetelui), cât și din self check-in-ul web (canvas tactil). Semnătura este salvată ca imagine PNG în profilul oaspetelui.
Semnătura oaspetelui este propusă doar în țările în care legea o cere pe formularul de înregistrare: Germania, Austria, Franța și Spania. Chiar și acolo este opțională — în aplicație și la check-in-ul online — deoarece oaspetele poate semna formularul pe hârtie la sosire; în nicio țară semnătura nu este transmisă autorității, ea servește unității drept dovadă. În celelalte țări secțiunea semnăturii nu apare, iar acolo unde Vezpa poate genera formularul, PDF-ul se generează oricum, cu un rând de semnat pe hârtie.
Formularul se generează din detaliul rezervării apăsând pe „Document de înregistrare”: iese deja completat cu datele oaspetelui, în limba țării unității, gata de semnat și de păstrat. Butonul apare singur acolo unde Vezpa poate produce formularul și rămâne dezactivat — cu un mesaj care explică de ce — până când responsabilul rezervării este înregistrat.
Conectori guvernamentali europeniTrimitere automată a datelor oaspeților pentru 7 țări + registrul Islandei
Pentru structurile situate într-una dintre următoarele țări europene, Vezpa poate trimite automat datele oaspeților către sistemul guvernamental național. Configurarea se află în Profil → Înregistrare guvernamentală. Dacă pentru țara ta conectarea nu este încă activă, aplicația îți spune printr-o avertizare în partea de sus a paginii: vezi Unde a ajuns conectarea.
🇪🇸 Spania — SES.Hospedajes
Obligatoriu de la 2 decembrie 2024 (Real Decreto 933/2021). Registro de viajeros la Ministerio del Interior.
| Credențial | De unde îl obții |
|---|---|
| API Key | seshospedajes.es (self-service) |
| Establishment ID | Portalul SES după înregistrarea structurii |
🇭🇷 Croația — eVisitor
Sistem telematic național gestionat de Hrvatska turisticka zajednica (HTZ).
| Credențial | De unde îl obții |
|---|---|
| Nume utilizator + Parolă | evisitor.hr (self-service) |
| API Key | Portalul eVisitor după înregistrare |
| Facility Code | Atribuit la înregistrare |
🇭🇺 Ungaria — NTAK
Sistemul național NTAK (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). Vezpa se conectează prin intermediarul NTAK.guru pentru a simplifica integrarea.
| Credențial | De unde îl obții |
|---|---|
| Bearer Token | ntak.guru (self-service) |
| Accommodation ID | Portalul NTAK.guru după înregistrare |
🇵🇹 Portugalia — SIBA
Boletim de Alojamento obligatoriu în temeiul Lei nr. 23/2007 (art. 15-16).
| Credențial | De unde îl obții |
|---|---|
| Nume utilizator + Parolă | siba.ssi.gov.pt |
| Cod Estabelecimento | Înregistrarea SIBA |
🇨🇿 Republica Cehă — UbyPort
Registru obligatoriu al străinilor, gestionat de Cizinecká policie (Poliția pentru Străini).
Din 9 octombrie 2026 Vezpa este aprobat de poliția cehă (Ředitelství služby cizinecké policie, RSCP) ca software pentru trimiterea automată a datelor oaspeților străini către UbyPort. Trimiterea pornește singură, la trecerea din fiecare oră. Dacă unui oaspete îi lipsesc date sau poliția respinge o înregistrare, primești notificarea «Verifică datele oaspetelui» cu numele oaspetelui și motivul: înregistrarea respinsă nu se reîncearcă singură, ci se retrimite după ce ai corectat datele.
| Credențial | De unde îl obții |
|---|---|
| Nume utilizator + Parolă | Cont pentru trimiterea robotizată a datelor (účet pro robotické zasílání dat), emis de RSCP |
| IDUB | Atribuit de RSCP la înregistrarea unității de cazare |
| Zkratka | Abrevierea unității, atribuită împreună cu IDUB (opțională, recomandată) |
Cum obții contul. Nu se creează automat; există trei cazuri:
- Ai deja un cont robotizat (de exemplu folosit cu alt PMS): nu ai nimic de făcut la poliție, contul este transferabil. Introdu în Vezpa datele de acces existente.
- Ai IDUB, dar nu ai cont robotizat: scrie la RSCP prin datová schránka (ID ybndqw9) sau prin e-mail la [email protected] cerând un cont pentru trimiterea robotizată a datelor. Indică IDUB, numele și adresa completă a unității, producătorul și numele programului, care trebuie să fie exact «Vezpa»: cu orice alt nume cererea nu este aprobată.
- Nu ai nici IDUB, nici cont: depune cererea obișnuită de înregistrare a unei noi unități de cazare (Žádost o registraci nového ubytovacího zařízení) pe ubyport.pcr.cz, alegând «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» și indicând «Vezpa» ca nume al programului.
Text model pentru cerere (în cehă): «Žá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.» Mai multe pe pagina oficială a poliției cehe.
În Vezpa, la Configurare → Înregistrare guvernamentală: numele de utilizator și parola contului robotizat, IDUB în câmpul «Cod proprietate», Zkratka în «Setări suplimentare», apoi activează «Trimitere automată». Lasă endpoint-ul gol și «Mediu de test» dezactivat: servește doar conturilor de test ale dezvoltatorilor. Mai multe unități cu IDUB diferite: folosește «Date de acces pe unitate».
🇦🇹 Austria — Meldeamt
Gaestemeldung obligatorie în temeiul legii Meldegesetz. Fiecare Bundesland are propriul sistem; Vezpa acceptă toate cele 9 Bundeslaender, cu endpoint configurabil.
| Credențial | De unde îl obții |
|---|---|
| Nume utilizator + Parolă sau API Key | Portalul propriului Bundesland (feratel Deskline, GMS etc.) |
| Betriebsnummer | Atribuit de Meldeamt-ul regional |
| Endpoint URL | Specific pentru fiecare Bundesland |
🇸🇮 Slovenia — eTurizem (AJPES)
Înregistrarea turiștilor este obligatorie și este gestionată de AJPES. Necesită un certificat digital calificat emis de un prestator acreditat sloven.
| Credențial | De unde îl obții |
|---|---|
| Certificat digital PEM | SIGEN-CA, Halcom, NLB sau altă entitate acreditată |
| ID Nastanitvenega Obrata | Portalul AJPES după înregistrare |
🇮🇸 Islanda — Gistiskrá (Registrul oaspeților)
Conform legii islandeze privind structurile de cazare (Lög um veitingastaði, gististaði og skemmtanahald), fiecare structură trebuie să țină un registru al oaspeților (gistiskrá) cu datele tuturor oaspeților. Registrul trebuie să fie disponibil pentru control din partea poliției islandeze (Lögreglan).
Vezpa înregistrează automat toate datele necesare în timpul check-in-ului. Nu este necesară nicio configurare de credențiale — datele sunt mereu disponibile în aplicație și pot fi exportate sau tipărite în orice moment.
| Câmp obligatoriu | Descriere |
|---|---|
| Nume complet | Numele și prenumele oaspetelui |
| Data nașterii | Data completă |
| Naționalitate | Țara de cetățenie |
| Document | Tip și număr (pașaport sau carte de identitate) |
| Reședință | Adresa completă |
| Datele sejurului | Sosire și plecare |
Descărcare fișier ISTATPentru regiunile cu încărcare manuală (Umbria, FVG, Puglia)
Regiunile Umbria, Friuli Venezia Giulia și Puglia nu dispun de web service pentru trimiterea automată. Pentru aceste regiuni, Vezpa generează fișierul pe care va trebui să îl descarci și să îl încarci manual.
Cum descarci fișierul
- Deschide configurarea structurii (Profil → apasă pe o cameră)
- În secțiunea ISTAT, verifică dacă este selectată regiunea corectă
- Apasă butonul „Descarcă fișierul ISTAT”
- Selectează data de început și data de sfârșit ale perioadei
- Apasă „Generează și descarcă fișierul”
- Fișierul este generat și îl poți partaja (e-mail, WhatsApp, salvare în sistemul de fișiere)
Formate de fișier pe regiune
| Regiune | Format | Unde se încarcă |
|---|---|---|
| Umbria | TXT (ROSS 1000, 338 caractere/înregistrare) | Turismatica |
| Friuli V.G. | TXT (ROSS 1000, 338 caractere/înregistrare) | WebTur |
| Puglia | XML (SPOT, format movimentogiornaliero-0.6.xsd) | www.dms.puglia.it (acces SPID) |
<movimento> pentru fiecare zi din perioada selectată, cu sosiri, plecări și date despre structură (camere disponibile, locuri de cazare, camere ocupate). Furnizorul (vendor) este setat automat pe „Vezpa”.
Ai nevoie de asistență?
Dacă ai nelămuriri privind configurarea sistemelor guvernamentale sau nu reușești să obții credențialele, contactează asistența Vezpa.