Taxa turística do Funchal: reconciliar o PMS antes do dia 15

Todos os meses repete-se o mesmo. Chega o dia 12 ou 13 e alguém na receção ou na contabilidade tira um relatório do PMS, abre-o numa folha de cálculo e tenta perceber porque é que o número de dormidas taxáveis não bate com o que foi faturado. Há um hóspede que mudou de quarto a meio da estadia, uma família com dois miúdos, um casal do Porto Santo que disse ser residente, uma reserva de dez noites que começou em agosto. No fim declara-se o que parece razoável e segue-se em frente, porque o dia 15 está aí e o hotel não para.

A taxa de setembro declara-se até 15 de outubro. Faltam 17 dias. Este artigo explica porque é que esse número falha quase sempre nos mesmos sítios, como se reconcilia a partir das estadias reais do teu PMS sem mexer em nada, e porque é que isto é um trabalho para um sistema fundado nos teus dados e não para um chatbot.

A regra é simples. Os dados é que não são

O regulamento municipal do Funchal (Regulamento n.º 764/2024) é curto: €2 por noite, por hóspede com 13 anos ou mais, até um máximo de 7 noites seguidas. Os residentes na Região Autónoma da Madeira estão isentos. O valor do mês é declarado eletronicamente até ao dia 15 do mês seguinte, e o regulamento prevê uma comissão de cobrança de 2,5% para quem cobra.

Cabe numa linha de código. O problema é que o PMS não guarda "estadias" como o regulamento as entende. Guarda reservas, quartos, noites e faturas. E há quatro sítios onde estas duas visões se afastam:

1. Mudança de quarto. O hóspede fica dez noites, mas ao terceiro dia passa para um quarto com vista de mar. Em muitos PMS isto cria duas reservas, uma de 3 noites e outra de 7. O teto das 7 noites aplica-se a cada uma, e cobras 10 noites em vez de 7.
2. Estadias que atravessam o mês. Uma reserva de 25 de setembro a 5 de outubro tem 6 noites em setembro e 4 em outubro. Pelo teto, só 1 dessas 4 é taxável. Se o relatório de outubro contar as noites do zero, cobras 4.
3. Idades e residência. A idade da criança fica numa nota da reserva, ou nem fica. A residência na RAM é declarada ao balcão e raramente fica ligada a um documento. Se um dia te pedirem para justificar uma isenção, precisas de saber onde está essa prova.
4. No-shows e cancelamentos tardios. A reserva é faturada por penalização e a linha da taxa vai atrás, mas a taxa incide sobre dormidas, e uma noite que não aconteceu não é uma dormida.

Nenhum destes casos é exótico. Num hotel de 40 quartos em setembro, acontecem todas as semanas.

Um exemplo trabalhado

Vamos pôr números num hotel de 40 quartos. Os números são ilustrativos, mas a estrutura é a de um mês real.

Em setembro, o PMS regista 2.310 noites-hóspede. Aplicando a regra estadia a estadia, e não reserva a reserva:

• 190 noites são de menores de 13 anos → isentas;
• 85 noites são de residentes na RAM → isentas;
• 140 noites ultrapassam a 7.ª noite da estadia → não taxáveis.

Ficam 1.895 noites taxáveis, ou seja €3.790.

Agora o que foi efetivamente faturado ao longo do mês, somando as linhas de taxa nas faturas: €3.946, o equivalente a 1.973 noites. A diferença são 78 noites, e a reconciliação diz exatamente de onde vêm:

| Origem | Noites | Valor |
|—|—|—|
| 11 estadias com mudança de quarto (teto aplicado duas vezes) | 46 | €92 |
| 9 estadias vindas de agosto (teto recomeçado em setembro) | 24 | €48 |
| 3 no-shows faturados com taxa | 8 | €16 |
| Total cobrado a mais | 78 | €156 |

E há uma quarta linha que não é dinheiro cobrado a mais, mas é exposição: 4 hóspedes marcados como residentes sem documento associado, 12 noites, €24. Não quer dizer que estejam mal. Quer dizer que, se alguém perguntar, hoje não tens como provar.

