Guide till integrationerna

Så får du de koder som behövs för att koppla din anläggning till tjänsterna Alloggiati Web, ISTAT och PayTourist

Alloggiati Web Questurans portal - Inrapportering av gästuppgifter

Alloggiati Web är portalen hos Polizia di Stato för den obligatoriska rapporteringen av gästernas personuppgifter inom 24 timmar efter incheckningen. För att koppla Vezpa till tjänsten behöver du inloggningsuppgifter för Web Service (WS).

Koder som behövs

Fält Beskrivning
Username WS Användarnamn för Web Service (inte samma som inloggningen till portalen)
Password WS Separat lösenord för Web Service
Token WS Autentiseringstoken för de automatiska anropen

Så får du dem

  1. Logga in på portalen Alloggiati Web med de inloggningsuppgifter du har fått av Questuran i din provins: alloggiatiweb.poliziadistato.it (öppnas i en ny flik)
  2. När du är inne går du till avsnittet "Tabelle" (Tabeller) i huvudmenyn och väljer sedan "Gestione WS" (Web Service).
  3. Om du ännu inte har några WS-uppgifter klickar du på "Genera credenziali" (Skapa inloggningsuppgifter). Systemet skapar då automatiskt Username, Password och Token.
  4. Kopiera de tre värdena (Username WS, Password WS, Token WS) och ange dem i Vezpa under Integrationer > Alloggiati i rumskonfigurationen.
Observera: WS-uppgifterna är inte samma som inloggningsuppgifterna till portalen. Om du inte hittar avsnittet "Gestione WS" ska du kontakta Questuran i din provins och begära behörighet till Web Service.
Token WS har en begränsad giltighetstid. När den går ut måste du skapa en ny i portalen och uppdatera den i Vezpa. Vi skickar en avisering till dig om det uppstår fel vid inrapporteringen.

ISTAT - Turistflöden Statistisk registrering av gästernas rörelser

ISTAT kräver att boendeanläggningar regelbundet skickar in statistiska uppgifter om gästerna (ankomster, gästnätter, avresor). Varje italiensk region har sitt eget system. Vezpa har stöd för 19 regioner med automatisk inrapportering eller filgenerering.

Regioner som stöds

RegionSystemInrapporteringInloggningsuppgifter
Piemonte, Toscana, Ligurien, Abruzzerna, Veneto, Emilia-Romagna, Lombardiet, Kalabrien, BasilicataTurismo5AutomatiskAnvändarnamn, Lösenord, Kod
Marche, Sardinien, Lazio, MoliseRoss1000AutomatiskAnvändarnamn, Lösenord, Kod
SicilienOsservatorio TuristicoAutomatiskUserId, Password, HotelCode
KampanienSinfonia SMARTAutomatiskCUSR, API Key
TrentinoDTU (Trentino Digitale)AutomatiskAnvändarnamn, Lösenord, Anläggnings-ID
UmbrienTurismaticaFil att ladda nerAnläggningskod
Friuli Venezia GiuliaWebTurFil att ladda nerAnläggningskod
Valle d'AostaVIT Albergatori (INVA)AutomatiskAnvändare, Lösenord, Anläggnings-ID

Turismo5 / Ross1000 (13 regioner) — Automatisk inrapportering

De flesta regioner använder protokollet Turismo5 eller plattformen Ross1000. Inrapporteringen sker helt automatiskt.

  1. Kontakta turistbyrån eller APT i din provins eller region.
  2. Begär inloggningsuppgifter till portalen Ross1000/Turismo5 för din anläggning.
  3. Anläggningskoden syns i den regionala portalens instrumentpanel när du har loggat in.
  4. Ange Användarnamn, Lösenord och Anläggningskod i rumskonfigurationen i Vezpa och välj din region i rullgardinsmenyn.

Sicilien — Osservatorio Turistico Regionale — Automatisk inrapportering

Sicilien använder ett eget system. Inloggningsuppgifterna måste beställas via e-post.

  1. Skicka ett e-postmeddelande till [email protected] och begär att en profil av typen "PMS User" aktiveras för din anläggning.
  2. Du får: UserId, Password och HotelCode (t.ex. TRS-IT-SIC-00004).
  3. I Vezpa väljer du Sicilien i regionmenyn och anger de tre värdena i motsvarande fält.
Inloggningsuppgifterna för Sicilien skiljer sig från Questurans och från ISTAT-uppgifterna i andra regioner. Profilen "PMS User" är avsedd för automatisk inrapportering från bokningssystem.

Kampanien — Sinfonia Turismo SMART — Automatisk inrapportering

