Gestão de Receitas

O Calendário de Receitas oferece uma visão visual das tarifas, ocupação e métricas de desempenho em todos os tipos de quarto e datas. É a principal ferramenta para gestores de receita monitorarem preços, aplicarem ajustes em massa e otimizarem a ocupação em tempo real.

Acessando o Calendário de Receitas

1. Navegue até Propriedades na barra lateral
2. Selecione uma propriedade
3. Clique na aba Receitas

O calendário exibe uma janela de 30 dias a partir de hoje. Use as setas de navegação para alternar entre períodos.

Grid do Calendário

O grid é organizado da seguinte forma:

Codificação por Cores

• Ocupação verde (>= 85%) — Alta demanda — considere aumentar tarifas
• Ocupação amarela (>= 50%) — Demanda moderada — tarifas podem estar adequadas
• Ocupação cinza (< 50%) — Baixa demanda — considere promoções ou reduções
• Fundo amarelo claro — Datas de final de semana (sábado/domingo)
• Badge âmbar — Promoção aplicada à tarifa
• Ícone LOS — Descontos por tempo de estadia ativos para esta tarifa/data

Dica: Células de final de semana são destacadas em amarelo claro. Garanta que suas tarifas de final de semana reflitam o padrão de demanda diferente — muitas propriedades cobram mais nos fins de semana.

Métricas Principais

Três cards de KPI são exibidos acima do calendário:

Essas métricas são calculadas no servidor para o período exibido.

Como Interpretar as Métricas em Conjunto

Dica: Foque no RevPAR como indicador principal. ADR alto não significa nada se os quartos estão vazios, e ocupação alta não significa nada se as tarifas são muito baixas. RevPAR combina ambos em uma única métrica.

Editando Tarifas

Edição Individual

Clique duplo em qualquer célula para editá-la inline:

1. Clique duplo na célula
2. Digite o novo valor (na moeda da propriedade)
3. Pressione Enter para confirmar ou Escape para cancelar

A atualização é salva imediatamente via a API de atualização em lote.

Atualização em Lote (Absoluta)

Para atualizar múltiplas tarifas para o mesmo valor:

1. Clique nas células para selecioná-las (destacadas com anel âmbar)
2. Clique no botão Atualizar em Lote no cabeçalho
3. Digite o novo valor no popover
4. Clique em Aplicar Preço

Todas as células selecionadas serão atualizadas em uma única requisição (até 500 atualizações).

Para limpar a seleção, clique no botão X ao lado do contador.

Ajuste Percentual em Massa

Para ajustar múltiplas tarifas por percentual (ex: +10% para alta temporada, -15% para uma promoção relâmpago):

1. Clique nas células para selecionar as tarifas que deseja ajustar
2. Clique no botão % Ajustar no cabeçalho
3. Digite o percentual:
   • Valores positivos aumentam tarifas (ex: 10 = +10%)
   • Valores negativos reduzem tarifas (ex: -15 = -15%)
4. Clique em Aplicar

O sistema calcula os novos valores a partir dos valores atuais e arredonda para o centavo mais próximo.

Dica: Use ajustes percentuais em vez de valores absolutos quando quiser manter a diferença relativa entre tipos de quarto. Um aumento de 10% em um Standard de R$ 200 e uma Suite de R$ 400 preserva a proporção 2×.

Clonar Período

Copie tarifas de um período para outro — útil para repetir padrões sazonais ou configurar preços do próximo ano:

1. Clique no botão Clonar Período no cabeçalho do calendário
2. Configure a origem:
   • Plano de tarifa de origem — qual plano copiar
   • Período de origem — as datas para copiar (ex: 20/dez–05/jan)
3. Configure o destino:
   • Período de destino — onde colar (ex: 20/dez–05/jan do ano seguinte)
   • Plano de tarifa de destino (opcional) — copiar para um plano diferente
   • Ajuste % (opcional) — aplicar ajuste percentual durante a cópia (ex: +5% para inflação)
4. Clique em Clonar

Exemplo: Clonar suas tarifas de verão 2026 para 2027 com aumento de 5%:

• Origem: 01/jan–31/mar 2026, “Tarifa Balcão”
• Destino: 01/jan–31/mar 2027, mesmo plano, +5%

Importante: O clone sobrescreve tarifas existentes no período de destino. Revise as datas antes de confirmar.

Importação CSV

Importe tarifas em massa a partir de uma planilha:

1. Clique no botão Importar CSV no cabeçalho do calendário
2. Baixe o template (se necessário) — o template inclui colunas para data, tipo de quarto, canal e tarifa
3. Preencha seus dados seguindo o formato do template:

