Gids voor de integraties

Hoe u de codes verkrijgt die nodig zijn om uw accommodatie te koppelen aan de diensten van Alloggiati Web, ISTAT en PayTourist

Alloggiati Web Portaal van de Questura - Verzending van de gastenmeldingen

Alloggiati Web is het portaal van de Polizia di Stato voor de verplichte melding van de persoonsgegevens van de gasten binnen 24 uur na de check-in. Om Vezpa aan deze dienst te koppelen hebt u inloggegevens voor de Web Service (WS) nodig.

Benodigde codes

Veld Omschrijving
Username WS Gebruikersnaam voor de Web Service (niet dezelfde als de login van het portaal)
Password WS Apart wachtwoord voor de Web Service
Token WS Authenticatietoken voor de automatische aanroepen

Hoe u ze verkrijgt

  1. Log in op het portaal Alloggiati Web met de inloggegevens die u van de Questura van uw provincie hebt gekregen: alloggiatiweb.poliziadistato.it (opent in een nieuw tabblad)
  2. Zodra u bent ingelogd, gaat u via het hoofdmenu naar het onderdeel "Tabelle" (Tabellen) en kiest u vervolgens "Gestione WS" (Web Service).
  3. Als u nog geen WS-inloggegevens hebt, klikt u op "Genera credenziali" (Inloggegevens genereren). Het systeem maakt dan automatisch Username, Password en Token aan.
  4. Kopieer de drie waarden (Username WS, Password WS, Token WS) en vul ze in Vezpa in bij het onderdeel Integraties > Alloggiati van de kamerconfiguratie.
Let op: De WS-inloggegevens zijn anders dan de inloggegevens van het portaal. Vindt u het onderdeel "Gestione WS" niet, neem dan contact op met de Questura van uw provincie om de Web Service te laten activeren.
Het Token WS heeft een beperkte geldigheidsduur. Zodra het verloopt, moet u het opnieuw genereren in het portaal en bijwerken in Vezpa. Bij verzendfouten sturen wij u een melding.

ISTAT - Toeristische stromen Statistische registratie van de gastenbewegingen

ISTAT verplicht accommodaties om periodiek statistische gegevens over de gasten door te geven (aankomsten, overnachtingen, vertrekken). Elke Italiaanse regio heeft haar eigen systeem. Vezpa ondersteunt 19 regio's met automatische verzending of het genereren van een bestand.

Ondersteunde regio's

RegioSysteemVerzendingInloggegevens
Piemonte, Toscane, Ligurië, Abruzzen, Veneto, Emilia-Romagna, Lombardije, Calabrië, BasilicataTurismo5AutomatischGebruikersnaam, Wachtwoord, Code
Marche, Sardinië, Lazio, MoliseRoss1000AutomatischGebruikersnaam, Wachtwoord, Code
SiciliëOsservatorio TuristicoAutomatischUserId, Password, HotelCode
CampaniëSinfonia SMARTAutomatischCUSR, API Key
TrentinoDTU (Trentino Digitale)AutomatischGebruikersnaam, Wachtwoord, Accommodatie-ID
UmbriëTurismaticaBestand om te downloadenAccommodatiecode
Friuli Venezia GiuliaWebTurBestand om te downloadenAccommodatiecode
Valle d'AostaVIT Albergatori (INVA)AutomatischGebruiker, Wachtwoord, Accommodatie-ID

