Guia Sistemas Governamentais

O registo de hóspedes funciona em todos os países onde o Vezpa está disponível, e continua a funcionar. O que não está ligado em toda a parte é a ligação automática com a autoridade: a transmissão dos dados que já registou.

Onde a ligação ainda não está ativa, no topo de Perfil → Registo Governamental encontra uma caixa informativa que o diz: o envio automático para a autoridade desse país está em fase de testes, e o registo de hóspedes funciona normalmente. É apenas informação: não bloqueia nada, não há nada a confirmar nem a fechar, e a caixa aparece também quando para o seu país ainda não há qualquer conector a configurar.

A caixa desaparece sozinha quando a ligação do seu país passa a estar ativa: não tem de fazer nada e não é preciso atualizar qualquer definição. As secções abaixo descrevem como se configura cada sistema; o aviso diz em que ponto está.

As outras secções dizem a quem o Vezpa declara e com que credenciais. Esta diz quando, porque a decisão é do alojamento e é o utilizador que a toma: abra Configuração → Registo governamental e, na caixa «Quando enviar às autoridades», escolha uma das três cadências. Vale em qualquer país: em Itália comanda os boletins para a Questura (o comando de polícia local) através do serviço Alloggiati Web da Polizia di Stato, noutros países os envios do conector do seu país.

• «A cada 4 horas» — seis passagens por dia. Registe o hóspede e deixe de pensar nisso.
• «Às 23:15» — uma única passagem, no fim do dia.
• «Manual» — sai apenas o que seleciona e envia.

O cesto «Pendentes de envio»

Logo que escolhe a cadência manual, na mesma caixa aparece a entrada «Pendentes de envio»: é o cesto das reservas que esperam, agrupadas por dia de chegada. Assinala as que quer declarar e prime «Enviar as selecionadas». Nas outras duas cadências essa entrada não existe, e não falta nada: não há nada a escolher, tudo sai por si.

Autorizar não é enviar, e a diferença não é um pormenor. Quando prime, a autorização é escrita antes da saída, e uma só pressão pode levar apenas uma parte do trabalho: nesse caso a página di-lo — «autorizadas, mas ainda não saíram por completo» — e oferece «Concluir agora». Prime de novo e retoma onde tinha parado: não é um erro. Pela mesma razão nunca lê no ecrã a palavra enviada: uma reserva está «Autorizada» quando a autorização existe, e se a autoridade a aceitou de facto di-lo o resultado, um a um.

O ISTAT e o PayTourist seguem a Questura

Aqui não há nada a decidir e não há um segundo interruptor: o ISTAT e o PayTourist vão atrás da Questura, por si. Se uma reserva foi declarada à Questura, eles também a declaram; se não foi, não a declaram. É assim que está construído, e em manual isso tem uma consequência que convém saber de antemão: uma noite que ainda não enviou chega ao ISTAT como quarto fechado. Ligue a cadência manual apenas se estiver pronto a enviar com regularidade, ou os seus dados de ocupação vão mudar por um motivo que não tem nada a ver com os seus alojamentos.

Em manual a Questura aceita apenas hoje e ontem

Não é uma escolha nossa, é o portal: o Alloggiati Web toma como data de chegada apenas hoje ou ontem, e além desse limite o boletim é rejeitado. Não é uma formalidade, porque um boletim com uma data antiga declara por si mesmo um envio fora de prazo. É por isso que o cesto tem uma janela: com a cadência manual, adiar dois dias não é adiar, é perder.

O resumo do dia

No topo da página «Pendentes de envio» abre-se o «Resumo do dia»: em que ponto está hoje, em três números — os «Hóspedes do dia», os «Autorizados» e os «Selecionados para enviar». É uma página de leitura apenas: daqui não se acrescenta nem se retira nada, volta-se ao cesto com «Adicionar ou retirar reservas». Dois sítios a escrever a mesma lista seriam duas listas diferentes.

As duas linhas a olhar são estas, porque são aquelas sobre as quais se age:

• Hóspedes selecionados que ainda não podem ser declarados — falta o seu registo. Não vão sair: registe-os e voltam a entrar na declaração.
• Hóspedes cuja seleção saiu da janela — não vão sair, a seleção já não pode ser retirada, e a partir da aplicação não há mais nada a fazer: para esses dias passa-se pelo portal da autoridade. São contados à parte dos selecionados, não entre eles, e este resumo é o único sítio que ainda lhos mostra.

