Excursões - Etiquetas de Bagagem e Embarque

O que é

A função Etiquetas gera um PDF pronto para impressão com os dados dos passageiros de uma excursão. É usada principalmente para identificar as bagagens despachadas no bagageiro do ônibus (com nome, excursão, ponto de embarque, transporte, assento e QR Code), mas também produz cartões de embarque, crachás e listagens de mala direta - sempre a partir do mesmo conjunto de passageiros confirmados/pendentes.

O atendente costuma chegar aqui no fechamento da excursão, alguns dias antes da viagem, quando a maior parte dos passageiros já está cadastrada e com transporte/embarque atribuídos. As etiquetas são geradas em formatos comerciais de folha adesiva (linha Pimaco) ou em etiquetas térmicas (100x60 e 100x80 mm), permitindo aproveitar o estoque de papel que a operação já usa.

Como usar

1. Vá em Viagens (Excursões) no sidebar e abra a excursão desejada.
2. Acesse a aba Passageiros e expanda o bloco Mapa de Assentos.
3. Clique no botão Etiquetas (botão âmbar com ícone de tag, ao lado de Exportar mapa em PDF). O modal Imprimir Etiquetas abre.
4. Escolha o Tipo de Etiqueta entre os quatro cartões do topo:
   • Bagagem - etiqueta horizontal com nome do passageiro em destaque, excursão, embarque, transporte, assento e QR Code, ideal para colar na mala.
   • Embarque - cartão de embarque com dados de horário e ponto de subida do passageiro.
   • Crachá - etiqueta para identificação pessoal do passageiro.
   • Lista - folha em formato de mala direta para conferência.
5. Selecione o Formato da Etiqueta. O sistema mostra apenas os formatos compatíveis com o tipo escolhido (por exemplo, Bagagem aceita Pimaco A4365, A4350, A4363 e térmicas 100x60/100x80).
6. (Opcional) Refine os filtros:
   • Transporte - limita a impressão a passageiros de um veículo específico.
   • Ponto de Embarque - gera etiquetas só de quem sobe num determinado ponto.
   • Status - escolha entre Confirmados e Pendentes (padrão), Apenas Confirmados ou Apenas Pendentes.
7. (Opcional) Ajuste as opções de conteúdo:
   • Incluir logotipo - imprime o logo da sua empresa.
   • Incluir QR Code - embute o QR do passageiro (mesmo usado no check-in).
8. (Opcional) Em Iniciar na posição, informe a primeira casa livre da folha quando estiver reaproveitando uma folha Pimaco parcialmente usada. O sistema deixa as primeiras posições em branco.
9. Clique em Gerar PDF. O PDF abre em uma nova aba pronto para imprimir.

Casos especiais

Folha de teste antes de imprimir

Antes da primeira tiragem em folha nova, clique em Folha de Teste no rodapé do modal. O sistema gera um PDF com a grade do formato escolhido (sem dados de passageiro) para você imprimir em papel comum e comparar contra a folha adesiva, confirmando se o alinhamento está correto.

Ajuste fino da impressora

Se a impressão estiver deslocada poucos milímetros (problema comum em impressoras a jato de tinta antigas), expanda o bloco Ajuste de impressora dentro do modal e informe a correção em Margem superior e Margem esquerda, ambas em milímetros, no intervalo de -10 a +10. O valor fica salvo na sua empresa (campo jornada_cliente.etiquetas_ajuste) e é aplicado em todas as impressões futuras, inclusive na folha de teste.

Etiquetas térmicas

Para os formatos Térmica 100x80mm e Térmica 100x60mm, o sistema gera o PDF com o tamanho de página igual ao tamanho da etiqueta (uma etiqueta por página), pronto para impressoras térmicas como Argox, Elgin ou Zebra.

Geração via Gotenberg ou DomPDF

O sistema tenta primeiro renderizar o PDF via Gotenberg (servidor headless dedicado). Se ele estiver indisponível no momento, faz fallback automático para o DomPDF. A qualidade visual pode variar levemente entre os dois engines - se notar diferença, repita a geração depois.

Erros comuns e como resolver

• "Nenhum passageiro encontrado com os filtros selecionados." - Causa: a combinação de transporte + embarque + status não retornou ninguém. Solução: afrouxe um filtro (ex.: troque para Confirmados e Pendentes ou remova o filtro de transporte) e tente novamente.
• "Formato incompatível com o tipo de etiqueta selecionado." - Causa: o tipo escolhido (ex.: Crachá) não aceita o formato pedido (ex.: Térmica 100x60). Solução: selecione o tipo primeiro; a lista de formatos mostra automaticamente só os válidos.
• "Formato de etiqueta não encontrado." - Causa: foi enviado um código de formato inexistente (geralmente por dados antigos no cache do navegador). Solução: feche o modal, abra de novo e selecione o formato pela lista.
• "Erro ao gerar PDF das etiquetas." - Causa: tanto o Gotenberg quanto o DomPDF falharam (HTML inválido, memória insuficiente ou bloqueio temporário). Solução: tente novamente em alguns segundos; se persistir, reduza a quantidade de passageiros usando filtros.

Onde encontrar

• URL: /admin/excursoes/{excursao}/etiquetas
• Caminho no menu: Viagens (Excursões) > Excursão > Passageiros > Mapa de Assentos > Etiquetas
• Permissão necessária: ver as viagens
• Módulo necessário: nenhum

Veja também

• Excursões - Gerenciar Passageiros
• Excursões - Check-in dos Passageiros
• Excursões - Checklist de Embarque
• Excursões - Pontos de Embarque
• Excursões - Gerenciar Transportes