Este artigo explica como funciona a integração com Estatísticas do INE no dia a dia: as configurações necessárias, como os relatórios são gerados e enviados, e como diagnosticar e resolver os problemas mais comuns.
Antes de começar: Para instalar e ligar a aplicação à sua propriedade Cloudbeds, siga os passos descritos em Como ligar-se a Portugal – Relatórios Estatísticos (INE) primeiro..
Visão Geral
Em Portugal, os prestadores de serviços de alojamento são legalmente obrigados a apresentar relatórios estatísticos mensais ao INE (Instituto Nacional de Estatística) pelo portal webinq.ine.pt. Esta integração automatiza a geração e o envio desses relatórios diretamente a partir dos dados da sua propriedade no Cloudbeds.
Dados necessários do hóspede
Os relatórios do INE apresentam a distribuição mensal do número de hóspedes por país de origem, pelo que a integração depende da exatidão dos dados relativos aos hóspedes no seu PMS Cloudbeds. O campo seguinte é obrigatório para todos os hóspedes, para que a sua estadia seja incluída no relatório:
- País - País de origem do hóspede. Os hóspedes sem indicação de país são comunicados ao INE como de nacionalidade desconhecida, o que é permitido até um limite de 5% do número mensal de hóspedes. Se houver demasiados hóspedes sem este campo preenchido, o seu relatório poderá ser rejeitado pelo INE.
Garanta que a equipa da receção regista o país de origem do hóspede no momento do check-in ou da reserva. Pode verificar e atualizar esta informação no perfil do hóspede no PMS da Cloudbeds.
Envio de Relatório
Os relatórios são enviados mensalmente ao INE, e abrangem toda a atividade dos hóspedes no período selecionado.
Envio Automático
Assim que a integração estiver totalmente configurada e ativada, os relatórios são gerados e enviados automaticamente todos os meses. Não é necessária qualquer ação manual para a elaboração de relatórios de rotina.
Envio Manual
Se precisar de enviar ou reenviar um relatório relativo a um mês específico (por exemplo, para corrigir um erro ou enviar um relatório em atraso), utilize a secção Envio de relatório:
- Selecione o Ano no menu suspenso.
- Selecione o Mês no menu suspenso.
- Clique em Enviar Relatório.
A integração irá gerar e enviar o relatório relativo ao período selecionado diretamente para o INE.
Relatórios com erros
A secção de Relatórios com erros na parte inferior da página de definições lista todos os envios que não foram concluídos com sucesso. Cada mês em que a tentativa falhou aparece como uma entrada separada, com um botão Tentar novamente. Para reenviar, corrija primeiro o problema subjacente (como credenciais inválidas, falta do país do hóspede ou mapeamento de quartos incompleto), depois, clique no botão "Tentar novamente" desse mês diretamente nesta secção.
Resolução de Problemas
Ler mensagens de erro em Sincronizar integração
Quando a integração encontra um problema, envia uma mensagem para o registo de Sincronizar integração da sua propriedade, visível em:
Conta→ Serviços
→ Sincronização de Integração. Cada registo apresenta uma descrição, detalhes e a data em que ocorreu. A tabela abaixo apresenta as mensagens que poderá ver, com a sua causa e solução:
| Mensagem | Motivo | Correção |
|---|---|---|
| Não foram configuradas definições da aplicação | A integração não tem definições guardadas para esta propriedade | Abra a página de definições da integração e preencha todos os campos obrigatórios |
| Faltam as definições necessárias da aplicação | Um ou mais campos obrigatórios estão em branco (os nomes dos campos estão indicados nos detalhes) | Preencha os campos em falta na página de Definições |
| Não foi possível determinar o segmento da propriedade | A combinação do Código de Atividade Económica e do Código de Estabelecimento não é válida | Verifique se o seu código CAE e o código do estabelecimento correspondem ao seu registo no INE e às combinações válidas na tabela de classificação de estabelecimentos acima |
| Erro na validação das definições | Foi violada uma regra de negócio (por exemplo, falta a data de suspensão quando o estado está Suspenso) | O campo de detalhes indicará qual a regra que falhou — corrija a definição em questão e guarde |
| Faltam os mapeamentos dos tipos de quartos | Um ou mais tipos de quarto não têm o número de camas configurado | Isto é um aviso, não um erro que bloqueia o processo — o relatório continuará a ser enviado, mas deve adicionar o número de camas a todos os tipos de quartos |
| Falha na autenticação em INE | As credenciais do INE estão incorretas | Introduza novamente o seu código, a palavra-passe e a unidade na página de definições e utilize Testar credenciais para verificar |
| Acesso ao INE recusado | A sua conta no INE não está autorizada a carregar ficheiros XML | Contacte diretamente o INE para solicitar acesso ao carregamento de ficheiros XML para a sua conta |
| O serviço INE está temporariamente indisponível | O serviço web do INE estava indisponível no momento do envio | Não é necessário fazer nada — a integração voltará a tentar automaticamente |
| Relatório referente a [mês] enviado com sucesso ao INE | Envio bem-sucedido | Nenhuma ação necessária |
| Não foi possível gerar o relatório para [mês]. Contacte o apoio ao cliente da Cloudbeds para receber assistência. | Ocorreu um erro inesperado | Contacte o apoio ao cliente da Cloudbeds, indicando o mês em questão e o ID da propriedade |
O banner indica todos os campos obrigatórios em falta. Preencha todos os campos assinalados - Código , Palavra-passe , Unidade , Atividade económica , and Código do estabelecimento - e depois, guarde as suas definições. O aviso desaparecerá assim que todos os campos estiverem preenchidos.
- Verifique se o seu código, palavra-passe e unidade correspondem exatamente aos dados que utiliza para iniciar sessão em https://webinq.ine.pt.
- Verifique se a sua conta no INE está ativa e não está bloqueada.
- Confirme o identificador da sua unidade — não é o mesmo que o nome da sua propriedade; trata-se do identificador numérico atribuído ao seu estabelecimento pelo INE.
- Verifique se a integração aparece como Ativada na parte superior da página de definições.
- Verifique se todos os campos de configuração obrigatórios estão preenchidos e se o teste de credenciais é bem-sucedido.
Verifique a secção de Relatórios com erros para verificar se o envio foi tentado mas falhou, e analisar o erro associado.
O INE permite que até 5% dos visitantes mensais não tenham o país de origem registado. Se ultrapassar esse limite, o relatório poderá ser rejeitado. Verifique as reservas recentes no PMS da Cloudbeds, adicione o país que falta ao perfil de cada hóspede e reenvie o relatório desse mês com o botão Tentar novamente ou a ferramenta de envio manual.
Analise a mensagem de erro do relatório que falhou. As causas mais comuns incluem:
- Credenciais inválidas - Introduza novamente as suas credenciais do INE e verifique se funcionam.
- Classificação incorreta do estabelecimento - Verifique se o seu código de atividade económica e de estabelecimento corresponde ao seu registo no INE. Nem todos os códigos são válidos para todas as atividades económicas; consulte a tabela de mapeamento na secção Classificação de Estabelecimentos para confirmar se selecionou uma combinação válida.
- Há demasiados hóspedes de nacionalidade desconhecida - O INE permite que até 5% dos hóspedes não tenham o país de origem registado. Se esse limite for ultrapassado, o relatório poderá ser rejeitado. Atualize os perfis dos hóspedes no PMS da Cloudbeds para adicionar os países em falta e reenvie.
-
Mapeamento dos quartos em falta - Se a secção Capacidade de Alojamento não tiver tipos de quartos associados, o relatório não poderá ser gerado. Configure o número de camas de um tipo de quarto no mínimo e guarde.
Assim que o problema estiver resolvido, clique no botão Tentar novamente ao lado da entrada com erro na secção Relatórios com erros, ou utilize a ferramenta de envio manual para reenviar o mês em questão.
Perguntas Frequentes
Cada relatório abrange um mês civil de atividade dos hóspedes. A integração gera um relatório por mês, que é enviado após o encerramento do período.
Sim. Utilize a secção Envio de relatório, selecione o ano e o mês e clique em Enviar relatório. Isto também permite que reenvie um relatório corrigido, caso o envio anterior contivesse erros.
Atualize os campos de Código , Palavra-passe , e Unidade na secção Credenciais do INE e clique em Testar credenciais para confirmar se as novas credenciais funcionam antes do próximo ciclo de relatórios.
"Micro" refere-se às microempresas segundo a classificação portuguesa — normalmente estabelecimentos de dimensão muito pequena. Para a maioria dos tipos de alojamento não hoteleiro, existem duas opções: um código padrão (por exemplo, T para albergue) e uma variante micro (por exemplo, U para Hostel - Micro). Se não tiver a certeza de qual se aplica à sua propriedade, consulte os documentos oficiais de registo do INE ou contacte diretamente o INE.
Sim. Deve marcar a caixa de seleção Este estabelecimento funciona sazonalmente e definir o seu Estado da atividade como Atividade sazonal durante os períodos de inatividade. O INE continua a exigir um relatório mensal, mesmo que a taxa de ocupação seja nula
Continuam a constar no relatório, mas são contabilizados como de nacionalidade desconhecida. O INE permite que este valor atinja no máximo 5% dos seus hóspedes mensais — caso ultrapasse esse limite, o relatório poderá ser rejeitado. Se estiver a receber recusas, verifique as reservas recentes no PMS da Cloudbeds para ver se há hóspedes cujo país não está indicado, e atualize os seus perfis antes de voltar a enviar a solicitação.
A tipologia T é a norma portuguesa para classificar os apartamentos segundo o número de quartos (T0 = estúdio, T1 = 1 quarto, e assim sucessivamente). É obrigatório apenas para alojamento que não sejam hotéis (552xx). Se tiver dúvidas, consulte o registo oficial do INE da sua propriedade ou a documentação da autoridade turística local.
Comentários
Por favor, entre para comentar.