A página das credenciais não é o mesmo formulário para todos. Além das caixas comuns — utilizador, palavra-passe, identificador do estabelecimento, endereço do serviço — cada país declara os campos adicionais que a sua autoridade exige, e a página desenha-os sozinha: abra Perfil → Registo Governamental, escolha o sistema e preencha o que vê. As etiquetas levam o nome oficial que a autoridade lhes dá e não são traduzidas, para as reencontrar iguais no portal de onde copia os valores. Onde a autoridade disponibiliza um ambiente de testes, encontra também um interruptor para o usar: serve para verificar a configuração antes de enviar a sério. Um campo que não vê não falta por engano: no seu país não é pedido.

Há depois uma coisa que não se imagina: algumas credenciais não são do estabelecimento, são do alojamento em concreto. Onde a autoridade emite um identificador por cada unidade de alojamento, por baixo das caixas comuns aparece um cartão a mais, Credenciais por alojamento. Escolha o alojamento no menu e preencha apenas o que muda para ele: o que deixar vazio usa o valor do estabelecimento e não precisa de ser repetido. Se esse cartão não aparecer, no seu país não é preciso e tudo vale para todo o estabelecimento.

Se a conta tiver várias propriedades, o menu do cartão mostra primeiro uma opção por propriedade, «Todos os alojamentos de …»: as credenciais que guardar aí são gravadas em cada um dos seus alojamentos. É útil quando a autoridade lhe atribuiu um identificador por morada e não por apartamento: introduz-o uma só vez e pode sempre corrigir um alojamento escolhendo-o no menu.

Todos os alojamentos turísticos italianos são obrigados a comunicar os dados dos hóspedes à Questura (o comando de polícia local) através do serviço Alloggiati Web da Polizia di Stato. O Vezpa envia automaticamente os dados dos hóspedes assim que estes são registados.

Como obter as credenciais

1. Registe-se em alloggiatiweb.poliziadistato.it
2. Apresente o pedido de ativação junto da sua Questura local
3. Receba as credenciais por e-mail: Nome de utilizador, Palavra-passe e Token WS
4. Introduza as credenciais no Vezpa: Perfil → Configuração → Questura
5. Ative o interruptor "Ativado"

Fluxo automático

Campos obrigatórios da Questura

Campo	Descrição
Apelido, Nome próprio	Dados pessoais do hóspede
Sexo	M / F (obrigatório apenas para Itália)
Data e local de nascimento	Com o código ISTAT do município
Nacionalidade	Código do país Alloggiatiweb
Tipo e número do documento	95 tipos disponíveis (passaporte, cartão de cidadão, etc.)
Tipo de alojado	Hóspede individual (16), Chefe de família (17), Chefe de grupo (18)

A Itália tem 19 sistemas regionais diferentes para a recolha dos dados estatísticos sobre o turismo. O Vezpa gere-os todos: a maioria de forma totalmente automática, algumas regiões exigem a descarga de um ficheiro.

Regiões com envio automático (16 regiões)

Nestas regiões, o Vezpa envia os dados automaticamente todas as noites através de web service. Só precisa das credenciais regionais.

ID	Região	Protocolo	Credenciais
0	Piemonte	SOAP v2	Nome de utilizador + Palavra-passe
1	Toscana	SOAP v2	Nome de utilizador + Palavra-passe
2	Basilicata	SOAP v1	Nome de utilizador + Palavra-passe
3	Ligúria	SOAP v2	Nome de utilizador + Palavra-passe
4	Abruzzo	SOAP v2 (Turismo5)	Nome de utilizador + Palavra-passe
5	Veneto	SOAP v2	Nome de utilizador + Palavra-passe
6	Emília-Romanha	SOAP v2	Nome de utilizador + Palavra-passe
7	Marcas	ROSS1000	Nome de utilizador + Palavra-passe
8	Lombardia	Turismo5	Nome de utilizador + Palavra-passe
9	Calábria	SOAP v2	Nome de utilizador + Palavra-passe
10	Sardenha	ROSS1000	Nome de utilizador + Palavra-passe
11	Lácio	ROSS1000	Nome de utilizador + Palavra-passe
12	Molise	ROSS1000	Nome de utilizador + Palavra-passe
13	Sicília	REST XML	PMS User + HotelCode
14	Campânia	REST JSON (Sinfonia)	CUSR + API Key
17	Trentino	SOAP DTU C59	Nome de utilizador + Palavra-passe
19	Vale de Aosta	SOAP VIT (INVA)	Utilizador + Palavra-passe + ID do Alojamento

Regiões com descarga de ficheiro (3 regiões)

Nestas regiões, o Vezpa gera o ficheiro que terá de descarregar da aplicação e carregar manualmente no portal regional.