Kampanien använder plattformen Sinfonia SMART med autentisering via CUSR och API Key.

  1. Logga in på portalen Sinfonia Turismo SMART med SPID: turismo.regione.campania.it (öppnas i en ny flik)
  2. Hämta CUSR (Codice Unico Struttura Ricettiva) i inställningsavsnittet och skapa en API Key.
  3. I Vezpa väljer du Kampanien i regionmenyn. Fälten anpassas automatiskt: ange CUSR och API Key i de angivna fälten.
CUSR är anläggningens regionala kod (format: 15123123ALBXXXX). API Key är en UUID-nyckel som kan skapas i portalen Sinfonia SMART.

Trentino — DTU (Trentino Digitale) — Automatisk inrapportering

Provinsen Trento använder systemet DTU med en egen web service. Inloggningsuppgifterna är samma som till STU-portalen.

  1. Logga in på STU-portalen: www.stu.provincia.tn.it (öppnas i en ny flik) med din anläggnings inloggningsuppgifter.
  2. Begär behörighet till web service hos provinsens Servizio Turismo genom att fylla i det avsedda formuläret (finns i portalens avsnitt för bokningssystem).
  3. Hämta anläggnings-ID (IDOBJ Esercizio, syns i avsnittet "Inserimento movimentazione giornaliera C59 > da file").
  4. I Vezpa väljer du Trentino i regionmenyn och anger Användarnamn, Lösenord och Anläggnings-ID.
Det är samma inloggningsuppgifter som du använder för att logga in på STU-portalen. Anläggnings-ID är ett tal (t.ex. 1212051), INTE en alfanumerisk kod.

Valle d'Aosta — VIT Albergatori — Automatisk inrapportering

Den autonoma regionen Valle d'Aosta använder systemet VIT Albergatori som drivs av INVA. Inrapporteringen sker helt automatiskt.

  1. Begär inloggningsuppgifter till tjänsten via Office du Tourisme i ditt område eller genom att kontakta regionen.
  2. Du får via e-post: Användare, Lösenord och Anläggnings-ID (ett tal, t.ex. 9005709).
  3. I Vezpa väljer du Valle d'Aosta i regionmenyn och anger de uppgifter du har fått.
Du kan kontrollera de inrapporterade uppgifterna genom att logga in på den regionala portalen med samma inloggningsuppgifter. Uppgifterna måste bekräftas varje månad genom avslutet C59-M i portalen.

Umbrien och Friuli Venezia Giulia — Nedladdning av fil

För dessa regioner skapar Vezpa automatiskt filen i det format som den regionala portalen kräver. Föreståndaren laddar ner den från appen och laddar upp den manuellt.

  1. Välj Umbrien eller Friuli Venezia Giulia i regionmenyn i rumskonfigurationen.
  2. Ange den anläggningskod som regionen har tilldelat.
  3. Ladda ner ISTAT-filen för önskad period i avsnittet Integrationer.
  4. Ladda upp filen till den regionala portalen: Turismatica för Umbrien (turismatica.regione.umbria.it (öppnas i en ny flik)) eller WebTur för Friuli Venezia Giulia (servizistatistici.regione.fvg.it/webtur (öppnas i en ny flik)).
Om din region inte finns med i listan (Puglia, Sydtyrolen), kontakta oss: vi lägger successivt till stöd för alla italienska regioner.

PayTourist Hantering och uppbörd av turistskatten

PayTourist är den plattform som många italienska kommuner använder för att hantera turistskatten. När du kopplar Vezpa till PayTourist skickas deklarationerna automatiskt vid varje utcheckning.

Koder som behövs

Fält Beskrivning
Anläggningskod Unik kod som PayTourist tilldelar din anläggning
API Key Autentiseringsnyckel för den automatiska kommunikationen

Så får du dem

  1. Kontrollera att din kommun använder PayTourist för att hantera turistskatten. Du kan kontrollera det på kommunens webbplats eller genom att kontakta skattekontoret.
  2. Logga in på PayTourist-portalen med de inloggningsuppgifter du har fått av din kommun: www.paytourist.com (öppnas i en ny flik)
  3. I avsnittet "Impostazioni" (Inställningar) eller "Profilo Struttura" (Anläggningens profil) hittar du den tilldelade anläggningskoden.
  4. För att få API Key letar du i avsnittet "Integrazioni" (Integrationer) eller "API" i PayTourist-portalen. Om du inte hittar den kontaktar du PayTourists support eller din kommuns skattekontor och begär behörighet till API:et.
  5. Ange Anläggningskod och API Key i Vezpa under Integrationer > PayTourist i rumskonfigurationen.
Obs: Alla italienska kommuner använder inte PayTourist. Vissa använder andra plattformar och andra har ingen turistskatt alls. Ta reda på hos din kommun vilket system som används.

Behöver du hjälp?

Om du har svårt att få tag på koderna eller har frågor om konfigurationen finns vårt team till hands.

Kontakta oss