Guía Sistemas Gubernamentales

Registrar huéspedes funciona en todos los países donde Vezpa está disponible, y sigue funcionando. Lo que no está encendido en todas partes es la conexión automática con la autoridad: la transmisión de los datos que ya has registrado.

Donde la conexión aún no está activa, en lo alto de Configuración → Registro gubernamental encuentras un cuadro informativo que lo dice: el envío automático a la autoridad de ese país se está probando, y registrar huéspedes funciona normalmente. Es solo información: no bloquea nada, no hay nada que confirmar ni que descartar, y el cuadro aparece también cuando para tu país todavía no hay ningún conector que configurar.

El cuadro desaparece solo en cuanto la conexión de tu país se activa: no tienes que hacer nada y ningún ajuste necesita actualizarse. Las secciones de abajo describen cómo se configura cada sistema; el aviso dice cómo va.

Qué significa de verdad «Configurado»

En la página Configuración → Registro gubernamental, la tarjeta de arriba lleva el nombre del sistema de tu país y la palabra «Configurado» o «No configurado». No depende solo de guardar: «Configurado» significa credenciales guardadas y el interruptor «Envío automático» puesto. Con el interruptor apagado la página se queda en «No configurado» aunque lo hayas rellenado todo, los contadores de los últimos 30 días y la tarjeta «Estadísticas» no aparecen, y «Probar conexión» responde que las credenciales no están configuradas.

Las otras secciones dicen a quién declara Vezpa y con qué credenciales. Esta dice cuándo, porque la decisión es del alojamiento y la tomas tú: abre Configuración → Registro gubernamental y en la tarjeta «Cuándo enviar a las autoridades» elige una de las tres cadencias. Vale en cualquier país: en Italia manda los partes de viajeros a la Questura (el servicio Alloggiati Web de la Polizia di Stato, o sea la jefatura de policía local), en los demás los envíos del conector de tu país.

• «Cada 4 horas» — seis pasadas al día. Registras al huésped y dejas de pensar en ello.
• «A las 23:15» — una sola pasada, al final del día.
• «Manual» — sale solo lo que seleccionas y envías tú.

La cesta «Pendientes de envío»

En cuanto eliges la cadencia manual, en la misma tarjeta aparece la entrada «Pendientes de envío»: es la cesta de las reservas que esperan, agrupadas por día de llegada. Marcas las que quieres declarar y pulsas «Enviar las seleccionadas». En las otras dos cadencias esa entrada no está, y no falta nada: no hay nada que elegir, todo sale solo.

Autorizar no es enviar, y la diferencia no es un detalle. Cuando pulsas, el permiso se escribe antes de la salida, y una sola pulsación puede llevarse solo una parte del trabajo: en ese caso la página te lo dice — «autorizadas, pero todavía no han salido del todo» — y te ofrece «Completar ahora». Vuelves a pulsar y sigue desde donde se había detenido: no es un error. Por la misma razón en pantalla nunca lees la palabra enviada: una reserva está «Autorizada» cuando el permiso existe, y que la autoridad la haya aceptado de verdad lo dice el resultado, uno por uno.

ISTAT y PayTourist siguen a la Questura

Aquí no hay nada que decidir y no hay un segundo interruptor: ISTAT y PayTourist van detrás de la Questura, por sí solos. Si una reserva se ha declarado a la Questura también la declaran ellos; si no se ha declarado, no la declaran. Está construido así, y en manual tiene una consecuencia que conviene saber antes: una noche que todavía no has enviado llega al ISTAT como habitación cerrada. Enciende la cadencia manual solo si estás listo para enviar con regularidad, o tus datos de ocupación cambiarán por un motivo que no tiene nada que ver con tus alojamientos.

En manual la Questura solo acepta hoy y ayer

No es una elección nuestra, es el portal: Alloggiati Web toma como fecha de llegada solo hoy o ayer, y más allá de ese límite el parte se rechaza. No es una formalidad, porque un parte con una fecha vieja es por sí mismo la declaración de un envío fuera de plazo. Es el motivo por el que la cesta tiene una ventana: con la cadencia manual, dejarlo para dos días después no es dejarlo, es perderlo.

El resumen del día