Turismo5 / Ross1000 (13 regio's) — Automatische verzending

De meeste regio's gebruiken het protocol Turismo5 of het platform Ross1000. De verzending verloopt volledig automatisch.

  1. Neem contact op met het toeristenbureau of het APT van uw provincie of regio.
  2. Vraag de inloggegevens voor het portaal Ross1000/Turismo5 voor uw accommodatie aan.
  3. De accommodatiecode is na het inloggen zichtbaar in het dashboard van het regionale portaal.
  4. Vul Gebruikersnaam, Wachtwoord en Accommodatiecode in bij de kamerconfiguratie in Vezpa en kies uw regio in het keuzemenu.

Sicilië — Osservatorio Turistico Regionale — Automatische verzending

Sicilië gebruikt een eigen systeem. De inloggegevens moeten per e-mail worden aangevraagd.

  1. Stuur een e-mail naar [email protected] en vraag de activering aan van een profiel "PMS User" voor uw accommodatie.
  2. U ontvangt: UserId, Password en HotelCode (bijv. TRS-IT-SIC-00004).
  3. Kies in Vezpa Sicilië in het regiomenu en vul de drie waarden in de bijbehorende velden in.
De inloggegevens voor Sicilië zijn anders dan die van de Questura en dan de ISTAT-gegevens van andere regio's. Het profiel "PMS User" is specifiek bedoeld voor de automatische verzending vanuit beheersoftware.

Campanië — Sinfonia Turismo SMART — Automatische verzending

Campanië gebruikt het platform Sinfonia SMART met authenticatie via CUSR en API Key.

  1. Log met SPID in op het portaal Sinfonia Turismo SMART: turismo.regione.campania.it (opent in een nieuw tabblad)
  2. Haal in het onderdeel instellingen de CUSR (Codice Unico Struttura Ricettiva) op en genereer een API Key.
  3. Kies in Vezpa Campanië in het regiomenu. De velden passen zich automatisch aan: vul de CUSR en de API Key in de aangegeven velden in.
De CUSR is de regionale code van de accommodatie (formaat: 15123123ALBXXXX). De API Key is een UUID-sleutel die u kunt genereren in het portaal Sinfonia SMART.

Trentino — DTU (Trentino Digitale) — Automatische verzending

De provincie Trento gebruikt het systeem DTU met een eigen web service. De inloggegevens zijn dezelfde als die van het STU-portaal.

  1. Log in op het STU-portaal: www.stu.provincia.tn.it (opent in een nieuw tabblad) met de inloggegevens van uw accommodatie.
  2. Vraag de activering van de web service aan bij de Servizio Turismo van de provincie door het daarvoor bestemde formulier in te vullen (beschikbaar in het onderdeel voor beheersoftware van het portaal).
  3. Haal de accommodatie-ID op (IDOBJ Esercizio, zichtbaar in het onderdeel "Inserimento movimentazione giornaliera C59 > da file").
  4. Kies in Vezpa Trentino in het regiomenu en vul Gebruikersnaam, Wachtwoord en Accommodatie-ID in.
Het zijn dezelfde inloggegevens die u gebruikt om in te loggen op het STU-portaal. De accommodatie-ID is een getal (bijv. 1212051), GEEN alfanumerieke code.

Valle d'Aosta — VIT Albergatori — Automatische verzending

De autonome regio Valle d'Aosta gebruikt het systeem VIT Albergatori, dat wordt beheerd door INVA. De verzending verloopt volledig automatisch.

  1. Vraag de inloggegevens voor de dienst aan via het Office du Tourisme van uw gebied of door contact op te nemen met de regio.
  2. U ontvangt per e-mail: Gebruiker, Wachtwoord en Accommodatie-ID (een getal, bijv. 9005709).
  3. Kies in Vezpa Valle d'Aosta in het regiomenu en vul de ontvangen inloggegevens in.
U kunt de verzonden gegevens controleren door met dezelfde inloggegevens in te loggen op het regionale portaal. De gegevens moeten maandelijks worden bevestigd via de afsluiting C59-M in het portaal.

Umbrië en Friuli Venezia Giulia — Bestand downloaden

Voor deze regio's genereert Vezpa het bestand automatisch in het formaat dat het regionale portaal vereist. De directeur downloadt het uit de app en uploadt het handmatig.

  1. Kies Umbrië of Friuli Venezia Giulia in het regiomenu van de kamerconfiguratie.
  2. Vul de accommodatiecode in die door de regio is toegekend.
  3. Download in het onderdeel Integraties het ISTAT-bestand voor de gewenste periode.
  4. Upload het bestand naar het regionale portaal: Turismatica voor Umbrië (turismatica.regione.umbria.it (opent in een nieuw tabblad)) of WebTur voor Friuli Venezia Giulia (servizistatistici.regione.fvg.it/webtur (opent in een nieuw tabblad)).
Staat uw regio niet in de lijst (Puglia, Zuid-Tirol), neem dan contact met ons op: we voegen geleidelijk ondersteuning toe voor alle Italiaanse regio's.

PayTourist Beheer en inning van de toeristenbelasting

PayTourist is het platform dat veel Italiaanse gemeenten gebruiken voor het beheer van de toeristenbelasting. Als u Vezpa aan PayTourist koppelt, worden de aangiften bij elke checkout automatisch verzonden.

Benodigde codes

Veld Omschrijving
Accommodatiecode Unieke code die PayTourist aan uw accommodatie toekent
API Key Authenticatiesleutel voor de automatische communicatie

Hoe u ze verkrijgt

  1. Controleer of uw gemeente PayTourist gebruikt voor het beheer van de toeristenbelasting. U kunt dit nakijken op de website van de gemeente of navragen bij de belastingdienst van de gemeente.
  2. Log in op het portaal van PayTourist met de inloggegevens die u van uw gemeente hebt gekregen: www.paytourist.com (opent in een nieuw tabblad)
  3. In het onderdeel "Impostazioni" (Instellingen) of "Profilo Struttura" (Profiel accommodatie) vindt u de toegekende accommodatiecode.
  4. Om de API Key te verkrijgen, zoekt u in het onderdeel "Integrazioni" (Integraties) of "API" van het PayTourist-portaal. Vindt u die niet, neem dan contact op met de support van PayTourist of met de belastingdienst van uw gemeente om de API te laten activeren.
  5. Vul Accommodatiecode en API Key in bij het onderdeel Integraties > PayTourist van de kamerconfiguratie in Vezpa.
Let op: Niet alle Italiaanse gemeenten gebruiken PayTourist. Sommige gebruiken andere platforms of heffen helemaal geen toeristenbelasting. Vraag bij uw gemeente na welk systeem daar in gebruik is.

Hebt u hulp nodig?

Als het u niet lukt om de codes te vinden of als u vragen hebt over de configuratie, staat ons team voor u klaar.

Neem contact met ons op