Guia das Integrações

Como obter os códigos necessários para ligar o seu alojamento aos serviços Alloggiati Web, ISTAT e PayTourist

Alloggiati Web Portal da Questura - Envio das fichas de hóspedes

O Alloggiati Web é o portal da Polizia di Stato para a comunicação obrigatória dos dados de identificação dos hóspedes no prazo de 24 horas após o check-in. Para ligar o Vezpa ao serviço, são necessárias credenciais de acesso através de Web Service (WS).

Códigos necessários

Campo Descrição
Username WS Nome de utilizador para o Web Service (diferente do início de sessão no portal)
Password WS Palavra-passe dedicada ao Web Service
Token WS Token de autenticação para as chamadas automáticas

Como obtê-los

  1. Aceda ao portal Alloggiati Web com as credenciais fornecidas pela Questura da sua província: alloggiatiweb.poliziadistato.it (abre num novo separador)
  2. Uma vez dentro, vá à secção «Tabelle» no menu principal e depois selecione «Gestione WS» (Web Service).
  3. Se ainda não tiver as credenciais WS, clique em «Genera credenziali». O sistema criará automaticamente Username, Password e Token.
  4. Copie os três valores (Username WS, Password WS, Token WS) e introduza-os na secção Integrações > Alloggiati da configuração do quarto no Vezpa.
Atenção: As credenciais WS são diferentes das credenciais de acesso ao portal. Se não encontrar a secção «Gestione WS», contacte a Questura da sua província para pedir a ativação do Web Service.
O Token WS tem uma validade periódica. Quando expirar, terá de o gerar novamente no portal e atualizá-lo no Vezpa. Enviar-lhe-emos uma notificação em caso de erros de envio.

ISTAT - Fluxos Turísticos Inquérito estatístico do movimento de clientes

O ISTAT exige aos estabelecimentos de alojamento o envio periódico dos dados estatísticos sobre os hóspedes (chegadas, dormidas, partidas). Cada região italiana tem o seu próprio sistema. O Vezpa suporta 19 regiões com envio automático ou geração de ficheiro.

Regiões suportadas

RegiãoSistemaEnvioCredenciais
Piemonte, Toscana, Ligúria, Abruzos, Veneto, Emília-Romanha, Lombardia, Calábria, BasilicataTurismo5AutomáticoUtilizador, Palavra-passe, Código
Marcas, Sardenha, Lácio, MoliseRoss1000AutomáticoUtilizador, Palavra-passe, Código
SicíliaOsservatorio TuristicoAutomáticoUserId, Password, HotelCode
CampâniaSinfonia SMARTAutomáticoCUSR, API Key
TrentinoDTU (Trentino Digitale)AutomáticoUtilizador, Palavra-passe, ID do Alojamento
ÚmbriaTurismaticaFicheiro para descarregarCódigo do Alojamento
Friuli-Venécia JúliaWebTurFicheiro para descarregarCódigo do Alojamento
Vale de AostaVIT Albergatori (INVA)AutomáticoUtilizador, Palavra-passe, ID do Alojamento

Turismo5 / Ross1000 (13 regiões) — Envio automático

A maioria das regiões utiliza o protocolo Turismo5 ou a plataforma Ross1000. O envio é totalmente automático.

  1. Contacte o posto de turismo ou a APT da sua província ou da sua região.
  2. Peça as credenciais de acesso ao portal Ross1000/Turismo5 para o seu alojamento.
  3. O código do alojamento está visível no painel do portal regional depois de iniciar sessão.
  4. Introduza Utilizador, Palavra-passe e Código do Alojamento na configuração do quarto no Vezpa, selecionando a sua região no menu pendente.

Sicília — Osservatorio Turistico Regionale — Envio automático

A Sicília utiliza um sistema próprio. As credenciais devem ser pedidas por e-mail.

  1. Envie um e-mail para [email protected] a pedir a ativação de um perfil «PMS User» para o seu alojamento.
  2. Receberá: UserId, Password e HotelCode (por ex. TRS-IT-SIC-00004).
  3. No Vezpa, selecione Sicília no menu da região e introduza os três valores nos campos correspondentes.
As credenciais da Sicília são diferentes das da Questura e das credenciais ISTAT de outras regiões. O perfil «PMS User» destina-se ao envio automático a partir de software de gestão.

Campânia — Sinfonia Turismo SMART — Envio automático

