Integraatioiden opas

Näin saat tarvittavat koodit, joilla yhdistät majoituskohteesi Alloggiati Web-, ISTAT- ja PayTourist-palveluihin

Alloggiati Web Questuran portaali - Majoittujailmoitusten lähetys

Alloggiati Web on Polizia di Stato -viranomaisen (Italian valtionpoliisi) portaali, jota käytetään vieraiden henkilötietojen pakolliseen ilmoittamiseen viranomaisille 24 tunnin kuluessa sisäänkirjautumisesta. Jotta voit yhdistää Vezpan tähän palveluun, tarvitset erilliset kirjautumistunnukset Web Service (WS) -rajapintaan.

Tarvittavat koodit

Kenttä Kuvaus
WS-käyttäjätunnus Web Service -rajapinnan käyttäjätunnus (eri kuin portaaliin kirjautumiseen käytettävä tunnus)
WS-salasana Erikseen Web Service -rajapintaa varten varattu salasana
WS-token Todennustunniste, jota käytetään automaattisissa kutsuissa

Näin saat ne

  1. Kirjaudu Alloggiati Web -portaaliin tunnuksilla, jotka olet saanut oman maakuntasi Questuralta (poliisilaitokselta): alloggiatiweb.poliziadistato.it (avautuu uuteen välilehteen)
  2. Kun olet sisällä, siirry päävalikosta osioon "Tabelle" ja valitse sitten "Gestione WS" (Web Service).
  3. Jos sinulla ei vielä ole WS-tunnuksia, napsauta "Genera credenziali". Järjestelmä luo automaattisesti käyttäjätunnuksen, salasanan ja tokenin.
  4. Kopioi kolme arvoa (WS-käyttäjätunnus, WS-salasana, WS-token) ja syötä ne Vezpan huoneasetusten osioon Integraatiot > Alloggiati.
Huomio: WS-tunnukset ovat eri kuin portaalin kirjautumistunnukset. Jos et löydä osiota "Gestione WS", ota yhteyttä oman maakuntasi Questuraan ja pyydä Web Service -käyttöoikeuden aktivointia.
WS-token vanhenee määräajoin. Kun se vanhenee, sinun on luotava se uudelleen portaalissa ja päivitettävä se Vezpaan. Lähetämme sinulle ilmoituksen, jos lähetyksessä ilmenee virheitä.

ISTAT - Matkailuvirrat Asiakasliikenteen tilastollinen seuranta

ISTAT edellyttää, että majoitusliikkeet lähettävät säännöllisin väliajoin vieraita koskevat tilastotiedot (saapumiset, yöpymiset ja lähdöt). Jokaisella Italian alueella on käytössä oma järjestelmänsä. Vezpa tukee yhteensä 19 aluetta, joko automaattisella lähetyksellä tai valmiin tiedoston luonnilla.

Tuetut alueet

AlueJärjestelmäLähetysTunnukset
Piemonte, Toscana, Liguria, Abruzzo, Veneto, Emilia-Romagna, Lombardia, Calabria, BasilicataTurismo5AutomaattinenKäyttäjätunnus, salasana, koodi
Marche, Sardinia, Lazio, MoliseRoss1000AutomaattinenKäyttäjätunnus, salasana, koodi
SisiliaOsservatorio TuristicoAutomaattinenUserId, Password, HotelCode
CampaniaSinfonia SMARTAutomaattinenCUSR, API Key
TrentinoDTU (Trentino Digitale)AutomaattinenKäyttäjätunnus, salasana, kohteen tunnus
UmbriaTurismaticaLadattava tiedostoKohteen koodi
Friuli Venezia GiuliaWebTurLadattava tiedostoKohteen koodi
Valle d'AostaVIT Albergatori (INVA)AutomaattinenKäyttäjä, salasana, kohteen tunnus

Turismo5 / Ross1000 (13 aluetta) — Automaattinen lähetys

Suurin osa alueista käyttää joko Turismo5-protokollaa tai Ross1000-alustaa. Näissä tapauksissa lähetys tapahtuu täysin automaattisesti.

  1. Ota yhteyttä oman maakuntasi tai alueesi matkailutoimistoon tai APT-toimistoon.
  2. Pyydä majoituskohteellesi kirjautumistunnukset Ross1000/Turismo5-portaaliin.
  3. Kohteen koodi näkyy aluehallinnon portaalin koontinäytöllä kirjautumisen jälkeen.
  4. Syötä käyttäjätunnus, salasana ja kohteen koodi Vezpan huoneasetuksiin ja valitse alueesi pudotusvalikosta.

Sisilia — Alueellinen Osservatorio Turistico — Automaattinen lähetys

Sisiliassa on käytössä oma järjestelmänsä. Tunnuksia on pyydettävä erikseen sähköpostitse.

  1. Lähetä sähköposti osoitteeseen [email protected] ja pyydä "PMS User" -profiilin aktivointia majoituskohteellesi.
  2. Saat käyttöösi: UserId, Password ja HotelCode (esim. TRS-IT-SIC-00004).
  3. Valitse Vezpassa aluevalikosta Sisilia ja syötä kolme arvoa niitä vastaaviin kenttiin.
Sisilian tunnukset ovat eri kuin Questuran tunnukset ja muiden alueiden ISTAT-tunnukset. "PMS User" -profiili on tarkoitettu automaattiseen lähetykseen hallintaohjelmistoista.

Campania — Sinfonia Turismo SMART — Automaattinen lähetys

