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 aparecem no folio da reserva, somadas ao saldo devedor.
Quando é possível adicionar cobranças?
Cobranças extras só podem ser registradas quando a reserva está em um dos seguintes status:
| Status da reserva | Pode adicionar? | Cenário típico |
|---|---|---|
| Confirmada | Sim | Taxas pré-estadia (ex: early check-in, cama extra solicitada antecipadamente) |
| Em Estadia (Check-in) | Sim | Consumos durante a estadia (minibar, room service, spa) |
| Check-out realizado | Não | O folio já foi fechado |
| Cancelada / No-show | Não | Reserva encerrada |
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
Toda cobrança é avulsa: você informa a descrição, a quantidade e o preço unitário. Abaixo, os tipos mais comuns:
| Tipo | Exemplo |
|---|---|
| Minibar | Água mineral, cerveja, snacks |
| Serviço de quarto (Room Service) | Refeição entregue no quarto |
| Late check-out | Taxa por saída após o horário padrão |
| Early check-in | Taxa por entrada antes do horário padrão |
| Cama extra | Cama avulsa adicionada à unidade |
| Lavanderia | Lavagem e passadoria de roupas |
| Spa e bem-estar | Massagem, sauna, tratamentos |
| Estacionamento | Diária de garagem |
| Danos | Reparo de itens danificados pelo hóspede |
| Serviço personalizado | Qualquer cobrança avulsa definida pelo operador |
Como adicionar uma cobrança — Passo a Passo
Passo 1: Abrir o painel de cobranças
Você pode lançar cobranças em dois lugares:
- Folio — botão Adicionar Cobrança (descrição e valor)
- Mapa — clique na barra da reserva e abra a aba Cobranças do painel lateral. Este painel exibe todas as cobranças já registradas com o total parcial atualizado
Atenção: No painel do Mapa, o botão de adicionar aparece apenas para reservas Confirmadas. Para hóspedes em estadia, lance a cobrança pelo folio.
Passo 2: Clicar em ”+ Add”
No painel Cobranças do Mapa, o botão + Add (exibido em inglês) abre o diálogo Add Charge com os seguintes campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Descrição | Sim | Nome do item ou serviço (ex: “Minibar — 2x Água Mineral”) |
| Quantidade | Não | Número de unidades consumidas (padrão: 1) |
| Preço unitário | Sim | Valor por unidade em reais (ex: R$ 8,00) |
Passo 3: Conferir o valor total
O sistema calcula automaticamente:
Valor total = Quantidade × Preço unitárioExemplo: 3 unidades × R$ 12,00 = R$ 36,00
Passo 4: Confirmar
Clique em “Adicionar Cobrança”. 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 exibe um total parcial (running total) na parte inferior, que soma todas as cobranças registradas até o momento. Este valor é atualizado a cada adição ou remoção.
O folio do hóspede consolida:
| Componente | Origem |
|---|---|
| Diárias | Valor total da reserva, com o detalhe por noite |
| Cobranças extras | Registradas no folio ou no painel de cobranças |
| Pagamentos recebidos | Registrados via gateway ou manualmente |
| Saldo devedor | Diárias + Extras − Pagamentos |
Remover uma cobrança
Para corrigir lançamentos incorretos, é possível remover uma cobrança pelo painel do Mapa. Assim como o botão de adicionar, o ícone de remover só aparece para reservas Confirmadas; o folio não tem opção de remover cobranças.
- No painel Cobranças do Mapa, localize o item a ser removido
- Clique no ícone de lixeira ao lado do valor
- A cobrança é excluída imediatamente (não há diálogo de confirmação) e o total parcial é recalculado
Permissões por papel
As cobranças extras não são restritas por papel: qualquer usuário com acesso ao Mapa ou ao folio pode adicionar e remover cobranças.
Endpoints da API
Para integrações e automações, a API expõe os seguintes endpoints:
| Método | Endpoint | Descrição |
|---|---|---|
POST | /reservations/:id/add-charge | Adiciona uma cobrança à reserva |
GET | /reservations/:id/charges | Lista todas as cobranças da reserva |
GET | /reservations/:id/charges/total | Retorna o total acumulado de cobranças |
DELETE | /reservations/:id/charges/:chargeId | Remove uma cobrança específica |
Consulte a documentação da API para detalhes sobre autenticação, formato dos payloads e códigos de resposta.
Boas práticas
- Registre imediatamente — Lance consumos assim que ocorrerem. Cobranças registradas de última hora no check-out geram atrito com o hóspede e disputas.
- Padronize as descrições — Use sempre o mesmo nome para o mesmo item (ex: “Minibar — Água Mineral”) para facilitar a conferência.
- Revise antes do check-out — Oriente a equipe a revisar as cobranças antes de iniciar o check-out. Itens esquecidos (ex: frigobar não conferido) geram perda de receita.
- 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.
Próximos passos
- Check-out — Veja como conferir o saldo antes da saída
- Catálogo de Serviços — Configure os serviços disponíveis na propriedade
- Estoque — Gerencie o inventário da propriedade
- Contas a Receber — Para cobranças identificadas após o check-out