ID	Região	Formato	Portal de carregamento
15	Úmbria	TXT (ROSS 1000)	Turismatica
16	Friuli-Venécia Juliana	TXT (ROSS 1000)	WebTur
18	Apúlia	XML (SPOT)	www.dms.puglia.it (SPID)

Como configurar o ISTAT

1. Abra Perfil → Configuração e selecione o seu quarto/alojamento
2. Na secção ISTAT, ative o interruptor "Ativado"
3. Selecione a sua região no menu pendente
4. Introduza as credenciais fornecidas pelo portal regional
5. Introduza o código ISTAT do alojamento
6. Guarde. O envio automático arranca nessa mesma noite

O PayTourist é uma plataforma opcional que automatiza a cobrança e a entrega da taxa turística em muitos municípios italianos. O Vezpa integra-se diretamente com o PayTourist para enviar os dados dos hóspedes.

Credenciais necessárias

Campo	Onde a obter
ID PayTourist	Registo em paytourist.it (autosserviço)
Token API	Painel PayTourist após o registo

A assinatura digital é recolhida tanto na aplicação Flutter (durante o registo do hóspede) como no self check-in web (área tátil de desenho). A assinatura é guardada como imagem PNG no perfil do hóspede.

A assinatura do hóspede só é proposta nos países em que a lei a exige no formulário de registo: Alemanha, Áustria, França e Espanha. Mesmo aí é opcional — na app e no check-in online — porque o hóspede pode assinar o formulário em papel à chegada; em nenhum país a assinatura é transmitida à autoridade, serve ao alojamento como prova. Nos outros países a secção da assinatura não aparece e, onde o Vezpa sabe produzir o formulário, o PDF é gerado na mesma, com uma linha para assinar em papel.

O formulário gera-se a partir do detalhe da reserva tocando em «Boletim de alojamento»: sai já preenchido com os dados do hóspede, na língua do país do alojamento, pronto para assinar e conservar. O botão aparece sozinho onde a Vezpa sabe produzir o formulário, e fica desativado — com uma mensagem que o explica — até que o responsável pela reserva esteja registado.

Para os alojamentos situados num dos seguintes países europeus, o Vezpa pode enviar automaticamente os dados dos hóspedes ao sistema governamental nacional. A configuração encontra-se em Perfil → Registo Governamental. Se a ligação do seu país ainda não estiver ativa, a aplicação di-lo com um aviso no topo da página: ver Em que ponto está a ligação.

🇪🇸 Espanha — SES.Hospedajes

Obrigatório desde 2 de dezembro de 2024 (Real Decreto 933/2021). Registro de viajeros junto do Ministerio del Interior.

Credencial	Onde a obter
API Key	seshospedajes.es (autosserviço)
Establishment ID	Portal SES após o registo do alojamento

🇭🇷 Croácia — eVisitor

Sistema telemático nacional gerido pela Hrvatska turisticka zajednica (HTZ).

Credencial	Onde a obter
Nome de utilizador + Palavra-passe	evisitor.hr (autosserviço)
API Key	Portal eVisitor após o registo
Facility Code	Atribuído no momento do registo

🇭🇺 Hungria — NTAK

Sistema nacional NTAK (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). O Vezpa liga-se através do intermediário NTAK.guru para simplificar a integração.

Credencial	Onde a obter
Bearer Token	ntak.guru (autosserviço)
Accommodation ID	Portal NTAK.guru após o registo

🇵🇹 Portugal — SIBA

Boletim de Alojamento obrigatório nos termos da Lei n.º 23/2007 (art. 15.º-16.º).

Credencial	Onde a obter
Nome de utilizador + Palavra-passe	siba.ssi.gov.pt
Código de Estabelecimento	Registo no SIBA

🇨🇿 República Checa — UbyPort

Registo obrigatório de estrangeiros gerido pela Cizinecká policie (Polícia de Estrangeiros).

Desde 9 de outubro de 2026 o Vezpa está aprovado pela polícia checa (Ředitelství služby cizinecké policie, RSCP) como software para o envio automático dos dados dos hóspedes estrangeiros ao UbyPort. O envio parte sozinho, na passagem horária. Se faltarem dados a um hóspede ou a polícia rejeitar um registo, recebe a notificação «Verificar dados do hóspede» com o nome do hóspede e o motivo: o registo rejeitado não é repetido sozinho, é reenviado depois de corrigir os dados.

