Leitfaden Integrationen

Wohin die Codes für Alloggiati Web, ISTAT und PayTourist gehören, und bei wem man sie anfordert

Wohin die Codes gehörenIn die Zimmerkonfiguration, Abschnitt «Integrationen»

Die Codes wohnen nicht in den allgemeinen Einstellungen: sie wohnen in der Zimmerkonfiguration, im Abschnitt «Integrationen». Es ist derselbe Bildschirm, von dem Sie diesen Leitfaden geöffnet haben, über den Link «Wie erhalte ich die Codes?».

Darin sind drei Flächen, jede mit ihrem eigenen Schalter «Aktiviert»: «Polizeiliche Meldung», «ISTAT» und «PayTourist». Solange der Schalter aus ist, bleiben die Felder geschlossen und es wird nie etwas gemeldet.

Ein Hotel füllt das einmal aus, eine Ferienwohnung jedes Mal. Ist Ihre Unterkunft ein Hotel oder ein B&B, sagt die Zeile oben, dass «Die Codes werden auf alle Zimmer der Unterkunft angewendet». Verwalten Sie Ferienwohnungen, sagt sie stattdessen, dass «Jede Ferienwohnung benötigt eigene Zugangscodes»: dort gehören die Codes zur Einheit und müssen auf jeder wiederholt werden.
Die drei Flächen gibt es nur für italienische Unterkünfte: außerhalb Italiens erscheinen sie nicht, denn die Meldungen an Polizei, ISTAT und PayTourist sind italienische Pflichten. Andere Länder haben ihre eigenen Anbindungen, beschrieben im Leitfaden zu den behördlichen Systemen.
Lesen Sie anstelle der Flächen «Abonnement erforderlich», kam das Konto aus einem Store und hat keinen aktiven Tarif: die Integrationen werden vom Abonnement freigeschaltet, nicht von einem Code.

Alloggiati Web (Polizei)Vier Werte, und sie sind nicht Ihr Portal-Login

Alloggiati Web ist das Portal der italienischen Staatspolizei, auf dem die Identitätsdaten der Gäste gemeldet werden müssen. Vezpa spricht mit ihm über den Web Service, der eigene Zugangsdaten hat.

FeldWas es ist
«WS-Benutzername»Der Benutzer des Web Service, nicht der, mit dem Sie sich am Portal anmelden
«WS-Passwort»Das Passwort, das dem Web Service vorbehalten ist
«WS-Token»Der Schlüssel, der im Abschnitt WS-Verwaltung des Portals erzeugt wird
«Lizenzcode»Der von der Polizeidirektion zugeteilte Lizenzcode
«Polizeinummer der Ferienwohnung»Nur Ferienwohnungen: die laufende Nummer, die die Polizeidirektion jener Einheit zuteilt

Um sie zu erhalten, von alloggiatiweb.poliziadistato.it (öffnet in einem neuen Tab): Tabellen › WS-Verwaltung. Fehlt dieser Abschnitt, muss der Zugang zum Web Service bei der Polizeidirektion Ihrer Provinz beantragt werden.

Jene vier Werte sind nicht der Ausweis für jede Meldung: bei jeder Übertragung legt Vezpa sie dem Portal vor und erhält ein Sitzungstoken für den einmaligen Gebrauch. Deshalb zeigt sich ein Fehler in den Zugangsdaten sofort, bei der ersten Meldung, und nicht Tage später.

ISTAT, Region für RegionZuerst die «Region» wählen, dann ändern die Felder ihren Namen

Jede Region hat ihr eigenes System. In der ISTAT-Fläche ist das erste Feld «Region», und es ist das bestimmende: haben Sie die Region gewählt, ändern die drei Felder darunter ihren Namen und werden die, die jenes Portal wirklich benutzt.

Die Liste enthält zwanzig Regionen, und sie stehen dort auf Italienisch, so wie Sie sie auf dem Bildschirm lesen: Piemonte, Toscana, Basilicata, Liguria, Abruzzo, Veneto, Emilia-Romagna, Marche, Lombardia, Calabria, Sardegna, Lazio, Molise, Sicilia, Campania, Umbria, Friuli Venezia Giulia, Trentino, Puglia und Valle d'Aosta.

RegionWie die Daten dorthin kommenWas sie verlangt
Piemonte, Toscana, Basilicata, Liguria, Abruzzo, Veneto, Emilia-Romagna, Marche, Lombardia, Calabria, Sardegna, Lazio, MoliseAutomatisch an das Regionalportal gemeldet«ISTAT-Benutzername», «ISTAT-Passwort», «ISTAT-Code»
SiciliaAutomatisch gemeldetUserId, Password, HotelCode
CampaniaAutomatisch gemeldetCUSR, API Key, «ISTAT-Code»
TrentinoAutomatisch gemeldet«ISTAT-Benutzername», «ISTAT-Passwort», «ISTAT-Code»
Valle d'AostaAutomatisch gemeldetUser, Password, Property ID
Umbria, Friuli Venezia Giulia, PugliaEine Datei, die Sie selbst herunterladen und hochladenNur der Code der Unterkunft

