Guide til integrasjoner

Slik får du kodene du trenger for å koble overnattingsstedet ditt til tjenestene Alloggiati Web, ISTAT og PayTourist

Alloggiati Web Questura-portalen - Innsending av gjesteregistreringer

Alloggiati Web er portalen til Polizia di Stato (det italienske statspolitiet) for den lovpålagte innrapporteringen av gjestenes personopplysninger innen 24 timer etter innsjekk. For å koble Vezpa til tjenesten trenger du innloggingsopplysninger til Web Service (WS).

Nødvendige koder

Felt Beskrivelse
Brukernavn WS Brukernavn for Web Service (forskjellig fra innloggingen til portalen)
Passord WS Eget passord for Web Service
Token WS Autentiseringstoken for de automatiske kallene

Slik får du dem

  1. Logg inn på portalen Alloggiati Web med innloggingsopplysningene du har fått fra Questura (politikammeret) i provinsen din: alloggiatiweb.poliziadistato.it (åpnes i en ny fane)
  2. Når du er inne, går du til seksjonen «Tabelle» i hovedmenyen og velger deretter «Gestione WS» (Web Service).
  3. Hvis du ennå ikke har WS-opplysninger, klikker du på «Genera credenziali». Systemet oppretter automatisk brukernavn, passord og token.
  4. Kopier de tre verdiene (brukernavn WS, passord WS, token WS) og legg dem inn i seksjonen Integrasjoner > Alloggiati i romkonfigurasjonen i Vezpa.
Viktig: WS-opplysningene er forskjellige fra innloggingsopplysningene til portalen. Finner du ikke seksjonen «Gestione WS», kontakter du Questura i provinsen din for å be om tilgang til Web Service.
WS-tokenet har en begrenset gyldighetstid. Når det utløper, må du generere det på nytt i portalen og oppdatere det i Vezpa. Vi sender deg et varsel hvis det oppstår feil ved innsending.

ISTAT - Turiststrømmer Statistisk kartlegging av gjestebevegelsene

ISTAT krever at overnattingsbedrifter jevnlig sender inn statistiske data om gjestene (ankomster, overnattinger, avreiser). Hver italiensk region har sitt eget system. Vezpa støtter 19 regioner, med automatisk innsending eller generering av fil.

Støttede regioner

RegionSystemInnsendingInnloggingsopplysninger
Piemonte, Toscana, Liguria, Abruzzo, Veneto, Emilia-Romagna, Lombardia, Calabria, BasilicataTurismo5AutomatiskBrukernavn, passord, kode
Marche, Sardinia, Lazio, MoliseRoss1000AutomatiskBrukernavn, passord, kode
SiciliaOsservatorio TuristicoAutomatiskUserId, Password, HotelCode
CampaniaSinfonia SMARTAutomatiskCUSR, API Key
TrentinoDTU (Trentino Digitale)AutomatiskBrukernavn, passord, virksomhets-ID
UmbriaTurismaticaFil som lastes nedVirksomhetskode
Friuli Venezia GiuliaWebTurFil som lastes nedVirksomhetskode
Valle d'AostaVIT Albergatori (INVA)AutomatiskBruker, passord, virksomhets-ID

Turismo5 / Ross1000 (13 regioner) — Automatisk innsending

De fleste regionene bruker protokollen Turismo5 eller plattformen Ross1000. Innsendingen er helt automatisk.

  1. Kontakt turistkontoret eller APT i provinsen eller regionen din.
  2. Be om innloggingsopplysninger til portalen Ross1000/Turismo5 for virksomheten din.
  3. Virksomhetskoden vises i dashbordet i regionportalen etter at du har logget inn.
  4. Legg inn brukernavn, passord og virksomhetskode i romkonfigurasjonen i Vezpa, og velg regionen din fra nedtrekksmenyen.

Sicilia — Regionalt Osservatorio Turistico — Automatisk innsending

Sicilia bruker sitt eget system. Innloggingsopplysningene må bes om via e-post.

  1. Send en e-post til [email protected] og be om at det aktiveres en «PMS User»-profil for virksomheten din.
  2. Du vil motta: UserId, Password og HotelCode (f.eks. TRS-IT-SIC-00004).
  3. I Vezpa velger du Sicilia fra regionmenyen og legger inn de tre verdiene i de tilsvarende feltene.
Innloggingsopplysningene for Sicilia er forskjellige fra dem du bruker hos Questura og fra ISTAT-opplysningene i andre regioner. «PMS User»-profilen er beregnet på automatisk innsending fra bookingsystemer.

Campania — Sinfonia Turismo SMART — Automatisk innsending