4. Faça upload do arquivo CSV
5. O sistema valida e exibe uma prévia com eventuais erros
6. Confirme para aplicar

Dica: Exporte suas tarifas atuais primeiro (via o botão de exportar do calendário) para obter um template pré-preenchido com os nomes corretos de tipos de quarto e canais.

Indicadores LOS

Quando Descontos Graduados por Estadia (LOS) estão configurados, o calendário exibe indicadores visuais:

• Um pequeno badge LOS aparece nas células de tarifa que têm tiers de desconto LOS ativos
• Ao passar o mouse sobre o badge, um tooltip mostra o resumo dos tiers (ex: “3+ noites: 5%, 7+ noites: 10%”)
• Isso ajuda gestores de receita a identificar rapidamente quais datas/tipos têm incentivos por tempo de estadia

Mensagens de Reserva

O calendário pode exibir mensagens relacionadas a reservas diretamente nas células:

• Contagem de reservas — número de reservas confirmadas para cada data
• Reservas de grupo — destacadas quando uma reserva de grupo abrange a data
• Indicadores de alerta — avisos de overbooking ou conflitos de tarifa

Essas mensagens fornecem contexto rápido sem sair da visualização do calendário.

Estratégias de Precificação

Quando Aumentar Tarifas

• Ocupação consistentemente acima de 85% para datas futuras
• Eventos locais ou feriados impulsionando demanda (shows, conferências, festivais)
• Tarifas de concorrentes aumentaram
• Datas de fim de semana ou alta temporada se aproximando

Quando Reduzir Tarifas

• Ocupação abaixo de 50% para datas nos próximos 14 dias
• Gaps entre reservas que poderiam ser preenchidos
• Baixa temporada se aproximando com reservas insuficientes
• Nova propriedade concorrente na sua área

Regras de Precificação Dinâmica

Para ajustes automáticos de tarifa, configure regras de precificação dinâmica em Settings > Planos de Tarifa > Precificação Dinâmica. Veja Tarifas e Preços para detalhes sobre:

• Regras por ocupação — ajusta tarifas automaticamente quando a ocupação cruza limiares
• Regras por antecedência — altera tarifas com base em quão cedo a reserva é feita
• Regras por tempo de estadia — oferece descontos para estadias mais longas (veja Descontos Graduados LOS)
• Regras por dia da semana — tarifas diferentes para dias úteis vs. fins de semana

Endpoints da API

Parâmetros do Calendário

Integração com Outros Módulos

• Tarifas e Preços — O Calendário de Receitas lê dos mesmos planos e tarifas configurados na aba Tarifas. Tiers de desconto LOS e allotments por canal também são gerenciados lá.
• Reservas — Dados de ocupação vêm de reservas confirmadas, em check-in e pendentes. Allotments podem bloquear ou tornar reservas pendentes.
• Dashboard — Métricas ADR e RevPAR alimentam o dashboard principal
• Financeiro — Classificação de receita segue categorias USALI para relatórios
• Portal de Reservas — Tarifas exibidas no site de reservas vêm dos mesmos planos, com ajustes de yield aplicados como overlays

Solução de Problemas

Boas Práticas

1. Revise semanalmente — Verifique o Calendário de Receitas ao menos uma vez por semana para identificar gaps e mudanças de demanda
2. Ajuste pela demanda — Quando a ocupação ultrapassa 85%, aumente tarifas; quando abaixo de 50%, considere promoções
3. Use clone para padrões sazonais — Copie as tarifas sazonais do ano passado com ajuste de inflação em vez de recriar do zero
4. Use ajustes % para mudanças proporcionais — Mantenha a proporção de preços entre tipos de quarto ajustando percentuais em vez de valores absolutos
5. Monitore tendências de ADR — ADR em queda com ocupação estável pode indicar subprecificação
6. Compare dias úteis vs. fins de semana — Garanta que tarifas de weekend reflitam a demanda de lazer mais alta
7. Configure descontos LOS — Incentive estadias mais longas com descontos graduados (3+ noites, 7+ noites, 14+ noites)
8. Exporte regularmente — Exporte seu calendário para CSV mensalmente para backup e análise offline

Yield Management (Gestão de Rendimento)

O Yield Management automatiza a precificação dinâmica aplicando ajustes baseados em regras sobre as tarifas base. Diferentemente da edição manual no Calendário de Receitas, regras de yield avaliam condições de mercado (ocupação, ritmo de reservas, antecedência, dia da semana) e ajustam preços automaticamente.