Die Zugangsdaten werden beim Fremdenverkehrsamt oder bei der APT Ihrer Provinz oder Region angefordert, und der Code der Unterkunft wird von der Regionalbehörde zugeteilt. Für Sicilia ist das Profil anzufordern, das für Verwaltungssoftware von Unterkünften gedacht ist, und der Code sieht aus wie TRS-IT-SIC-00004; für Campania werden CUSR und API Key dem Regionalportal entnommen.

Die drei Regionen mit Datei

Für Umbria, Friuli Venezia Giulia und Puglia gibt es keine automatische Meldung: Vezpa bereitet die Datei vor und Sie laden sie auf das Regionalportal hoch. Ist die Region gewählt, erscheint die Schaltfläche «ISTAT-Datei herunterladen» und öffnet einen Bildschirm, auf dem Sie den Zeitraum wählen, das Dokument erzeugen und es speichern oder teilen.

RegionFormatWo es hochgeladen wird
UmbriaTXT (ROSS 1000)Turismatica
Friuli Venezia GiuliaTXT (ROSS 1000)WebTur
PugliaXML (SPOT)dms.puglia.it, mit SPID
Südtirol (Provinz Bozen) fehlt: der Eintrag Trentino in der Liste ist allein die Provinz Trient. Liegt Ihre Unterkunft dort, schreiben Sie uns.

PayTouristZwei Werte, und vor allem eine Frage an die Gemeinde

PayTourist ist die Plattform, über die manche italienischen Gemeinden die Kurtaxe einziehen. Nicht alle tun es: bevor Sie irgendetwas eintragen, prüfen Sie bei Ihrer Gemeinde oder ihrem Steueramt, dass diese die benutzte ist.

FeldWas es ist
«PayTourist-ID»Die Kennung der Unterkunft, von der Gemeinde oder dem Betreiber gestellt
«PayTourist API-Token»Der Schlüssel, den Sie selbst auf paytourist.com erzeugen, im Abschnitt Integrationen/API
Das Token hält zwölf Monate. Läuft es ab, muss es auf dem Portal neu erzeugt und hier wieder eingetragen werden: Vezpa erneuert es nicht von selbst, und ohne gültiges Token halten die Meldungen an.
Verwalten Sie Einheiten in verschiedenen Gemeinden, sind die Codes für jede verschieden: hier zählt die Zeile «Jede Ferienwohnung benötigt eigene Zugangscodes» wirklich, denn zwei Wohnungen in zwei Gemeinden sind zwei getrennte Abgaben.

Wann die Meldungen hinausgehenNicht alle im gleichen Augenblick, und keine beim Check-out

Sind die Codes gespeichert, müssen Sie nichts starten: die Meldungen gehen von selbst hinaus, aber zu verschiedenen Zeiten, denn die Fristen sind verschieden.

SystemWann
Alloggiati WebAm selben Tag, mehrmals täglich: der Meldeschein muss die Polizei innerhalb von 24 Stunden nach der Anreise erreichen
ISTATEinmal am Tag, und es meldet den Tag fünf Tage zurück
PayTouristEinmal am Tag, am selben Tag, an dem ISTAT meldet
Jene fünf Tage Abstand sind keine Verzögerung: sie lassen Korrekturen sich setzen — ein hinzugefügter Gast, ein Zimmerwechsel — bevor die Daten hinausgehen. Die Polizeimeldung bleibt dagegen am selben Tag, denn dort ist die Frist 24 Stunden.

Wenn etwas nicht stimmtDie Anzeichen, und die wirkliche Ursache jedes einzelnen

  • Ich finde den Abschnitt WS-Verwaltung auf dem Portal nicht. Der Zugang zum Web Service muss von der Polizeidirektion gewährt werden: Ihre Portal-Zugangsdaten genügen nicht und wandeln sich nicht um.
  • Ich habe meine Portal-Zugangsdaten eingetragen und nichts funktioniert. Das ist etwas anderes. Die Fläche sagt es selbst: sie warnt in Großbuchstaben, dass die WS-Zugangsdaten ANDERE sind als die zum Anmelden am Portal.
  • Eine E-Mail sagt, dass einige Meldungen nicht hinausgegangen sind. Das ist die automatische Warnung, und sie erreicht die Adresse der Unterkunft zusammen mit einer Mitteilung in der App. Darin steht der Grund, den das System gemeldet hat: sind die Daten gerichtet, nimmt die Meldung beim nächsten Durchlauf von selbst wieder auf.
  • Ich habe die Region gewechselt und die Felder ergeben keinen Sinn mehr. Das ist Absicht: jede Region verlangt andere Werte, und die alten funktionieren auf dem neuen Portal nicht.
  • Für meine Region geht nichts hinaus. Prüfen Sie, ob sie eine der drei mit Datei ist: Umbria, Friuli Venezia Giulia und Puglia haben keine automatische Meldung, das Dokument laden Sie selbst hoch.
  • Vezpa verlangt Zugangsdaten, die ich nicht habe. Vezpa hat gegenüber keiner dieser Behörden eigene Zugangsdaten: jede Unterkunft meldet sich selbst an und benutzt die eigenen. Es gibt keinen gemeinsamen Zugang, den man uns abfragen könnte.

Brauchen Sie Hilfe?

Wenn Sie Schwierigkeiten haben, die Codes zu bekommen, oder Fragen zur Einrichtung, ist unser Team da.

Kontaktieren Sie uns