Ghidul Integrărilor

Cum obții codurile necesare pentru a conecta unitatea ta de cazare la serviciile Alloggiati Web, ISTAT și PayTourist

Alloggiati Web Portalul Questura - Trimiterea fișelor de cazare

Alloggiati Web este portalul Polizia di Stato pentru comunicarea obligatorie a datelor de identitate ale oaspeților în termen de 24 de ore de la check-in. Pentru a conecta Vezpa la serviciu sunt necesare credențiale de acces prin Web Service (WS).

Coduri necesare

Câmp Descriere
Username WS Numele de utilizator pentru Web Service (diferit de datele de conectare la portal)
Password WS Parolă dedicată Web Service-ului
Token WS Token de autentificare pentru apelurile automate

Cum le obții

  1. Autentifică-te pe portalul Alloggiati Web cu credențialele furnizate de Questura din provincia ta: alloggiatiweb.poliziadistato.it (se deschide într-o filă nouă)
  2. După ce ai intrat, mergi la secțiunea „Tabelle” din meniul principal, apoi selectează „Gestione WS” (Web Service).
  3. Dacă nu ai încă credențialele WS, apasă pe „Genera credenziali”. Sistemul va crea automat Username, Password și Token.
  4. Copiază cele trei valori (Username WS, Password WS, Token WS) și introdu-le în secțiunea Integrări > Alloggiati din configurarea camerei în Vezpa.
Atenție: Credențialele WS sunt diferite de credențialele de acces la portal. Dacă nu găsești secțiunea „Gestione WS”, contactează Questura din provincia ta pentru a cere activarea Web Service-ului.
Tokenul WS are o valabilitate periodică. Când expiră, va trebui să îl regenerezi din portal și să îl actualizezi în Vezpa. Îți vom trimite o notificare în caz de erori la trimitere.

ISTAT - Fluxuri Turistice Ancheta statistică privind mișcarea clienților

ISTAT le cere unităților de cazare trimiterea periodică a datelor statistice despre oaspeți (sosiri, înnoptări, plecări). Fiecare regiune italiană are propriul sistem. Vezpa acceptă 19 regiuni cu trimitere automată sau generare de fișier.

Regiuni acceptate

RegiuneSistemTrimitereCredențiale
Piemont, Toscana, Liguria, Abruzzo, Veneto, Emilia-Romagna, Lombardia, Calabria, BasilicataTurismo5AutomatăUtilizator, Parolă, Cod
Marche, Sardinia, Lazio, MoliseRoss1000AutomatăUtilizator, Parolă, Cod
SiciliaOsservatorio TuristicoAutomatăUserId, Password, HotelCode
CampaniaSinfonia SMARTAutomatăCUSR, API Key
TrentinoDTU (Trentino Digitale)AutomatăUtilizator, Parolă, ID Unitate
UmbriaTurismaticaFișier de descărcatCod Unitate
Friuli-Veneția GiuliaWebTurFișier de descărcatCod Unitate
Valle d'AostaVIT Albergatori (INVA)AutomatăUtilizator, Parolă, ID Unitate

Turismo5 / Ross1000 (13 regiuni) — Trimitere automată

Majoritatea regiunilor folosesc protocolul Turismo5 sau platforma Ross1000. Trimiterea este complet automată.

  1. Contactează biroul de turism sau APT din provincia ori din regiunea ta.
  2. Solicită credențialele de acces la portalul Ross1000/Turismo5 pentru unitatea ta de cazare.
  3. Codul unității este vizibil în panoul portalului regional după autentificare.
  4. Introdu Utilizator, Parolă și Cod Unitate în configurarea camerei în Vezpa, selectând regiunea ta din meniul derulant.

Sicilia — Osservatorio Turistico Regionale — Trimitere automată

Sicilia folosește un sistem propriu. Credențialele trebuie solicitate prin e-mail.

  1. Trimite un e-mail la [email protected] prin care ceri activarea unui profil „PMS User” pentru unitatea ta de cazare.
  2. Vei primi: UserId, Password și HotelCode (ex. TRS-IT-SIC-00004).
  3. În Vezpa, selectează Sicilia din meniul regiunilor și introdu cele trei valori în câmpurile corespunzătoare.
Credențialele pentru Sicilia sunt diferite de cele ale Questura și de credențialele ISTAT ale altor regiuni. Profilul „PMS User” este dedicat trimiterii automate din programele de gestiune.

Campania — Sinfonia Turismo SMART — Trimitere automată