Desde la página «Pendientes de envío», arriba, se abre el «Resumen del día»: en qué punto estás hoy, en tres números — los «Huéspedes del día», los «Autorizados» y los «Seleccionados para enviar». Es una página de solo lectura: desde aquí no se añade ni se quita nada, se vuelve a la cesta con «Añadir o quitar reservas». Dos sitios que escriben la misma lista serían dos listas distintas.

Las dos líneas que hay que mirar son estas, porque son las que se accionan:

• Huéspedes seleccionados que todavía no se pueden declarar — falta su registro. No saldrán: regístralos y vuelven a entrar en la declaración.
• Huéspedes cuya selección ha salido de la ventana — no saldrán, la selección ya no se puede quitar y desde la app no queda nada por hacer: para esos días se pasa por el portal de la autoridad. Se cuentan aparte de los seleccionados, no entre ellos, y este resumen es el único sitio que todavía te los muestra.

La página de las credenciales no es el mismo formulario para todos. El sistema no lo eliges tú: lo decide el país de tu alojamiento, y la página dibuja sola las casillas que esa autoridad exige. Además de las comunes — usuario, contraseña, identificador del alojamiento, dirección del servicio — cada país declara los campos adicionales que exige su propia autoridad, reunidos en «Ajustes adicionales»: abre Configuración → Registro gubernamental y rellena lo que veas. Las etiquetas de esos campos llevan el nombre oficial que les da la autoridad y no se traducen, así los encuentras iguales en el portal del que copias los valores. Donde la autoridad ofrece un entorno de pruebas, recibes también el interruptor «Entorno de pruebas» para usarlo. Un campo que no ves no falta por error: tu país no lo pide.

Un secreto ya guardado — contraseña, clave, certificado — no vuelve nunca a la pantalla: la casilla se queda vacía y una línea debajo te dice que el valor ya está almacenado. Dejarla vacía no lo borra; para sustituirlo escribes uno nuevo. «Probar conexión» llama al servicio de la autoridad y te dice que responde: no es prueba de que tus credenciales sean las correctas, porque cualquier respuesta que no sea un error de servidor cuenta como éxito.

Y luego hay algo que no se adivina: algunas credenciales no son del alojamiento, son de la unidad concreta. Donde la autoridad emite un identificador por cada establecimiento, bajo las casillas comunes aparece otra tarjeta, Credenciales por alojamiento. Elige la unidad en el menú y rellena solo lo que cambia en ella: lo que dejes vacío usa el valor del alojamiento y no hay que repetirlo. Si esa tarjeta no aparece, tu país no la necesita y todo vale para el alojamiento entero.

Si la cuenta tiene varias propiedades, el menú de la tarjeta muestra primero una opción por propiedad, «Todos los alojamientos de …»: las credenciales que guardes ahí se escriben en cada uno de sus alojamientos. Sirve cuando la autoridad te dio un identificador por dirección y no por apartamento: lo introduces una sola vez y siempre puedes corregir un alojamiento concreto eligiéndolo en el menú.

Todos los establecimientos italianos están obligados a comunicar los datos de los huéspedes a la Questura, la jefatura de policía local, a través del servicio Alloggiati Web de la Polizia di Stato. Vezpa envía los partes por su cuenta: no en el instante en que registras al huésped, sino en el primero de los pases automáticos, que corren cada media hora.

La ventana es estrecha por ley, no por nuestra elección: Alloggiati Web acepta como fecha de llegada solo hoy o ayer. Por eso Vezpa no recupera días más antiguos por su cuenta — un parte con fecha vieja sería rechazado, y enviarlo dejaría constancia de que esos días quedaron sin cubrir.

Cómo conseguir las credenciales

1. Regístrate en alloggiatiweb.poliziadistato.it
2. Presenta la solicitud de activación a tu Questura local
3. Recibe las credenciales por correo: Usuario, Contraseña y WS Token
4. Introduce las credenciales en Vezpa: Configuración → Habitaciones → la habitación → Registro policial
5. Pon el interruptor «Habilitado» y guarda

El flujo automático

Campos obligatorios de la Questura

