Przewodnik po integracjach

Jak uzyskać kody potrzebne do połączenia Twojego obiektu z usługami Alloggiati Web, ISTAT i PayTourist

Alloggiati Web Portal Questura - przesyłanie zgłoszeń o zakwaterowanych gościach

Alloggiati Web to portal Polizia di Stato służący do obowiązkowego zgłaszania danych osobowych gości w ciągu 24 godzin od zameldowania. Do połączenia Vezpa z tą usługą potrzebne są dane dostępowe do usługi sieciowej (Web Service, WS).

Potrzebne kody

Pole Opis
Nazwa użytkownika WS Nazwa użytkownika usługi sieciowej (inna niż login do portalu)
Hasło WS Hasło przeznaczone wyłącznie dla usługi sieciowej
Token WS Token uwierzytelniający dla wywołań automatycznych

Jak je uzyskać

  1. Zaloguj się do portalu Alloggiati Web przy użyciu danych dostępowych przekazanych przez Questurę Twojej prowincji: alloggiatiweb.poliziadistato.it (otwiera się w nowej karcie)
  2. Po zalogowaniu przejdź w menu głównym do sekcji „Tabelle” (Tabele), a następnie wybierz „Gestione WS” (zarządzanie usługą sieciową).
  3. Jeśli nie masz jeszcze danych dostępowych WS, kliknij „Genera credenziali” (Wygeneruj dane dostępowe). System automatycznie utworzy nazwę użytkownika, hasło i token.
  4. Skopiuj wszystkie trzy wartości (Nazwa użytkownika WS, Hasło WS, Token WS) i wprowadź je w sekcji Integracje > Alloggiati w konfiguracji pokoju w Vezpa.
Uwaga: Dane dostępowe WS są inne niż dane logowania do portalu. Jeśli nie znajdziesz sekcji „Gestione WS”, skontaktuj się z Questurą swojej prowincji i poproś o aktywację usługi sieciowej.
Token WS ma ograniczony okres ważności. Po jego wygaśnięciu trzeba wygenerować go ponownie w portalu i zaktualizować w Vezpa. W razie błędów wysyłki wyślemy Ci powiadomienie.

ISTAT - ruch turystyczny Badanie statystyczne ruchu gości

ISTAT wymaga od obiektów noclegowych okresowego przesyłania danych statystycznych o gościach (przyjazdy, noclegi, wyjazdy). Każdy włoski region ma własny system. Vezpa obsługuje 19 regionów z wysyłką automatyczną lub z generowaniem pliku.

Obsługiwane regiony

RegionSystemWysyłkaDane dostępowe
Piemont, Toskania, Liguria, Abruzja, Wenecja Euganejska, Emilia-Romania, Lombardia, Kalabria, BasilicataTurismo5AutomatycznaNazwa użytkownika, hasło, kod
Marche, Sardynia, Lacjum, MoliseRoss1000AutomatycznaNazwa użytkownika, hasło, kod
SycyliaOsservatorio TuristicoAutomatycznaUserId, Password, HotelCode
KampaniaSinfonia SMARTAutomatycznaCUSR, klucz API
TrentinoDTU (Trentino Digitale)AutomatycznaNazwa użytkownika, hasło, ID obiektu
UmbriaTurismaticaPlik do pobraniaKod obiektu
Friuli-Wenecja JulijskaWebTurPlik do pobraniaKod obiektu
Dolina AostyVIT Albergatori (INVA)AutomatycznaUżytkownik, hasło, ID obiektu

Turismo5 / Ross1000 (13 regionów) — wysyłka automatyczna

Większość regionów korzysta z protokołu Turismo5 lub z platformy Ross1000. Wysyłka jest w pełni automatyczna.

  1. Skontaktuj się z biurem turystycznym lub z APT swojej prowincji albo regionu.
  2. Poproś o dane dostępowe do portalu Ross1000/Turismo5 dla swojego obiektu.
  3. Kod obiektu jest widoczny po zalogowaniu w panelu regionalnego portalu.
  4. Wprowadź nazwę użytkownika, hasło i kod obiektu w konfiguracji pokoju w Vezpa, wybierając swój region z listy rozwijanej.

Sycylia — Osservatorio Turistico Regionale — wysyłka automatyczna

Sycylia korzysta z własnego systemu. O dane dostępowe należy poprosić e-mailem.

  1. Wyślij wiadomość e-mail na adres [email protected] z prośbą o aktywację profilu „PMS User” dla swojego obiektu.
  2. Otrzymasz: UserId, Password i HotelCode (np. TRS-IT-SIC-00004).
  3. W Vezpa wybierz Sycylia z menu regionów i wprowadź te trzy wartości w odpowiednich polach.
Dane dostępowe dla Sycylii różnią się od danych Questury oraz od danych ISTAT innych regionów. Profil „PMS User” jest przeznaczony do automatycznej wysyłki z systemów hotelowych.

Kampania — Sinfonia Turismo SMART — wysyłka automatyczna

