Pular para o conteúdo
Português
Mais suporte
Chekin website
  • Não há sugestões porque o campo de pesquisa está em branco.

Como ligar o PayTourist

Introdução

Através do portal PayTourist do seu município, pode registar o seu alojamento, listá-lo e gerir tanto o pagamento como a declaração da taxa turística (imposta di soggiorno).

Esta integração foi concebida especificamente para todos os gestores de alojamentos em Itália, desde anfitriões individuais com uma única propriedade até grandes cadeias hoteleiras, que são obrigados a declarar as estadias dos hóspedes e a comunicar a respetiva taxa turística.

Se gere propriedades num dos municípios abrangidos pela rede PayTourist, este serviço foi pensado para lhe facilitar a vida.

Porquê usar esta funcionalidade?

Para gestores de propriedades e hoteleiros em Itália, gerir a taxa turística é uma obrigação legal complexa e que consome muito tempo. Tratar os dados dos hóspedes, calcular com precisão os montantes da taxa e enviar atempadamente os relatórios às autoridades locais pode ser um encargo administrativo contínuo.

A Chekin tem o orgulho de anunciar a sua integração oficial com o PayTourist, a principal plataforma em Itália para a gestão da taxa turística.

Esta poderosa ligação elimina a introdução manual de dados, garante o cumprimento legal total e devolve-lhe o bem mais valioso de todos: o seu tempo.

IMPORTANTE:
A lista de municípios disponíveis para esta integração pode ser consultada aqui:
https://assistenza.paytourist.com/hc/it/articles/4455534383634-Elenco-Comuni-PayTourist

Principais funcionalidades

Esta integração é mais do que uma simples ligação de dados: inclui funcionalidades inteligentes pensadas para casos de uso reais:

1) Gestão automática de isenções

O nosso sistema identifica automaticamente os hóspedes que estão isentos do pagamento da taxa turística.
Se um hóspede tiver menos de 14 anos ou mais de 80, o sistema assinala-o e aplica a isenção correta diretamente no PayTourist, garantindo que nunca são aplicadas cobranças incorretas ou imprecisas.

2) Prolongamentos de estadia sem esforço

Se um hóspede prolongar a estadia, não precisa de fazer nada.
O sistema deteta automaticamente a alteração, trata-a como um novo período de estadia e envia a informação atualizada para o PayTourist na transmissão diária seguinte.

3) Relatórios transparentes e acompanhamento do estado

Tal como na funcionalidade de comunicação policial, cada transmissão de dados para o PayTourist fica registada e visível diretamente no seu painel Chekin.
Pode ver exatamente quando foram enviados os dados de cada reserva, verificar o estado da confirmação e aceder aos recibos em PDF emitidos pelas autoridades, o que lhe dá rastreabilidade total sobre todas as operações.

4) Centralizado e seguro

Todas as comunicações são geridas através da Chekin, proporcionando uma fonte de informação única e fiável.
Os seus dados são transmitidos de forma segura via API, utilizando os protocolos de integração oficiais do PayTourist, garantindo integridade e conformidade em cada passo.

Como ligar o PayTourist na Chekin

Como gerar o seu API Token do PayTourist para a integração com a Chekin

Para ligar o PayTourist via API, tem primeiro de gerar um token de acesso pessoal.
Este token funciona como uma chave de segurança que permite à Chekin enviar os dados dos seus hóspedes diretamente para o PayTourist.

➡️ Página de início de sessão: https://paytourist.zendesk.com/auth/v2/login/signin

Siga estes passos com atenção para criar e configurar corretamente o seu token.

IMPORTANTE: O token tem de ser gerado por um utilizador do tipo “Booking User” (Utente Booking).
Antes de começar, certifique-se de que iniciou sessão no PayTourist com a sua conta de administrador.

Passo 1) Aceder à secção API Access Token

Há duas formas (Método A ou Método B) de aceder ao ecrã de gestão de tokens.

