Reservas - Requisitos para Embarque

O que é

Na página de detalhes da reserva (/admin/reservas/{passageiro}) não existe um painel único chamado "Requisitos para Embarque". O que o Viagilize faz é verificar, automaticamente, três condições por passageiro para considerá-lo apto para embarque: aceite de contrato (quando exigido), documentos aprovados (quando exigidos) e pagamento realizado. O resultado dessa verificação aparece distribuído pelas seções da reserva e é consolidado de fato no Checklist da Excursão.

Você normalmente chega a essa página quando precisa entender por que um passageiro ainda aparece como pendente no checklist da viagem, ou quando o cliente liga perguntando o que falta enviar antes do embarque. As pendências reais vêm de quatro lugares na tela de detalhes: bloco Status da Reserva, seção Documentos, seção Pagamentos e os blocos de Cadastros Personalizados (que podem ser usados pela agência para registrar ficha médica, comprovante de vacina, autorização de menor, etc.).

Como usar

1. Vá em Reservas no sidebar e abra a reserva clicando na linha desejada.
2. No card Status da Reserva (coluna esquerda do topo), confira o campo Aceite em - ele só aparece quando o passageiro já registrou o aceite do contrato digital. Se a excursão exige contrato e essa linha estiver ausente, o aceite está pendente.
3. Role até a seção Documentos ("Recibos, contratos, notas fiscais"). Aqui ficam até 5 arquivos anexados à reserva (recibos, contratos, comprovantes de pagamento, notas fiscais). Use o botão Enviar no canto superior direito da seção para anexar comprovantes específicos da reserva (ex.: comprovante de vacina, autorização).
4. Verifique a seção Pagamentos: o valor pendente aparece no resumo financeiro e o histórico mostra cada lançamento. Pagamento pendente bloqueia a aptidão de embarque do titular.
5. Confira os blocos de Cadastros Personalizados (logo acima de Documentos). Cada bloco corresponde a um schema configurado pela agência (ficha médica, exigências adicionais, etc.) e exibe os registros vinculados à reserva. Use o botão Adicionar no cabeçalho de cada bloco para registrar uma nova entrada.
6. Para resolver pendências de pagamento, abra Ações (dropdown no topo) e use Gerar Link de Pagamento ou registre um pagamento manual na seção Pagamentos.
7. Para reenviar o contrato ao cliente, abra Ações > Reenviar Contrato (visível apenas com o módulo contratos-digitais ativo e reserva em status pendente ou confirmado).
8. Para conferir a visão consolidada de quem está apto, vá em Viagens > {excursão} > Checklist - lá aparecem os contadores Aptos e Pendências e cada passageiro com a lista de requisitos faltantes.

Casos especiais

Passageiro dependente

A regra é diferente para quem está marcado como dependente de um titular: ele herda o aceite de contrato e o status de pagamento do titular, mas precisa ter os próprios documentos aprovados (quando documentos são obrigatórios). Se o titular ainda não está apto, o dependente fica como "aguardando titular" mesmo que ele próprio esteja em ordem.

Excursão que não exige contrato ou documentos

Cada excursão pode sobrescrever a regra global da agência via os campos exigir_contrato e exigir_documentos. Se a excursão não exige um dos itens, ele não conta como pendência. O fallback é a configuração da Jornada do Cliente da sua empresa.

Cadastros Personalizados como checklist próprio da agência

A seção de Cadastros Personalizados é dinâmica: aparece apenas se a agência criou schemas com a entidade pai "reserva" e marcou o local de exibição reserva_show. É aqui que cabem ficha médica, comprovante de vacina, autorização de menor ou qualquer requisito extra - mas o preenchimento desses blocos não entra no cálculo automático de "apto para embarque": é controle operacional da equipe.

Documentos da reserva vs. documentos do cliente

A seção Documentos da reserva guarda arquivos vinculados àquela reserva específica (recibos, contratos assinados, comprovantes). Já a regra de "documentos aprovados" usada no aptoParaEmbarque consulta os documentos cadastrados no perfil do cliente (ver módulo de Clientes). Anexar arquivo na reserva não substitui aprovar o documento de identidade do cliente.

Erros comuns e como resolver

• Passageiro continua "Pendências" no checklist mesmo com tudo pago - Causa: documentos do cliente não foram aprovados ou contrato ainda não foi assinado. Solução: abrir o cliente em Cadastros > Clientes e aprovar o documento; usar Ações > Reenviar Contrato na reserva.
• Não aparece o botão Reenviar Contrato - Causa: módulo contratos-digitais desativado ou reserva cancelada. Solução: ativar o módulo em Plano Atual > Módulos ou reativar a reserva.
• Bloco de Cadastros Personalizados não aparece - Causa: nenhum schema configurado para a entidade reserva com local reserva_show. Solução: ir em Cadastros > Cadastros Personalizados e criar/ajustar o schema.
• Aceite registrado mas ainda consta como pendente - Causa: o aceite anterior foi invalidado por mudança no grupo do contrato (titular trocou, dependente entrou/saiu). Solução: reenviar o contrato pelo dropdown Ações para o cliente assinar novamente.

Onde encontrar

• URL: /admin/reservas/{passageiro}
• Caminho no menu: Reservas (clicar na reserva desejada na listagem)
• Permissão necessária: ver as reservas
• Módulo necessário: nenhum para a página em si. O bloco de contrato depende do módulo contratos-digitais.

Veja também

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