Campo	Descripción
Apellido, nombre	Datos personales del huésped
Sexo	M / F (obligatorio solo para Italia)
Fecha y lugar de nacimiento	Con el código ISTAT del municipio
Ciudadanía	Código de país de Alloggiatiweb
Tipo y número de documento	95 tipos disponibles (pasaporte, DNI, etc.)
Tipo de alojado	Huésped único (16), Cabeza de familia (17), Jefe de grupo (18)

Italia tiene veinte sistemas regionales distintos para recoger las estadísticas turísticas. Vezpa los atiende todos: diecisiete del todo automáticos, tres con un archivo que descargas y subes a mano al portal regional.

Regiones con envío automático (diecisiete)

Para estas regiones Vezpa envía los datos por su cuenta, una vez al día, a las cuatro de la mañana en la zona horaria del alojamiento. No declara el día que acaba de terminar: declara el día cinco días antes, para que un traslado entre unidades tenga tiempo de asentarse antes de transmitirse. Solo hacen falta las credenciales regionales.

ID	Región	Protocolo	Credenciales
0	Piemonte	SOAP v2	Usuario + Contraseña
1	Toscana	SOAP v2	Usuario + Contraseña
2	Basilicata	SOAP v1	Usuario + Contraseña
3	Liguria	SOAP v2	Usuario + Contraseña
4	Abruzzo	SOAP v2 (Turismo5)	Usuario + Contraseña
5	Veneto	SOAP v2	Usuario + Contraseña
6	Emilia-Romagna	SOAP v2	Usuario + Contraseña
7	Marche	ROSS1000	Usuario + Contraseña
8	Lombardia	Turismo5	Usuario + Contraseña
9	Calabria	SOAP v2	Usuario + Contraseña
10	Sardegna	ROSS1000	Usuario + Contraseña
11	Lazio	ROSS1000	Usuario + Contraseña
12	Molise	ROSS1000	Usuario + Contraseña
13	Sicilia	REST XML	PMS User + HotelCode
14	Campania	REST JSON (Sinfonia)	CUSR + API Key
17	Trentino	SOAP DTU C59	Usuario + Contraseña
19	Valle d'Aosta	SOAP VIT (INVA)	User + Contraseña + Property ID

Regiones con descarga de archivo (tres)

Para estas regiones, Vezpa genera el archivo que tendrás que descargar desde la app y subir a mano al portal regional.

ID	Región	Formato	Portal de subida
15	Umbria	TXT (ROSS 1000)	Turismatica
16	Friuli Venezia Giulia	TXT (ROSS 1000)	WebTur
18	Puglia	XML (SPOT)	www.dms.puglia.it (SPID)

Cómo configurar ISTAT

1. Abre Configuración → Habitaciones desde Dirección, menú de tres puntos, y toca la habitación
2. Abre la sección «ISTAT» y pon el interruptor «Habilitado»
3. Elige tu «Región» en el menú desplegable
4. Introduce las credenciales que te dio el portal regional
5. Introduce el «Código ISTAT» del alojamiento
6. Guarda. El primer envío automático sale en el siguiente pase nocturno

PayTourist es una plataforma opcional que automatiza el cobro y el pago de la tasa turística para muchos municipios italianos. Vezpa está integrada directamente con PayTourist y envía los datos de los huéspedes en el mismo pase nocturno que ISTAT y con el mismo día de referencia: cinco días antes.

Credenciales necesarias

Campo	De dónde sale
PayTourist ID	Registro en paytourist.it (autoservicio)
API Token	Panel de PayTourist después del registro

La firma digital se recoge tanto desde la app Flutter (durante el registro del huésped) como desde el check-in web (lienzo táctil). La firma se guarda como imagen PNG en el perfil del huésped.

La firma del huésped solo se propone en los países donde la ley la exige en el formulario de registro: Alemania, Austria, Francia y España. Incluso allí es opcional — en la app y en el check-in online — porque el huésped puede firmar el formulario en papel a su llegada; en ningún país la firma se transmite a la autoridad, sirve al alojamiento como prueba. En los demás países la sección de la firma no aparece y, donde Vezpa sabe generar el formulario, el PDF se genera igualmente, con una línea para firmar en papel.