Campania bruker plattformen Sinfonia SMART med autentisering via CUSR og API Key.

  1. Logg inn på portalen Sinfonia Turismo SMART med SPID: turismo.regione.campania.it (åpnes i en ny fane)
  2. Under innstillinger henter du CUSR (Codice Unico Struttura Ricettiva, virksomhetens unike kode) og genererer en API Key.
  3. I Vezpa velger du Campania fra regionmenyen. Feltene tilpasser seg automatisk: legg inn CUSR og API Key i de angitte feltene.
CUSR er virksomhetens regionale kode (format: 15123123ALBXXXX). API Key er en UUID-nøkkel som kan genereres fra portalen Sinfonia SMART.

Trentino — DTU (Trentino Digitale) — Automatisk innsending

Provinsen Trento bruker systemet DTU med en egen web service. Innloggingsopplysningene er de samme som til STU-portalen.

  1. Logg inn på STU-portalen: www.stu.provincia.tn.it (åpnes i en ny fane) med innloggingsopplysningene til virksomheten din.
  2. Be turismekontoret i provinsen om tilgang til web service ved å fylle ut det aktuelle skjemaet (finnes i portalens seksjon for bookingsystemer).
  3. Hent virksomhets-ID-en (IDOBJ Esercizio, som vises i seksjonen «Inserimento movimentazione giornaliera C59 > da file»).
  4. I Vezpa velger du Trentino fra regionmenyen og legger inn brukernavn, passord og virksomhets-ID.
Innloggingsopplysningene er de samme som du bruker for å logge inn på STU-portalen. Virksomhets-ID-en er et tall (f.eks. 1212051), IKKE en alfanumerisk kode.

Valle d'Aosta — VIT Albergatori — Automatisk innsending

Den autonome regionen Valle d'Aosta bruker systemet VIT Albergatori, som driftes av INVA. Innsendingen er helt automatisk.

  1. Be om innloggingsopplysninger til tjenesten gjennom Office du Tourisme i ditt område eller ved å kontakte regionen.
  2. Du får tilsendt på e-post: bruker, passord og virksomhets-ID (et tall, f.eks. 9005709).
  3. I Vezpa velger du Valle d'Aosta fra regionmenyen og legger inn opplysningene du har mottatt.
Du kan kontrollere de overførte dataene ved å logge inn på regionportalen med de samme opplysningene. Dataene må bekreftes månedlig gjennom C59-M-avslutningen i portalen.

Umbria og Friuli Venezia Giulia — Nedlasting av fil

For disse regionene lager Vezpa automatisk filen i formatet som regionportalen krever. Lederen laster den ned fra appen og laster den opp manuelt.

  1. Velg Umbria eller Friuli Venezia Giulia fra regionmenyen i romkonfigurasjonen.
  2. Legg inn virksomhetskoden som regionen har tildelt deg.
  3. Fra seksjonen Integrasjoner laster du ned ISTAT-filen for ønsket periode.
  4. Last filen opp i regionportalen: Turismatica for Umbria (turismatica.regione.umbria.it (åpnes i en ny fane)) eller WebTur for Friuli Venezia Giulia (servizistatistici.regione.fvg.it/webtur (åpnes i en ny fane)).
Hvis regionen din ikke står på listen (Puglia, Alto Adige), ta kontakt med oss: vi legger gradvis til støtte for alle de italienske regionene.

PayTourist Håndtering og innkreving av turistskatten

PayTourist er plattformen som mange italienske kommuner bruker til å håndtere turistskatten. Når du kobler Vezpa til PayTourist, sendes meldingene automatisk ved hver utsjekk.

Nødvendige koder

Felt Beskrivelse
Virksomhetskode Unik kode som PayTourist har tildelt virksomheten din
API Key Autentiseringsnøkkel for den automatiske kommunikasjonen

Slik får du dem

  1. Kontroller at kommunen din bruker PayTourist til å håndtere turistskatten. Du kan sjekke det på kommunens nettsted eller ved å kontakte skattekontoret der.
  2. Logg inn på PayTourist-portalen med innloggingsopplysningene du har fått fra kommunen din: www.paytourist.com (åpnes i en ny fane)
  3. I seksjonen «Innstillinger» eller «Virksomhetsprofil» finner du virksomhetskoden som er tildelt deg.
  4. For å få API Key ser du i seksjonen «Integrasjoner» eller «API» i PayTourist-portalen. Finner du den ikke, kontakter du PayTourist-supporten eller skattekontoret i kommunen din og ber om tilgang til API-ene.
  5. Legg inn virksomhetskoden og API Key i seksjonen Integrasjoner > PayTourist i romkonfigurasjonen i Vezpa.
Merk: Ikke alle italienske kommuner bruker PayTourist. Noen bruker andre plattformer, andre har ingen turistskatt. Sjekk med kommunen din hvilket system som gjelder.

Trenger du hjelp?

Hvis du har problemer med å finne kodene eller har spørsmål om oppsettet, står teamet vårt til disposisjon.

Kontakt oss