Hospedagem - Relatório de Custos

O que é

O Relatório de Custos é a página do módulo Hospedagem que consolida, em um único lugar, o valor gasto com cada hospedagem vinculada às excursões da sua empresa. A página soma o custo_total de cada vínculo excursão-hospedagem (modelo ExcursaoHospedaria) e calcula automaticamente três métricas: custo total no período, custo médio por excursão e custo médio por passageiro alocado em quartos.

O usuário normalmente chega aqui depois de cadastrar hospedagens e vinculá-las às excursões. É a tela usada por proprietário, gerente e financeiro para validar precificação, comparar fornecedores e identificar desvios em relação ao orçamento planejado da viagem.

Como usar

1. No sidebar, abra Módulos > Hospedagem > Custos. A URL é /admin/hospedagem/relatorios/custos.
2. No bloco de filtros (logo abaixo do cabeçalho), ajuste Período:
   • Próximas - somente excursões cuja data de início é hoje ou futura (valor padrão).
   • Passadas - somente excursões cuja data de início já passou.
   • Todas - sem filtro de data.
3. Opcionalmente, use o campo Hospedagem para restringir a uma hospedaria específica. Deixe em branco para ver todas.
4. A página recarrega automaticamente ao mudar qualquer filtro (não existe botão "Aplicar").
5. Analise os quatro KPIs no topo:
   • Custo Total - soma do custo_total de todas as hospedagens do filtro.
   • Custo Médio / Excursão - custo total dividido pelo número de excursões com hospedagem.
   • Custo / Passageiro - custo total dividido pelo total de passageiros alocados em quartos.
   • Total de Passageiros - quantos passageiros estão efetivamente alocados em quartos no período.
6. Na tabela Custos por Excursão, confira linha a linha: excursão, data de início, hospedaria, custo total, número de passageiros e custo por passageiro daquela excursão específica. O rodapé repete os totais.

Casos especiais

Hospedagem cancelada

Vínculos com status = 'cancelado' são automaticamente ignorados pelo relatório. Se você cancelou uma hospedagem por engano, reative-a na listagem para que volte a aparecer nos custos.

Excursão sem passageiros alocados

Se a excursão ainda não tem passageiros distribuídos em quartos, o custo por passageiro daquela linha fica em R$ 0,00. O custo total continua sendo contabilizado normalmente. Faça a alocação na página de quartos para que a métrica fique correta.

Custo total zerado

O campo somado é o custo_total do vínculo entre excursão e hospedaria. Se ele estiver vazio ou em zero, edite o vínculo na página de detalhes da excursão (aba Hospedagem) e informe o valor negociado com o fornecedor.

Múltiplas hospedagens na mesma excursão

Se uma excursão tem mais de uma hospedaria vinculada (ex.: dois hotéis em cidades diferentes), cada vínculo aparece como uma linha separada no relatório. O custo total da excursão é a soma dessas linhas.

Erros comuns e como resolver

• "Nenhum dado encontrado" - Causa: o filtro de período ou de hospedagem não retorna nenhum vínculo ExcursaoHospedaria ativo. Solução: troque o período para Todas, limpe o filtro de hospedagem ou vincule hospedagens às excursões antes de gerar o relatório.
• Custo total muito menor que o esperado - Causa: vínculos sem custo_total preenchido. Solução: abra cada excursão sem custo e preencha o valor na aba Hospedagem.
• Acesso negado ao abrir a página - Causa: usuário sem a permissão de ver a hospedagem ou empresa sem o módulo Hospedagem ativo. Solução: pedir ao Proprietário para conceder a permissão e/ou ativar o módulo Hospedagem em Configurações > Módulos.
• Página não aparece no menu - Causa: o módulo Hospedagem está inativo para você ou o item de menu modulos.hospedagem foi ocultado. Solução: ativar o módulo e verificar a configuração de menu.

Onde encontrar

• URL: /admin/hospedagem/relatorios/custos
• Caminho no menu: Módulos > Hospedagem > Custos
• Permissão necessária: ver a hospedagem
• Módulo necessário: Hospedagem

Veja também

• Relatório de Ocupação - Acompanha a taxa de ocupação dos quartos para entender se o custo está sendo bem aproveitado.
• Listagem de Hospedagens - Cadastro das hospedarias que alimentam este relatório.
• Alocação de Quartos - Distribuição dos passageiros em quartos, base do cálculo de custo por passageiro.