€156 num mês não afunda um hotel. Mas são €156 cobrados a hóspedes que não os deviam, e que alguém vai ter de explicar ao hóspede, ao contabilista ou à Câmara. Somados a um ano, com a época alta pelo meio, são um número que vale a pena conhecer antes de declarar e não depois.

O que o sistema faz, e o que não faz

A reconciliação lê três fontes: as estadias no PMS (hóspedes, datas, quartos, idades, residência), as linhas de taxa nas faturas do teu software de faturação e o valor que vais declarar. Junta as reservas que pertencem à mesma estadia (mesmo hóspede, noites contíguas, mudança de quarto), aplica a regra do regulamento a cada estadia e mostra as diferenças, uma a uma, com o número da reserva e da fatura.

O que não faz: não escreve no PMS, não emite notas de crédito e não submete nada no portal da Câmara. O acesso é read-only. Cada consulta fica registada em log (quem perguntou, quando, que dados foram lidos), para que a reconciliação de setembro possa ser reproduzida em março se for preciso. Quem corrige e declara é a tua equipa, com a lista na mão.

Onde entra a IA, e porque não é um chatbot

A regra da taxa não precisa de IA. É código determinístico, escrito e testado, porque um cálculo fiscal não pode depender de um modelo que umas vezes acerta e outras não.

A IA entra na conversa. O diretor do hotel não quer abrir uma tabela. Quer perguntar no WhatsApp "quanto declaro em setembro e o que é que não bate?" e receber a resposta: €3.790, 78 noites de diferença, a lista das 11 mudanças de quarto e os 4 residentes sem documento. O modelo de linguagem traduz a pergunta para a consulta certa e explica o resultado. Não inventa valores, porque cada número da resposta vem de uma consulta aos teus dados e leva consigo a referência da reserva.

Um chatbot genérico faz o contrário. Sabe recitar o regulamento, mas não sabe que o quarto 214 teve duas reservas para o mesmo hóspede. E quando não sabe, adivinha.

As objeções que ouvimos

"O meu PMS já calcula a taxa." Calcula por reserva, que é diferente de calcular por estadia. Os quatro casos acima são exatamente aqueles em que o cálculo por reserva falha. Se o teu PMS os trata todos bem, a reconciliação mostra zero diferenças e ficas com a prova disso guardada, o que também tem valor.

"Isto faz-se numa folha de cálculo." Faz-se, uma vez. A folha não junta estadias partidas, não sabe que uma reserva começou no mês anterior e depende de quem a montou estar cá no dia 13. O sistema faz o mesmo raciocínio todos os meses, da mesma maneira, e fica registado.

"As ferramentas de alojamento local já tratam da taxa." Tratam, e bem, para um AL com meia dúzia de unidades. Um hotel com PMS próprio, faturação separada e grupos precisa de cruzar as três fontes, não apenas de gerar a declaração.

"E os dados dos hóspedes?" Ficam onde estão. O sistema lê o mínimo necessário (datas, idades, residência, quartos) e cada leitura fica auditada. Não há cópia da base de hóspedes num serviço externo.

Porque é que isto é uma conversa das ilhas

A linha de financiamento de IA do PRR ficou reservada ao continente. As regiões autónomas tiveram a "Reindustrializar", já fechada, e a agenda regional de IA da Madeira, lançada a 17 de setembro, ainda está a preparar os apoios. A oferta de IA que chega hoje ao Funchal é sobretudo formação em prompts. É útil, mas não liga nada ao teu PMS.

A taxa turística é uma obrigação do Funchal, com regras do Funchal. É um bom primeiro caso precisamente por ser pequeno, mensal e verificável: ao fim de um mês sabes se o sistema acertou.

Próximo passo

Antes de 15 de outubro, envia-nos uma exportação de agosto e setembro do teu PMS e das faturas, ou dá-nos acesso só de leitura. Devolvemos a reconciliação dos dois meses, com a lista de diferenças e a origem de cada uma, a tempo de declarares setembro com números certos. Somos uma equipa pequena em Leiria e quem te responde é quem escreve o código: hello@leiritech.com · +351 914 572 595.