Passageiros - Check-in e Embarque

O que é

O fluxo de embarque no Viagilize tem duas etapas distintas, executadas por pessoas e telas diferentes:

1. Cadastro do ponto de embarque - feito pelo administrador no painel da excursão. Define onde e quando o passageiro deve estar (local, endereço, cidade, data, hora de saída e hora prevista de retorno). É pré-requisito para vender vagas com escolha de embarque e para emitir vouchers com endereço correto.
2. Check-in e check-out do passageiro - feito pelo guia (ou admin) em campo, no momento da viagem, pelo app do guia. Confirma a presença lendo o QR Code do voucher ou digitando o código de 6 a 20 caracteres.

Você normalmente chega aqui logo após criar a excursão (para cadastrar pelo menos um embarque antes de abrir as vendas) e novamente no dia da viagem (para conferir presença).

Como usar

Cadastrar um ponto de embarque (admin)

1. Vá em Excursões no menu lateral e abra a excursão desejada.
2. Role até o card Pontos de Embarque e clique em Adicionar (botão azul no canto superior direito do card).
3. Preencha o modal Novo Ponto de Embarque:
   • Disponível para - aparece só se a excursão tem mais de um veículo. Deixe "Todos os veículos" para que o embarque seja compartilhado ou escolha um veículo específico para restringir.
   • Nome do Local - obrigatório. Ex: "Terminal Rodoviário de Campinas". Use o botão Buscar (lupa ao lado) para reutilizar locais já cadastrados em outras excursões.
   • CEP - opcional. Ao digitar 8 dígitos o sistema busca o endereço automaticamente e preenche estado e cidade.
   • Ponto de Referência - texto livre tipo "próximo ao posto de gasolina".
   • Estado e Cidade - obrigatórios. Cidade carrega depois de escolher o estado.
   • Endereço - rua, número e bairro.
   • Data de Embarque - obrigatório. Aceita de 1 dia antes do início da excursão até 1 dia depois do fim. Use a data do dia seguinte quando o embarque é após meia-noite.
   • Hora de Embarque - recomendado. Aparece no site e no voucher.
   • Hora de Retorno - opcional. Hora prevista de retorno ao mesmo local.
4. Clique em Adicionar no rodapé do modal.

Reordenar e renumerar pontos de embarque

Cada item da lista mostra setas para cima/baixo à esquerda e um número verde indicando a ordem. A ordem é gravada automaticamente ao mover.

• Use as setas para mover um passo por vez.
• Clique no número verde para digitar uma posição específica (ex: passar do 5 para o 1) e confirme no botão de check.

Alterar datas em massa (ida e volta)

Quando uma excursão é remarcada inteira, em vez de editar embarque por embarque:

1. No card Pontos de Embarque clique em Alterar Datas (botão âmbar, só aparece se já existe pelo menos 1 embarque).
2. No modal informe Data de Ida e/ou Data de Volta.
3. O sistema decide quais embarques são de "volta" pelo nome (qualquer embarque cujo nome contém "volta" cai no grupo volta; o resto vai como ida).
4. Embarques cujo horário cruza a meia-noite recebem D+1 automaticamente (ex: ida sai 22h, primeiro retorno marcado para 01h fica no dia seguinte).
5. Clique em Aplicar Datas e confirme.

Fazer check-in do passageiro (guia em campo)

1. O guia abre /guia/scanner no celular (também acessível pelo admin com mesma URL).
2. Libera permissões de câmera e localização quando o navegador pedir (sem isso o scanner não funciona).
3. Seleciona a excursão do dia e o transporte correto (carro, ônibus etc.) na tela.
4. Aponta a câmera para o QR Code do voucher do passageiro ou digita manualmente o código (entre 6 e 20 caracteres).
5. O sistema chama a validação, exibe nome, status e ponto de embarque do passageiro. Confirme para registrar o check-in.
6. Latitude e longitude são gravadas junto com o check-in para fins de auditoria.

Fazer check-out (final da viagem)

Mesmo fluxo do check-in, mas o passageiro precisa ter feito check-in antes. Útil para registrar quem efetivamente retornou ao final do passeio. O check-out só pode ser feito uma vez por passageiro.

Conferir o mapa de embarque (relatório)

No menu do guia, dentro da excursão, abra Relatório de Embarque. Mostra:

• Mapa visual de assentos por transporte (se o veículo tem layout cadastrado).
• Lista de passageiros agrupados por ônibus, com ponto de embarque, telefone e indicador de check-in feito.
• Passageiros sem transporte atribuído listados à parte.

Casos especiais

Reutilizar um ponto de embarque já usado em outra excursão

No modal Novo Ponto de Embarque, clique em Buscar (lupa ao lado do campo Nome). O sistema sugere os pontos mais usados em outras excursões, agrupados por nome+cidade+estado, ordenando primeiro os mais completos (com CEP e endereço). Pode filtrar por nome, cidade, endereço ou CEP.