Campania folosește platforma Sinfonia SMART cu autentificare prin CUSR și API Key.

  1. Autentifică-te pe portalul Sinfonia Turismo SMART cu SPID: turismo.regione.campania.it (se deschide într-o filă nouă)
  2. Din secțiunea de setări, preia CUSR (Codice Unico Struttura Ricettiva, codul unic al unității de cazare) și generează o API Key.
  3. În Vezpa, selectează Campania din meniul regiunilor. Câmpurile se adaptează automat: introdu CUSR și API Key în câmpurile indicate.
CUSR este codul regional al unității de cazare (format: 15123123ALBXXXX). API Key este o cheie UUID care poate fi generată din portalul Sinfonia SMART.

Trentino — DTU (Trentino Digitale) — Trimitere automată

Provincia Trento folosește sistemul DTU cu un web service dedicat. Credențialele sunt aceleași cu cele ale portalului STU.

  1. Autentifică-te pe portalul STU: www.stu.provincia.tn.it (se deschide într-o filă nouă) cu credențialele unității tale de cazare.
  2. Solicită activarea web service-ului la Servizio Turismo al Provinciei, completând formularul specific (disponibil în secțiunea dedicată programelor de gestiune din portal).
  3. Preia ID-ul unității (IDOBJ Esercizio, vizibil în secțiunea „Inserimento movimentazione giornaliera C59 > da file”).
  4. În Vezpa, selectează Trentino din meniul regiunilor și introdu Utilizator, Parolă și ID Unitate.
Credențialele sunt aceleași pe care le folosești pentru a accesa portalul STU. ID-ul unității este un număr (ex. 1212051), NU un cod alfanumeric.

Valle d'Aosta — VIT Albergatori — Trimitere automată

Regiunea Autonomă Valle d'Aosta folosește sistemul VIT Albergatori, gestionat de INVA. Trimiterea este complet automată.

  1. Solicită credențialele de acces la serviciu prin Office du Tourisme din zona ta sau contactând Regiunea.
  2. Vei primi prin e-mail: Utilizator, Parolă și ID Unitate (un număr, ex. 9005709).
  3. În Vezpa, selectează Valle d'Aosta din meniul regiunilor și introdu credențialele primite.
Poți verifica datele transmise accesând portalul regional cu aceleași credențiale. Datele trebuie confirmate lunar prin închiderea C59-M pe portal.

Umbria și Friuli-Veneția Giulia — Descărcarea fișierului

Pentru aceste regiuni Vezpa generează automat fișierul în formatul cerut de portalul regional. Directorul de hotel îl descarcă din aplicație și îl încarcă manual.

  1. Selectează Umbria sau Friuli-Veneția Giulia din meniul regiunilor, în configurarea camerei.
  2. Introdu Codul Unității atribuit de regiune.
  3. Din secțiunea Integrări, descarcă fișierul ISTAT pentru perioada dorită.
  4. Încarcă fișierul pe portalul regional: Turismatica pentru Umbria (turismatica.regione.umbria.it (se deschide într-o filă nouă)) sau WebTur pentru Friuli-Veneția Giulia (servizistatistici.regione.fvg.it/webtur (se deschide într-o filă nouă)).
Dacă regiunea ta nu se află în listă (Apulia, Alto Adige), contactează-ne: adăugăm treptat suportul pentru toate regiunile italiene.

PayTourist Gestionarea și încasarea taxei de sejur

PayTourist este platforma pe care multe primării italiene o folosesc pentru gestionarea taxei de sejur. Conectând Vezpa la PayTourist, declarațiile sunt trimise automat la fiecare checkout.

Coduri necesare

Câmp Descriere
Cod Unitate Cod unic atribuit de PayTourist unității tale de cazare
API Key Cheie de autentificare pentru comunicările automate

Cum le obții

  1. Verifică dacă primăria ta folosește PayTourist pentru gestionarea taxei de sejur. Poți verifica pe site-ul primăriei sau contactând biroul de taxe și impozite.
  2. Autentifică-te pe portalul PayTourist cu credențialele furnizate de primăria ta: www.paytourist.com (se deschide într-o filă nouă)
  3. În secțiunea „Setări” sau „Profil Unitate” vei găsi Codul Unității atribuit.
  4. Pentru a obține API Key, caută în secțiunea „Integrări” sau „API” a portalului PayTourist. Dacă nu o găsești, contactează suportul PayTourist sau biroul de taxe și impozite al primăriei tale pentru a cere activarea API-urilor.
  5. Introdu Codul Unității și API Key în secțiunea Integrări > PayTourist din configurarea camerei în Vezpa.
Notă: Nu toate primăriile italiene folosesc PayTourist. Unele folosesc platforme alternative sau nu au taxă de sejur. Verifică la primăria ta ce sistem este în uz.

Ai nevoie de ajutor?

Dacă întâmpini dificultăți în obținerea codurilor sau ai întrebări despre configurare, echipa noastră îți stă la dispoziție.

Contactează-ne