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 a partir da página de detalhes de qualquer reserva clicando na aba Folio.

Cartões de Saldo

No topo do folio, três cartões de resumo fornecem uma visão financeira rápida:

Cartão	O que exibe	Cálculo
Total	Valor total devido pela estadia	Diárias (do rate snapshot) + cobranças extras
Pago	Soma de todas as transações aprovadas	Pagamentos via gateway + pagamentos manuais (status = aprovado)
A Receber	Saldo restante	Total - Pago (positivo = hóspede deve; negativo = crédito/pagamento excedente)

Dica: Quando o valor a receber é 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, 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.


Noite 1 — 10 Jun, 2026 .................. R$ 350,00
Noite 2 — 11 Jun, 2026 .................. R$ 350,00
Noite 3 — 12 Jun, 2026 .................. R$ 420,00  (tarifa fim de semana)
───────────────────────────────────────────────────────
Subtotal diárias ......................... R$ 1.120,00

Serviços e Extras

Quaisquer cobranças registradas pelo painel de Cobranças Extras aparecem abaixo das diárias:

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.

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	Ícone do gateway (Stripe, PIX, etc.) ou “Manual”
Status	Aprovado, pendente, falhou ou reembolsado
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, PIX 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.

Substituição de Pagamento (Override)

Em situações excepcionais, o saldo do folio pode ser resolvido sem um pagamento padrão:

Override	Significado	Quando usar
LOSS (Perda)	Baixa do saldo pendente	Hóspede saiu sem pagar; dívida considerada incobrável
VOLUNTEER (Voluntário)	Marcar como pago fora do sistema	Pagamento recebido por canal não rastreado pelo Opero

Ambas as substituições exigem:

Selecionar o tipo de override
Informar um motivo (campo de texto obrigatório)
Confirmar a ação

Atenção: Substituições de pagamento são ações destrutivas. Uma vez aplicadas, o saldo é zerado e a reserva é marcada de acordo. Esta ação é registrada na trilha de auditoria e não pode ser desfeita sem intervenção gerencial.

Ciclo de Vida do Status de Pagamento

Toda reserva segue uma progressão de status de pagamento:


PENDING ──▶ PARTIAL ──▶ PAID
                │
                ├──▶ LOSS
                ├──▶ VOLUNTEER
                └──▶ REFUNDED

Status	Condição
PENDING (Pendente)	Nenhum pagamento registrado ainda
PARTIAL (Parcial)	Algum pagamento recebido, mas saldo pendente restante
PAID (Pago)	Total pago igual ou superior ao total de cobranças
LOSS (Perda)	Saldo baixado via override
VOLUNTEER (Voluntário)	Saldo marcado como pago externamente via override
REFUNDED (Reembolsado)	Reembolso total processado após pagamento concluído

Integração com o Módulo Financeiro

O folio não existe isoladamente — cada ação alimenta o sistema financeiro mais amplo:

Contas a Receber (AR): Cada cobrança cria um registro correspondente em Contas a Receber, rastreando o que a propriedade tem a receber
Lançamentos Contábeis: Pagamentos geram lançamentos em partida dobrada (débito caixa/banco, crédito receita)
Fluxo de Check-out: No check-out, o sistema verifica o saldo do folio. Valores pendentes devem ser resolvidos (pagos, substituídos ou reconhecidos) antes de concluir a saída
Trilha de Auditoria: Cada adição de cobrança, registro de pagamento e override é registrado com o usuário, data/hora e detalhes da ação

Boas Práticas

Registre cobranças de minibar antes do check-out — instrua a governança a reportar consumo de minibar antecipadamente. Cobranças de última hora atrasam a saída e frustram os hóspedes.
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 dar baixa em um saldo (LOSS) ou marcar como VOLUNTEER, forneça um motivo detalhado. Auditores irão revisar esses registros.
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; processe um reembolso se apropriado
Não é possível concluir o check-out	Saldo pendente não resolvido	Registre o pagamento restante, aplique override ou ajuste as cobranças antes do check-out

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 — faturamento consolidado para estadias em grupo