Folio
O Folio é a conta financeira de uma reserva. Ele consolida todas as cobranças, pagamentos e o saldo atual da estadia do hóspede em uma única visualização. Acesse-o pela lista de reservas clicando no ícone Ver Folio da reserva (ou pelo atalho Ir para o Fólio exibido após o check-in).
Cartões de Saldo
No topo do folio, quatro cartões de resumo fornecem uma visão financeira rápida:
| Cartão | O que exibe | Cálculo |
|---|---|---|
| Total Reserva | Valor da hospedagem | Valor total da reserva |
| Total Lançamentos | Cobranças extras | Soma das cobranças lançadas na reserva |
| Total Pago | Soma dos pagamentos aprovados | Pagamentos via gateway + pagamentos manuais aprovados |
| Saldo devedor | Saldo restante | Total Reserva + Total Lançamentos - Total Pago (positivo = hóspede deve; negativo = crédito/pagamento excedente) |
Dica: Quando o saldo é negativo, o cartão exibe como Crédito, indicando que o hóspede pagou a mais. Isso pode ocorrer após um cancelamento parcial ou ajuste de tarifa.
Detalhamento de Cobranças (Painel Esquerdo)
O lado esquerdo do folio lista cada cobrança associada à reserva:
Detalhe da Tarifa por Noite
Cada noite da estadia aparece como um item individual (data, nome da tarifa e valor), extraído do rateSnapshot da reserva. Esse snapshot captura a tarifa no momento da reserva, garantindo consistência de preço mesmo que as tarifas mudem posteriormente.
2026-06-10 (Diária Standard) ............ R$ 350,00
2026-06-11 (Diária Standard) ............ R$ 350,00
2026-06-12 (Diária Fim de Semana) ....... R$ 420,00Serviços e Extras
Quaisquer cobranças registradas pelo painel de Cobranças Extras aparecem abaixo das diárias, em Serviços:
- Consumo de minibar
- Serviço de quarto
- Taxa de late check-out
- Cobranças manuais/avulsas
Adicionando uma Cobrança Manual
Clique em “Adicionar Cobrança” para registrar um novo item diretamente no folio:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Descrição | Sim | Motivo da cobrança (ex: “Minibar — 2x Água”) |
| Valor | Sim | Valor da cobrança na moeda da propriedade |
Importante: Cobranças manuais adicionadas pelo folio são idênticas às registradas pelo painel de Cobranças Extras. Elas aparecem em ambas as visualizações. Só é possível adicionar cobranças em reservas Confirmadas ou Em Estadia.
Histórico de Pagamentos (Painel Direito)
O lado direito exibe todas as transações de pagamento associadas à reserva:
Lista de Transações
Cada registro de pagamento exibe:
| Coluna | Descrição |
|---|---|
| Provedor | Nome do gateway (Stripe, GetNet, PIX, etc.) ou “Manual” |
| Status | Status da transação (aprovada, pendente, falhou, expirada) |
| Valor | Valor da transação |
| Data | Quando a transação foi processada |
Registrando um Pagamento Manual
Clique em “Registrar Pagamento” para registrar um pagamento recebido fora do gateway:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Valor | Sim | Valor do pagamento recebido |
| Método | Sim | Dinheiro, Transferência Bancária ou Outro |
| Observações | Não | Número de referência, detalhes do recibo ou qualquer nota relevante |
Dica: Use pagamentos manuais para dinheiro recebido na recepção ou transferências bancárias confirmadas fora do sistema. Sempre inclua uma referência nas observações para fins de auditoria.
Após o check-out ou o cancelamento, o folio fica bloqueado: não é possível adicionar cobranças nem registrar pagamentos.
Substituição de Pagamento (Override)
Em situações excepcionais, o status de pagamento pode ser definido manualmente pelo botão Sobrescrever Pagamento:
| Override | Significado | Quando usar |
|---|---|---|
| LOSS (Perda) | Perda irrecuperável | Hóspede saiu sem pagar; dívida considerada incobrável |
| VOLUNTEER (Voluntário) | Estadia voluntária — nenhum pagamento esperado | Hospedagem em troca de trabalho voluntário |
Para aplicar:
- Selecionar o tipo de override
- Informar um motivo (opcional)
- Confirmar a ação
Perda pode ser aplicada a reservas com pagamento Pendente, Parcial ou aguardando repasse da OTA; Voluntário, apenas a reservas com pagamento Pendente.
Atenção: Substituições de pagamento são definitivas. Elas mudam o status de pagamento da reserva (os valores do folio não mudam) e não podem ser revertidas pela interface. A sincronização automática de pagamentos nunca sobrescreve esses status.
Ciclo de Vida do Status de Pagamento
Toda reserva segue uma progressão de status de pagamento:
PENDING ──▶ PARTIAL ──▶ PAID
│ │
│ └──▶ LOSS
├──▶ LOSS
└──▶ VOLUNTEER| Status | Condição |
|---|---|
| PENDING (Pendente) | Nenhum pagamento registrado ainda |
| PARTIAL (Parcial) | Algum pagamento recebido, mas abaixo do total da reserva |
| PAID (Pago) | Total pago igual ou superior ao total da reserva (as cobranças extras não entram nessa comparação) |
| LOSS (Perda) | Definido manualmente via override |
| VOLUNTEER (Voluntário) | Definido manualmente via override |
| REFUNDED (Reembolsado) | Status reservado para reembolsos; hoje nenhum fluxo o aplica automaticamente |
Integração com o Módulo Financeiro
O folio não existe isoladamente — ele se conecta ao sistema financeiro mais amplo:
- Contas a Receber (AR): No check-in, o sistema cria a conta a receber da reserva com o valor da reserva mais as cobranças lançadas até aquele momento, e contabiliza a receita no razão. Reservas pagas em dinheiro são liquidadas automaticamente na conta caixa padrão
- Pagamentos: Pagamentos registrados no folio atualizam o Total Pago e o status de pagamento da reserva
- Fluxo de Check-out: No check-out, o sistema avisa se ainda há saldo devedor no folio, mas não bloqueia a saída
Boas Práticas
- Registre cobranças de minibar antes do check-out — instrua a governança a reportar consumo de minibar antecipadamente. Depois do check-out o folio fica bloqueado.
- Concilie os folios diariamente — revise os folios abertos de hóspedes em estadia para detectar divergências antes que se acumulem.
- Use pagamentos manuais como último recurso — sempre prefira transações via gateway para rastreabilidade. Pagamentos manuais devem ser exceção para dinheiro ou transferências offline.
- Documente overrides detalhadamente — ao marcar uma reserva como Perda ou Voluntário, preencha o motivo para referência futura.
- Verifique o rate snapshot — se um hóspede contestar a tarifa da diária, o rateSnapshot mostra exatamente o que foi cotado no momento da reserva.
Solução de Problemas
| Problema | Causa possível | Solução |
|---|---|---|
| Saldo não bate com o total esperado | Cobranças extras não registradas ou ajuste de tarifa pendente | Revise o detalhamento de cobranças; verifique se minibar ou serviços não foram lançados |
| Pagamento aparece como “falhou” | Problema na configuração do gateway ou cartão recusado | Verifique as configurações do gateway de pagamento na configuração da propriedade; solicite ao hóspede um método alternativo |
| Pagamento excedente aparecendo como crédito | Cancelamento parcial após pagamento ou pagamento duplicado | Verifique o histórico de transações; solicite um reembolso se apropriado |
| Botões “Adicionar Cobrança” e “Registrar Pagamento” desabilitados | A reserva já fez check-out ou foi cancelada | O folio fica bloqueado nesses status |
Próximos Passos
- Cobranças Extras — como registrar cobranças adicionais na conta do hóspede
- Check-out — o processo de saída e fechamento financeiro
- Contas a Receber — rastreamento de saldos pendentes após o check-out
- Grupos de Reservas — reservas de grupo