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.
Os servicos ficam em Operacoes → Servicos (tela Catalogo de Servicos) e fazem parte do add-on pago Operations Services (operations.services), contratado na Loja Opero; o mesmo add-on libera Ocorrencias e Produtos.
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 (2 casas decimais) |
| Tipo de preco | Texto livre, padrao fixed (valor fixo); apenas informativo, nao entra em nenhum calculo |
| Disponivel | Se o servico esta ativo para venda |
| Popular | Servicos populares aparecem primeiro na listagem do catalogo |
| Uso no mes | Somado automaticamente (pela quantidade) quando o servico entra na reserva por um bundle; cobrancas avulsas nao contam e o contador nao e zerado a cada mes |
| Receita no mes | Soma automatica dos valores cobrados via bundle (mesmas regras do uso no mes) |
Categorias de servico
O formulario da tela oferece estas categorias:
| Categoria | Rotulo na tela | Exemplos |
|---|---|---|
| room | Quarto | Decoracao do quarto |
| food | Alimentos e Bebidas | Cafe da manha, almoco, jantar, minibar, bar |
| wellness | Bem-estar | Massagem, sauna, hidromassagem |
| transport | Transporte | Transfer aeroporto, estacionamento, aluguel de bicicleta |
| housekeeping | Governanca | Lavanderia, passadoria |
A categoria e um texto livre: pela API, qualquer valor e aceito, e o padrao e other.
Criando um Servico
- Acesse Operacoes → Servicos
- Clique em Novo Servico
- Preencha nome, categoria e preco
- Opcionalmente, adicione descricao
- Clique em Salvar
Atencao: nesta versao, o botao Salvar desse formulario ainda nao grava o servico; o cadastro (inclusive a marcacao de “popular”) so e concluido pela API.
Na reserva, a cobranca e avulsa (descricao e valor): a tela da reserva ainda nao escolhe servicos do catalogo.
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, pode-se escolher quais itens opcionais incluir (sem escolha, todos entram). Itens obrigatorios sao sempre adicionados.
Criando um Bundle
Na tela Operacoes → Servicos, a secao Pacotes de Servicos lista os bundles, com os servicos incluidos e o desconto. O botao Novo Pacote ainda nao abre formulario: o bundle e criado pela API, em duas etapas:
- Cadastre nome, descricao e tipo de precificacao
- Adicione os servicos do catalogo ao bundle:
- O servico
- A quantidade (ex: 2x Cafe da Manha)
- Se e opcional
Aplicando um Bundle a uma Reserva
O bundle e aplicado a reserva pela API (a tela da reserva ainda nao tem essa opcao), informando os itens opcionais escolhidos. O bundle precisa estar disponivel e dentro do periodo de validade.
O sistema cria automaticamente um lancamento de servico na reserva para cada item, com o preco do catalogo ajustado proporcionalmente ao preco do bundle (o motor de precos nao e usado).
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 (da maior para a menor) sobre o preco base do catalogo.
As regras sao cadastradas e simuladas (pre-visualizacao do preco final) pela API; ainda nao ha tela. O preco calculado nao e aplicado automaticamente aos lancamentos na reserva nem as diarias.
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 e encerra a avaliacao (as regras seguintes sao ignoradas) |
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,00As 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:
- Usa o valor informado no lancamento (as regras dinamicas nao sao aplicadas)
- Cria um registro de
reservation_servicevinculado a reserva - O valor aparece no folio da reserva (Folio da Reserva → Cobrancas) e entra no saldo devedor
- No check-in, o titulo a receber da reserva e gerado com a diaria mais os servicos lancados ate esse momento
Lancamento durante a estadia
A equipe operacional pode lancar servicos a qualquer momento enquanto a reserva estiver confirmada ou com check-in feito (status confirmed ou 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 → atendente lanca o servico
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 — Eles aparecem primeiro na listagem do catalogo
- 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 → Nao ha baixa automatica: lancar um servico na reserva nao consome estoque (o consumo e registrado no Estoque)
- Financeiro → Os servicos lancados ate o check-in entram no titulo a receber da reserva, junto com a diaria e na mesma conta de receita (sem classificacao separada por tipo de receita)
- Dashboard → Os servicos lancados nas reservas entram no card GMV (Receita Bruta) (realizado e esperado)