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
- Navegue até Propriedades na barra lateral
- Selecione uma propriedade
- 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:
| Elemento | Descrição |
|---|---|
| Coluna esquerda | Nomes dos tipos de quarto (fixa — sempre visível ao rolar) |
| Cabeçalho de datas | Número do dia e abreviação do dia da semana |
| Linha de ocupação | Percentual de ocupação por data, com cores |
| Células de tarifa | Tarifa vigente para cada tipo de quarto em cada data |
| Badge LOS | Indicador de que descontos graduados por tempo de estadia estão configurados |
| Ícone de yield | Raio (⚡) nas células com ajuste de yield aplicado; ao passar o mouse, mostra a variação em % |
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
- Badge LOS — Faixa de desconto por tempo de estadia ativa para esta tarifa/data (ex: “3+n -5%”)
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
Seis cards de KPI são exibidos acima do calendário:
| Métrica | Nome Completo | Fórmula | O Que Indica |
|---|---|---|---|
| ADR | Diária Média | Média das tarifas exibidas no grid para o período | Preço médio publicado por tipo de quarto e data |
| RevPAR | Receita por Quarto Disponível | ADR × ocupação média | Quão bem você monetiza seu inventário total |
| Ocupação Média | Taxa Média de Ocupação | Unidades-noite ocupadas ÷ unidades-noite disponíveis × 100 | Percentual de unidades ocupadas no período |
| Receita Realizada | — | Total das reservas em estadia ou com check-out, pela data de check-in | Receita de estadias já iniciadas |
| Receita Esperada | — | Total das demais reservas, pela data de check-in | Receita ainda por vir |
| Hóspedes / Reservas | — | Hóspedes e reservas do período | Volume do período |
Essas métricas são calculadas no servidor para o período exibido.
Como Interpretar as Métricas em Conjunto
| Cenário | ADR | Ocupação | RevPAR | Ação |
|---|---|---|---|---|
| Preços altos, ocupação baixa | Alto | Baixa | Baixo | Tarifas podem estar altas — considere reduzir |
| Preços baixos, ocupação alta | Baixo | Alta | Médio | Vendendo barato demais — aumente gradualmente |
| Preços altos, ocupação alta | Alto | Alta | Alto | Ótimo — mantenha a estratégia atual |
| Preços baixos, ocupação baixa | Baixo | Baixa | Muito Baixo | Problema estrutural — revise marketing, canais e produto |
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:
- Clique duplo na célula
- Digite o novo valor em centavos (ex:
35000para R$ 350,00) - 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:
- Clique nas células para selecioná-las (destacadas com anel âmbar)
- Clique no botão Atualizar em Lote no cabeçalho
- Mantenha o modo Preço Absoluto e digite a nova tarifa em centavos no popover
- 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):
- Clique nas células para selecionar as tarifas que deseja ajustar
- Clique no botão Atualizar em Lote no cabeçalho e mude para o modo Ajuste %
- Digite o percentual:
- Valores positivos aumentam tarifas (ex:
10= +10%) - Valores negativos reduzem tarifas (ex:
-15= -15%)
- Valores positivos aumentam tarifas (ex:
- Clique em Aplicar Preço
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:
- Clique no botão Clonar Período (ícone de copiar) no cabeçalho do calendário
- Configure a origem:
- Plano de tarifa de origem — qual plano copiar
- Período de origem — as datas para copiar (ex: 20/dez–05/jan)
- 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)
- 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 cria novas tarifas (deslocadas para o período de destino) e não apaga as tarifas que já existem nele. Se o período de destino já tiver tarifas, revise as prioridades para que a tarifa certa prevaleça.
Importação CSV
Importe tarifas em massa a partir de uma planilha:
- Clique no botão CSV no cabeçalho do calendário
- Baixe o template (se necessário) em Baixar Template
- Preencha seus dados seguindo o formato do template:
| Coluna | Formato | Exemplo |
|---|---|---|
rateName | Nome da tarifa (obrigatório) | Summer Rate |
unitType | Tipo de unidade | standard |
bedConfigCode | Configuração de camas (opcional) | double |
unitId | ID de unidade específica (opcional) | — |
basePrice | Preço em reais (obrigatório) | 150.00 |
currency | Código ISO | BRL |
validFrom / validTo | YYYY-MM-DD | 2026-06-01 |
daysOfWeek | Dias 1–7, entre aspas | ”1,2,3,4,5” |
channel | Código do canal (opcional) | — |
minStay / maxStay | Noites | 1 |
rateType | per_night, per_stay ou per_person | per_night |
- Selecione o arquivo CSV — o diálogo mostra uma prévia das primeiras linhas
- Clique em Importar
- O sistema cria uma nova tarifa por linha e informa quantas foram criadas e quais linhas tiveram erro
Indicadores LOS
Quando Descontos Graduais por Permanência (LOS) estão configurados, o calendário exibe indicadores visuais:
- Um pequeno badge LOS aparece nas células de tarifa que têm uma faixa de desconto LOS ativa, com o mínimo de noites e o desconto da faixa (ex: “3+n -5%”)
- Isso ajuda gestores de receita a identificar rapidamente quais datas/tipos têm incentivos por tempo de estadia
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, use as regras de Yield Management desta mesma aba (veja abaixo):
- Regras por ocupação — ajusta tarifas automaticamente quando a ocupação cruza limiares
- Regras por dias até a chegada — altera tarifas conforme a proximidade da data de chegada
- Regras por ritmo de reservas — reage ao número de novas reservas em um período
- Regras por dia da semana — tarifas diferentes para dias úteis vs. fins de semana
Para descontos em estadias mais longas, veja Descontos Graduais LOS.
Endpoints da API
| Método | Endpoint | Descrição |
|---|---|---|
GET | /api/tenants/:tenantId/rates/calendar | Busca grid pré-computado |
POST | /api/tenants/:tenantId/rates/bulk-update | Atualização em lote de até 500 tarifas |
POST | /api/tenants/:tenantId/rates/clone-period | Clonar tarifas de um período para outro |
GET | /api/tenants/:tenantId/rates/csv-template | Baixar o template CSV |
POST | /api/tenants/:tenantId/rates/csv-import | Importar tarifas de CSV |
Parâmetros do Calendário
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
propertyId | Sim | UUID da propriedade |
startDate | Sim | Data inicial (YYYY-MM-DD) |
endDate | Sim | Data final (YYYY-MM-DD) |
ratePlanId | Não | Filtrar por plano de tarifas |
channel | Não | Filtrar por canal de distribuição |
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. Faixas de desconto LOS, allotments por canal e regras de yield são gerenciados nesta aba Receitas.
- Reservas — Dados de ocupação vêm das reservas que ocupam cada data (exceto canceladas e no-shows). Allotments rígidos podem bloquear reservas do Portal de Reservas.
- Dashboard — O dashboard principal também exibe ADR e RevPAR
- 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
| Problema | Causa | Solução |
|---|---|---|
| Calendário sem dados | Nenhuma tarifa configurada | Crie tarifas em Propriedades > Tarifas |
| Tarifas não aparecem em algumas datas | Nenhuma tarifa cobre o período | Estenda a validade da tarifa |
| Atualização em lote falha | Mais de 500 células selecionadas | Selecione menos células e aplique em batches |
| Tarifas clonadas não aparecem | Tarifas que já existiam no período de destino prevalecem pela prioridade | Revise as prioridades dos planos e tarifas no período de destino |
| Importação CSV rejeitada | Falta a coluna rateName ou basePrice | Baixe o template e use os nomes exatos |
Boas Práticas
- Revise semanalmente — Verifique o Calendário de Receitas ao menos uma vez por semana para identificar gaps e mudanças de demanda
- Ajuste pela demanda — Quando a ocupação ultrapassa 85%, aumente tarifas; quando abaixo de 50%, considere promoções
- Use clone para padrões sazonais — Copie as tarifas sazonais do ano passado com ajuste de inflação em vez de recriar do zero
- Use ajustes % para mudanças proporcionais — Mantenha a proporção de preços entre tipos de quarto ajustando percentuais em vez de valores absolutos
- Monitore tendências de ADR — ADR em queda com ocupação estável pode indicar subprecificação
- Compare dias úteis vs. fins de semana — Garanta que tarifas de weekend reflitam a demanda de lazer mais alta
- Configure descontos LOS — Incentive estadias mais longas com descontos graduados (3+ noites, 7+ noites, 14+ noites)
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_adjustmentse 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
| Aspecto | Calendário de Receitas (Manual) | Yield Management (Automatizado) |
|---|---|---|
| Gatilho | Você edita células manualmente | Sistema avalia condições automaticamente |
| Frequência | Sob demanda | Cron noturno (02:00 UTC) para os próximos 30 dias |
| Escopo | Células individuais ou seleção em massa | Todos os tipos de quarto e canais correspondentes |
| Efeito na tarifa base | Modifica a tarifa base diretamente | Cria camada separada — tarifa base inalterada |
| Reversibilidade | Sem desfazer (precisa re-editar) | Rollback com um clique por ajuste |
Como acessar
- Navegue até Propriedades na barra lateral
- Selecione uma propriedade
- Clique na aba Receitas
- Clique no botão Yield — a seção Gestão de Yield abre abaixo do calendário
Estrutura de uma Regra de Yield
Cada regra de yield consiste em uma condição de gatilho e uma ação:
Tipos de Gatilho
| Gatilho | Sinal Avaliado | Campos de Condição | Exemplo |
|---|---|---|---|
| Ocupação | % de ocupação atual para a data alvo | occupancyMin, occupancyMax | Dispara quando ocupação >= 85% |
| Dias até chegada | Número de dias entre hoje e a data alvo | daysToArrivalMin, daysToArrivalMax | Dispara quando chegada está a <= 3 dias (última hora) |
| Ritmo de reservas | Número de novas reservas em uma janela móvel | bookingPaceMin, bookingPaceDays | Dispara quando 10+ reservas nos últimos 7 dias |
| Dia da semana | Número ISO do dia (1=Segunda, 7=Domingo) | daysOfWeek | Dispara nas sextas e sábados |
Tipos de Ação
| Ação | Efeito | Exemplo de Valor |
|---|---|---|
| Ajuste percentual | Soma ou subtrai um percentual da tarifa base | +15 = aumenta 15%, -10 = diminui 10% |
| Ajuste fixo | Soma ou subtrai um valor fixo (em reais) da tarifa base | 50 = adiciona R$ 50,00, -20 = subtrai R$ 20,00 |
Criando uma Regra de Yield
Clique em “Adicionar Regra” e preencha os campos:
| Campo | Descrição |
|---|---|
| Nome | Nome descritivo da regra (ex: “Alta Demanda +15%“) |
| Tipo de gatilho | Ocupação, Dias até Chegada, Ritmo de Reservas ou Dia da Semana |
| Condições | Limiares para o gatilho (o formulário oferece campos estruturados) |
| Tipo de ação | Ajuste Percentual ou Ajuste Fixo |
| Valor da ação | Magnitude do ajuste (ex: 15 para +15%, ou 50 para +R$ 50) |
| Válido de / até | Período em que a regra está ativa (obrigatório) |
| Prioridade | Regras de maior prioridade são avaliadas primeiro (inteiro) |
Pela API, a regra também pode ter descrição, escopo alvo (tipos de quarto e canais; vazio = todos) e ser ativada ou desativada. Regras criadas pelo formulário valem para todos os tipos de quarto e canais.
O Cron Noturno
O motor de yield roda automaticamente às 02:00 UTC toda noite:
- Carrega todas as regras de yield ativas de cada propriedade
- Para cada um dos próximos 30 dias, avalia todas as regras em ordem de prioridade (maior primeiro)
- Para cada regra cujas condições são atendidas, calcula o ajuste
- Insere registros de ajuste em
yield_adjustmentscom statusapplied - Emite um evento
inventory.yield-appliedpara 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:
| Campo | Descrição |
|---|---|
| Data alvo | A data a que o ajuste se aplica |
| Tipo de quarto | Qual tipo de quarto foi ajustado |
| Canal | Qual canal (ou todos se nulo) |
| Tarifa base | A tarifa antes do ajuste |
| Tarifa ajustada | A tarifa após o ajuste |
| Valor do ajuste | A diferença (em centavos) |
| Status | applied (aplicado), simulated (simulado) ou rolled_back (revertido) |
| Nome da regra | Qual regra de yield gerou o ajuste |
Revertendo um Ajuste
Para reverter um ajuste de yield:
- Na seção Gestão de Yield, clique em “Ajustes” para abrir o painel de ajustes
- Encontre o ajuste que deseja reverter
- Clique no botão Reverter
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
O preview está disponível apenas pela API (POST /api/tenants/:tenantId/yield-rules/preview): para uma propriedade e um período, o sistema avalia as regras ativas com os dados de mercado atuais e retorna os ajustes projetados sem aplicá-los.
Ajustes de preview são armazenados com status simulated e não afetam a precificação real.
Como Overlays de Yield funcionam no Pipeline de Precificação
O pipeline de precificação aplica o ajuste de yield à tarifa de cada noite:
- Tarifa base é resolvida a partir dos planos de tarifas (baseado em prioridade)
- Overlay de yield adjustment é aplicado — se existe um
yield_adjustmentaplicado para o tipo de quarto, canal e data, a tarifa da noite é substituída pela tarifa ajustada - A promoção é aplicada, se houver
- Descontos graduais LOS são aplicados se aplicável
- O preço final é retornado ao motor de reservas ou à reserva
Atenção: A tarifa ajustada é calculada quando a regra é avaliada (pelo cron noturno). Se você alterar a tarifa base depois, a noite continua com o valor ajustado anteriormente até a próxima avaliação ou até você reverter o ajuste.
Boas práticas de Yield Management
- Comece conservador — Inicie com ajustes pequenos (+5% a +10%) e meça o impacto na ocupação antes de aumentar
- Simule antes de ativar — Se você usa a API, rode o preview para validar o comportamento esperado
- Separe regras de ocupação e antecedência — Evite combinar múltiplos gatilhos em uma única regra; use ordenação por prioridade
- Defina períodos sensíveis — Não crie regras com validade ilimitada; revise e renove trimestralmente
- Monitore o painel de ajustes — Verifique quais tarifas foram ajustadas e se o RevPAR melhorou
- Use regras de dia da semana para prêmios de fim de semana — Mais preciso que edições manuais em massa
- Reverta agressivamente — Se uma regra produzir resultados inesperados, reverta imediatamente em vez de esperar o próximo ciclo do cron
- 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