Guide Systèmes Gouvernementaux
Questura, ISTAT, PayTourist et connecteurs européens — configuration, identifiants et envoi automatique
Sommaire
Où en est la liaisonL'avis affiché par l'application, et ce qu'il signifie
L'enregistrement des clients fonctionne dans tous les pays où Vezpa est disponible, et continue de fonctionner. Ce qui n'est pas activé partout, c'est la liaison automatique avec l'autorité : la transmission des données que vous avez déjà saisies.
Là où la liaison n'est pas encore active, en haut de Profil → Enregistrement Gouvernement vous trouvez un encadré d'information qui vous le dit : la transmission automatique à l'autorité de ce pays est en cours de test, et l'enregistrement des clients fonctionne normalement. Ce n'est qu'une information : elle ne bloque rien, il n'y a rien à confirmer ni à fermer, et l'encadré apparaît aussi lorsqu'il n'existe encore aucun connecteur à configurer pour votre pays.
L'encadré disparaît de lui-même lorsque la liaison de votre pays devient active : vous n'avez rien à faire et aucun réglage n'est à mettre à jour. Les sections ci-dessous décrivent comment se configure chaque système ; l'avis dit où en est la liaison.
Quand part ce que vous avez autoriséLes trois cadences, le panier « À envoyer » et le résumé du jour
Les autres sections disent à qui Vezpa déclare et avec quels identifiants. Celle-ci dit quand, car la décision appartient à l'hébergement et c'est vous qui la prenez : ouvrez Configuration → Enregistrement gouvernemental et, dans l'encadré « Quand envoyer aux autorités », choisissez l'une des trois cadences. Cela vaut dans tous les pays : en Italie, cela commande les fiches destinées à la Questura (préfecture de police) via le service Alloggiati Web de la Polizia di Stato, ailleurs les envois du connecteur de votre pays.
- « Toutes les 4 heures » — six passages par jour. Vous enregistrez le client et vous n'y pensez plus.
- « À 23:15 » — un seul passage, en fin de journée.
- « Manuel » — ne part que ce que vous sélectionnez et envoyez.
Le panier « À envoyer »
Dès que vous choisissez la cadence manuelle, l'entrée « À envoyer » apparaît dans le même encadré : c'est le panier des réservations en attente, regroupées par jour d'arrivée. Vous cochez celles que vous voulez déclarer et vous appuyez sur « Envoyer la sélection ». Dans les deux autres cadences, cette entrée n'existe pas, et il ne manque rien : il n'y a rien à choisir, tout part tout seul.
Autoriser n'est pas envoyer, et la différence n'est pas une subtilité. Quand vous appuyez, l'autorisation est écrite avant le départ, et un seul appui peut n'emporter qu'une partie du travail : la page vous le dit alors — « autorisées, mais pas encore entièrement parties » — et vous propose « Terminer maintenant ». Vous appuyez de nouveau et cela reprend là où cela s'était arrêté : ce n'est pas une erreur. Pour la même raison, vous ne lisez jamais le mot envoyée à l'écran : une réservation est « Autorisée » dès que l'autorisation existe, et c'est le résultat, un par un, qui dit si l'autorité l'a réellement acceptée.
L'ISTAT et PayTourist suivent la Questura
Ici, il n'y a rien à décider et il n'y a pas de second interrupteur : l'ISTAT et PayTourist suivent la Questura d'eux-mêmes. Si une réservation a été déclarée à la Questura, ils la déclarent aussi ; si elle ne l'a pas été, ils ne la déclarent pas. C'est ainsi que c'est construit, et en manuel cela a une conséquence qu'il vaut mieux connaître d'avance : une nuit que vous n'avez pas encore envoyée arrive à l'ISTAT comme chambre fermée. N'activez la cadence manuelle que si vous êtes prêt à envoyer régulièrement, sinon vos chiffres d'occupation changeront pour une raison qui n'a rien à voir avec vos chambres.
En manuel, la Questura n'accepte qu'aujourd'hui et hier
Ce n'est pas notre choix, c'est le portail : Alloggiati Web ne prend comme date d'arrivée qu'aujourd'hui ou hier, et au-delà de cette limite la fiche est refusée. Ce n'est pas une formalité, car une fiche portant une date ancienne déclare d'elle-même un envoi hors délai. C'est pourquoi le panier a une fenêtre : avec la cadence manuelle, reporter de deux jours, ce n'est pas reporter, c'est perdre.
Le résumé du jour
En haut de la page « À envoyer », vous ouvrez le « Résumé du jour » : où vous en êtes aujourd'hui, en trois nombres — les « Clients du jour », les « Autorisés » et les « Sélectionnés à envoyer ». C'est une page en lecture seule : on n'y ajoute et on n'y retire rien, on revient au panier avec « Ajouter ou retirer des réservations ». Deux endroits qui écrivent la même liste seraient deux listes différentes.
Les deux lignes à regarder sont celles-ci, car ce sont celles sur lesquelles on agit :
- Clients sélectionnés qui ne peuvent pas encore être déclarés — leur enregistrement manque. Ils ne partiront pas : enregistrez-les et ils reviennent dans la déclaration.
- Clients dont la sélection est sortie de la fenêtre — ils ne partiront pas, la sélection ne peut plus être retirée, et depuis l'application il n'y a plus rien à faire : pour ces jours-là, on passe par le portail de l'autorité. Ils sont comptés à part des sélectionnés, et non parmi eux, et ce résumé est le seul endroit qui vous les montre encore.
Les identifiants changent selon le paysChamps déclarés par l'autorité, et ceux qui valent par logement
La page des identifiants n'est pas le même formulaire pour tout le monde. Outre les cases communes — nom d'utilisateur, mot de passe, identifiant de l'établissement, adresse du service — chaque pays déclare les champs supplémentaires que son autorité exige, et la page les dessine toute seule : ouvrez Profil → Enregistrement Gouvernement, choisissez le système et remplissez ce que vous voyez. Les libellés portent le nom officiel que l'autorité leur donne et ne sont pas traduits, afin que vous les retrouviez tels quels dans le portail d'où vous copiez les valeurs. Là où l'autorité propose un environnement de test, vous trouvez aussi un interrupteur pour l'utiliser : il sert à vérifier la configuration avant tout envoi réel. Un champ que vous ne voyez pas ne manque pas par erreur : votre pays ne le demande pas.
Il y a ensuite une chose qu'on n'imagine pas : certains identifiants n'appartiennent pas à l'établissement, mais au logement. Là où l'autorité délivre un identifiant par unité d'hébergement, une carte supplémentaire apparaît sous les cases communes : Identifiants par logement. Choisissez le logement dans le menu et remplissez uniquement ce qui change pour lui : ce que vous laissez vide reprend la valeur de l'établissement et n'a pas à être répété. Si cette carte n'apparaît pas, votre pays n'en a pas besoin et tout vaut pour l'établissement entier.
Si le compte compte plusieurs établissements, le menu de la carte propose d'abord une entrée par établissement, « Tous les logements de … » : les identifiants enregistrés là sont écrits sur chacun de ses logements. C'est utile quand l'autorité vous a attribué un identifiant par adresse et non par appartement : vous le saisissez une seule fois, et vous pouvez toujours corriger un logement en le choisissant dans le menu.
Questura (Alloggiati Web)Envoi des fiches de voyageurs à la Polizia di Stato
Tous les hébergements touristiques italiens sont tenus de communiquer les données de leurs clients à la Questura (préfecture de police) via le service Alloggiati Web de la Polizia di Stato. Vezpa envoie automatiquement les données des clients dès qu'elles sont enregistrées.
Comment obtenir les identifiants
- Inscrivez-vous sur alloggiatiweb.poliziadistato.it
- Déposez la demande d'activation auprès de votre Questura locale
- Recevez les identifiants par e-mail : Nom d'utilisateur, Mot de passe et Token WS
- Saisissez les identifiants dans Vezpa : Profil → Configuration → Questura
- Activez l'interrupteur « Activé »
Flux automatique
Champs obligatoires Questura
| Champ | Description |
|---|---|
| Nom, Prénom | État civil du client |
| Sexe | M / F (obligatoire uniquement pour l'Italie) |
| Date et lieu de naissance | Avec le code ISTAT de la commune |
| Nationalité | Code pays Alloggiati Web |
| Type et numéro de document | 95 types disponibles (passeport, carte d'identité, etc.) |
| Type d'hébergé | Client individuel (16), Chef de famille (17), Chef de groupe (18) |
ISTAT — Statistiques touristiques19 régions, chacune avec son propre système
L'Italie compte 19 systèmes régionaux différents pour la collecte des données statistiques sur le tourisme. Vezpa les gère tous : la plupart de façon entièrement automatique, certaines régions exigeant le téléchargement d'un fichier.
Régions avec envoi automatique (16 régions)
Pour ces régions, Vezpa envoie les données automatiquement chaque soir via un service web. Vous n'avez besoin que des identifiants régionaux.
| ID | Région | Protocole | Identifiants |
|---|---|---|---|
| 0 | Piémont | SOAP v2 | Nom d'utilisateur + Mot de passe |
| 1 | Toscane | SOAP v2 | Nom d'utilisateur + Mot de passe |
| 2 | Basilicate | SOAP v1 | Nom d'utilisateur + Mot de passe |
| 3 | Ligurie | SOAP v2 | Nom d'utilisateur + Mot de passe |
| 4 | Abruzzes | SOAP v2 (Turismo5) | Nom d'utilisateur + Mot de passe |
| 5 | Vénétie | SOAP v2 | Nom d'utilisateur + Mot de passe |
| 6 | Émilie-Romagne | SOAP v2 | Nom d'utilisateur + Mot de passe |
| 7 | Marches | ROSS1000 | Nom d'utilisateur + Mot de passe |
| 8 | Lombardie | Turismo5 | Nom d'utilisateur + Mot de passe |
| 9 | Calabre | SOAP v2 | Nom d'utilisateur + Mot de passe |
| 10 | Sardaigne | ROSS1000 | Nom d'utilisateur + Mot de passe |
| 11 | Latium | ROSS1000 | Nom d'utilisateur + Mot de passe |
| 12 | Molise | ROSS1000 | Nom d'utilisateur + Mot de passe |
| 13 | Sicile | REST XML | PMS User + HotelCode |
| 14 | Campanie | REST JSON (Sinfonia) | CUSR + API Key |
| 17 | Trentin | SOAP DTU C59 | Nom d'utilisateur + Mot de passe |
| 19 | Vallée d'Aoste | SOAP VIT (INVA) | Utilisateur + Mot de passe + ID Établissement |
Régions avec téléchargement de fichier (3 régions)
Pour ces régions, Vezpa génère le fichier que vous devrez télécharger depuis l'application et déposer manuellement sur le portail régional.
| ID | Région | Format | Portail de dépôt |
|---|---|---|---|
| 15 | Ombrie | TXT (ROSS 1000) | Turismatica |
| 16 | Frioul-Vénétie Julienne | TXT (ROSS 1000) | WebTur |
| 18 | Pouilles | XML (SPOT) | www.dms.puglia.it (SPID) |
Comment configurer l'ISTAT
- Ouvrez Profil → Configuration et sélectionnez votre chambre/hébergement
- Dans la section ISTAT, activez l'interrupteur « Activé »
- Sélectionnez votre région dans le menu déroulant
- Saisissez les identifiants fournis par le portail régional
- Saisissez le code ISTAT de l'établissement
- Enregistrez. L'envoi automatique démarrera dès le soir même
PayTouristPlateforme pour la taxe de séjour
PayTourist est une plateforme facultative qui automatise la collecte et le reversement de la taxe de séjour pour de nombreuses communes italiennes. Vezpa s'intègre directement à PayTourist pour envoyer les données des clients.
Identifiants nécessaires
| Champ | Où l'obtenir |
|---|---|
| ID PayTourist | Inscription sur paytourist.it (libre-service) |
| Token API | Tableau de bord PayTourist après l'inscription |
Signature numériqueRecueil de la signature du client lors de l'enregistrement
La signature numérique est recueillie aussi bien depuis l'application Flutter (pendant l'enregistrement du client) que depuis le self check-in web (zone tactile). La signature est enregistrée sous forme d'image PNG dans la fiche du client.
La signature du client n'est proposée que dans les pays où la loi l'exige sur le formulaire d'enregistrement : Allemagne, Autriche, France et Espagne. Même là, elle est facultative — dans l'application et dans l'enregistrement en ligne — car le client peut signer le formulaire sur papier à son arrivée ; dans aucun pays la signature n'est transmise à l'autorité, elle sert de preuve à l'établissement. Dans les autres pays, la section signature n'apparaît pas et, là où Vezpa sait produire le formulaire, le PDF est quand même généré, avec une ligne à signer sur papier.
Le formulaire se génère depuis le détail de la réservation en touchant « Fiche de police » : il sort déjà rempli avec les données du client, dans la langue du pays de l'établissement, prêt à faire signer et à conserver. Le bouton apparaît tout seul là où Vezpa sait produire le formulaire, et reste désactivé — avec un message qui l'explique — tant que le responsable de la réservation n'est pas enregistré.
Connecteurs gouvernementaux européensEnvoi automatique des données clients pour 7 pays + registre Islande
Pour les établissements situés dans l'un des pays européens suivants, Vezpa peut envoyer automatiquement les données des clients au système gouvernemental national. La configuration se trouve dans Profil → Enregistrement Gouvernement. Si la liaison de votre pays n'est pas encore active, l'application vous le dit par un avis en haut de la page : voir Où en est la liaison.
🇪🇸 Espagne — SES.Hospedajes
Obligatoire depuis le 2 décembre 2024 (Real Decreto 933/2021). Registro de viajeros auprès du Ministerio del Interior.
| Identifiant | Où l'obtenir |
|---|---|
| API Key | seshospedajes.es (libre-service) |
| Establishment ID | Portail SES après l'enregistrement de l'établissement |
🇭🇷 Croatie — eVisitor
Système télématique national géré par la Hrvatska turisticka zajednica (HTZ).
| Identifiant | Où l'obtenir |
|---|---|
| Nom d'utilisateur + Mot de passe | evisitor.hr (libre-service) |
| API Key | Portail eVisitor après l'inscription |
| Facility Code | Attribué lors de l'inscription |
🇭🇺 Hongrie — NTAK
Système national NTAK (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). Vezpa se connecte via l'intermédiaire NTAK.guru afin de simplifier l'intégration.
| Identifiant | Où l'obtenir |
|---|---|
| Bearer Token | ntak.guru (libre-service) |
| Accommodation ID | Portail NTAK.guru après l'inscription |
🇵🇹 Portugal — SIBA
Boletim de Alojamento obligatoire au sens de la Lei n.º 23/2007 (art. 15-16).
| Identifiant | Où l'obtenir |
|---|---|
| Nom d'utilisateur + Mot de passe | siba.ssi.gov.pt |
| Code Estabelecimento | Enregistrement SIBA |
🇨🇿 République tchèque — UbyPort
Registre des étrangers obligatoire géré par la Cizinecká policie (police des étrangers).
Depuis le 9 octobre 2026, Vezpa est approuvé par la police tchèque (Ředitelství služby cizinecké policie, RSCP) comme logiciel d'envoi automatique des données des clients étrangers à UbyPort. L'envoi part tout seul, lors du passage horaire. S'il manque des données à un client ou si la police rejette une fiche, vous recevez la notification «Vérifier les données de l'hôte» avec le nom du client et le motif : une fiche rejetée n'est pas renvoyée automatiquement, elle repart une fois les données corrigées.
| Identifiant | Où l'obtenir |
|---|---|
| Nom d'utilisateur + Mot de passe | Compte d'envoi robotisé des données (účet pro robotické zasílání dat), délivré par la RSCP |
| IDUB | Attribué par la RSCP lors de l'enregistrement de l'établissement |
| Zkratka | Abréviation de l'établissement, attribuée avec l'IDUB (facultative, recommandée) |
Comment obtenir le compte. Il n'est pas créé automatiquement ; trois cas :
- Vous avez déjà un compte robotisé (par exemple utilisé avec un autre PMS) : rien à faire auprès de la police, le compte est transférable. Saisissez vos identifiants existants dans Vezpa.
- Vous avez un IDUB mais pas de compte robotisé : écrivez à la RSCP via la datová schránka (ID ybndqw9) ou par e-mail à [email protected] pour demander un compte d'envoi robotisé des données. Indiquez l'IDUB, le nom et l'adresse complète de l'établissement, l'éditeur et le nom du logiciel, qui doit être exactement «Vezpa» : avec un autre nom, la demande n'est pas approuvée.
- Vous n'avez ni IDUB ni compte : déposez la demande standard d'enregistrement d'un nouvel établissement (Žádost o registraci nového ubytovacího zařízení) sur ubyport.pcr.cz, en choisissant «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» et en indiquant «Vezpa» comme nom du programme.
Modèle de texte pour la demande (en tchèque) : «Žádám o přihlašovací údaje do Ubyport Webová služba pro ubytovací zařízení <název>, <adresa>, IDUB: <IDUB>, které budu zasílat prostřednictvím programu Vezpa, výrobce Vezpa.» Plus de détails sur la page officielle de la police tchèque.
Dans Vezpa, sous Configuration → Enregistrement gouvernemental : le nom d'utilisateur et le mot de passe du compte robotisé, l'IDUB dans le champ «Code de l'établissement», la Zkratka dans «Paramètres supplémentaires», puis activez «Envoi automatique». Laissez l'endpoint vide et «Environnement de test» désactivé : il ne sert qu'aux comptes de test des développeurs. Plusieurs établissements avec des IDUB distincts : utilisez «Identifiants par logement».
🇦🇹 Autriche — Meldeamt
Gaestemeldung obligatoire au sens de la Meldegesetz. Chaque Bundesland a son propre système ; Vezpa prend en charge les 9 Bundeslaender avec un endpoint configurable.
| Identifiant | Où l'obtenir |
|---|---|
| Nom d'utilisateur + Mot de passe ou bien API Key | Portail de votre Bundesland (feratel Deskline, GMS, etc.) |
| Betriebsnummer | Attribué par le Meldeamt régional |
| Endpoint URL | Spécifique à chaque Bundesland |
🇸🇮 Slovénie — eTurizem (AJPES)
Enregistrement des touristes obligatoire, géré par AJPES. Nécessite un certificat numérique qualifié délivré par un prestataire slovène accrédité.
| Identifiant | Où l'obtenir |
|---|---|
| Certificat numérique PEM | SIGEN-CA, Halcom, NLB ou un autre organisme accrédité |
| ID Nastanitvenega Obrata | Portail AJPES après l'inscription |
🇮🇸 Islande — Gistiskrá (registre des clients)
En vertu de la loi islandaise sur les établissements d'hébergement (Lög um veitingastaði, gististaði og skemmtanahald), chaque établissement doit tenir un registre des clients (gistiskrá) contenant les données de tous les clients. Le registre doit être disponible pour inspection par la police islandaise (Lögreglan).
Vezpa enregistre automatiquement toutes les données requises lors du check-in. Aucune configuration d'identifiants n'est nécessaire — les données sont toujours disponibles dans l'application et peuvent être exportées ou imprimées à tout moment.
| Champ obligatoire | Description |
|---|---|
| Nom complet | Prénom et nom du client |
| Date de naissance | Date complète |
| Nationalité | Pays de citoyenneté |
| Document | Type et numéro (passeport ou carte d'identité) |
| Résidence | Adresse complète |
| Dates du séjour | Arrivée et départ |
Téléchargement du fichier ISTATPour les régions à dépôt manuel (Ombrie, FVG, Pouilles)
Les régions Ombrie, Frioul-Vénétie Julienne et Pouilles ne disposent pas de service web pour l'envoi automatique. Pour ces régions, Vezpa génère le fichier que vous devrez télécharger et déposer manuellement.
Comment télécharger le fichier
- Ouvrez la configuration de l'établissement (Profil → touchez une chambre)
- Dans la section ISTAT, vérifiez que la bonne région est sélectionnée
- Touchez le bouton « Télécharger le fichier ISTAT »
- Sélectionnez la date de début et la date de fin de la période
- Touchez « Générer et télécharger le fichier »
- Le fichier est généré et vous pouvez le partager (e-mail, WhatsApp, enregistrement dans le système de fichiers)
Formats de fichier par région
| Région | Format | Où le déposer |
|---|---|---|
| Ombrie | TXT (ROSS 1000, 338 caractères/enregistrement) | Turismatica |
| Frioul-V.J. | TXT (ROSS 1000, 338 caractères/enregistrement) | WebTur |
| Pouilles | XML (SPOT, format movimentogiornaliero-0.6.xsd) | www.dms.puglia.it (accès SPID) |
<movimento> pour chaque jour de la période sélectionnée, avec les arrivées, les départs et les données de l'établissement (chambres disponibles, lits, chambres occupées). Le vendor est défini automatiquement sur « Vezpa ».
Besoin d'aide ?
Si vous avez des doutes sur la configuration des systèmes gouvernementaux ou si vous n'arrivez pas à obtenir les identifiants, contactez le support Vezpa.