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 o envio de boletins de hóspedes para o SIBA, podem ocorrer problemas de ligação e ativação durante a configuração.

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

O que é o WebService do SIBA?

O WebService do SIBA (Sistema de Informação de Boletins de Alojamento) permite aos prestadores de alojamento automatizar o envio de informações de hóspedes estrangeiros para as autoridades portuguesas.

Em vez de introduzir manualmente os dados dos hóspedes no portal do SIBA, um software compatível pode enviar o boletim de alojamento de forma automática.

Isto ajuda os anfitriões a:

• Poupar tempo

• Reduzir erros manuais

• Evitar falhas nos envios

• Manter o registo de hóspedes organizado

Antes de Começar

Deve ter consigo:

• Morada completa da propriedade

• Número de telefone

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

• Número de quartos

• Tipo de propriedade (Apartamento / Moradia / Quarto)

• O seu número de NIF

• Município onde a propriedade está registada

Tudo isto pode ser consultado pesquisando no RNAL. Todos os Alojamentos Locais em Portugal estão lá listados.

Lembre-se:
Todos os hóspedes estrangeiros — incluindo cidadãos da UE — devem ser comunicados ao SIBA dentro do prazo legal.

Como enviar através do WebService do SIBA

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

Após a ativação, o seu software de alojamento pode enviar com segurança os dados de registo dos hóspedes diretamente para o SIBA utilizando as credenciais fornecidas. Isto permite envios mais rápidos, reduz o trabalho manual e ajuda a evitar falhas nos prazos de comunicação.

E se me registei com envio pelo Portal do SIBA?

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

De acordo com o suporte do SIBA, as credenciais existentes do portal também podem ser utilizadas para a comunicação por WebService assim que o método for ativado para a sua conta.

Isto significa que:

• O seu utilizador atual do SIBA e os dados de ativação permanecem válidos

• O seu estabelecimento de alojamento mantém-se o mesmo

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

Como altero o meu método do SIBA?

Para mudar, geralmente precisa de contactar o suporte do SIBA através de siba@ssi.gov.pt e solicitar que a sua conta seja ativada para envios por WebService. Uma vez aprovado, o seu fornecedor de software pode começar a realizar os envios automaticamente em seu nome.

Exemplo de E-mail para siba@ssi.gov.pt :

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 no WebService do SIBA

1. Chave de Ativação Inválida

Sintomas

• “Chave inválida”

• Falha na autenticação

• Impossibilidade de ativar a automatização

Causas Possíveis

• Copiar/colar incorreto

• Espaços adicionais

• Número de estabelecimento errado

• Chave antiga ou desativada

Como Resolver

• Copie a chave diretamente do SIBA

• Remova quaisquer espaços antes ou depois da chave

• Confirme se o número de estabelecimento está correto

• Tente primeiro iniciar sessão manualmente no SIBA

Se o início de sessão manual também falhar, o problema reside geralmente do lado do SIBA e não no seu software.

2. O Início de Sessão no Portal do SIBA Funciona, mas a Automatização Falha

A maioria das plataformas de software de AL — incluindo ferramentas como a Talkguest, AvaiBook e outros channel managers ou sistemas de automatização — não comunica com o SIBA de formas diferentes e individuais.

Em vez disso, dependem tipicamente de:

Um endpoint SOAP/XML do SIBA partilhado (camada de integração de web service) fornecido pelo governo.

Falha no Envio para o SIBA: Porque Poderá Ver “503 Service Unavailable” (Mesmo Quando os Seus Dados Estão Corretos)

Ao enviar boletins de hóspedes para o SIBA (sistema de comunicação de alojamento em Portugal), alguns anfitriões podem deparar-se com erros que parecem estar relacionados com os dados — mas que, na verdade, são causados por problemas temporários no sistema governamental.

Um caso comum é a falha no envio de SOAP/XML com o erro HTTP 503 Service Unavailable, que pode parecer um erro técnico de leitura (parsing) dentro do seu software.

O que acontece na realidade

Num fluxo de envio normal, o seu sistema envia um pedido estruturado em XML/SOAP para o endpoint de produção do SIBA:

https://siba.ssi.gov.pt/baws/boletinsalojamento.asmx

Em condições normais, o SIBA responde com uma confirmação XML válida ou um erro de validação estruturado.

No entanto, durante interrupções do serviço, o sistema pode devolver uma página de HTML de “Service Unavailable” em vez de XML, tal como:

• HTTP 503 Service Unavailable

• Página de erro em texto simples HTML em vez de resposta SOAP

• Inoperacionalidade temporária do sistema do lado do SIBA

O que deve fazer enquanto anfitrião

Se se deparar com esta situação:

1. Não volte a submeter nem duplique o envio imediatamente

2. Aguarde e permita que o sistema tente novamente de forma automática (se utilizar um software de automatização)

3. Se o problema persistir, envie um e-mail diretamente para o suporte do SIBA para confirmar o estado do sistema. Utilize o e-mail siba@ssi.gov.pt para contactar o suporte técnico

Exemplo de e-mail:

PARA: siba@ssi.gov

