Excursões - Check-in de Passageiros

O que é

O Check-in confirma a presença do passageiro no dia da viagem e libera o embarque. Cada registro guarda data/hora, método (manual ou QR Code), quem registrou (operador admin ou guia), dispositivo, IP e - quando o guia usa o app mobile - também a latitude e longitude. O Check-out funciona no mesmo padrão, registrando o retorno do passageiro ao fim da viagem.

A página de Checklist é a central operacional desse fluxo: lista os passageiros agrupados por transporte e ponto de embarque, mostra pendências (contrato, documentos, pagamento), recebe em tempo real os escaneamentos feitos pelo Portal do Guia e permite acompanhar o avanço com o painel "Ver ao Vivo". O acesso é normalmente disparado no dia anterior, durante a preparação, e fica em uso ao longo do embarque.

Como usar

1. Abra a excursão em Viagens (Excursões) no sidebar e acesse o dropdown Outras páginas logo abaixo do cabeçalho. Clique em Checklist. A URL será /admin/excursoes/{excursao}/checklist.

2. Confira o painel de estatísticas gerais no topo:

   • Total: passageiros confirmados ou pendentes no transporte.
   • Aptos: sem pendências bloqueantes para embarcar.
   • Pendências: aguardando contrato, documento ou pagamento.
   • Check-in OK / Aguardando: já embarcaram x ainda não.
   • Check-out OK: já retornaram.
   • Presentes: percentual de check-ins sobre o total.

3. Use a barra de filtros para focar no que importa:

   • Buscar por nome, CPF, telefone… - campo de texto livre.
   • Todos embarques - filtra por ponto de embarque.
   • Todos status - Check-in Pendente, Check-in OK, Check-out Pendente, Check-out OK.
   • Todas pendências - Sem contrato assinado, Documentos pendentes, Pagamento pendente, Somente convidados, Somente dependentes.

4. Acompanhe ao vivo os check-ins feitos pelo guia: clique em Ver ao Vivo (botão verde no cabeçalho, só aparece de véspera até o dia seguinte da viagem). A tela passa a buscar atualizações a cada 8 segundos e dá um toast verde a cada novo registro. Para parar, clique no mesmo botão (agora vermelho, escrito Parar).

5. Veja os detalhes de um check-in: clique no horário verde ao lado do passageiro. O modal Detalhes do check-in mostra data/hora, embarque, método (manual ou QR Code), operador que registrou, dispositivo, IP e - se houver GPS - o mapa com link para o Google Maps. O mesmo vale para o check-out (botão roxo).

6. Cancele um registro errado: dentro do modal Detalhes, clique em Cancelar Registro (link vermelho à esquerda). Informe o motivo (obrigatório, até 500 caracteres) e confirme em Confirmar Cancelamento. A ação fica auditada.

7. Exporte a lista de embarque clicando em Exportar Lista (botão índigo no cabeçalho) - abre o modal para escolher campos, formato (PDF, Excel ou CSV) e perfil (Empresa, Guia, Seguradora).

Como o check-in é registrado

A página admin lista e monitora os check-ins - o registro em si acontece de três formas distintas:

Pelo guia no app (QR Code)

É o caminho recomendado no dia da viagem. O passageiro apresenta o cartão de embarque (gerado em Cartão de Embarque na linha de cada passageiro apto), o guia escaneia pelo Portal do Guia e o registro entra na lista com método QR Code e GPS preenchido. A atualização aparece sozinha quando o Ver ao Vivo está ligado.

Pelo guia no app (manual)

Quando o passageiro não tem o QR Code à mão, o guia abre a lista no celular e marca o passageiro pelo nome. O registro fica com método Manual e identifica o guia em "Registrado por".

Pelo admin no painel

Para correções pontuais, o admin também pode disparar check-in e check-out via os endpoints POST /admin/api/excursoes/{id}/checklist/checkin e POST /admin/api/excursoes/{id}/checklist/checkout, normalmente integrados a ações secundárias da tela. O método fica como Manual e "Registrado por" mostra o usuário admin logado.

Casos especiais

Reagir a um check-in duplicado

O sistema bloqueia automaticamente: tentativas no mesmo passageiro retornam Este passageiro já fez check-in. O registro original permanece. Se for engano, abra os detalhes e cancele antes de tentar de novo.

Cancelar um check-in que já tem check-out

Não é permitido. Aparece a mensagem Não é possível cancelar o check-in porque existe um check-out ativo. Cancele o check-out primeiro. Cancele primeiro o check-out (clique no horário roxo do passageiro) e depois volte para cancelar o check-in.

Passageiro com pendência (contrato, documento ou pagamento)

A linha do passageiro mostra os ícones em vermelho/laranja e o filtro Todas pendências ajuda a isolar quem ainda não está apto. O check-in em si não é bloqueado pela pendência - fica a critério do operador liberar ou não o embarque. Use os botões da linha para Enviar Contrato ou abrir o Cartão de Embarque e resolver antes.

Múltiplos pontos de embarque

Use o filtro Todos embarques para ver apenas quem sobe naquele ponto. As estatísticas internas de cada embarque continuam visíveis no cabeçalho azul de cada grupo.

Excursão com mais de um transporte (ônibus)

Cada transporte aparece em um bloco separado, com seu próprio contador de check-in/check-out. As estatísticas gerais no topo somam todos os transportes.

Encontrar o registro de quem fez o check-in

Abra Detalhes clicando no horário verde - o campo "Registrado por" mostra o nome do usuário admin ou guia, e "Dispositivo" identifica navegador e sistema operacional usados.

Erros comuns e como resolver

• "Este passageiro já fez check-in." - Causa: tentou registrar check-in duas vezes para o mesmo passageiro. Solução: abra os detalhes do check-in existente e cancele se foi engano; do contrário, ignore.

• "Este passageiro precisa fazer check-in primeiro." - Causa: tentou registrar o check-out antes do check-in. Solução: faça o check-in primeiro e depois o check-out.

• "Este passageiro já fez check-out." - Causa: check-out duplicado. Solução: abra os detalhes e cancele o registro anterior se necessário.

• "Não é possível cancelar o check-in porque existe um check-out ativo. Cancele o check-out primeiro." - Causa: ordem incorreta de cancelamento. Solução: clique no horário roxo (check-out) do passageiro, cancele esse registro, depois cancele o check-in.

• "Check-in não pertence a esta excursão." - Causa: tentou cancelar um registro vinculado a outra excursão (link antigo aberto, recarga manual de URL). Solução: volte ao checklist da excursão correta.

• Botão "Ver ao Vivo" não aparece - Causa: a data da excursão está fora da janela de 1 dia antes a 1 dia depois. Solução: o monitoramento só fica disponível nesse intervalo. Use o Mapa de Check-ins para consultar histórico após o evento.

Onde encontrar

• URL: /admin/excursoes/{excursao}/checklist
• Caminho no menu: Viagens (Excursões) > abrir a excursão > Outras páginas > Checklist
• Permissão necessária: ver as viagens
• Módulo necessário: nenhum (núcleo do produto)

Veja também

• Checklist de Embarque
• Mapa de Check-ins
• Gerenciar Passageiros
• Pontos de Embarque
• Check-in e Embarque (visão do passageiro)