Guía Integraciones

Dónde van los códigos de Alloggiati Web, ISTAT y PayTourist, y a quién pedirlos

Contenido

Dónde van los códigos Alloggiati Web (Policía) ISTAT, región por región PayTourist Cuándo salen las comunicaciones Si algo no encaja

Dónde van los códigosEn la configuración de la habitación, sección «Integraciones»

Los códigos no viven en los ajustes generales: viven en la configuración de la habitación, en la sección «Integraciones». Es la misma pantalla desde la que has abierto esta guía, con el enlace «¿Cómo obtener los códigos?».

Dentro hay tres paneles, cada uno con su interruptor «Habilitado»: «Registro policial», «ISTAT» y «PayTourist». Mientras el interruptor está apagado los campos se quedan cerrados y no se comunica nunca nada.

Un hotel rellena esto una vez, una casa de vacaciones cada vez. Si tu alojamiento es un hotel o un B&B, la línea de arriba dice que «Los códigos se aplicarán a todas las habitaciones del alojamiento». Si gestionas casas de vacaciones dice en cambio que «Cada casa de vacaciones requiere sus propios códigos de acceso»: ahí los códigos son de la unidad, y hay que repetirlos en cada una.
Los tres paneles existen solo para alojamientos italianos: fuera de Italia no aparecen, porque las comunicaciones a la Policía, al ISTAT y a PayTourist son obligaciones italianas. Otros países tienen sus propias conexiones, descritas en la guía de los sistemas gubernamentales.
Si en lugar de los paneles lees «Suscripción necesaria», la cuenta entró desde una tienda y no tiene plan activo: las integraciones las desbloquea la suscripción, no un código.

Alloggiati Web (Policía)Cuatro valores, y no son tu acceso al portal

Alloggiati Web es el portal de la Policía del Estado italiana donde hay que comunicar los datos de identidad de los huéspedes. Vezpa habla con él a través del Web Service, que tiene credenciales propias.

CampoQué es
«Usuario WS»El usuario del Web Service, no el que usas para entrar en el portal
«Contraseña WS»La contraseña dedicada al Web Service
«Token WS»La clave generada en la sección Gestión WS del portal
«Código de licencia»El código de licencia asignado por la Jefatura de Policía
«Número policial de la casa de vacaciones»Solo casas de vacaciones: el número secuencial que la Jefatura asigna a esa unidad

Para obtenerlos, desde alloggiatiweb.poliziadistato.it (se abre en una pestaña nueva): Tablas › Gestión WS. Si esa sección falta, el acceso al Web Service hay que pedirlo a la Jefatura de Policía de tu provincia.

Esos cuatro valores no son el pase de cada comunicación: en cada transmisión Vezpa los presenta al portal y recibe un token de sesión de un solo uso. Por eso un error en las credenciales se ve al instante, en la primera comunicación, y no días después.

ISTAT, región por regiónElige primero la «Región», luego los campos cambian de nombre

Cada región tiene su propio sistema. En el panel ISTAT el primer campo es «Región», y es el que manda: una vez elegida la región, los tres campos de abajo cambian de nombre y se convierten en los que ese portal usa de verdad.

La lista tiene veinte regiones, y están ahí en italiano, tal como las lees en la pantalla: Piemonte, Toscana, Basilicata, Liguria, Abruzzo, Veneto, Emilia-Romagna, Marche, Lombardia, Calabria, Sardegna, Lazio, Molise, Sicilia, Campania, Umbria, Friuli Venezia Giulia, Trentino, Puglia y Valle d'Aosta.

RegiónCómo llegan los datosQué pide
Piemonte, Toscana, Basilicata, Liguria, Abruzzo, Veneto, Emilia-Romagna, Marche, Lombardia, Calabria, Sardegna, Lazio, MoliseComunicados automáticamente al portal regional«Usuario ISTAT», «Contraseña ISTAT», «Código ISTAT»
SiciliaComunicados automáticamenteUserId, Password, HotelCode
CampaniaComunicados automáticamenteCUSR, API Key, «Código ISTAT»
TrentinoComunicados automáticamente«Usuario ISTAT», «Contraseña ISTAT», «Código ISTAT»
Valle d'AostaComunicados automáticamenteUser, Password, Property ID
Umbria, Friuli Venezia Giulia, PugliaUn archivo que descargas y subes túSolo el código del alojamiento

