Servicos e Bundles

O modulo de Servicos do Opero gerencia todo o catalogo de produtos e servicos adicionais oferecidos pela propriedade: minibar, lavanderia, spa, estacionamento, cafe da manha, room service e qualquer outro item que possa ser cobrado durante a estadia de um hospede.

Catalogo de Servicos

O catalogo de servicos e a lista central de tudo que sua propriedade oferece alem da hospedagem. Cada servico possui:

Campo	Descricao
Nome	Nome do servico (ex: “Cafe da Manha Buffet”)
Slug	Identificador URL-friendly (gerado automaticamente)
Categoria	Classificacao do servico (veja tabela abaixo)
Descricao	Texto descritivo para o hospede
Preco	Valor unitario (em reais, 2 casas decimais)
Tipo de preco	`fixed` (valor fixo) ou variavel
Disponivel	Se o servico esta ativo para venda
Popular	Destaque na interface (badge de “popular”)
Uso no mes	Contagem automatica de vezes que foi cobrado
Receita no mes	Soma automatica dos valores cobrados

Categorias de servico

Categoria	Exemplos
food	Cafe da manha, almoco, jantar, lanche
beverage	Minibar, bar, drinks
spa	Massagem, sauna, hidromassagem
laundry	Lavanderia, passadoria
transport	Transfer aeroporto, estacionamento, aluguel de bicicleta
entertainment	Tour guiado, mergulho, passeio de barco
business	Sala de reuniao, impressao, coworking
other	Qualquer outro servico nao classificado

Criando um Servico

Acesse Menu lateral → Servicos (dentro da propriedade ativa)
Clique em Novo Servico
Preencha nome, categoria e preco
Opcionalmente, adicione descricao e marque como “popular”
Salve

O servico estara imediatamente disponivel para ser lancado em reservas ativas.

Dica: Use nomes claros e padronizados. “Cafe da Manha Buffet - Adulto” e melhor que “CM Adulto”. O hospede pode ver esses nomes no extrato do check-out.

Bundles (Pacotes)

Um Bundle e um pacote que combina multiplos servicos do catalogo com um preco especial. Exemplos:

Pacote Romantico: Jantar + Spa + Decoracao do quarto
Pacote Familia: Cafe da manha (4 pessoas) + Estacionamento + Tour infantil
All-Inclusive Basico: Cafe + Almoco + Jantar + Minibar

Tipos de precificacao de bundle

Tipo	Descricao	Exemplo
FLAT_PRICE	Preco fixo unico para o pacote inteiro	Pacote Romantico: R$ 450 (independente da soma dos itens)
SUM_WITH_DISCOUNT	Soma dos itens com desconto percentual	3 servicos de R$ 100 cada, 15% de desconto = R$ 255
SUM_NO_DISCOUNT	Soma dos itens sem desconto	Agrupamento sem beneficio de preco (conveniencia)

Campos do bundle

Campo	Descricao
Nome	Nome do pacote (ex: “Pacote Lua de Mel”)
Descricao	Texto descritivo do que esta incluso
Tipo de preco	FLAT_PRICE, SUM_WITH_DISCOUNT ou SUM_NO_DISCOUNT
Preco fixo	Valor (quando tipo = FLAT_PRICE)
Desconto (%)	Percentual de desconto (quando tipo = SUM_WITH_DISCOUNT)
Valido de/ate	Periodo de disponibilidade do pacote
Itens	Lista de servicos inclusos com quantidade e opcionalidade

Itens opcionais

Cada item dentro de um bundle pode ser marcado como opcional. Quando o bundle e aplicado a uma reserva, o hospede (ou o atendente) pode escolher quais itens opcionais incluir. Itens obrigatorios sao sempre adicionados.

Criando um Bundle

Acesse Menu lateral → Servicos → Bundles
Clique em Novo Bundle
Preencha nome, descricao e tipo de precificacao
Adicione os servicos do catalogo ao bundle:
- Selecione o servico
- Defina a quantidade (ex: 2x Cafe da Manha)
- Marque como opcional se aplicavel
Salve

Aplicando um Bundle a uma Reserva

Na tela da reserva, clique em Adicionar Servico → Bundle
Selecione o bundle desejado
Escolha os itens opcionais (se houver)
Confirme

O sistema cria automaticamente os lancamentos de servico na reserva, cada um com o valor proporcional calculado pelo motor de precos.

Motor de Precos (Pricing Engine)

O motor de precos calcula o valor final de servicos e unidades aplicando regras dinamicas. As regras sao avaliadas em ordem de prioridade sobre o preco base do catalogo.

Tipos de regra

Tipo	Descricao
SEASONAL	Ajuste por periodo (ex: +20% no Reveillon)
DAY_OF_WEEK	Ajuste por dia da semana (ex: +10% no sabado)
OCCUPANCY	Ajuste por taxa de ocupacao da propriedade
LENGTH_OF_STAY	Ajuste pela duracao da estadia
EARLY_BIRD	Desconto para reserva antecipada
LAST_MINUTE	Ajuste para reserva de ultima hora

Tipos de ajuste

Ajuste	Descricao
PERCENTAGE	+15% ou -10% sobre o preco atual
FIXED_AMOUNT	+R$ 50 ou -R$ 20 sobre o preco atual
OVERRIDE	Substitui o preco (para a avaliacao)

Fluxo de avaliacao


Preco base do catalogo
  → Regra 1 (prioridade 100): SEASONAL +20% → R$ 120,00
  → Regra 2 (prioridade 50): EARLY_BIRD -10% → R$ 108,00
  → Preco final: R$ 108,00

As regras podem ser vinculadas a um servico especifico, a uma unidade especifica, ou aplicadas globalmente a toda a propriedade.

Integracao com Reservas

Quando um servico e lancado em uma reserva, o sistema:

Calcula o preco final (catalogo + regras dinamicas)
Cria um registro de reservation_service vinculado a reserva
O valor aparece no extrato do hospede
No check-out, os servicos sao somados ao total da conta

Lancamento durante a estadia

A equipe operacional pode lancar servicos a qualquer momento enquanto a reserva estiver com status checked_in:

Minibar: Hospede consumiu itens → atendente lanca servico “Minibar” com o valor
Lavanderia: Roupas coletadas → servico lancado com quantidade de pecas
Room service: Pedido entregue → servico lancado automaticamente

Boas Praticas

Categorize corretamente — Uma boa categorizacao facilita relatorios e analises por departamento
Revise precos periodicamente — Atualize valores do catalogo antes de cada temporada
Use bundles para aumentar o ticket medio — Pacotes com desconto incentivam o consumo de multiplos servicos
Nao crie servicos duplicados — Mantenha um catalogo limpo. Se o preco mudou, atualize o servico existente
Marque servicos populares — O badge de “popular” destaca os servicos mais vendidos na interface
Use itens opcionais em bundles — Permita personalizacao sem criar dezenas de pacotes diferentes
Configure regras de preco com cuidado — Regras acumulam. Teste o preco final antes de ativar

Integracao com outros modulos

Reservas → Servicos sao lancados como charges na reserva ativa
Estoque → Servicos de minibar e F&B podem ter vinculo com itens de estoque (consumo automatico)
Financeiro → Receita de servicos e classificada por tipo de receita nos relatorios USALI
Motor de Reservas → Bundles podem ser oferecidos como add-ons durante a reserva online
Dashboard → Receita anciliar (non-room revenue) e calculada a partir dos servicos