Tarifas e Precos
O modulo de Tarifas do Opero permite configurar precos para suas unidades de forma flexivel: desde uma tabela simples com preco unico ate estruturas com temporadas, restricoes por canal, promocoes, descontos por permanencia e ajustes automaticos de yield.
Conceitos Fundamentais
Plano de Tarifas (Rate Plan)
Um Plano de Tarifas e um agrupamento nomeado de tarifas com prioridade. Cada propriedade pode ter multiplos planos, e o sistema resolve o preco de cada noite aplicando a tarifa ativa do plano ativo de maior prioridade.
| Campo | Descricao |
|---|---|
| Nome | Identificacao do plano (ex: “Tabela Alta Temporada 2026”) |
| Valido de | Data de inicio da vigencia |
| Valido ate | Data de termino (vazio = validade infinita) |
| Prioridade | Numero inteiro — quanto maior, mais precedencia |
| Ativo | Liga/desliga o plano inteiro |
| Padrao | Marca o plano como fallback (prioridade 0, validade infinita) |
Importante: A validade do plano e apenas uma referencia. No calculo do preco, vale a validade de cada tarifa (veja abaixo).
Tarifa de Unidade (Unit Rate)
Dentro de cada plano, as Tarifas de Unidade definem o preco concreto por tipo de quarto ou unidade especifica:
| Campo | Descricao |
|---|---|
| Tipo de unidade | Tipo de quarto ao qual a tarifa se aplica (ex: standard, suite) |
| Unidade especifica | Opcional — aplica a tarifa a uma unica unidade (pela API ou importacao CSV) |
| Nome da tarifa | Descricao (ex: “Diaria Standard Weekend”) |
| Tipo de cobranca | per_night (por diaria), per_stay (por estadia), per_person (por pessoa) |
| Preco base | Valor em reais (decimal com 2 casas) |
| Moeda | Codigo ISO (padrao: BRL) |
| Periodo de validade | Datas de inicio e termino |
| Dias da semana | Restricao opcional (ex: somente sexta e sabado) |
| Estadia minima/maxima | Restricao de permanencia |
| Prioridade | Desempate entre tarifas do mesmo plano |
| Canal | Restricao por canal de venda (direct, booking_com, expedia, etc.) |
Criando um Plano de Tarifas
- Acesse a pagina Planos Tarifarios (
/settings/rate-plans) — ela nao aparece no menu; abra pelo endereco - Clique em Novo Plano Tarifario
- Preencha nome, periodo de validade e prioridade
- Salve o plano
- Adicione as tarifas em Propriedades > [propriedade] > Tarifas, clicando em Nova Tarifa e escolhendo o plano no campo Plano Tarifario
Plano Padrao: Ao criar uma tarifa sem plano, o sistema gera automaticamente um plano “Default” com prioridade 0 e validade infinita. Ao cadastrar uma unidade com preco base, o sistema tambem cria nesse plano uma tarifa “Default” para a unidade. Use-o como sua tabela base.
Exemplo de estrutura
Propriedade: Hotel Beira Mar
├── Plano "Default" (prioridade 0, sempre ativo)
│ ├── Standard: R$ 280/noite
│ ├── Deluxe: R$ 420/noite
│ └── Suite: R$ 680/noite
│
├── Plano "Carnaval 2026" (prioridade 10, tarifas de 28/fev a 05/mar)
│ ├── Standard: R$ 580/noite
│ ├── Deluxe: R$ 780/noite
│ └── Suite: R$ 1.200/noite
│
└── Plano "Baixa Temporada" (prioridade 5, tarifas de 01/abr a 30/jun)
├── Standard: R$ 199/noite
└── Deluxe: R$ 320/noiteQuando uma reserva inclui a noite de 02/mar, o sistema aplica a tarifa do plano “Carnaval 2026” (prioridade 10). Para 15/mai, aplica “Baixa Temporada” (prioridade 5). Para 10/set, cai no “Default” (prioridade 0).
Precificacao Sazonal
Temporadas sao implementadas como planos de tarifas com prioridade mais alta que o plano padrao, cujas tarifas tem as datas da temporada.
Resolucao de prioridade
O sistema calcula o preco noite a noite, seguindo esta logica:
- Considera as tarifas ativas de planos ativos da propriedade
- Mantem as tarifas cuja validade cobre a noite
- Ordena por prioridade do plano (decrescente) e, em seguida, pela prioridade da tarifa
- Considera tarifas da unidade especifica, do tipo de unidade ou sem tipo (toda a propriedade)
- Aplica restricoes de canal, dias da semana, estadia minima/maxima e configuracao de camas, se houver
- Usa a primeira tarifa encontrada
Importante: Se nenhuma tarifa cobrir a noite, o sistema usa o preco base cadastrado na unidade. Certifique-se de que o plano padrao tenha tarifas para todos os tipos de quarto.
Dias da semana
Uma tarifa pode ser restrita a dias especificos (1 = segunda … 7 = domingo). Isso permite diferenciar precos de fim de semana:
Plano "Default"
Standard (seg a qui): R$ 280/noite → daysOfWeek: [1,2,3,4]
Standard (sex a dom): R$ 350/noite → daysOfWeek: [5,6,7]No formulario de tarifa, escolha Todos os Dias, Dias Uteis (Seg-Sex) ou Fins de Semana (Sab-Dom).
Restricoes por Canal de Distribuicao
Cada tarifa pode ser restrita a um canal de venda especifico. No formulario, o campo Canal oferece Direto (direct) e os canais conectados a propriedade, como:
| Canal | Descricao |
|---|---|
direct | Direto |
booking_com | Booking.com |
expedia | Expedia/Hotels.com |
airbnb | Airbnb |
decolar_despegar | Decolar/Despegar |
tripadvisor | TripAdvisor |
| (vazio) | Todas os canais (tarifa fallback) |
Importante: As reservas criadas no painel usam apenas tarifas sem canal. O Portal de Reservas usa tarifas sem canal ou do canal
direct_gbp. Por isso, uma tarifa restrita adirectou a uma OTA nao e aplicada nessas reservas.
Paridade vs. Diferenciacao
- Paridade: Crie uma unica tarifa sem restricao de canal. O mesmo preco sera usado em todos os canais.
- Diferenciacao: Crie tarifas separadas por canal, mantendo sempre uma tarifa sem canal como base para as reservas do painel.
Ativacao e Desativacao em Massa
O Opero permite ativar ou desativar um plano de tarifas inteiro com um unico clique (Ativar Todas as Tarifas / Desativar Todas as Tarifas na pagina Planos Tarifarios). Ao desativar um plano:
- O plano e marcado como
isActive = false - Todas as tarifas vinculadas ao plano tambem sao desativadas
- O sistema para de considerar essas tarifas na resolucao de precos
Ao reativar, o processo inverso acontece automaticamente.
Tipos de Cobranca
| Tipo | Descricao | Uso tipico |
|---|---|---|
| per_night | Valor por diaria | Hoteis, pousadas (padrao) |
| per_stay | Valor fixo por estadia | Pacotes promocionais, estadias longas |
| per_person | Valor por pessoa por noite | Hostels, resorts all-inclusive |
Atencao: Hoje o calculo de preco trata todas as tarifas como valor por noite. O tipo de cobranca fica registrado na tarifa, mas nao altera o calculo.
Estadia Minima e Maxima
Cada tarifa pode exigir uma estadia minima ou limitar a maxima:
| Restricao | Campo | Exemplo |
|---|---|---|
| Minima | minStay | 3 noites no Carnaval |
| Maxima | maxStay | Maximo 30 noites (long stay) |
Quando a duracao da reserva nao atende a restricao, a tarifa e ignorada e o sistema tenta a proxima na ordem de prioridade.
Precificacao Dinamica
O preco das diarias nao passa por regras de precificacao dinamica (sazonal, ocupacao, antecedencia etc.). Para ajustes automaticos com base em ocupacao, antecedencia, ritmo de reservas ou dia da semana, use o Yield Management da aba Receitas (veja Gestao de Receitas).
Descontos Graduais por Permanencia (LOS)
Os Descontos Graduais por Permanencia (LOS — Length of Stay) permitem definir faixas concretas de desconto com base no numero de noites que o hospede permanece. Os descontos graduais LOS sao uma tabela gerenciavel de faixas — cada uma com seu proprio intervalo, tipo de desconto e escopo.
Isso oferece controle detalhado: por exemplo, 5% de desconto para estadias de 3 noites, 10% para estadias semanais e 20% para estadias de duas semanas ou mais.
Como acessar
- Acesse Propriedades > [propriedade] > aba Receitas
- Clique no botao LOS
Criando uma faixa
Clique em “Adicionar” e preencha os campos:
| Campo | Descricao |
|---|---|
| Noites minimas | Numero minimo de noites para se qualificar nesta faixa (minimo 2) |
| Noites maximas | Numero maximo de noites (deixe vazio para ilimitado) |
| Tipo de desconto | Percentual ou Valor fixo por noite |
| Valor do desconto | O valor do desconto (ex: 10 para 10% ou 50 para R$ 50 de desconto por noite) |
| Valido de | Data de inicio da validade da faixa |
| Valido ate | Data de termino da validade (obrigatoria) |
| Ativo | Habilita ou desabilita a faixa |
Pela API, a faixa tambem pode ser restrita a um tipo de unidade, a um canal e receber uma prioridade de desempate.
Logica de resolucao
Ao calcular o preco de uma reserva, o sistema avalia todas as faixas de desconto LOS ativas e aplica a regra “a faixa com maior numero minimo de noites vence”:
- Filtra faixas que estao ativas e cuja validade cobre a data de check-in
- Filtra faixas cujo intervalo
noites_minimas/noites_maximasinclui a duracao da estadia do hospede - Filtra por escopo de tipo de unidade e escopo de canal (se definidos)
- Entre todas as faixas correspondentes, seleciona a de maior numero minimo de noites; em caso de empate, a de maior prioridade
- Aplica o desconto: percentual sobre o total da estadia, ou valor fixo multiplicado pelo numero de noites
Exemplo
| Faixa | Noites Min | Noites Max | Desconto |
|---|---|---|---|
| 1 | 3 | 6 | 5% |
| 2 | 7 | 13 | 10% |
| 3 | 14 | — | 20% |
- Um hospede ficando 2 noites nao recebe desconto LOS.
- Um hospede ficando 5 noites corresponde a Faixa 1 e recebe 5% de desconto.
- Um hospede ficando 10 noites corresponde a Faixa 2 e recebe 10% de desconto.
- Um hospede ficando 21 noites corresponde a Faixa 3 e recebe 20% de desconto.
Como os descontos aparecem durante a reserva
O pipeline de precificacao integra os descontos LOS apos o calculo da tarifa base. O fluxo e:
- A tarifa de cada noite e resolvida a partir dos planos de tarifas (com ajuste de yield, se houver)
- A promocao aplicavel e descontada
- O desconto gradual LOS e aplicado sobre o valor ja com a promocao
- O desconto LOS aplicado fica registrado no snapshot de preco da reserva
Dica: Os descontos LOS acumulam com promocoes. Um hospede reservando uma estadia de 14 noites durante uma promocao pode receber tanto o desconto da promocao quanto um desconto LOS de 20%.
Boas praticas para faixas LOS
- Evite sobreposicao de intervalos — Se uma estadia de 5 noites corresponder a duas faixas (ex: “3-7” e “5-10”), vence a de maior numero minimo de noites (“5-10”). Mantenha os intervalos sem sobreposicao para evitar surpresas.
- Revise sazonalmente — Ajuste suas faixas LOS antes da alta e baixa temporada. Um desconto de 20% para estadias longas pode ser generoso demais em periodos de pico.
- Estruturas comuns:
- 3 faixas: Curta (3-6 noites), Media (7-13 noites), Longa (14+ noites)
- 2 faixas: Semanal (7-13 noites), Estendida (14+ noites)
- Faixa unica: Desconto simples por estadia minima (ex: 7+ noites = 10% de desconto)
Importante: Os descontos graduais LOS sao independentes das restricoes
minStay/maxStaydas tarifas. Uma restricao de tarifa ignora a tarifa inteiramente se a duracao da estadia nao se qualificar. Um desconto LOS recompensa estadias mais longas com um preco menor — a reserva ainda e permitida sem ele.
Channel Allotment (Alocacao por Canal)
O Channel Allotment permite controlar quantas unidades cada canal de distribuicao pode vender para um determinado tipo de quarto e periodo. Por exemplo, voce pode alocar 5 quartos para o Booking.com, 3 para a Expedia e 10 para o seu motor de reservas direto.
Quando nenhum allotment e definido para um tipo de quarto e canal, o sistema assume venda livre (free sale) — sem restricao.
Tipos de Allotment
| Tipo | Comportamento | Caso de uso |
|---|---|---|
| Rigido (hard) | Bloqueia a reserva quando o limite e atingido. O motor de reservas retorna um erro de conflito. | Canais com controle estrito de inventario |
| Flexivel (soft) | A reserva e aceita normalmente mesmo com o limite atingido; o tipo serve como sinalizacao. | Canais onde voce quer visibilidade sem bloquear vendas |
| Venda Livre (free sale) | Sem limite — o canal pode vender tantas unidades quantas estiverem fisicamente disponiveis. | Reservas diretas ou parceiros de confianca |
Como acessar
- Navegue ate Propriedades na barra lateral
- Selecione uma propriedade
- Clique na aba Receitas
- Clique no botao Allotments
Criando um Allotment
Clique em “Adicionar Allotment” e preencha os campos:
| Campo | Descricao |
|---|---|
| Tipo de quarto | Identificador (ID) do tipo de quarto ao qual o allotment se aplica |
| Canal | Identificador (ID) do canal de distribuicao sendo alocado |
| Data inicial | Data de inicio do periodo de allotment |
| Data final | Data de termino do periodo de allotment |
| Limite | Numero maximo de unidades que o canal pode vender por noite |
| Tipo | Rigido, Flexivel ou Venda Livre |
Como Allotments funcionam com o Motor de Reservas
Os allotments sao verificados quando o Portal de Reservas bloqueia uma unidade para o hospede (hold). Reservas criadas no painel nao passam por essa verificacao.
- Busca o allotment ativo para o tipo de quarto, canal e data de check-in
- Conta as reservas existentes do mesmo tipo de quarto e canal que ocupam essa data (exceto canceladas e no-shows)
- Calcula
restante = limiteAllotment - reservados - Com base no tipo de allotment:
- Rigido e
restante <= 0— a reserva e rejeitada com erro de conflito - Flexivel, Venda Livre ou sem allotment — a reserva e aceita normalmente
- Rigido e
Dica: O “restante” e sempre calculado em tempo real com base na contagem real de reservas, nao decrementado.
Calendario, Criacao em Lote e Clonagem
A visao de calendario de allotments (limite, reservados e restante por data), a criacao em lote e a clonagem de allotments entre periodos estao disponiveis apenas pela API. A aba Receitas lista os allotments cadastrados e permite criar, editar e excluir um de cada vez.
Boas praticas de Allotment
- Comece com venda livre — So adicione allotments rigidos em canais que exigem controle estrito (ex: alocacoes contratadas de OTA)
- Use allotments flexiveis para sinalizar — Eles nao bloqueiam vendas
- Revise mensalmente — Mudancas sazonais de demanda podem exigir ajuste de limites
- Limites generosos no canal direto — Priorize reservas sem comissao do seu proprio site
Boas Praticas
- Sempre tenha um plano Default — E a rede de seguranca. Se nenhuma tarifa sazonal cobrir a noite, a tarifa do Default sera usada
- Prioridades em dezenas — Use prioridades como 0, 10, 20, 30. Isso deixa espaco para inserir planos intermediarios sem renumerar tudo
- Nao sobreponha planos da mesma prioridade — O resultado pode ser imprevisivel. Use prioridades distintas
- Revise tarifas antes de cada temporada — Agende uma revisao mensal para garantir que os planos estao atualizados
- Mantenha tarifas sem canal — Elas sao a base usada pelas reservas do painel e pelo Portal de Reservas
Integracao com outros modulos
- Unidades → Tarifas sao vinculadas a tipos de quarto ou unidades especificas; o preco base da unidade e o fallback
- Reservas → O preco da reserva e calculado a partir dos planos de tarifas vigentes, promocoes e descontos LOS
- Motor de Reservas → Exibe o preco final (com yield, promocoes e descontos LOS) no site publico
- Dashboard → Exibe ADR (Average Daily Rate) e RevPAR
- Channel Allotment → Allotments controlam limites de inventario por canal no Portal de Reservas
- Yield Management → Regras de yield aplicam ajustes automaticos sobre as tarifas base