Guide til integrationerne

Sådan får du de koder, der skal til for at forbinde dit overnatningssted med tjenesterne Alloggiati Web, ISTAT og PayTourist

Alloggiati Web Questura-portalen - Indsendelse af gæsteregistreringer

Alloggiati Web er portalen hos Polizia di Stato til den lovpligtige indberetning af gæsternes persondata inden for 24 timer efter check-in. For at forbinde Vezpa med tjenesten skal du bruge adgangsoplysninger til Web Service (WS).

Nødvendige koder

Felt Beskrivelse
Username WS Brugernavn til Web Service (ikke det samme som loginnet til portalen)
Password WS Særskilt adgangskode til Web Service
Token WS Godkendelsestoken til de automatiske kald

Sådan får du dem

  1. Log ind på portalen Alloggiati Web med de adgangsoplysninger, du har fået af Questura i din provins: alloggiatiweb.poliziadistato.it (åbner i en ny fane)
  2. Når du er inde, går du til afsnittet "Tabelle" (Tabeller) i hovedmenuen og vælger derefter "Gestione WS" (Web Service).
  3. Hvis du endnu ikke har WS-adgangsoplysninger, skal du klikke på "Genera credenziali" (Generér adgangsoplysninger). Systemet opretter automatisk Username, Password og Token.
  4. Kopiér de tre værdier (Username WS, Password WS, Token WS), og indtast dem i Vezpa under Integrationer > Alloggiati i værelseskonfigurationen.
Vigtigt: WS-adgangsoplysningerne er ikke de samme som adgangsoplysningerne til portalen. Hvis du ikke kan finde afsnittet "Gestione WS", skal du kontakte Questura i din provins for at få adgang til Web Service.
Token WS har en begrænset gyldighedsperiode. Når det udløber, skal du generere det igen i portalen og opdatere det i Vezpa. Vi sender dig en notifikation, hvis der opstår fejl ved indsendelsen.

ISTAT - Turiststrømme Statistisk registrering af gæsternes bevægelser

ISTAT kræver, at overnatningssteder løbende indsender statistiske data om gæsterne (ankomster, overnatninger, afrejser). Hver italiensk region har sit eget system. Vezpa understøtter 19 regioner med automatisk indsendelse eller filgenerering.

Understøttede regioner

RegionSystemIndsendelseAdgangsoplysninger
Piemonte, Toscana, Ligurien, Abruzzerne, Veneto, Emilia-Romagna, Lombardiet, Calabrien, BasilicataTurismo5AutomatiskBrugernavn, Adgangskode, Kode
Marche, Sardinien, Lazio, MoliseRoss1000AutomatiskBrugernavn, Adgangskode, Kode
SicilienOsservatorio TuristicoAutomatiskUserId, Password, HotelCode
CampanienSinfonia SMARTAutomatiskCUSR, API Key
TrentinoDTU (Trentino Digitale)AutomatiskBrugernavn, Adgangskode, Stedets ID
UmbrienTurismaticaFil til downloadStedets kode
Friuli Venezia GiuliaWebTurFil til downloadStedets kode
Valle d'AostaVIT Albergatori (INVA)AutomatiskBruger, Adgangskode, Stedets ID

Turismo5 / Ross1000 (13 regioner) — Automatisk indsendelse

De fleste regioner bruger protokollen Turismo5 eller platformen Ross1000. Indsendelsen sker helt automatisk.

  1. Kontakt turistkontoret eller APT i din provins eller region.
  2. Bed om adgangsoplysninger til portalen Ross1000/Turismo5 for dit overnatningssted.
  3. Stedets kode kan ses i dashboardet på den regionale portal, når du er logget ind.
  4. Indtast Brugernavn, Adgangskode og Stedets kode i værelseskonfigurationen i Vezpa, og vælg din region i rullemenuen.

Sicilien — Osservatorio Turistico Regionale — Automatisk indsendelse

Sicilien bruger sit eget system. Adgangsoplysningerne skal bestilles pr. e-mail.

  1. Send en e-mail til [email protected], og bed om at få aktiveret en "PMS User"-profil til dit overnatningssted.
  2. Du modtager: UserId, Password og HotelCode (f.eks. TRS-IT-SIC-00004).
  3. I Vezpa vælger du Sicilien i regionsmenuen og indtaster de tre værdier i de tilsvarende felter.
Adgangsoplysningerne til Sicilien er ikke de samme som dem til Questura eller som ISTAT-oplysningerne i andre regioner. Profilen "PMS User" er beregnet til automatisk indsendelse fra administrationssoftware.

Campanien — Sinfonia Turismo SMART — Automatisk indsendelse