El parte se genera desde el detalle de la reserva tocando «Parte de viajeros»: sale ya rellenado con los datos del huésped, en el idioma del país del alojamiento, listo para firmar y conservar. El botón aparece solo allí donde Vezpa puede producir el parte, y se queda desactivado — con un mensaje que explica por qué — hasta que la persona responsable de la reserva esté registrada.

Para los alojamientos situados en uno de los países de abajo, Vezpa puede enviar automáticamente los datos de los huéspedes al sistema gubernamental nacional. La configuración está en Configuración → Registro gubernamental, y esa página existe solo para estos países: en cualquier otro dice que no hay conector disponible, y no es un fallo. Si la conexión de tu país aún no está activa, la app te lo dice con un aviso en lo alto de la página: ver Cómo va la conexión.

Cuándo ocurre el envío. No cuando registras al huésped: lo hacen dos pases automáticos. Para los registros policiales, un pase cada hora recoge los huéspedes registrados hace poco; para los sistemas estadísticos, un pase una vez al día. La transmisión real sale después en media hora. El interruptor «Envío automático» manda sobre todo: con él apagado no sale nada.

🇪🇸 España — SES.Hospedajes

Obligatorio desde el 2 de diciembre de 2024 (Real Decreto 933/2021). Registro de viajeros con el Ministerio del Interior.

Credencial	De dónde sale
API Key	seshospedajes.es (autoservicio)
Establishment ID	Portal SES después de registrar el alojamiento

🇭🇷 Croacia — eVisitor

Sistema nacional en línea gestionado por la Hrvatska turistička zajednica (HTZ).

Credencial	De dónde sale
Usuario + Contraseña	evisitor.hr (autoservicio)
API Key	Portal eVisitor después del registro
Facility Code	Asignado al registrarse

🇭🇺 Hungría — NTAK

Sistema nacional NTAK (Nemzeti Turisztikai Adatszolgáltatási Központ). Vezpa se conecta a través del intermediario NTAK.guru para simplificar la integración.

Credencial	De dónde sale
Bearer Token	ntak.guru (autoservicio)
Accommodation ID	Portal NTAK.guru después del registro

NTAK es el sistema estadístico. Para la parte policial Hungría tiene un segundo sistema, VIZA, que no se enciende solo: se configura aparte, con credenciales propias, y quien se lo salta se queda solo con NTAK.

🇵🇹 Portugal — SIBA

Boletim de Alojamento exigido por la Lei n.º 23/2007 (art. 15-16).

Credencial	De dónde sale
Usuario + Contraseña	siba.ssi.gov.pt
Código Estabelecimento	Registro en el SIBA

🇨🇿 República Checa — UbyPort

Registro obligatorio de huéspedes extranjeros gestionado por la Cizinecká policie (Policía de Extranjería).

Desde el 9 de octubre de 2026 Vezpa está aprobado por la policía checa (Ředitelství služby cizinecké policie, RSCP) como software para el envío automático de los datos de los huéspedes extranjeros a UbyPort. El envío sale solo, en la pasada de cada hora. Si a un huésped le faltan datos o la policía rechaza un registro, recibes la notificación «Verificar datos del huésped» con el nombre del huésped y el motivo: el registro rechazado no se reintenta solo, se vuelve a enviar cuando hayas corregido los datos.

Credencial	De dónde sale
Usuario + Contraseña	Cuenta para el envío robótico de datos (účet pro robotické zasílání dat), emitida por la RSCP
IDUB	Asignado por la RSCP al registrar el alojamiento
Zkratka	Abreviatura del alojamiento, asignada junto con el IDUB (opcional, recomendada)

Cómo se obtiene la cuenta. No se crea automáticamente; hay tres casos:

• Ya tienes una cuenta robótica (por ejemplo, usada con otro PMS): no tienes que hacer nada con la policía, la cuenta es transferible. Introduce en Vezpa las credenciales que ya tienes.
• Tienes IDUB pero no cuenta robótica: escribe a la RSCP por datová schránka (ID ybndqw9) o por e-mail a [email protected] pidiendo una cuenta para el envío robótico de datos. Indica el IDUB, el nombre y la dirección completa del alojamiento, el fabricante y el nombre del programa, que debe ser exactamente «Vezpa»: con cualquier otro nombre la solicitud no se aprueba.
• No tienes ni IDUB ni cuenta: presenta la solicitud normal de registro de un nuevo alojamiento (Žádost o registraci nového ubytovacího zařízení) en ubyport.pcr.cz (se abre en una pestaña nueva), eligiendo «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» e indicando «Vezpa» como nombre del programa.