ASSUNTO: Indisponibilidade do Web Service SIBA/AIMA - erro HTTP 503 {27088}

Exmos. Senhores,

Venho por este meio solicitar apoio relativamente ao Web Service SIBA/AIMA para submissão de boletins de alojamento.

Ao tentar aceder ao endpoint de produção:

https://siba.ssi.gov.pt/baws/boletinsalojamento.asmx

e também ao respetivo WSDL:

https://siba.ssi.gov.pt/baws/boletinsalojamento.asmx?WSDL

o serviço está a devolver:

HTTP/1.1 503 Service Unavailable

com a mensagem:

HTTP Error 503. The service is unavailable.

Dados para referência:

• Serviço: SIBA/AIMA Web Service

• Endpoint: https://siba.ssi.gov.pt/baws/boletinsalojamento.asmx

• Erro recebido: HTTP 503 Service Unavailable

• Tipo de resposta: text/html, em vez de SOAP/XML

Fico a aguardar a vossa confirmação.

Com os melhores cumprimentos,

Se o problema persistir

Se o SIBA continuar indisponível por um período prolongado:

• Se continuar por mais de 3 dias úteis, contacte novamente o SIBA

• Nessa altura, deve enviar por e-mail os dados de check-in dos hóspedes da propriedade para garantir o cumprimento da legalidade

Isto garante que as suas obrigações de comunicação de hóspedes continuam a ser cumpridas, mesmo durante falhas do sistema prolongadas.

3. Os Hóspedes Não Aparecem no SIBA

Causas Possíveis

• Formulário de hóspede incompleto

• Falta de dados de nacionalidade ou passaporte

• Incompatibilidade na data de envio

• Excedido o tempo de ligação à Internet (timeout) durante o envio

O que Verificar

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

• Confirme as datas de chegada e de partida

• Verifique se o campo da nacionalidade não está em branco

• Confirme se o envio do hóspede aparece no painel de controlo do seu software

Muitas falhas no envio são causadas por formulários de check-in de hóspedes incompletos.

4. Propriedade Errada Ligada

Isto pode acontecer se:

• Existirem várias propriedades na mesma conta

• Foi partilhado o link público de check-in errado

• Foi reutilizada uma configuração copiada de outra unidade

Solução

Cada propriedade deve utilizar o seu próprio link público de check-in de hóspedes e configuração do SIBA.

Verifique sempre:

• Nome da propriedade

• Registo de AL

• Número de estabelecimento

• Link público de hóspedes

antes de testar a automatização.

Lista Rápida de Validação do SIBA

Antes de ativar os envios automáticos, verifique o seguinte:

Lista de Verificação de Configuração do SIBA

Conta e Acesso

• Consigo iniciar sessão manualmente no portal do SIBA

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

• O meu número de estabelecimento coincide com o do SIBA

• O NIF da minha propriedade está correto

Dados dos Hóspedes

• A nacionalidade do hóspede está preenchida

• As datas de chegada e partida estão corretas

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

• O número de hóspedes coincide com o da reserva

Automatização

• Testei primeiro enviar um hóspede

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

• O envio aparece dentro do portal do SIBA

• A propriedade correta está ligada

Boas Práticas para Anfitriões de AL

A forma mais fácil de reduzir erros no SIBA é recolher as informações dos hóspedes antes da chegada utilizando um formulário digital de check-in dedicado.

Isto ajuda a:

• Reduzir a introdução manual de dados

• Melhorar a conformidade dos hóspedes

• Organizar os registos

• Automatizar os envios

• Reduzir o risco de atrasos na comunicação

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

Dica Final

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

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

2. O envio de um novo hóspede

3. A receção do e-mail de confirmação

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

Perguntas Frequentes

O que é o WebService do SIBA? Um método de ligação que permite a um software compatível enviar boletins de hóspedes estrangeiros ao SIBA de forma automática, em vez de realizar a introdução manual no portal.

Como ativo o envio por WebService? Solicite a ativação à equipa do SIBA/AIMA, quer durante o registo quer enviando um e-mail para siba@ssi.gov.pt. Uma vez ativado, o seu software poderá enviar diretamente os dados dos hóspedes.

Já utilizo o Portal do SIBA manualmente — preciso de uma nova conta? Não. De acordo com o suporte do SIBA, as suas credenciais de portal já existentes podem ser utilizadas para a comunicação por WebService assim que o método estiver ativado. O seu estabelecimento e utilizador mantêm-se iguais; muda apenas o método de comunicação.

Que informações devo ter prontas antes da configuração? Morada completa da propriedade, número de telefone, capacidade de hóspedes, número de quartos, tipo de propriedade, o seu NIF e o município de registo — tudo consultável através do seu registo de RNAL.

Automatize os seus Envios para o SIBA com a EazyAL

A EazyAL ajuda os anfitriões portugueses de AL a:

• Recolher dados dos hóspedes digitalmente

• Organizar os check-ins

• Automatizar os envios para o SIBA

• Acompanhar as obrigações da taxa turística

• Simplificar os processos de conformidade legal

Comece com um link de check-in de hóspedes gratuito e faça o upgrade para envios automáticos para o SIBA quando estiver preparado.