Guide des intégrations

Comment obtenir les codes nécessaires pour relier votre établissement aux services Alloggiati Web, ISTAT et PayTourist

Alloggiati Web Portail de la Questura - Envoi des fiches de police

Alloggiati Web est le portail de la Polizia di Stato (la police d'État italienne) destiné à la communication obligatoire de l'identité des clients dans les 24 heures suivant le check-in. Pour relier Vezpa au service, il vous faut des identifiants d'accès au Web Service (WS).

Codes nécessaires

Champ Description
Nom d'utilisateur WS Nom d'utilisateur du Web Service (différent de celui du portail)
Mot de passe WS Mot de passe dédié au Web Service
Token WS Jeton d'authentification pour les appels automatiques

Comment les obtenir

  1. Connectez-vous au portail Alloggiati Web avec les identifiants fournis par la Questura (commissariat central) de votre province : alloggiatiweb.poliziadistato.it (s'ouvre dans un nouvel onglet)
  2. Une fois à l'intérieur, rendez-vous dans la rubrique « Tabelle » du menu principal, puis sélectionnez « Gestione WS » (Web Service).
  3. Si vous n'avez pas encore d'identifiants WS, cliquez sur « Genera credenziali ». Le système créera automatiquement un nom d'utilisateur, un mot de passe et un token.
  4. Copiez les trois valeurs (nom d'utilisateur WS, mot de passe WS, token WS) et saisissez-les dans la rubrique Intégrations > Alloggiati de la configuration de la chambre dans Vezpa.
Attention : les identifiants WS sont différents des identifiants de connexion au portail. Si vous ne trouvez pas la rubrique « Gestione WS », contactez la Questura de votre province pour demander l'activation du Web Service.
Le token WS a une durée de validité limitée. Lorsqu'il expire, vous devez le régénérer depuis le portail et le mettre à jour dans Vezpa. Nous vous enverrons une notification en cas d'erreur d'envoi.

ISTAT - Flux touristiques Relevé statistique du mouvement des clients

L'ISTAT demande aux hébergements d'envoyer périodiquement les données statistiques relatives aux clients (arrivées, nuitées, départs). Chaque région italienne dispose de son propre système. Vezpa prend en charge 19 régions, avec envoi automatique ou génération de fichier.

Régions prises en charge

RégionSystèmeEnvoiIdentifiants
Piémont, Toscane, Ligurie, Abruzzes, Vénétie, Émilie-Romagne, Lombardie, Calabre, BasilicateTurismo5AutomatiqueNom d'utilisateur, mot de passe, code
Marches, Sardaigne, Latium, MoliseRoss1000AutomatiqueNom d'utilisateur, mot de passe, code
SicileOsservatorio TuristicoAutomatiqueUserId, Password, HotelCode
CampanieSinfonia SMARTAutomatiqueCUSR, API Key
TrentinDTU (Trentino Digitale)AutomatiqueNom d'utilisateur, mot de passe, ID établissement
OmbrieTurismaticaFichier à téléchargerCode établissement
Frioul-Vénétie JulienneWebTurFichier à téléchargerCode établissement
Vallée d'AosteVIT Albergatori (INVA)AutomatiqueUtilisateur, mot de passe, ID établissement

Turismo5 / Ross1000 (13 régions) — Envoi automatique

La plupart des régions utilisent le protocole Turismo5 ou la plateforme Ross1000. L'envoi est entièrement automatique.

  1. Contactez l'office de tourisme ou l'APT de votre province ou de votre région.
  2. Demandez les identifiants d'accès au portail Ross1000/Turismo5 pour votre établissement.
  3. Le code établissement est visible dans le tableau de bord du portail régional après la connexion.
  4. Saisissez le nom d'utilisateur, le mot de passe et le code établissement dans la configuration de la chambre dans Vezpa, en sélectionnant votre région dans le menu déroulant.

Sicile — Osservatorio Turistico régional — Envoi automatique

La Sicile utilise un système qui lui est propre. Les identifiants doivent être demandés par e-mail.

  1. Envoyez un e-mail à [email protected] en demandant l'activation d'un profil « PMS User » pour votre établissement.
  2. Vous recevrez : un UserId, un Password et un HotelCode (ex. TRS-IT-SIC-00004).
  3. Dans Vezpa, sélectionnez Sicile dans le menu des régions et saisissez les trois valeurs dans les champs correspondants.
Les identifiants siciliens sont différents de ceux de la Questura et des identifiants ISTAT des autres régions. Le profil « PMS User » est réservé à l'envoi automatique depuis un logiciel de gestion.

Campanie — Sinfonia Turismo SMART — Envoi automatique

La Campanie utilise la plateforme Sinfonia SMART, avec une authentification par CUSR et API Key.

  1. Connectez-vous au portail Sinfonia Turismo SMART avec SPID : turismo.regione.campania.it (s'ouvre dans un nouvel onglet)
  2. Dans la rubrique des paramètres, récupérez le CUSR (Codice Unico Struttura Ricettiva, le code unique de l'établissement) et générez une API Key.
  3. Dans Vezpa, sélectionnez Campanie dans le menu des régions. Les champs s'adaptent automatiquement : saisissez le CUSR et l'API Key dans les champs indiqués.
Le CUSR est le code régional de l'établissement (format : 15123123ALBXXXX). L'API Key est une clé UUID que vous pouvez générer depuis le portail Sinfonia SMART.

Trentin — DTU (Trentino Digitale) — Envoi automatique

La province de Trente utilise le système DTU avec un web service dédié. Les identifiants sont les mêmes que ceux du portail STU.

  1. Connectez-vous au portail STU : www.stu.provincia.tn.it (s'ouvre dans un nouvel onglet) avec les identifiants de votre établissement.
  2. Demandez l'activation du web service auprès du service tourisme de la Province en remplissant le formulaire prévu à cet effet (disponible dans la section consacrée aux logiciels de gestion du portail).
  3. Récupérez l'ID établissement (IDOBJ Esercizio, visible dans la section « Inserimento movimentazione giornaliera C59 > da file »).
  4. Dans Vezpa, sélectionnez Trentin dans le menu des régions et saisissez le nom d'utilisateur, le mot de passe et l'ID établissement.
Les identifiants sont les mêmes que ceux que vous utilisez pour accéder au portail STU. L'ID établissement est un nombre (ex. 1212051), et NON un code alphanumérique.

Vallée d'Aoste — VIT Albergatori — Envoi automatique

La Région autonome Vallée d'Aoste utilise le système VIT Albergatori géré par INVA. L'envoi est entièrement automatique.

  1. Demandez les identifiants d'accès au service auprès de l'Office du Tourisme de votre secteur ou en contactant la Région.
  2. Vous recevrez par e-mail : un utilisateur, un mot de passe et un ID établissement (un nombre, ex. 9005709).
  3. Dans Vezpa, sélectionnez Vallée d'Aoste dans le menu des régions et saisissez les identifiants reçus.
Vous pouvez vérifier les données transmises en vous connectant au portail régional avec les mêmes identifiants. Les données doivent être confirmées chaque mois au moyen de la clôture C59-M sur le portail.

Ombrie et Frioul-Vénétie Julienne — Téléchargement du fichier

Pour ces régions, Vezpa génère automatiquement le fichier au format exigé par le portail régional. Le directeur le télécharge depuis l'application et le charge manuellement.

  1. Sélectionnez Ombrie ou Frioul-Vénétie Julienne dans le menu des régions de la configuration de la chambre.
  2. Saisissez le code établissement attribué par la région.
  3. Depuis la rubrique Intégrations, téléchargez le fichier ISTAT pour la période souhaitée.
  4. Chargez le fichier sur le portail régional : Turismatica pour l'Ombrie (turismatica.regione.umbria.it (s'ouvre dans un nouvel onglet)) ou WebTur pour le Frioul-Vénétie Julienne (servizistatistici.regione.fvg.it/webtur (s'ouvre dans un nouvel onglet)).
Si votre région ne figure pas dans la liste (Pouilles, Haut-Adige), contactez-nous : nous ajoutons progressivement la prise en charge de toutes les régions italiennes.

PayTourist Gestion et perception de la taxe de séjour

PayTourist est la plateforme que de nombreuses communes italiennes utilisent pour la gestion de la taxe de séjour. En reliant Vezpa à PayTourist, les déclarations sont envoyées automatiquement à chaque check-out.

Codes nécessaires

Champ Description
Code établissement Code unique attribué à votre établissement par PayTourist
API Key Clé d'authentification pour les communications automatiques

Comment les obtenir

  1. Vérifiez que votre commune utilise PayTourist pour la gestion de la taxe de séjour. Vous pouvez le contrôler sur le site de la commune ou en contactant le service des impôts locaux.
  2. Connectez-vous au portail PayTourist avec les identifiants fournis par votre commune : www.paytourist.com (s'ouvre dans un nouvel onglet)
  3. Dans la rubrique « Paramètres » ou « Profil établissement », vous trouverez le code établissement qui vous a été attribué.
  4. Pour obtenir l'API Key, cherchez dans la rubrique « Intégrations » ou « API » du portail PayTourist. Si vous ne la trouvez pas, contactez l'assistance PayTourist ou le service des impôts locaux de votre commune pour demander l'activation des API.
  5. Saisissez le code établissement et l'API Key dans la rubrique Intégrations > PayTourist de la configuration de la chambre dans Vezpa.
Remarque : toutes les communes italiennes n'utilisent pas PayTourist. Certaines ont recours à d'autres plateformes ou n'appliquent pas de taxe de séjour. Vérifiez auprès de votre commune quel système est en vigueur.

Besoin d'aide ?

Si vous avez du mal à retrouver les codes ou si vous avez des questions sur la configuration, notre équipe est à votre disposition.

Contactez-nous