Reservas - Cancelar Reserva

O que é

Cancelar uma reserva é a ação que encerra a participação de um passageiro em uma excursão ou pacote, liberando a vaga para que outro cliente possa ocupá-la. O cancelamento exige sempre um motivo escrito, fica registrado no histórico da reserva (com data, autor e justificativa) e marca o registro financeiro vinculado como cancelado.

O atendente normalmente chega a esta ação após contato do cliente informando desistência, em casos de não-comparecimento ou quando o pagamento não é realizado dentro do prazo combinado. O cancelamento é feito a partir da tela de detalhes da reserva - não existe ação de cancelamento em massa na listagem.

Como usar

1. Vá em Reservas no sidebar e localize o passageiro pela busca, filtros ou ordenação da listagem.
2. Clique na linha da reserva para abrir a tela de detalhes em /admin/reservas/{passageiro}.
3. No topo da página, clique no botão Ações e selecione Cancelar Reserva (opção em vermelho, com ícone de X). Essa opção só aparece quando o status atual é Pendente ou Confirmado.
4. No modal Cancelar Reserva, preencha:
   • Motivo do Cancelamento - obrigatório, até 500 caracteres. Descreva por que a reserva está sendo encerrada (ex.: desistência do cliente, falta de pagamento, motivo médico). Esse texto vai para o histórico e fica visível no card vermelho de Reserva Cancelada dentro da própria tela.
5. Clique em Confirmar Cancelamento. O sistema exibe o toast "Reserva cancelada com sucesso!" e atualiza a tela com o status Cancelado.

Casos especiais

Cancelamento do titular cancela o grupo inteiro

Quando o passageiro cancelado é o comprador (titular do pedido) e a reserva está vinculada a um order_id, o sistema cancela automaticamente todos os outros passageiros do mesmo pedido que ainda não foram cancelados. Use com atenção: ao cancelar o titular, toda a família/grupo é encerrada de uma vez.

Cancelamento de acompanhante ajusta o financeiro do titular

Se o cancelado é um acompanhante (não-titular) com valor cobrado, o sistema subtrai o valor desse acompanhante do registro financeiro do titular e da Order correspondente, recalculando valor total e valor pendente. O status do financeiro do titular passa para pago, parcial ou pendente conforme o saldo restante.

Reserva com check-in não pode ser cancelada

Reservas em que o passageiro já fez check-in (campo checkin_em preenchido) não podem ser canceladas pelo painel - a opção Cancelar Reserva nem aparece no dropdown. O mesmo vale para reservas que já estão em status Cancelado, Transferido ou No Show.

Reativar uma reserva cancelada

A partir da tela de detalhes de uma reserva cancelada, o dropdown Ações mostra a opção Reativar Reserva (Pendente), que devolve a reserva ao status Pendente sem precisar criar de novo.

Excluir definitivamente uma reserva cancelada

Apenas reservas com status Cancelado podem ser excluídas. No dropdown de ações da reserva cancelada, a opção Excluir Reserva abre um modal de confirmação ("Esta reserva será removida das listagens. Deseja continuar?"). A exclusão é soft delete - o registro some das listagens mas permanece no banco.

Alocação de quarto é desfeita

Ao cancelar, o sistema remove o passageiro de qualquer quarto em que ele estava alocado (registros em QuartoPassageiro são apagados), liberando a vaga no rooming list da hospedaria.

Estorno do pagamento não é automático

O cancelamento marca o financeiro como cancelado, mas não devolve dinheiro ao cliente. Se houver pagamentos confirmados, o estorno precisa ser feito manualmente na aba Pagamentos da reserva, seguindo a política de reembolso da empresa.

Erros comuns e como resolver

• "Esta reserva não pode ser cancelada." - Causa: a reserva está em status que não permite cancelamento (Cancelado, Transferido, No Show) ou o passageiro já fez check-in. Solução: confira o status atual no topo da tela; se for check-in indevido, peça para o operacional reverter o check-in antes.
• "The motivo field is required." ou validação falhando no modal - Causa: o campo Motivo do Cancelamento ficou em branco. Solução: escreva o motivo (mínimo 1 caractere, máximo 500) antes de clicar em Confirmar Cancelamento.
• "Erro ao cancelar reserva." - Causa: falha inesperada na transação (problema de banco, integridade financeira, etc.). Solução: recarregue a página e tente novamente; se persistir, abra um chamado no suporte informando o código da reserva.
• "Apenas reservas canceladas podem ser excluídas." - Causa: tentativa de excluir reserva ainda ativa via rota de destroy. Solução: cancele a reserva primeiro; depois a opção Excluir Reserva ficará disponível no dropdown.

Onde encontrar

• URL: /admin/reservas (listagem) e /admin/reservas/{passageiro} (detalhes, onde a ação acontece)
• Caminho no menu: Reservas (item fixo do sidebar)
• Permissão necessária: editar as reservas (a rota admin.reservas.cancelar exige essa permissão)
• Módulo necessário: nenhum

Veja também

• Confirmar Reserva
• Status da Reserva
• Pagamentos da Reserva
• Detalhes da Reserva