Método A: através das definições do perfil

  1. Inicie sessão na sua conta PayTourist.

  2. Na barra verde superior, à direita, clique no nome da sua conta para abrir “Profile Info.”

  3. Por baixo da imagem do seu perfil, selecione “API Access Token.”



Método B: através do menu “Users”

  1. No menu principal à esquerda, aceda à secção Users.

  2. Encontre o utilizador “Booking User” para o qual pretende criar o token.

  3. Clique em Edit para esse utilizador.
    Chegará ao mesmo ecrã de gestão de tokens.

Passo 2) Criar um novo token

No ecrã de gestão de tokens, verá uma lista dos tokens já criados.

  1. Clique em “+ Create New Token.”

  2. Introduza um nome claro e descritivo, por exemplo, PMS_Integration_Token.

  3. Clique no botão para confirmar e criar o token.

Passo 3) Guardar o seu token em segurança

⚠️ Atenção: Este é o passo mais importante.

  1. O sistema mostrará agora o seu novo token de acesso pessoal.
    Esta é a única vez que o token completo será mostrado.

  2. Copie cuidadosamente todo o texto do token.

  3. Cole-o num documento de texto seguro, certificando-se de que não há espaços extra antes ou depois e de que nada é alterado.

  4. Vai precisar deste token para configurar a ligação no seu painel Chekin.

IMPORTANTE:
Se perder este token, não é possível recuperá-lo.
Terá de gerar um novo seguindo novamente estes passos.
Recomenda-se eliminar os tokens antigos ou não utilizados para manter um nível de segurança elevado.

Passo 4) Associar o token ao software

Criar o token não basta: tem de o associar ao software correto para ativar a transmissão de dados.

  1. Volte ao perfil do Booking User.

  2. Encontre a secção de associação de software.

  3. No menu pendente dos fornecedores disponíveis, selecione “Chekin.”

  4. Clique em Save (normalmente no canto inferior direito) para aplicar as alterações.

Gestão do token: expiração e renovação

Validade: Cada token é válido durante 12 meses.

Lembrete de expiração:
Antes de o token expirar, o PayTourist enviar-lhe-á um lembrete por email para que tenha tempo de gerar um novo sem interrupção do serviço.

Renovação:
Para evitar interrupções, crie proativamente um novo token e elimine o antigo antes de expirar.
Depois de gerar o novo token, atualize as definições da integração na Chekin com o novo código para garantir uma transição tranquila e sem erros.

Nota:
O Access Token é específico de cada alojamento (anfitrião) e tem de ser gerado por um utilizador da conta PayTourist dessa propriedade.
“O access token é válido durante 12 meses e tem de ser gerado por um utilizador ‘Booking’ no PayTourist.”
Este utilizador “Booking” corresponde a uma conta no portal PayTourist da propriedade de alojamento específica.

Como encontrar o Room ID

O partner_room_id é o identificador único atribuído a cada quarto no seu sistema de gestão de propriedades.
Este ID é utilizado ao enviar os dados das reservas para o PayTourist.

Para o encontrar:

  1. Aceda à página “Rooms” a partir do seu painel principal.

  2. Localize o quarto cujo ID pretende obter.

  3. O Room ID (partner_room_id) aparecerá na coluna dedicada ou nos detalhes do quarto.

💡 Dica: Mantenha uma lista atualizada dos seus Room IDs; isto ajudá-lo-á a verificar se os dados enviados para o PayTourist correspondem sempre aos quartos corretos.


Depois, copie apenas o número do seu Object (XXX #__).


Envio de dados para o PayTourist

Os dados são enviados automaticamente todos os dias às 12:00 PM (UTC) para todas as reservas cujo check-in ocorreu no dia anterior.

Exemplo:
Se uma reserva tiver a data de check-in a 20 de maio, os seus dados serão enviados para o PayTourist a 21 de maio às 12:00 PM UTC.

Para qualquer dúvida ou assistência adicional, não hesite em contactar a nossa equipa através de:
📩 support@chekin.com