Web abstract

SIBA Guia de resolução de problemas do WebService para anfitriões de Alojamento Local


Se gere um Alojamento Local (AL) em Portugal e está a tentar automatizar a comunicação de hóspedes para a SIBA, podem ocorrer por vezes problemas de ligação e ativação durante a configuração.

Este guia explica os problemas mais comuns do WebService da SIBA, como validar as suas credenciais e o que verificar antes de ativar a automatização.


O que é o WebService da SIBA?

O WebService da SIBA (Sistema de Informação de Boletins de Alojamento) permite que os fornecedores de alojamento automatizem a submissão das informações dos hóspedes estrangeiros às autoridades portuguesas.

Em vez de introduzir manualmente os dados dos hóspedes no portal SIBA, software compatível pode submeter automaticamente o boletim de alojamento.

Isto ajuda os anfitriões a:

  • Poupar tempo

  • Reduzir erros manuais

  • Evitar submissões em falta

  • Manter organizada a comunicação de hóspedes


Antes de Começar

Deve ter:

  • Morada completa do alojamento

  • Número de telefone

  • Capacidade de hóspedes (máximo de hóspedes)

  • Número de quartos

  • Tipo de alojamento (Apartamento / Casa / Quarto)

  • O seu número de NIF

  • Concelho onde o alojamento está registado

Isto pode ser encontrado procurando no RNAL. Todos os Alojamentos Locais em Portugal estão listados lá.

Lembre-se:
Todos os hóspedes estrangeiros — incluindo cidadãos da UE — têm de ser comunicados à SIBA dentro do prazo legal.


Como submeter através do WebService da SIBA

Para utilizar o método WebService da SIBA, primeiro tem de solicitar a ativação junto da equipa da SIBA/AIMA. Isto pode ser feito durante o registo ou por e-mail para siba@ssi.gov.pt. Depois de ativado, o seu software ou plataforma de gestão de alojamento pode comunicar diretamente com a SIBA de forma automática, sem necessitar de submissões manuais através do portal.

Após a ativação, o software de alojamento pode enviar com segurança os dados de registo dos hóspedes diretamente para a SIBA usando as credenciais fornecidas. Isto permite submissões mais rápidas, reduz o trabalho manual e ajuda a evitar prazos de comunicação em falta.


E se me registei com submissão no Portal SIBA?

Se atualmente submete os dados dos hóspedes manualmente através do Portal SIBA, não precisa de criar uma conta totalmente nova para passar para a submissão via WebService.

Segundo o apoio da SIBA, as credenciais existentes do portal também podem ser usadas para comunicação via WebService depois de o método ser ativado na sua conta.

Isto significa:

  • O seu nome de utilizador SIBA e os detalhes de ativação atuais continuam válidos

  • O seu estabelecimento de alojamento permanece o mesmo

  • Apenas o método de comunicação muda de Portal para WebService

Para mudar, normalmente tem de contactar o apoio da SIBA em siba@ssi.gov.pt e pedir que a sua conta seja ativada para submissões via WebService. Depois de aprovado, o seu fornecedor de software pode começar a enviar submissões automaticamente em seu nome.

Exemplo de e-mail:

Exmos. Senhores,

Venho por este meio solicitar a alteração do método de comunicação para Web Service da seguinte conta SIBA:

  • Username / NIF:

  • Estabelecimento:

  • Nº AL:

Agradeço, por favor, que a conta passe a estar configurada para utilização via Web Service.

Fico ao dispor para qualquer informação adicional necessária.

Com os melhores cumprimentos,


Problemas comuns do WebService da SIBA

1. Chave de ativação inválida

Sintomas

  • “Chave inválida”

  • Falha na autenticação

  • Não é possível ativar a automatização

Possíveis causas

  • Cópia/colagem incorreta

  • Espaços extra

  • Número de estabelecimento errado

  • Chave antiga ou desativada

Como resolver

  • Copie a chave diretamente da SIBA

  • Remova os espaços antes ou depois da chave

  • Confirme que o número do estabelecimento está correto

  • Tente primeiro iniciar sessão na SIBA manualmente

Se o início de sessão manual também falhar, o problema costuma estar do lado da SIBA e não do seu software.

2. O início de sessão no Portal SIBA funciona, mas a automatização falha

Possíveis causas

  • WebService não ativado

  • Credenciais associadas incorretas

  • Problema temporário no servidor da SIBA

Verificações recomendadas

  • Confirme que o NIF do alojamento corresponde à conta da SIBA

  • Verifique o identificador do estabelecimento

  • Aguarde alguns minutos e tente novamente

  • Teste com uma nova submissão de hóspede