Campanien bruger platformen Sinfonia SMART med godkendelse via CUSR og API Key.

  1. Log ind på portalen Sinfonia Turismo SMART med SPID: turismo.regione.campania.it (åbner i en ny fane)
  2. Hent CUSR (Codice Unico Struttura Ricettiva) i indstillingsafsnittet, og generér en API Key.
  3. I Vezpa vælger du Campanien i regionsmenuen. Felterne tilpasser sig automatisk: indtast CUSR og API Key i de angivne felter.
CUSR er stedets regionale kode (format: 15123123ALBXXXX). API Key er en UUID-nøgle, som kan genereres i portalen Sinfonia SMART.

Trentino — DTU (Trentino Digitale) — Automatisk indsendelse

Provinsen Trento bruger systemet DTU med en dedikeret web service. Adgangsoplysningerne er de samme som til STU-portalen.

  1. Log ind på STU-portalen: www.stu.provincia.tn.it (åbner i en ny fane) med adgangsoplysningerne til dit overnatningssted.
  2. Bed provinsens Servizio Turismo om adgang til web service ved at udfylde den dertil beregnede formular (findes i portalens afsnit for administrationssoftware).
  3. Find stedets ID (IDOBJ Esercizio, som kan ses i afsnittet "Inserimento movimentazione giornaliera C59 > da file").
  4. I Vezpa vælger du Trentino i regionsmenuen og indtaster Brugernavn, Adgangskode og Stedets ID.
Det er de samme adgangsoplysninger, som du bruger til at logge ind på STU-portalen. Stedets ID er et tal (f.eks. 1212051), IKKE en alfanumerisk kode.

Valle d'Aosta — VIT Albergatori — Automatisk indsendelse

Den autonome region Valle d'Aosta bruger systemet VIT Albergatori, som drives af INVA. Indsendelsen sker helt automatisk.

  1. Bed om adgangsoplysninger til tjenesten gennem Office du Tourisme i dit område eller ved at kontakte regionen.
  2. Du modtager pr. e-mail: Bruger, Adgangskode og Stedets ID (et tal, f.eks. 9005709).
  3. I Vezpa vælger du Valle d'Aosta i regionsmenuen og indtaster de modtagne adgangsoplysninger.
Du kan kontrollere de indsendte data ved at logge ind på den regionale portal med de samme adgangsoplysninger. Dataene skal bekræftes månedligt via afslutningen C59-M i portalen.

Umbrien og Friuli Venezia Giulia — Download af fil

For disse regioner genererer Vezpa automatisk filen i det format, som den regionale portal kræver. Direktøren downloader den fra appen og uploader den manuelt.

  1. Vælg Umbrien eller Friuli Venezia Giulia i regionsmenuen i værelseskonfigurationen.
  2. Indtast stedets kode, som er tildelt af regionen.
  3. Download ISTAT-filen for den ønskede periode i afsnittet Integrationer.
  4. Upload filen til den regionale portal: Turismatica for Umbrien (turismatica.regione.umbria.it (åbner i en ny fane)) eller WebTur for Friuli Venezia Giulia (servizistatistici.regione.fvg.it/webtur (åbner i en ny fane)).
Hvis din region ikke står på listen (Puglia, Sydtyrol), så kontakt os: vi tilføjer løbende understøttelse af alle italienske regioner.

PayTourist Håndtering og opkrævning af turistskat

PayTourist er den platform, som mange italienske kommuner bruger til at håndtere turistskatten. Når du forbinder Vezpa med PayTourist, indsendes indberetningerne automatisk ved hvert checkout.

Nødvendige koder

Felt Beskrivelse
Stedets kode Entydig kode, som PayTourist tildeler dit overnatningssted
API Key Godkendelsesnøgle til den automatiske kommunikation

Sådan får du dem

  1. Kontrollér, at din kommune bruger PayTourist til at håndtere turistskatten. Du kan tjekke det på kommunens hjemmeside eller ved at kontakte skattekontoret.
  2. Log ind på PayTourist-portalen med de adgangsoplysninger, du har fået af din kommune: www.paytourist.com (åbner i en ny fane)
  3. I afsnittet "Impostazioni" (Indstillinger) eller "Profilo Struttura" (Stedets profil) finder du den tildelte kode for stedet.
  4. For at få API Key skal du søge i afsnittet "Integrazioni" (Integrationer) eller "API" i PayTourist-portalen. Hvis du ikke kan finde den, skal du kontakte PayTourists support eller skattekontoret i din kommune og bede om at få adgang til API'et.
  5. Indtast stedets kode og API Key i Vezpa under Integrationer > PayTourist i værelseskonfigurationen.
Bemærk: Ikke alle italienske kommuner bruger PayTourist. Nogle bruger andre platforme, og andre har slet ingen turistskat. Undersøg hos din kommune, hvilket system der anvendes.

Har du brug for hjælp?

Hvis du har svært ved at finde koderne, eller hvis du har spørgsmål til opsætningen, står vores team til rådighed.

Kontakt os