Skip to Content
PMS CoreGestão de Receitas

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:

ElementoDescrição
Coluna esquerdaNomes dos tipos de quarto (fixa — sempre visível ao rolar)
Cabeçalho de datasNúmero do dia e abreviação do dia da semana
Linha de ocupaçãoPercentual de ocupação por data, com cores
Células de tarifaTarifa vigente para cada tipo de quarto em cada data
Badge LOSIndicador de que descontos graduados por tempo de estadia estão configurados
Ícone de yieldRaio (⚡) 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étricaNome CompletoFórmulaO Que Indica
ADRDiária MédiaMédia das tarifas exibidas no grid para o períodoPreço médio publicado por tipo de quarto e data
RevPARReceita por Quarto DisponívelADR × ocupação médiaQuão bem você monetiza seu inventário total
Ocupação MédiaTaxa Média de OcupaçãoUnidades-noite ocupadas ÷ unidades-noite disponíveis × 100Percentual de unidades ocupadas no período
Receita Realizada—Total das reservas em estadia ou com check-out, pela data de check-inReceita de estadias já iniciadas
Receita Esperada—Total das demais reservas, pela data de check-inReceita ainda por vir
Hóspedes / Reservas—Hóspedes e reservas do períodoVolume do período

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

Como Interpretar as Métricas em Conjunto

CenárioADROcupaçãoRevPARAção
Preços altos, ocupação baixaAltoBaixaBaixoTarifas podem estar altas — considere reduzir
Preços baixos, ocupação altaBaixoAltaMédioVendendo barato demais — aumente gradualmente
Preços altos, ocupação altaAltoAltaAltoÓtimo — mantenha a estratégia atual
Preços baixos, ocupação baixaBaixoBaixaMuito BaixoProblema 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:

  1. Clique duplo na célula
  2. Digite o novo valor em centavos (ex: 35000 para R$ 350,00)
  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. Mantenha o modo Preço Absoluto e digite a nova tarifa em centavos 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 Atualizar em Lote no cabeçalho e mude para o modo Ajuste %
  3. Digite o percentual:
    • Valores positivos aumentam tarifas (ex: 10 = +10%)
    • Valores negativos reduzem tarifas (ex: -15 = -15%)
  4. 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:

  1. Clique no botão Clonar Período (ícone de copiar) 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 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:

  1. Clique no botão CSV no cabeçalho do calendário
  2. Baixe o template (se necessário) em Baixar Template
  3. Preencha seus dados seguindo o formato do template:
ColunaFormatoExemplo
rateNameNome da tarifa (obrigatório)Summer Rate
unitTypeTipo de unidadestandard
bedConfigCodeConfiguração de camas (opcional)double
unitIdID de unidade específica (opcional)—
basePricePreço em reais (obrigatório)150.00
currencyCódigo ISOBRL
validFrom / validToYYYY-MM-DD2026-06-01
daysOfWeekDias 1–7, entre aspas”1,2,3,4,5”
channelCódigo do canal (opcional)—
minStay / maxStayNoites1
rateTypeper_night, per_stay ou per_personper_night
  1. Selecione o arquivo CSV — o diálogo mostra uma prévia das primeiras linhas
  2. Clique em Importar
  3. 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étodoEndpointDescrição
GET/api/tenants/:tenantId/rates/calendarBusca grid pré-computado
POST/api/tenants/:tenantId/rates/bulk-updateAtualização em lote de até 500 tarifas
POST/api/tenants/:tenantId/rates/clone-periodClonar tarifas de um período para outro
GET/api/tenants/:tenantId/rates/csv-templateBaixar o template CSV
POST/api/tenants/:tenantId/rates/csv-importImportar tarifas de CSV

Parâmetros do Calendário

ParâmetroObrigatórioDescrição
propertyIdSimUUID da propriedade
startDateSimData inicial (YYYY-MM-DD)
endDateSimData final (YYYY-MM-DD)
ratePlanIdNãoFiltrar por plano de tarifas
channelNãoFiltrar 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