Credencial	Onde a obter
Nome de utilizador + Palavra-passe	Conta para envio robótico de dados (účet pro robotické zasílání dat), emitida pela RSCP
IDUB	Atribuído pela RSCP no registo do alojamento
Zkratka	Abreviatura do alojamento, atribuída juntamente com o IDUB (opcional, recomendada)

Como obter a conta. Não é criada automaticamente; há três casos:

• Já tem uma conta robótica (por exemplo, usada com outro PMS): não há nada a tratar com a polícia, a conta é transferível. Introduza no Vezpa as credenciais que já tem.
• Tem IDUB mas não tem conta robótica: escreva à RSCP pela datová schránka (ID ybndqw9) ou por e-mail para [email protected] pedindo uma conta para envio robótico de dados. Indique o IDUB, o nome e a morada completa do alojamento, o fabricante e o nome do programa, que tem de ser exatamente «Vezpa»: com qualquer outro nome o pedido não é aprovado.
• Não tem IDUB nem conta: submeta o pedido normal de registo de um novo alojamento (Žádost o registraci nového ubytovacího zařízení) em ubyport.pcr.cz (abre num novo separador), escolhendo «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» e indicando «Vezpa» como nome do programa.

Texto modelo do pedido (em 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.» Mais detalhes na página oficial da polícia checa (abre num novo separador).

No Vezpa, em Configuração → Registo governamental: o utilizador e a palavra-passe da conta robótica, o IDUB no campo «Código do alojamento», a Zkratka em «Definições adicionais», e depois ative «Envio automático». Deixe o endpoint vazio e «Ambiente de teste» desligado: serve apenas para as contas de teste dos programadores. Vários alojamentos com IDUB distintos: use «Credenciais por alojamento».

🇦🇹 Áustria — Meldeamt

Gaestemeldung obrigatória nos termos da Meldegesetz. Cada Bundesland tem o seu próprio sistema; o Vezpa suporta todos os 9 Bundeslaender com endpoint configurável.

Credencial	Onde a obter
Nome de utilizador + Palavra-passe ou API Key	Portal do seu Bundesland (feratel Deskline, GMS, etc.)
Betriebsnummer	Atribuído pelo Meldeamt regional
Endpoint URL	Específico de cada Bundesland

🇸🇮 Eslovénia — eTurizem (AJPES)

Registo obrigatório de turistas gerido pela AJPES. Exige um certificado digital qualificado emitido por um prestador esloveno acreditado.

Credencial	Onde a obter
Certificado digital PEM	SIGEN-CA, Halcom, NLB ou outra entidade acreditada
ID Nastanitvenega Obrata	Portal AJPES após o registo

🇮🇸 Islândia — Gistiskrá (Registo de Hóspedes)

Nos termos da lei islandesa sobre estabelecimentos de alojamento (Lög um veitingastaði, gististaði og skemmtanahald), cada estabelecimento deve manter um registo de hóspedes (gistiskrá) com os dados de todos os hóspedes. O registo tem de estar disponível para inspeção por parte da polícia islandesa (Lögreglan).

O Vezpa regista automaticamente todos os dados exigidos durante o check-in. Não é necessária qualquer configuração de credenciais — os dados estão sempre disponíveis na aplicação e podem ser exportados ou impressos a qualquer momento.

Campo obrigatório	Descrição
Nome completo	Nome próprio e apelido do hóspede
Data de nascimento	Data completa
Nacionalidade	País de cidadania
Documento	Tipo e número (passaporte ou cartão de cidadão)
Residência	Morada completa
Datas da estadia	Chegada e partida

As regiões da Úmbria, Friuli-Venécia Juliana e Apúlia não dispõem de web service para o envio automático. Para estas regiões, o Vezpa gera o ficheiro que terá de descarregar e carregar manualmente.

Como descarregar o ficheiro

1. Abra a configuração do alojamento (Perfil → toque num quarto)
2. Na secção ISTAT, verifique se está selecionada a região correta
3. Toque no botão "Descarregar ficheiro ISTAT"
4. Selecione a data de início e a data de fim do período
5. Toque em "Gerar e descarregar ficheiro"
6. O ficheiro é gerado e pode partilhá-lo (e-mail, WhatsApp, guardar no sistema de ficheiros)

Formatos de ficheiro por região

Região	Formato	Onde o carregar
Úmbria	TXT (ROSS 1000, 338 caracteres/registo)	Turismatica
Friuli V.J.	TXT (ROSS 1000, 338 caracteres/registo)	WebTur
Apúlia	XML (SPOT, formato movimentogiornaliero-0.6.xsd)	www.dms.puglia.it (acesso SPID)