Cobranças Extras

Cobranças extras são valores adicionais registrados na conta do hóspede durante a estadia, como consumo de minibar, serviço de quarto, lavanderia ou taxas avulsas. Todas as cobranças são consolidadas automaticamente no checkout e integradas à fatura final.

Quando é possível adicionar cobranças?

Cobranças extras só podem ser registradas quando a reserva está em um dos seguintes status:

Importante: Após o check-out, não é possível adicionar cobranças. Se houver consumo não registrado identificado após a saída do hóspede, é necessário criar um lançamento financeiro avulso em Contas a Receber.

Tipos de cobranças

O Opero suporta cobranças vinculadas ao catálogo de serviços da propriedade ou cobranças avulsas (manuais). Abaixo, os tipos mais comuns:

Dica: Cadastre os serviços recorrentes no Catálogo de Serviços da propriedade para padronizar preços e agilizar o lançamento. Cobranças vinculadas ao catálogo já vêm com descrição e preço unitário preenchidos.

Como adicionar uma cobrança — Passo a Passo

Passo 1: Abrir o painel de cobranças

Acesse a reserva desejada e localize o painel “Cobranças Extras” na aba lateral direita. Este painel exibe todas as cobranças já registradas com o total parcial atualizado.

Passo 2: Clicar em “Adicionar cobrança”

O botão “Adicionar cobrança” está disponível no topo do painel. Ao clicar, um diálogo é aberto com os seguintes campos:

Passo 3: Conferir o valor total

O sistema calcula automaticamente:

Valor total = Quantidade × Preço unitário

Exemplo: 3 unidades × R$ 12,00 = R$ 36,00

Passo 4: Confirmar

Clique em “Confirmar”. A cobrança aparece imediatamente no painel com o total parcial atualizado.

Total parcial e visão do fólio

O painel de cobranças extras exibe um total parcial (running total) na parte inferior, que soma todas as cobranças registradas até o momento. Este valor é atualizado em tempo real a cada adição ou remoção.

O fólio completo do hóspede (visível na aba “Financeiro” da reserva) consolida:

No momento do check-out, o sistema consolida todas as cobranças extras junto com as diárias para gerar a fatura final. Nenhuma cobrança é perdida.

Integração com estoque (consumo automático)

Quando uma cobrança é vinculada a um item de inventário (campo inventoryItemId), o Opero registra automaticamente uma movimentação de saída no módulo de Estoque com o tipo SALE (venda).

Como funciona:

1. O operador adiciona a cobrança e seleciona o item de estoque correspondente (ex: “Água Mineral 500ml”)
2. Ao confirmar, o sistema:
   • Registra a cobrança na conta do hóspede
   • Cria uma movimentação de saída no estoque (tipo: SALE)
   • Reduz o saldo disponível do item automaticamente
3. Se o item atingir o estoque mínimo, um alerta é gerado para reposição

Exemplo prático — Minibar:

Hóspede consome 2 cervejas do minibar
  → Cobrança: 2 × R$ 15,00 = R$ 30,00 (conta do hóspede)
  → Estoque: −2 unidades de "Cerveja Lager 350ml" (tipo: SALE)
  → Saldo anterior: 48 → Saldo atual: 46

Atenção: A integração com estoque é opcional. Cobranças avulsas (como “Danos” ou “Serviço personalizado”) não exigem vínculo com inventário.

Remover uma cobrança

Para corrigir lançamentos incorretos, é possível remover uma cobrança antes do check-out:

1. No painel de cobranças, localize o item a ser removido
2. Clique no botão “Remover” (disponível apenas para usuários com permissão)
3. Confirme a exclusão no diálogo de confirmação
4. O total parcial é recalculado automaticamente
5. Se a cobrança estava vinculada ao estoque, a movimentação de saída é estornada e o saldo é restaurado

Nota: A remoção é registrada na trilha de auditoria com o usuário responsável, data/hora e motivo.

Permissões por papel

O acesso às funcionalidades de cobranças extras varia conforme o papel do usuário:

Detalhamento:

• Recepcionista pode adicionar cobranças apenas durante a estadia (status “Em Estadia”). Não pode remover cobranças existentes — deve solicitar ao gerente.
• Gerente e Admin têm acesso completo: podem adicionar cobranças em qualquer status permitido e remover lançamentos incorretos.
• Financeiro visualiza as cobranças para fins de conferência e relatórios, mas não as manipula diretamente. A gestão de cobranças é uma atividade operacional, não financeira.

Endpoints da API

Para integrações e automações, a API expõe os seguintes endpoints:

Consulte a documentação da API para detalhes sobre autenticação, formato dos payloads e códigos de resposta.

Boas práticas

1. Registre imediatamente — Lance consumos assim que ocorrerem. Cobranças registradas de última hora no check-out geram atrito com o hóspede e disputas.
2. Use o catálogo de serviços — Itens cadastrados no catálogo padronizam preços e evitam erros de digitação. Cobranças manuais devem ser exceção, não regra.
3. Vincule ao estoque quando aplicável — O consumo automático mantém o controle de inventário atualizado sem trabalho adicional. Essencial para minibar e A&B.
4. Revise antes do check-out — Oriente a equipe a revisar o painel de cobranças antes de iniciar o check-out. Itens esquecidos (ex: frigobar não conferido) geram perda de receita.
5. Documente danos com detalhes — Ao cobrar por danos, inclua descrição clara (ex: “Dano — Toalha manchada, Quarto 205”). Isso protege a propriedade em caso de contestação.
6. Treine a equipe sobre permissões — Recepcionistas sabem que devem chamar o gerente para remover cobranças. Isso evita remoções indevidas e mantém a trilha de auditoria íntegra.

Próximos passos

• Check-out — Veja como as cobranças são consolidadas na fatura final
• Catálogo de Serviços — Configure os serviços disponíveis na propriedade
• Estoque — Gerencie o inventário e entenda as movimentações automáticas
• Contas a Receber — Para cobranças identificadas após o check-out