Skip to Content
PMS CoreReservasCharges e Extras

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 reservaPode adicionar?Cenário típico
ConfirmadaSimTaxas pré-estadia (ex: early check-in, cama extra solicitada antecipadamente)
Em Estadia (Check-in)SimConsumos durante a estadia (minibar, room service, spa)
Check-out realizadoNãoO folio já foi fechado
Cancelada / No-showNãoReserva 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:

TipoExemplo
MinibarÁgua mineral, cerveja, snacks
Serviço de quarto (Room Service)Refeição entregue no quarto
Late check-outTaxa por saída após o horário padrão
Early check-inTaxa por entrada antes do horário padrão
Cama extraCama avulsa adicionada à unidade
LavanderiaLavagem e passadoria de roupas
Spa e bem-estarMassagem, sauna, tratamentos
EstacionamentoDiária de garagem
DanosReparo de itens danificados pelo hóspede
Serviço personalizadoQualquer 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:

CampoObrigatórioDescrição
DescriçãoSimNome do item ou serviço (ex: “Minibar — 2x Água Mineral”)
QuantidadeNãoNúmero de unidades consumidas (padrão: 1)
Preço unitárioSimValor por unidade em reais (ex: R$ 8,00)

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 “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:

ComponenteOrigem
DiáriasValor total da reserva, com o detalhe por noite
Cobranças extrasRegistradas no folio ou no painel de cobranças
Pagamentos recebidosRegistrados via gateway ou manualmente
Saldo devedorDiá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.

  1. No painel Cobranças do Mapa, localize o item a ser removido
  2. Clique no ícone de lixeira ao lado do valor
  3. 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étodoEndpointDescrição
POST/reservations/:id/add-chargeAdiciona uma cobrança à reserva
GET/reservations/:id/chargesLista todas as cobranças da reserva
GET/reservations/:id/charges/totalRetorna o total acumulado de cobranças
DELETE/reservations/:id/charges/:chargeIdRemove 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

  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. Padronize as descrições — Use sempre o mesmo nome para o mesmo item (ex: “Minibar — Água Mineral”) para facilitar a conferência.
  3. 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.
  4. 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

Last updated on