Las credenciales se piden a la oficina de turismo o a la APT de tu provincia o región, y el código del alojamiento lo asigna la autoridad regional. Para Sicilia el perfil que hay que pedir es el pensado para software de gestión de alojamientos, y el código se parece a TRS-IT-SIC-00004; para Campania el CUSR y la API Key se toman del portal regional.

Las tres regiones de archivo

Para Umbria, Friuli Venezia Giulia y Puglia no hay comunicación automática: Vezpa prepara el archivo y tú lo subes al portal regional. Una vez elegida la región aparece el botón «Descargar archivo ISTAT» y abre una pantalla donde eliges el periodo, generas el documento y lo guardas o lo compartes.

RegiónFormatoDónde se sube
UmbriaTXT (ROSS 1000)Turismatica
Friuli Venezia GiuliaTXT (ROSS 1000)WebTur
PugliaXML (SPOT)dms.puglia.it, con SPID
Alto Adige (provincia de Bolzano) falta: la entrada Trentino de la lista es solo la provincia de Trento. Si tu alojamiento está ahí, escríbenos.

PayTouristDos valores, y antes de todo una pregunta al ayuntamiento

PayTourist es la plataforma que algunos municipios italianos usan para cobrar la tasa turística. No todos lo hacen: antes de rellenar nada, comprueba con tu municipio o con su oficina de tributos que esta es la que se usa.

CampoQué es
«ID PayTourist»El identificador del alojamiento, facilitado por el municipio o por el operador
«Token API PayTourist»La clave que generas tú en paytourist.com, en la sección Integraciones/API
El token dura doce meses. Cuando caduca hay que generarlo otra vez en el portal y volver a escribirlo aquí: Vezpa no lo renueva por su cuenta, y sin un token válido las comunicaciones se detienen.
Si gestionas unidades en municipios distintos, los códigos son distintos para cada uno: aquí es donde la línea «Cada casa de vacaciones requiere sus propios códigos de acceso» cuenta de verdad, porque dos apartamentos en dos municipios son dos tasas separadas.

Cuándo salen las comunicacionesNo todas en el mismo momento, y ninguna al check-out

Una vez guardados los códigos no tienes que lanzar nada: las comunicaciones salen por su cuenta, pero en horarios distintos, porque los plazos son distintos.

SistemaCuándo
Alloggiati WebEl mismo día, varias veces al día: la ficha tiene que llegar a la policía dentro de las 24 horas desde la llegada
ISTATUna vez al día, y comunica el día de cinco días atrás
PayTouristUna vez al día, el mismo día en que comunica ISTAT
Esos cinco días de distancia no son un retraso: dejan que las correcciones se asienten — un huésped añadido, un cambio de habitación — antes de que los datos salgan. La comunicación a la policía se queda en cambio el mismo día, porque ahí el plazo es de 24 horas.

Si algo no encajaLos síntomas, y la causa real de cada uno

  • No encuentro la sección Gestión WS en el portal. El acceso al Web Service lo tiene que conceder la Jefatura de Policía: tus credenciales del portal no bastan y no se convierten.
  • He puesto mis credenciales del portal y no funciona nada. Son otra cosa. El panel lo dice él mismo: avisa en mayúsculas de que las credenciales WS son DISTINTAS de las de acceso al portal.
  • Un correo dice que algunos registros no se han comunicado. Ese es el aviso automático, y llega a la dirección del alojamiento junto con una notificación en la app. Dentro está el motivo que informó el sistema: una vez arreglados los datos, la comunicación se reanuda por su cuenta en el siguiente ciclo.
  • He cambiado de región y los campos han dejado de tener sentido. Es a propósito: cada región pide valores distintos, y los viejos no funcionan en el portal nuevo.
  • Para mi región no sale nada. Comprueba si es una de las tres de archivo: Umbria, Friuli Venezia Giulia y Puglia no tienen comunicación automática, el documento lo subes tú.
  • Vezpa me pide credenciales que no tengo. Vezpa no tiene credenciales propias ante ninguna de estas autoridades: cada alojamiento se registra por su cuenta y usa las suyas. No hay un acceso compartido que pedirnos.

¿Necesitas ayuda?

Si tienes dificultades para conseguir los códigos, o dudas sobre la configuración, nuestro equipo está aquí.

Contáctanos