Przewodnik po systemach rządowych
Questura, ISTAT, PayTourist i konektory europejskie — konfiguracja, dane dostępowe i automatyczna wysyłka
Spis treści
Na jakim etapie jest połączenieKomunikat pokazywany przez aplikację i co oznacza
Rejestracja gości działa w każdym kraju, w którym Vezpa jest dostępna, i działa nadal. To, co nie jest włączone wszędzie, to automatyczne połączenie z urzędem: przesyłanie danych, które już wprowadziłeś.
Tam, gdzie połączenie nie jest jeszcze aktywne, u góry Profil → Rejestracja rządowa znajdziesz ramkę informacyjną, która o tym mówi: automatyczna wysyłka do urzędu tego kraju jest testowana, a rejestracja gości działa normalnie. To wyłącznie informacja: niczego nie blokuje, nie ma czego potwierdzać ani zamykać, a ramka pojawia się także wtedy, gdy dla Twojego kraju nie ma jeszcze żadnego łącznika do skonfigurowania.
Ramka znika sama, gdy połączenie dla Twojego kraju stanie się aktywne: nic nie musisz robić i nie trzeba aktualizować żadnego ustawienia. Poniższe sekcje opisują, jak skonfigurować każdy system; komunikat mówi, na jakim etapie jest.
Kiedy wyrusza to, co zautoryzowałeśTrzy rytmy, koszyk „Oczekujące wysyłki” i podsumowanie dnia
Pozostałe sekcje mówią, komu Vezpa zgłasza i jakimi danymi dostępu. Ta mówi, kiedy, bo decyzja należy do obiektu i podejmujesz ją ty: otwórz Konfiguracja → Rejestracja rządowa i w ramce „Kiedy wysyłać do organów” wybierz jeden z trzech rytmów. Obowiązuje w każdym kraju: we Włoszech rządzi zgłoszeniami do Questury (miejscowej komendy policji) przez usługę Alloggiati Web prowadzoną przez Polizia di Stato, gdzie indziej wysyłkami łącznika twojego kraju.
- „Co 4 godziny” — sześć przebiegów na dobę. Rejestrujesz gościa i przestajesz o tym myśleć.
- „O 23:15” — jeden jedyny przebieg, na koniec dnia.
- „Ręcznie” — wyrusza tylko to, co zaznaczysz i wyślesz sam.
Koszyk „Oczekujące wysyłki”
Gdy tylko wybierzesz rytm ręczny, w tej samej ramce pojawia się pozycja „Oczekujące wysyłki”: to koszyk rezerwacji, które czekają, pogrupowanych według dnia przyjazdu. Zaznaczasz te, które chcesz zgłosić, i naciskasz „Wyślij wybrane”. W pozostałych dwóch rytmach tej pozycji nie ma i nic nie brakuje: nie ma czego wybierać, wszystko wyrusza samo.
Autoryzować to nie wysłać, a różnica nie jest drobiazgiem. Kiedy naciskasz, zezwolenie jest zapisywane przed wyruszeniem, a jedno naciśnięcie może zabrać tylko część pracy: wtedy strona ci to mówi — „autoryzowane, ale wysyłka nie jest jeszcze zakończona” — i proponuje „Zakończ teraz”. Naciskasz ponownie i podejmuje tam, gdzie się zatrzymała: to nie jest błąd. Z tego samego powodu na ekranie nigdy nie czytasz słowa wysłana: rezerwacja jest „Autoryzowana”, gdy zezwolenie istnieje, a czy organ naprawdę ją przyjął, mówi wynik, jeden po drugim.
ISTAT i PayTourist idą za Questurą
Tu nie ma czego decydować i nie ma drugiego przełącznika: ISTAT i PayTourist idą za Questurą same. Jeśli rezerwacja została zgłoszona Questurze, zgłaszają ją też one; jeśli nie została, nie zgłaszają. Tak jest zbudowane, a przy rytmie ręcznym ma to następstwo, które lepiej znać z wyprzedzeniem: noc, której jeszcze nie wysłałeś, dociera do ISTAT jako zamknięty pokój. Włączaj rytm ręczny tylko wtedy, gdy jesteś gotów wysyłać regularnie, inaczej twoje dane o obłożeniu zmienią się z powodu, który nie ma nic wspólnego z twoimi pokojami.
Ręcznie Questura przyjmuje tylko dziś i wczoraj
To nie nasz wybór, to portal: Alloggiati Web przyjmuje jako datę przyjazdu tylko dziś lub wczoraj, a za tą granicą zgłoszenie jest odrzucane. To nie formalność, bo zgłoszenie ze starą datą samo w sobie oświadcza wysyłkę po terminie. Dlatego koszyk ma okno: przy rytmie ręcznym odłożenie o dwa dni nie jest odłożeniem, lecz stratą.
Podsumowanie dnia
Z góry strony „Oczekujące wysyłki” otwiera się „Podsumowanie dnia”: na jakim jesteś etapie dziś, w trzech liczbach — „Goście dnia”, „Autoryzowani” i „Wybrani do wysłania”. Strona jest tylko do czytania: stąd nic się nie dodaje i nic nie usuwa, do koszyka wracasz przez „Dodaj lub usuń rezerwacje”. Dwa miejsca, które zapisują tę samą listę, byłyby dwiema różnymi listami.
Dwa wiersze, na które warto spojrzeć, są te, bo na nich się działa:
- Wybrani goście, których nie można jeszcze zgłosić — brakuje ich rejestracji. Nie wyruszą: zarejestruj ich i wracają do zgłoszenia.
- Goście, których wybór wypadł z okna — nie wyruszą, wyboru nie da się już usunąć, a z aplikacji nie ma już nic do zrobienia: dla tych dni przechodzi się przez portal organu. Są liczeni osobno od wybranych, nie wśród nich, a to podsumowanie jest jedynym miejscem, które jeszcze ci ich pokazuje.
Dane dostępu zmieniają się zależnie od krajuPola wskazane przez urząd i te, które dotyczą pojedynczego obiektu
Strona danych dostępu nie jest dla wszystkich tym samym formularzem. Oprócz wspólnych pól — nazwa użytkownika, hasło, identyfikator obiektu, adres usługi — każdy kraj zgłasza dodatkowe pola, których wymaga jego urząd, a strona rysuje je sama: otwórz Profil → Rejestracja rządowa, wybierz system i wypełnij to, co widzisz. Etykiety tych pól noszą oficjalną nazwę nadaną przez urząd i nie są tłumaczone, dzięki czemu znajdziesz je bez zmian w portalu, z którego kopiujesz wartości. Tam, gdzie urząd udostępnia środowisko testowe, jest też przełącznik do jego użycia: pozwala sprawdzić konfigurację, zanim cokolwiek zostanie naprawdę wysłane. Pole, którego nie widzisz, nie brakuje przez pomyłkę: w Twoim kraju nie jest wymagane.
Jest jeszcze coś, czego się nie spodziewasz: część danych dostępu należy nie do obiektu głównego, lecz do pojedynczego obiektu noclegowego. Tam, gdzie urząd nadaje osobny identyfikator każdemu obiektowi noclegowemu, pod wspólnymi polami pojawia się dodatkowa karta: Dane dostępu dla każdego obiektu. Wybierz obiekt z menu i wypełnij tylko to, co się różni: to, co zostawisz puste, przyjmie wartość obiektu głównego i nie trzeba tego powtarzać. Jeśli ta karta się nie pojawia, w Twoim kraju nie jest potrzebna i wszystko dotyczy całości.
Jeśli konto ma kilka nieruchomości, menu karty pokazuje najpierw jedną pozycję dla każdej z nich, „…: wszystkie obiekty”: zapisane tam dane dostępu trafiają do każdego z jej obiektów. Przydaje się, gdy urząd nadał jeden identyfikator na adres, a nie na mieszkanie: wpisujesz go raz, a pojedynczy obiekt nadal możesz poprawić, wybierając go z menu.
Questura (Alloggiati Web)Wysyłka kart meldunkowych do Polizia di Stato
Wszystkie włoskie obiekty noclegowe mają obowiązek przekazywania danych gości do Questury (miejscowej komendy policji) za pośrednictwem usługi Alloggiati Web prowadzonej przez Polizia di Stato. Vezpa wysyła dane gości automatycznie, gdy tylko zostaną zarejestrowane.
Jak uzyskać dane dostępowe
- Zarejestruj się na alloggiatiweb.poliziadistato.it
- Złóż wniosek o aktywację w swojej lokalnej Questurze
- Otrzymasz dane dostępowe e-mailem: Nazwę użytkownika, Hasło i Token WS
- Wprowadź dane dostępowe w Vezpa: Profil → Konfiguracja → Questura
- Włącz przełącznik "Włączone"
Przepływ automatyczny
Pola obowiązkowe Questury
| Pole | Opis |
|---|---|
| Nazwisko, Imię | Dane osobowe gościa |
| Płeć | M / F (obowiązkowe tylko dla Włoch) |
| Data i miejsce urodzenia | Z kodem ISTAT gminy |
| Obywatelstwo | Kod kraju Alloggiatiweb |
| Rodzaj i numer dokumentu | 95 dostępnych rodzajów (paszport, dowód osobisty itp.) |
| Typ zakwaterowanego | Gość pojedynczy (16), Głowa rodziny (17), Kierownik grupy (18) |
ISTAT — Statystyki turystyczne19 regionów, każdy z własnym systemem
Włochy mają 19 różnych systemów regionalnych do zbierania danych statystycznych o turystyce. Vezpa obsługuje je wszystkie: większość w pełni automatycznie, niektóre regiony wymagają pobrania pliku.
Regiony z wysyłką automatyczną (16 regionów)
W przypadku tych regionów Vezpa wysyła dane automatycznie każdego wieczoru przez usługę sieciową. Potrzebujesz jedynie regionalnych danych dostępowych.
| ID | Region | Protokół | Dane dostępowe |
|---|---|---|---|
| 0 | Piemont | SOAP v2 | Nazwa użytkownika + Hasło |
| 1 | Toskania | SOAP v2 | Nazwa użytkownika + Hasło |
| 2 | Basilicata | SOAP v1 | Nazwa użytkownika + Hasło |
| 3 | Liguria | SOAP v2 | Nazwa użytkownika + Hasło |
| 4 | Abruzja | SOAP v2 (Turismo5) | Nazwa użytkownika + Hasło |
| 5 | Wenecja Euganejska | SOAP v2 | Nazwa użytkownika + Hasło |
| 6 | Emilia-Romania | SOAP v2 | Nazwa użytkownika + Hasło |
| 7 | Marche | ROSS1000 | Nazwa użytkownika + Hasło |
| 8 | Lombardia | Turismo5 | Nazwa użytkownika + Hasło |
| 9 | Kalabria | SOAP v2 | Nazwa użytkownika + Hasło |
| 10 | Sardynia | ROSS1000 | Nazwa użytkownika + Hasło |
| 11 | Lacjum | ROSS1000 | Nazwa użytkownika + Hasło |
| 12 | Molise | ROSS1000 | Nazwa użytkownika + Hasło |
| 13 | Sycylia | REST XML | PMS User + HotelCode |
| 14 | Kampania | REST JSON (Sinfonia) | CUSR + API Key |
| 17 | Trentino | SOAP DTU C59 | Nazwa użytkownika + Hasło |
| 19 | Dolina Aosty | SOAP VIT (INVA) | Użytkownik + Hasło + ID obiektu |
Regiony z pobieraniem pliku (3 regiony)
W przypadku tych regionów Vezpa generuje plik, który musisz pobrać z aplikacji i ręcznie wgrać na portal regionalny.
| ID | Region | Format | Portal do wgrania |
|---|---|---|---|
| 15 | Umbria | TXT (ROSS 1000) | Turismatica |
| 16 | Friuli-Wenecja Julijska | TXT (ROSS 1000) | WebTur |
| 18 | Apulia | XML (SPOT) | www.dms.puglia.it (SPID) |
Jak skonfigurować ISTAT
- Otwórz Profil → Konfiguracja i wybierz swój pokój/lokal
- W sekcji ISTAT włącz przełącznik "Włączone"
- Wybierz swój region z listy rozwijanej
- Wprowadź dane dostępowe otrzymane z portalu regionalnego
- Wprowadź kod ISTAT obiektu
- Zapisz. Automatyczna wysyłka ruszy już tego samego wieczoru
PayTouristPlatforma do obsługi opłaty turystycznej
PayTourist to opcjonalna platforma, która automatyzuje pobieranie i odprowadzanie opłaty turystycznej dla wielu włoskich gmin. Vezpa integruje się bezpośrednio z PayTourist, aby przesyłać dane gości.
Wymagane dane dostępowe
| Pole | Gdzie je uzyskać |
|---|---|
| ID PayTourist | Rejestracja na paytourist.it (samoobsługowa) |
| Token API | Panel PayTourist po rejestracji |
Podpis cyfrowyZbieranie podpisu gościa podczas rejestracji
Podpis cyfrowy jest zbierany zarówno w aplikacji Flutter (podczas rejestracji gościa), jak i w internetowym self check-in (dotykowe pole podpisu). Podpis jest zapisywany jako obraz PNG w profilu gościa.
Podpis gościa jest proponowany tylko w krajach, w których prawo wymaga go na formularzu meldunkowym: w Niemczech, Austrii, Francji i Hiszpanii. Nawet tam jest opcjonalny — w aplikacji i w meldunku online — ponieważ gość może podpisać formularz na papierze po przyjeździe; w żadnym kraju podpis nie jest przekazywany organom, służy obiektowi jako dowód. W pozostałych krajach sekcja podpisu się nie pojawia, a tam, gdzie Vezpa potrafi wygenerować formularz, PDF powstaje i tak, z linią do podpisania na papierze.
Formularz generuje się ze szczegółów rezerwacji przez dotknięcie „Dokument rejestracyjny”: wychodzi już wypełniony danymi gościa, w języku kraju obiektu, gotowy do podpisu i przechowania. Przycisk pojawia się sam tam, gdzie Vezpa potrafi utworzyć formularz, i pozostaje nieaktywny — z komunikatem, który to wyjaśnia — dopóki osoba odpowiedzialna za rezerwację nie zostanie zarejestrowana.
Europejskie konektory rządoweAutomatyczna wysyłka danych gości dla 7 krajów + rejestr Islandii
W przypadku obiektów położonych w jednym z poniższych krajów europejskich Vezpa może automatycznie wysyłać dane gości do krajowego systemu rządowego. Konfiguracja znajduje się w Profil → Rejestracja rządowa. Jeśli połączenie dla Twojego kraju nie jest jeszcze aktywne, aplikacja powie Ci to komunikatem u góry strony: zobacz Na jakim etapie jest połączenie.
🇪🇸 Hiszpania — SES.Hospedajes
Obowiązkowy od 2 grudnia 2024 r. (Real Decreto 933/2021). Registro de viajeros przy Ministerio del Interior.
| Dane dostępowe | Gdzie je uzyskać |
|---|---|
| API Key | seshospedajes.es (samoobsługowo) |
| Establishment ID | Portal SES po rejestracji obiektu |
🇭🇷 Chorwacja — eVisitor
Krajowy system teleinformatyczny prowadzony przez Hrvatska turisticka zajednica (HTZ).
| Dane dostępowe | Gdzie je uzyskać |
|---|---|
| Nazwa użytkownika + Hasło | evisitor.hr (samoobsługowo) |
| API Key | Portal eVisitor po rejestracji |
| Facility Code | Przydzielany przy rejestracji |
🇭🇺 Węgry — NTAK
Krajowy system NTAK (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). Vezpa łączy się przez pośrednika NTAK.guru, aby uprościć integrację.
| Dane dostępowe | Gdzie je uzyskać |
|---|---|
| Bearer Token | ntak.guru (samoobsługowo) |
| Accommodation ID | Portal NTAK.guru po rejestracji |
🇵🇹 Portugalia — SIBA
Boletim de Alojamento obowiązkowy na mocy Lei nr 23/2007 (art. 15-16).
| Dane dostępowe | Gdzie je uzyskać |
|---|---|
| Nazwa użytkownika + Hasło | siba.ssi.gov.pt |
| Kod Estabelecimento | Rejestracja w SIBA |
🇨🇿 Czechy — UbyPort
Obowiązkowy rejestr cudzoziemców prowadzony przez Cizinecká policie (policję ds. cudzoziemców).
Od 9 października 2026 Vezpa jest zatwierdzona przez czeską policję (Ředitelství služby cizinecké policie, RSCP) jako oprogramowanie do automatycznego przesyłania danych gości zagranicznych do UbyPort. Wysyłka rusza sama, w cogodzinnym przebiegu. Jeśli gościowi brakuje danych albo policja odrzuci zgłoszenie, otrzymasz powiadomienie «Sprawdź dane gościa» z nazwiskiem gościa i powodem: odrzucone zgłoszenie nie jest ponawiane samo, zostaje wysłane ponownie, gdy poprawisz dane.
| Dane dostępowe | Gdzie je uzyskać |
|---|---|
| Nazwa użytkownika + Hasło | Konto do zrobotyzowanego przesyłania danych (účet pro robotické zasílání dat), wydawane przez RSCP |
| IDUB | Nadawany przez RSCP przy rejestracji obiektu |
| Zkratka | Skrót obiektu, nadawany razem z IDUB (opcjonalny, zalecany) |
Jak uzyskać konto. Nie powstaje automatycznie; są trzy przypadki:
- Masz już konto zrobotyzowane (np. używane z innym PMS): z policją nic nie załatwiasz, konto można przenieść. Wpisz w Vezpa posiadane dane logowania.
- Masz IDUB, ale nie masz konta zrobotyzowanego: napisz do RSCP przez datová schránka (ID ybndqw9) lub e-mailem na [email protected] z prośbą o konto do zrobotyzowanego przesyłania danych. Podaj IDUB, nazwę i pełny adres obiektu, producenta oraz nazwę programu, która musi brzmieć dokładnie «Vezpa»: z inną nazwą wniosek nie zostanie zatwierdzony.
- Nie masz ani IDUB, ani konta: złóż standardowy wniosek o rejestrację nowego obiektu (Žádost o registraci nového ubytovacího zařízení) na ubyport.pcr.cz, wybierając «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» i podając «Vezpa» jako nazwę programu.
Wzór treści wniosku (po czesku): «Žá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.» Więcej na oficjalnej stronie czeskiej policji.
W Vezpa, w Konfiguracja → Rejestracja rządowa: nazwa użytkownika i hasło konta zrobotyzowanego, IDUB w polu «Kod obiektu», Zkratka w «Ustawienia dodatkowe», a następnie włącz «Automatyczne wysyłanie». Pozostaw pusty endpoint i wyłączone «Środowisko testowe»: służy tylko do kont testowych programistów. Kilka obiektów z osobnymi IDUB: użyj «Dane dostępu dla każdego obiektu».
🇦🇹 Austria — Meldeamt
Gaestemeldung obowiązkowa na mocy Meldegesetz. Każdy Bundesland ma własny system; Vezpa obsługuje wszystkie 9 Bundeslaender dzięki konfigurowalnemu punktowi końcowemu.
| Dane dostępowe | Gdzie je uzyskać |
|---|---|
| Nazwa użytkownika + Hasło albo API Key | Portal własnego Bundeslandu (feratel Deskline, GMS itp.) |
| Betriebsnummer | Przydzielany przez regionalny Meldeamt |
| Endpoint URL | Specyficzny dla danego Bundeslandu |
🇸🇮 Słowenia — eTurizem (AJPES)
Obowiązkowa rejestracja turystów prowadzona przez AJPES. Wymaga kwalifikowanego certyfikatu cyfrowego wydanego przez akredytowanego dostawcę słoweńskiego.
| Dane dostępowe | Gdzie je uzyskać |
|---|---|
| Certyfikat cyfrowy PEM | SIGEN-CA, Halcom, NLB lub inny akredytowany podmiot |
| ID Nastanitvenega Obrata | Portal AJPES po rejestracji |
🇮🇸 Islandia — Gistiskrá (rejestr gości)
Zgodnie z islandzką ustawą o obiektach noclegowych (Lög um veitingastaði, gististaði og skemmtanahald) każdy obiekt musi prowadzić rejestr gości (gistiskrá) z danymi wszystkich gości. Rejestr musi być dostępny do kontroli przez islandzką policję (Lögreglan).
Vezpa automatycznie zapisuje wszystkie wymagane dane podczas zameldowania. Nie jest potrzebna żadna konfiguracja danych dostępowych — dane są zawsze dostępne w aplikacji i można je w każdej chwili wyeksportować lub wydrukować.
| Pole obowiązkowe | Opis |
|---|---|
| Imię i nazwisko | Imię i nazwisko gościa |
| Data urodzenia | Pełna data |
| Narodowość | Kraj obywatelstwa |
| Dokument | Rodzaj i numer (paszport lub dowód osobisty) |
| Miejsce zamieszkania | Pełny adres |
| Daty pobytu | Przyjazd i wyjazd |
Pobieranie pliku ISTATDla regionów z ręcznym wgrywaniem (Umbria, FVG, Apulia)
Regiony Umbria, Friuli-Wenecja Julijska i Apulia nie dysponują usługą sieciową do automatycznej wysyłki. Dla tych regionów Vezpa generuje plik, który musisz pobrać i wgrać ręcznie.
Jak pobrać plik
- Otwórz konfigurację obiektu (Profil → dotknij pokoju)
- W sekcji ISTAT sprawdź, czy wybrany jest prawidłowy region
- Dotknij przycisku "Pobierz plik ISTAT"
- Wybierz datę początkową i datę końcową okresu
- Dotknij "Wygeneruj i pobierz plik"
- Plik zostanie wygenerowany i możesz go udostępnić (e-mail, WhatsApp, zapis w systemie plików)
Formaty plików według regionu
| Region | Format | Gdzie go wgrać |
|---|---|---|
| Umbria | TXT (ROSS 1000, 338 znaków/rekord) | Turismatica |
| Friuli W.J. | TXT (ROSS 1000, 338 znaków/rekord) | WebTur |
| Apulia | XML (SPOT, format movimentogiornaliero-0.6.xsd) | www.dms.puglia.it (dostęp przez SPID) |
<movimento> na każdy dzień wybranego okresu, z przyjazdami, wyjazdami i danymi obiektu (dostępne pokoje, miejsca noclegowe, pokoje zajęte). Vendor jest ustawiany automatycznie jako "Vezpa".
Potrzebujesz pomocy?
Jeśli masz wątpliwości dotyczące konfiguracji systemów rządowych lub nie udaje Ci się uzyskać danych dostępowych, skontaktuj się ze wsparciem Vezpa.