Importante: Regras de yield NÃO modificam suas tarifas base. Os ajustes são armazenados como uma camada separada na tabela yield_adjustments e aplicados pelo Serviço de Resolução de Tarifas ao calcular o preço final. Você pode reverter um ajuste a qualquer momento sem afetar seus planos de tarifa.

Diferença entre Ajuste Manual e Yield

Como acessar

1. Navegue até Propriedades na barra lateral
2. Selecione uma propriedade
3. Clique na aba Receitas
4. Clique na aba Regras de Yield

Estrutura de uma Regra de Yield

Cada regra de yield consiste em uma condição de gatilho e uma ação:

Tipos de Gatilho

Tipos de Ação

Criando uma Regra de Yield

Clique em “Nova Regra” e preencha os campos:

O Cron Noturno

O motor de yield roda automaticamente às 02:00 UTC toda noite:

1. Carrega todas as regras de yield ativas de cada propriedade
2. Para cada um dos próximos 30 dias, avalia todas as regras em ordem de prioridade (maior primeiro)
3. Para cada regra cujas condições são atendidas, calcula o ajuste
4. Insere registros de ajuste em yield_adjustments com status applied
5. Emite um evento inventory.yield-applied para monitoramento

Dica: Regras de maior prioridade são avaliadas primeiro. Se múltiplas regras correspondem ao mesmo tipo de quarto e data, todos os ajustes são registrados. O Serviço de Resolução de Tarifas usa o ajuste aplicado mais recente.

Ajustes de Yield (Trilha de Auditoria)

Cada ajuste que o motor de yield faz é registrado como uma entrada de yield adjustment:

Revertendo um Ajuste

Para reverter um ajuste de yield:

1. Acesse Receitas > aba Regras de Yield
2. Clique em “Ver Ajustes” para abrir o painel de ajustes
3. Encontre o ajuste que deseja reverter
4. Clique no botão de rollback

O status do ajuste muda para rolled_back e o Serviço de Resolução de Tarifas para de aplicá-lo. A tarifa base não é afetada.

Modo de Preview

Antes de ativar uma regra, você pode visualizar o impacto:

1. Crie ou edite uma regra de yield (pode estar inativa)
2. Clique em “Preview”
3. Selecione um período para simular
4. O sistema avalia a regra com os dados de mercado atuais e mostra ajustes projetados sem aplicá-los

Ajustes de preview são armazenados com status simulated e não afetam a precificação real.

Dica: Sempre faça preview de novas regras antes de ativá-las. Uma regra que parece razoável na teoria pode produzir resultados inesperados com seus dados reais de ocupação e tarifas.

Como Overlays de Yield funcionam no Pipeline de Precificação

O pipeline de precificação aplica ajustes de yield como a camada final:

1. Tarifa base é resolvida a partir do plano de tarifas ativo (baseado em prioridade)
2. Regras de precificação dinâmica são aplicadas (SEASONAL, OCCUPANCY, etc.)
3. Descontos graduais LOS são aplicados se aplicável
4. Overlay de yield adjustment é aplicado — o sistema verifica se existe um yield_adjustment ativo correspondente ao tipo de quarto, canal e data
5. A tarifa final é retornada ao motor de reservas ou calendário

Atenção: Ajustes de yield são aditivos às regras de precificação dinâmica. Uma regra dinâmica de 10% por ocupação mais uma regra de yield de 15% podem resultar em um aumento total de 25%. Verifique o efeito combinado no Calendário de Receitas.

Boas práticas de Yield Management

1. Comece conservador — Inicie com ajustes pequenos (+5% a +10%) e meça o impacto na ocupação antes de aumentar
2. Use preview antes de ativar — Toda nova regra deve ser visualizada para validar o comportamento esperado
3. Separe regras de ocupação e antecedência — Evite combinar múltiplos gatilhos em uma única regra; use ordenação por prioridade
4. Defina períodos sensíveis — Não crie regras com validade ilimitada; revise e renove trimestralmente
5. Monitore o painel de ajustes — Verifique quais tarifas foram ajustadas e se o RevPAR melhorou
6. Use regras de dia da semana para prêmios de fim de semana — Mais preciso que edições manuais em massa
7. Reverta agressivamente — Se uma regra produzir resultados inesperados, reverta imediatamente em vez de esperar o próximo ciclo do cron
8. Coordene com allotments — Se um canal tem um limite hard de allotment, ajustes de yield nesse canal podem ter menos impacto (menos reservas possíveis)

Próximos Passos

• Tarifas e Preços — Configure planos de tarifa, preços sazonais, descontos LOS e allotments por canal
• Reservas — Entenda o ciclo de vida das reservas
• Dashboard — Veja métricas agregadas da propriedade
• Relatórios Financeiros — Analise o desempenho de receita