Kampania korzysta z platformy Sinfonia SMART z uwierzytelnianiem za pomocą CUSR i klucza API.

  1. Zaloguj się do portalu Sinfonia Turismo SMART przy użyciu SPID: turismo.regione.campania.it (otwiera się w nowej karcie)
  2. W sekcji ustawień odszukaj CUSR (unikalny kod obiektu noclegowego) i wygeneruj klucz API.
  3. W Vezpa wybierz Kampania z menu regionów. Pola dostosują się automatycznie: wprowadź CUSR i klucz API we wskazanych polach.
CUSR to regionalny kod obiektu (format: 15123123ALBXXXX). Klucz API to klucz typu UUID, który można wygenerować w portalu Sinfonia SMART.

Trentino — DTU (Trentino Digitale) — wysyłka automatyczna

Prowincja Trydentu korzysta z systemu DTU z dedykowaną usługą sieciową. Dane dostępowe są takie same jak do portalu STU.

  1. Zaloguj się do portalu STU: www.stu.provincia.tn.it (otwiera się w nowej karcie) przy użyciu danych dostępowych swojego obiektu.
  2. Poproś o aktywację usługi sieciowej w Servizio Turismo prowincji, wypełniając odpowiedni formularz (dostępny w sekcji portalu poświęconej systemom hotelowym).
  3. Odszukaj ID obiektu (IDOBJ Esercizio, widoczne w sekcji „Inserimento movimentazione giornaliera C59 > da file”).
  4. W Vezpa wybierz Trentino z menu regionów i wprowadź nazwę użytkownika, hasło oraz ID obiektu.
Dane dostępowe są takie same jak te, których używasz do logowania w portalu STU. ID obiektu to liczba (np. 1212051), a NIE kod alfanumeryczny.

Dolina Aosty — VIT Albergatori — wysyłka automatyczna

Region Autonomiczny Doliny Aosty korzysta z systemu VIT Albergatori zarządzanego przez INVA. Wysyłka jest w pełni automatyczna.

  1. O dane dostępowe do usługi poproś za pośrednictwem Office du Tourisme w swojej okolicy lub kontaktując się z regionem.
  2. Otrzymasz e-mailem: użytkownika, hasło i ID obiektu (liczbę, np. 9005709).
  3. W Vezpa wybierz Dolina Aosty z menu regionów i wprowadź otrzymane dane dostępowe.
Przesłane dane możesz sprawdzić, logując się do portalu regionalnego przy użyciu tych samych danych dostępowych. Dane należy co miesiąc potwierdzać zamknięciem C59-M w portalu.

Umbria i Friuli-Wenecja Julijska — pobieranie pliku

Dla tych regionów Vezpa automatycznie generuje plik w formacie wymaganym przez portal regionalny. Dyrektor pobiera go z aplikacji i wgrywa ręcznie.

  1. Wybierz Umbria lub Friuli-Wenecja Julijska z menu regionów w konfiguracji pokoju.
  2. Wprowadź kod obiektu przydzielony przez region.
  3. W sekcji Integracje pobierz plik ISTAT za wybrany okres.
  4. Wgraj plik do portalu regionalnego: Turismatica dla Umbrii (turismatica.regione.umbria.it (otwiera się w nowej karcie)) lub WebTur dla Friuli-Wenecji Julijskiej (servizistatistici.regione.fvg.it/webtur (otwiera się w nowej karcie)).
Jeśli Twojego regionu nie ma na liście (Apulia, Górna Adyga), skontaktuj się z nami: stopniowo dodajemy obsługę wszystkich włoskich regionów.

PayTourist Zarządzanie opłatą klimatyczną i jej pobieranie

PayTourist to platforma, z której wiele włoskich gmin korzysta do zarządzania opłatą klimatyczną. Po połączeniu Vezpa z PayTourist deklaracje są wysyłane automatycznie przy każdym wymeldowaniu.

Potrzebne kody

Pole Opis
Kod obiektu Unikalny kod przypisany Twojemu obiektowi przez PayTourist
Klucz API Klucz uwierzytelniający do komunikacji automatycznej

Jak je uzyskać

  1. Sprawdź, czy Twoja gmina korzysta z PayTourist do zarządzania opłatą klimatyczną. Możesz to sprawdzić na stronie gminy lub kontaktując się z urzędem podatkowym gminy.
  2. Zaloguj się do portalu PayTourist przy użyciu danych dostępowych przekazanych przez Twoją gminę: www.paytourist.com (otwiera się w nowej karcie)
  3. W sekcji „Ustawienia” lub „Profil obiektu” znajdziesz przypisany kod obiektu.
  4. Aby uzyskać klucz API, poszukaj w sekcji „Integracje” lub „API” portalu PayTourist. Jeśli go nie znajdziesz, skontaktuj się ze wsparciem PayTourist lub z urzędem podatkowym swojej gminy i poproś o aktywację API.
  5. Wprowadź kod obiektu i klucz API w sekcji Integracje > PayTourist w konfiguracji pokoju w Vezpa.
Uwaga: Nie wszystkie włoskie gminy korzystają z PayTourist. Niektóre używają innych platform lub nie mają opłaty klimatycznej. Sprawdź w swojej gminie, jaki system jest stosowany.

Potrzebujesz pomocy?

Jeśli masz trudności ze zdobyciem kodów lub pytania dotyczące konfiguracji, nasz zespół jest do Twojej dyspozycji.

Skontaktuj się z nami