Para tirar um endereço antigo da lista de sugestões, passe o mouse no item e clique no ícone de olho riscado. O ponto fica oculto da busca mas os embarques já vinculados a excursões não são alterados.

Excursão de vários dias com embarque a partir do segundo dia

O sistema aceita qualquer data entre data_inicio - 1 dia e data_fim + 1 dia. Para um embarque no segundo dia do roteiro, basta selecionar a data correta no campo Data de Embarque - não precisa ser o primeiro dia da excursão.

Excursão sem transporte (pacote de viagem)

Pacotes de viagem (tipo_excursao = pacote_viagem) tipicamente não usam pontos de embarque porque o cliente vai por conta própria. Se mesmo assim precisar registrar um local de encontro (ex: hotel de destino), cadastre normalmente sem vincular a um transporte.

Admin fazendo check-in no lugar do guia

A mesma URL /guia/scanner funciona para admins. O sistema detecta automaticamente pelo guard de autenticação e registra o check-in com o nome do usuário admin (em vez do guia). Útil quando o guia não está com o celular ou em emergências.

Passageiro sem voucher impresso

Use a digitação manual do código (6 a 20 caracteres) no scanner. Se nem o código está disponível, busque o passageiro pelo nome dentro da tela da excursão no app do guia e use a ação manual.

Erros comuns e como resolver

• "A data de embarque deve estar dentro do período da excursão." - Causa: data informada está fora do intervalo data_inicio - 1 dia até data_fim + 1 dia. Solução: ajuste a data do embarque ou edite as datas da própria excursão antes.
• "Este ponto de embarque possui N passageiro(s) vinculado(s): nomes. Altere o embarque dos passageiros antes de remover." - Causa: existem passageiros confirmados ou pendentes apontando para este embarque. Solução: abra cada passageiro e troque o ponto de embarque, ou cancele-os antes de excluir.
• "Este ponto de embarque possui preco vinculado ao passageiro 'Fulano'. Altere o embarque do passageiro antes de remover." - Causa: o preço deste embarque está em uso por passageiro ativo. Solução: alterar o embarque (ou o preço) do passageiro citado.
• "O passageiro 'X' usa o embarque atual, mas não há preço cadastrado lá para a mesma categoria." - Causa: durante a exclusão o sistema tentou migrar o preço para o embarque atual do passageiro mas não achou equivalência de categoria. Solução: cadastre o preço da categoria faltante no embarque de destino e tente novamente.
• "Transporte não pertence a esta excursão" - Causa: o ID de transporte enviado não está nos transportes da excursão (pode ter sido removido entre a abertura do modal e o salvamento). Solução: feche e reabra o modal para recarregar a lista de veículos.
• "Este código não corresponde a nenhum passageiro cadastrado." (scanner) - Causa: QR Code inválido ou de outra plataforma. Solução: confira se é o voucher emitido pelo Viagilize.
• "Este passageiro pertence a outra excursão." (scanner) - Causa: scanner aberto numa excursão diferente da do voucher. Solução: volte e selecione a excursão correta no topo do scanner.
• "Este passageiro pertence ao transporte: X. Verifique o veículo correto." (scanner) - Causa: transporte selecionado no scanner não bate com o vinculado ao passageiro. Solução: trocar o transporte selecionado.
• "Este passageiro já fez check-in em DD/MM HH:MM" - Causa: tentativa de fazer check-in duplicado. Solução: verifique se não é o mesmo passageiro embarcando duas vezes; se for engano, ignore.
• "O passageiro precisa fazer check-in antes do check-out." - Causa: tentativa de check-out sem check-in prévio. Solução: fazer o check-in primeiro.
• "Câmera bloqueada / Localização bloqueada" - Causa: navegador negou permissão. Solução: abrir as configurações do site no navegador, liberar câmera e localização, recarregar a página.

Onde encontrar

• URL admin: /admin/excursoes/{excursao} (card Pontos de Embarque)
• URL scanner do guia: /guia/scanner
• URL relatório de embarque: /guia/excursoes/{excursao}/embarque
• Caminho no menu admin: Excursões > [abrir excursão] > Pontos de Embarque
• Permissão necessária: ver as viagens para visualizar, editar as viagens para cadastrar/alterar/remover embarques
• Módulo necessário: nenhum (recurso nativo do módulo Excursões)

Veja também

• Voucher e QR Code - Como gerar e enviar o voucher que o passageiro apresenta no embarque
• Assentos e Acomodações - Distribuir os assentos do ônibus antes do dia da viagem
• Status do Passageiro - Como o check-in interage com os status confirmado, pendente e no-show
• Cancelamento e Transferência - Tratar passageiros que não comparecem