Texto modelo de la solicitud (en checo): «Žá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.» Más detalles en la página oficial de la policía checa (se abre en una pestaña nueva).

En Vezpa, en Configuración → Registro gubernamental: el usuario y la contraseña de la cuenta robótica, el IDUB en el campo «Código del alojamiento», la Zkratka en «Ajustes adicionales», y después activa «Envío automático». Deja vacío el endpoint y apagado «Entorno de pruebas»: solo sirve para las cuentas de prueba de los desarrolladores. Varios alojamientos con IDUB distintos: usa «Credenciales por alojamiento».

🇦🇹 Austria — Meldeamt

Gästemeldung exigida por la Meldegesetz. Cada Bundesland tiene su propio sistema; Vezpa soporta los 9 Bundesländer con un endpoint configurable.

Credencial	De dónde sale
Usuario + Contraseña o API Key	Portal del propio Bundesland (feratel Deskline, GMS, etc.)
Betriebsnummer	Asignado por el Meldeamt regional
Endpoint URL	Propia de cada Bundesland

🇧🇬 Bulgaria — ESTI

Registro de huéspedes en el sistema unificado ESTI, al que se llega por la pasarela RegiX. Una sola declaración cumple tanto la obligación con el Ministerio de Turismo como el registro de los huéspedes extranjeros.

Credencial	De dónde sale
Certificado digital	Proveedor búlgaro acreditado
Identificador del alojamiento	Registro ESTI después de inscribirse

🇸🇮 Eslovenia — eTurizem (AJPES)

Registro obligatorio de huéspedes gestionado por AJPES. Exige un certificado digital cualificado emitido por un proveedor esloveno acreditado.

Credencial	De dónde sale
Certificado digital PEM	SIGEN-CA, Halcom, NLB u otra autoridad acreditada
ID Nastanitvenega Obrata	Portal AJPES después del registro

🇮🇸 Islandia — Gistiskrá (Registro de huéspedes)

Según la ley islandesa sobre establecimientos de alojamiento (Lög um veitingastaði, gististaði og skemmtanahald), cada alojamiento debe llevar un registro de huéspedes (gistiskrá) con los datos de todos ellos. El registro tiene que estar disponible para la inspección de la policía islandesa (Lögreglan).

Vezpa recoge por su cuenta todos los datos exigidos durante el check-in. No hay que configurar ninguna credencial — los datos están siempre disponibles en la app y se pueden exportar o imprimir en cualquier momento.

Campo obligatorio	Descripción
Nombre completo	Nombre y apellido del huésped
Fecha de nacimiento	Fecha completa
Nacionalidad	País de ciudadanía
Documento	Tipo y número (pasaporte o documento de identidad)
Residencia	Dirección completa
Fechas de la estancia	Llegada y salida

Las regiones de Umbría, Friuli Venezia Giulia y Apulia no tienen un servicio web para el envío automático. Para estas regiones, Vezpa genera el archivo que tendrás que descargar y subir a mano.

Cómo descargar el archivo

1. Desde Dirección abre «Configuración», grupo «Habitaciones», y toca la habitación
2. En la sección «ISTAT» comprueba que la «Región» sea la correcta
3. Toca el botón «Descargar archivo ISTAT»
4. Elige la fecha de inicio y la fecha final del periodo
5. Genera el archivo
6. El archivo se genera y puedes compartirlo (correo, WhatsApp, guardarlo en el sistema de archivos)

Formatos de archivo por región

Región	Formato	Dónde subirlo
Umbria	TXT (ROSS 1000, 338 car./registro)	Turismatica
Friuli V.G.	TXT (ROSS 1000, 338 car./registro)	WebTur
Puglia	XML (SPOT, formato movimentogiornaliero-0.6.xsd)	www.dms.puglia.it (acceso con SPID)