A Campânia utiliza a plataforma Sinfonia SMART com autenticação através de CUSR e API Key.

  1. Aceda ao portal Sinfonia Turismo SMART com SPID: turismo.regione.campania.it (abre num novo separador)
  2. Na secção das definições, obtenha o CUSR (Codice Unico Struttura Ricettiva, o código único do alojamento) e gere uma API Key.
  3. No Vezpa, selecione Campânia no menu da região. Os campos adaptam-se automaticamente: introduza o CUSR e a API Key nos campos indicados.
O CUSR é o código regional do alojamento (formato: 15123123ALBXXXX). A API Key é uma chave UUID que pode ser gerada no portal Sinfonia SMART.

Trentino — DTU (Trentino Digitale) — Envio automático

A Província de Trento utiliza o sistema DTU com um web service dedicado. As credenciais são as mesmas do portal STU.

  1. Aceda ao portal STU: www.stu.provincia.tn.it (abre num novo separador) com as credenciais do seu alojamento.
  2. Peça a ativação do web service ao Servizio Turismo da Província, preenchendo o respetivo formulário (disponível na secção dos softwares de gestão do portal).
  3. Obtenha o ID do alojamento (IDOBJ Esercizio, visível na secção «Inserimento movimentazione giornaliera C59 > da file»).
  4. No Vezpa, selecione Trentino no menu da região e introduza Utilizador, Palavra-passe e ID do Alojamento.
As credenciais são as mesmas que utiliza para aceder ao portal STU. O ID do alojamento é um número (por ex. 1212051), NÃO um código alfanumérico.

Vale de Aosta — VIT Albergatori — Envio automático

A Região Autónoma do Vale de Aosta utiliza o sistema VIT Albergatori gerido pela INVA. O envio é totalmente automático.

  1. Peça as credenciais de acesso ao serviço através do Office du Tourisme da sua zona ou contactando a Região.
  2. Receberá por e-mail: Utilizador, Palavra-passe e ID do Alojamento (um número, por ex. 9005709).
  3. No Vezpa, selecione Vale de Aosta no menu da região e introduza as credenciais recebidas.
Pode verificar os dados transmitidos acedendo ao portal regional com as mesmas credenciais. Os dados têm de ser confirmados mensalmente através do fecho C59-M no portal.

Úmbria e Friuli-Venécia Júlia — Descarregamento do ficheiro

Para estas regiões o Vezpa gera automaticamente o ficheiro no formato exigido pelo portal regional. O diretor descarrega-o na aplicação e carrega-o manualmente.

  1. Selecione Úmbria ou Friuli-Venécia Júlia no menu da região na configuração do quarto.
  2. Introduza o Código do Alojamento atribuído pela região.
  3. Na secção Integrações, descarregue o ficheiro ISTAT referente ao período pretendido.
  4. Carregue o ficheiro no portal regional: Turismatica para a Úmbria (turismatica.regione.umbria.it (abre num novo separador)) ou WebTur para o Friuli-Venécia Júlia (servizistatistici.regione.fvg.it/webtur (abre num novo separador)).
Se a sua região não estiver na lista (Apúlia, Alto Ádige), contacte-nos: estamos a acrescentar progressivamente o suporte para todas as regiões italianas.

PayTourist Gestão e cobrança da taxa turística

O PayTourist é a plataforma que muitos municípios italianos utilizam para a gestão da taxa turística. Ao ligar o Vezpa ao PayTourist, as declarações são enviadas automaticamente em cada checkout.

Códigos necessários

Campo Descrição
Código do Alojamento Código único atribuído pelo PayTourist ao seu alojamento
API Key Chave de autenticação para as comunicações automáticas

Como obtê-los

  1. Verifique se o seu município utiliza o PayTourist para a gestão da taxa turística. Pode confirmá-lo no site do município ou contactando a repartição de finanças municipal.
  2. Aceda ao portal PayTourist com as credenciais fornecidas pelo seu município: www.paytourist.com (abre num novo separador)
  3. Na secção «Definições» ou «Perfil do Alojamento» encontrará o Código do Alojamento atribuído.
  4. Para obter a API Key, procure na secção «Integrações» ou «API» do portal PayTourist. Se não a encontrar, contacte o suporte do PayTourist ou a repartição de finanças do seu município para pedir a ativação das API.
  5. Introduza o Código do Alojamento e a API Key na secção Integrações > PayTourist da configuração do quarto no Vezpa.
Nota: Nem todos os municípios italianos utilizam o PayTourist. Alguns usam plataformas alternativas ou não têm taxa turística. Confirme com o seu município qual é o sistema em uso.

Precisa de ajuda?

Se tiver dificuldade em obter os códigos ou dúvidas sobre a configuração, a nossa equipa está à sua disposição.

Contacte-nos