ProblemaCausaSolução
Calendário sem dadosNenhuma tarifa configuradaCrie tarifas em Propriedades > Tarifas
Tarifas não aparecem em algumas datasNenhuma tarifa cobre o períodoEstenda a validade da tarifa
Atualização em lote falhaMais de 500 células selecionadasSelecione menos células e aplique em batches
Tarifas clonadas não aparecemTarifas que já existiam no período de destino prevalecem pela prioridadeRevise as prioridades dos planos e tarifas no período de destino
Importação CSV rejeitadaFalta a coluna rateName ou basePriceBaixe o template e use os nomes exatos

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)

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

AspectoCalendário de Receitas (Manual)Yield Management (Automatizado)
GatilhoVocê edita células manualmenteSistema avalia condições automaticamente
FrequênciaSob demandaCron noturno (02:00 UTC) para os próximos 30 dias
EscopoCélulas individuais ou seleção em massaTodos os tipos de quarto e canais correspondentes
Efeito na tarifa baseModifica a tarifa base diretamenteCria camada separada — tarifa base inalterada
ReversibilidadeSem desfazer (precisa re-editar)Rollback com um clique por ajuste

Como acessar

  1. Navegue até Propriedades na barra lateral
  2. Selecione uma propriedade
  3. Clique na aba Receitas
  4. 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

GatilhoSinal AvaliadoCampos de CondiçãoExemplo
Ocupação% de ocupação atual para a data alvooccupancyMin, occupancyMaxDispara quando ocupação >= 85%
Dias até chegadaNúmero de dias entre hoje e a data alvodaysToArrivalMin, daysToArrivalMaxDispara quando chegada está a <= 3 dias (última hora)
Ritmo de reservasNúmero de novas reservas em uma janela móvelbookingPaceMin, bookingPaceDaysDispara quando 10+ reservas nos últimos 7 dias
Dia da semanaNúmero ISO do dia (1=Segunda, 7=Domingo)daysOfWeekDispara nas sextas e sábados

Tipos de Ação

AçãoEfeitoExemplo de Valor
Ajuste percentualSoma ou subtrai um percentual da tarifa base+15 = aumenta 15%, -10 = diminui 10%
Ajuste fixoSoma ou subtrai um valor fixo (em reais) da tarifa base50 = adiciona R$ 50,00, -20 = subtrai R$ 20,00

Criando uma Regra de Yield

Clique em “Adicionar Regra” e preencha os campos:

CampoDescrição
NomeNome descritivo da regra (ex: “Alta Demanda +15%“)
Tipo de gatilhoOcupação, Dias até Chegada, Ritmo de Reservas ou Dia da Semana
CondiçõesLimiares para o gatilho (o formulário oferece campos estruturados)
Tipo de açãoAjuste Percentual ou Ajuste Fixo
Valor da açãoMagnitude 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)
PrioridadeRegras 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:

  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:

CampoDescrição
Data alvoA data a que o ajuste se aplica
Tipo de quartoQual tipo de quarto foi ajustado
CanalQual canal (ou todos se nulo)
Tarifa baseA tarifa antes do ajuste
Tarifa ajustadaA tarifa após o ajuste
Valor do ajusteA diferença (em centavos)
Statusapplied (aplicado), simulated (simulado) ou rolled_back (revertido)
Nome da regraQual regra de yield gerou o ajuste

Revertendo um Ajuste

Para reverter um ajuste de yield:

  1. Na seção Gestão de Yield, clique em “Ajustes” para abrir o painel de ajustes
  2. Encontre o ajuste que deseja reverter
  3. 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:

  1. Tarifa base é resolvida a partir dos planos de tarifas (baseado em prioridade)
  2. Overlay de yield adjustment é aplicado — se existe um yield_adjustment aplicado para o tipo de quarto, canal e data, a tarifa da noite é substituída pela tarifa ajustada
  3. A promoção é aplicada, se houver
  4. Descontos graduais LOS são aplicados se aplicável
  5. 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

  1. Comece conservador — Inicie com ajustes pequenos (+5% a +10%) e meça o impacto na ocupação antes de aumentar
  2. Simule antes de ativar — Se você usa a API, rode o preview 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

Last updated on