Por vezes, os servidores da SIBA têm lentidões temporárias ou períodos de manutenção.


3. Os hóspedes não estão a aparecer na SIBA

Possíveis causas

  • Formulário do hóspede incompleto

  • Faltam dados de nacionalidade/passaporte

  • Incompatibilidade na data da submissão

  • Timeout da internet durante a submissão

O que verificar

  • Assegure que todos os campos obrigatórios do hóspede estão preenchidos

  • Confirme as datas de chegada e partida

  • Verifique se a nacionalidade não está em branco

  • Verifique se a submissão do hóspede aparece no painel do seu software

Muitas submissões falhadas são causadas por formulários de check-in de hóspedes incompletos.

4. O alojamento errado está ligado

Isto pode acontecer se:

  • Existirem vários alojamentos na mesma conta

  • O link público de check-in errado foi partilhado

  • Uma configuração copiada de outra unidade foi reutilizada


Solução

Cada alojamento deve usar o seu próprio link único de check-in de hóspedes e a sua configuração SIBA.

Verifique sempre:

  • Nome do alojamento

  • Registo de AL

  • Número do estabelecimento

  • Link público de hóspede

antes de testar a automatização.

Lista rápida de validação da SIBA

Antes de ativar as submissões automáticas, verifique o seguinte:

Lista de verificação da configuração SIBA

Conta & acesso

  • Consigo iniciar sessão manualmente no portal SIBA

  • A minha chave de ativação está correta

  • O meu número de estabelecimento corresponde ao da SIBA

  • O NIF do meu alojamento está correto

Dados do hóspede

  • A nacionalidade do hóspede está preenchida

  • As datas de chegada e partida estão corretas

  • Os dados do passaporte ou do documento de identificação estão completos

  • O número de hóspedes corresponde à reserva

Automatização

  • Testei primeiro uma submissão de hóspede

  • Recebi um e-mail de confirmação da SIBA

  • A submissão aparece no portal SIBA

  • O alojamento correto está ligado

Melhor prática para anfitriões de AL

A forma mais fácil de reduzir erros na SIBA é recolher os dados dos hóspedes antes da chegada, usando um formulário digital de check-in dedicado.

Isto ajuda a:

  • Reduzir a introdução manual

  • Melhorar a conformidade dos hóspedes

  • Organizar registos

  • Automatizar submissões

  • Reduzir o risco de comunicação tardia

Muitos anfitriões incluem agora o link de check-in de hóspedes diretamente nas Mensagens Programadas da Airbnb ou na automatização de mensagens da Booking.com.

Dica final

Se a sua ligação à SIBA deixar subitamente de funcionar depois de ter funcionado corretamente, teste primeiro:

  1. Início de sessão manual na SIBA

  2. Uma nova submissão de hóspede

  3. Entrega do e-mail de confirmação

Em muitos casos, o problema é temporário e resolve-se sem necessidade de uma reconfiguração completa.

Automatize as suas submissões à SIBA com EazyAL

A EazyAL ajuda anfitriões de AL em Portugal:

  • Recolher os dados dos hóspedes digitalmente

  • Organizar os check-ins

  • Automatizar submissões à SIBA

  • Acompanhar obrigações de taxa turística

  • Simplificar fluxos de trabalho de conformidade

Comece com um link gratuito de check-in de hóspedes e faça upgrade para submissões automáticas à SIBA quando estiver pronto.

Know another Alojamento Local host who needs this?
Share this guide with another host.
WhatsAppFacebookLinkedIn
EazyAL helps Alojamento Local hosts automate SIBA, tourist tax and compliance workflows in Portugal.

Sobre o autor: O Daniel é engenheiro de software e anfitrião de Alojamento Local sediado na Madeira, Portugal. É o fundador da EazyAL, uma ferramenta concebida para simplificar o cumprimento das obrigações da SIBA, do INE e fiscais para anfitriões de alojamento de curta duração. O seu trabalho combina experiência prática de anfitrião com tecnologia para ajudar os anfitriões a manterem-se em conformidade e a reduzir o trabalho manual.

Autor Daniel de Oliveira

Sobre o autor: O Daniel é engenheiro de software e anfitrião de Alojamento Local sediado na Madeira, Portugal. É o fundador da EazyAL, uma ferramenta concebida para simplificar o cumprimento das obrigações da SIBA, do INE e fiscais para anfitriões de alojamento de curta duração. O seu trabalho combina experiência prática de anfitrião com tecnologia para ajudar os anfitriões a manterem-se em conformidade e a reduzir o trabalho manual.