Campania käyttää Sinfonia SMART -alustaa, jossa todennus tapahtuu CUSR-koodilla ja API-avaimella.

  1. Kirjaudu Sinfonia Turismo SMART -portaaliin SPID-tunnuksella: turismo.regione.campania.it (avautuu uuteen välilehteen)
  2. Hae asetusosiosta CUSR (Codice Unico Struttura Ricettiva eli majoituskohteen yksilöllinen koodi) ja luo API Key.
  3. Valitse Vezpassa aluevalikosta Campania. Kentät mukautuvat automaattisesti: syötä CUSR ja API Key osoitettuihin kenttiin.
CUSR on majoituskohteen alueellinen koodi (muoto: 15123123ALBXXXX). API Key on UUID-avain, jonka voi luoda Sinfonia SMART -portaalissa.

Trentino — DTU (Trentino Digitale) — Automaattinen lähetys

Trenton maakunta käyttää DTU-järjestelmää, jossa on oma erillinen web service -rajapinta. Tunnukset ovat samat kuin STU-portaalissa käyttämäsi tunnukset.

  1. Kirjaudu STU-portaaliin: www.stu.provincia.tn.it (avautuu uuteen välilehteen) majoituskohteesi tunnuksilla.
  2. Pyydä maakunnan matkailuyksiköltä web service -käyttöoikeutta täyttämällä sitä varten tarkoitettu lomake (löytyy portaalin hallintaohjelmistoja koskevasta osiosta).
  3. Hae kohteen tunnus (IDOBJ Esercizio, näkyy osiossa "Inserimento movimentazione giornaliera C59 > da file").
  4. Valitse Vezpassa aluevalikosta Trentino ja syötä käyttäjätunnus, salasana ja kohteen tunnus.
Tunnukset ovat samat, joilla kirjaudut STU-portaaliin. Kohteen tunnus on numero (esim. 1212051), EI aakkosnumeerinen koodi.

Valle d'Aosta — VIT Albergatori — Automaattinen lähetys

Valle d'Aostan autonominen alue käyttää INVAn ylläpitämää VIT Albergatori -järjestelmää. Lähetys on täysin automaattinen.

  1. Pyydä palvelun kirjautumistunnuksia oman alueesi Office du Tourisme -toimistosta tai ottamalla yhteyttä aluehallintoon.
  2. Saat sähköpostitse: käyttäjän, salasanan ja kohteen tunnuksen (numero, esim. 9005709).
  3. Valitse Vezpassa aluevalikosta Valle d'Aosta ja syötä saamasi tunnukset.
Voit tarkistaa lähetetyt tiedot kirjautumalla aluehallinnon portaaliin samoilla tunnuksilla. Tiedot on vahvistettava kuukausittain portaalin C59-M-kuukausisulkemisella.

Umbria ja Friuli Venezia Giulia — Tiedoston lataus

Näiden alueiden osalta Vezpa luo tiedoston automaattisesti siinä muodossa, jota aluehallinnon portaali edellyttää. Johtaja lataa tiedoston sovelluksesta ja vie sen portaaliin käsin.

  1. Valitse huoneasetusten aluevalikosta Umbria tai Friuli Venezia Giulia.
  2. Syötä alueen antama kohteen koodi.
  3. Lataa Integraatiot-osiosta ISTAT-tiedosto haluamaltasi ajanjaksolta.
  4. Vie tiedosto aluehallinnon portaaliin: Turismatica Umbriassa (turismatica.regione.umbria.it (avautuu uuteen välilehteen)) tai WebTur Friuli Venezia Giuliassa (servizistatistici.regione.fvg.it/webtur (avautuu uuteen välilehteen)).
Jos aluettasi ei ole luettelossa (Puglia, Alto Adige), ota yhteyttä: lisäämme tukea vähitellen kaikille Italian alueille.

PayTourist Matkailuveron hallinta ja perintä

PayTourist on alusta, jota monet Italian kunnat käyttävät matkailuveron hallinnointiin ja perimiseen. Kun yhdistät Vezpan PayTouristiin, veroilmoitukset lähtevät eteenpäin automaattisesti jokaisen uloskirjautumisen yhteydessä.

Tarvittavat koodit

Kenttä Kuvaus
Kohteen koodi Yksilöllinen koodi, jonka PayTourist on antanut majoituskohteellesi
API Key Todennusavain, jota käytetään automaattisessa tiedonsiirrossa

Näin saat ne

  1. Tarkista, käyttääkö oma kuntasi PayTouristia matkailuveron hallintaan. Voit tarkistaa asian kunnan verkkosivuilta tai ottamalla yhteyttä sen verotoimistoon.
  2. Kirjaudu PayTourist-portaaliin kunnaltasi saamillasi tunnuksilla: www.paytourist.com (avautuu uuteen välilehteen)
  3. Osiosta "Asetukset" tai "Kohteen profiili" löydät sinulle annetun kohteen koodin.
  4. Saadaksesi API Keyn etsi PayTourist-portaalin osiosta "Integraatiot" tai "API". Jos et löydä sitä, ota yhteyttä PayTouristin tukeen tai kuntasi verotoimistoon ja pyydä API-käyttöoikeuden aktivointia.
  5. Syötä kohteen koodi ja API Key Vezpan huoneasetusten osioon Integraatiot > PayTourist.
Huomaa: Kaikki Italian kunnat eivät käytä PayTouristia. Osa käyttää muita alustoja, eikä kaikilla ole matkailuveroa lainkaan. Tarkista kunnaltasi, mikä järjestelmä on käytössä.

Tarvitsetko apua?

Jos koodien löytäminen tuottaa vaikeuksia tai sinulla on kysyttävää määrityksistä, tiimimme on käytettävissäsi ja auttaa mielellään.

Ota yhteyttä