Viagens
Programe e gerencie as viagens da sua frota — defina veículo, paradas, horários, precificação por trecho e acompanhe a ocupação em tempo real.
A tela de Viagens é o coração do planejamento operacional. Aqui você programa cada saída do veículo, define as paradas e os preços por trecho, e acompanha a ocupação em tempo real antes da partida.
Antes de criar viagens, certifique-se de ter cadastrado veículos com mapa de assentos, lugares (origens e destinos) e categorias de assento com os preços base.
Onde encontrar
Menu lateral → Gestão → Viagens. URL direta: /reservation/trips.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar viagens | trips:read |
| Criar, editar, excluir | trips:edit |
| Excluir viagem | trips:delete |
| Alterar status | trips:edit |
A tela em um relance
08:00
BH → Rio
14:30
BH → SP
07:00
BH → Rio
09:00
BH → Rio
A tela tem duas abas:
- Calendário — visão semanal (7 dias) com as viagens agendadas como blocos clicáveis. Clique em um horário vazio para criar; clique em uma viagem para gerenciá-la.
- Recorrências — lista de séries de viagens repetidas. Gerencie ou encerre uma recorrência inteira daqui.
Status das viagens
| Status | Cor | Significado |
|---|---|---|
| Agendada | Azul | Programada, ainda não iniciou embarque. |
| Embarcando | Amarelo | Passageiros embarcando — janela de check-in ativa. |
| Em Andamento | Laranja | Viagem saiu — em rota. |
| Concluída | Verde | Chegou ao destino. Estado final. |
| Cancelada | Vermelho | Cancelada. Reservas devem ser tratadas individualmente. |
Criar uma viagem
Abrir o assistente
Clique em Nova viagem ou clique em um horário vazio no calendário.
Configuração geral
Repetir viagem
Cria uma série recorrente
| Campo | Obrigatório | Descrição |
|---|---|---|
| Veículo | Sim | Define o mapa de assentos e os espaços de carga disponíveis. |
| Data e hora de partida | Sim | Data/hora em que o veículo parte da origem. |
| Início do embarque | Sim | Quantos minutos antes da partida os passageiros podem embarcar (0–1440). |
| Repetir viagem | Não | Cria uma série recorrente (diária, semanal, etc.) com uma regra RRULE. |
Paradas
Origem
Parada 1
Destino
Adicione as paradas em ordem:
- A primeira parada é sempre a Origem.
- A última é sempre o Destino.
- As do meio são Paradas intermediárias.
Para cada parada (exceto a origem), informe o horário de chegada e, se necessário, o deslocamento de dia (para viagens noturnas que cruzam a meia-noite).
Use as setas ↑↓ para reordenar e o ✕ para remover paradas intermediárias.
A ordem das paradas define quais trechos existem. Mudar a ordem depois de criar a viagem afeta os bilhetes já vendidos — evite alterar viagens com reservas ativas.
Precificação
Para cada par origem→destino e cada categoria de assento, defina o preço em R$. O sistema gera automaticamente todos os trechos possíveis com base nas paradas configuradas no passo anterior.
Exemplo: uma viagem com 3 paradas (A, B, C) gera os trechos A→B, A→C e B→C.
Gerenciar uma viagem
Clique em qualquer viagem no calendário para abrir o painel de detalhes:
Ocupação · BH → Rio
9 ocupados · 35 disponíveis
O painel exibe:
- Data e hora de partida, status atual e badge de recorrência (se aplicável).
- Veículo — nome, placa e total de assentos.
- Rota — paradas em ordem com horários e deslocamentos de dia.
- Mapa de ocupação — selecione um trecho para ver poltronas ocupadas e disponíveis. Clique em uma poltrona disponível para abrir o assistente de reserva diretamente.
Ações disponíveis no painel:
| Ação | O que faz |
|---|---|
| Gerar lista PDF | Baixa a lista de passageiros em PDF com dados de embarque. |
| Editar preços | Atualiza a precificação sem recriar a viagem. |
| Alterar status | Avança o status da viagem (Agendada → Embarcando → Em Andamento…). |
| Ver encomendas | Abre a tela de Encomendas já filtrada para esta viagem. |
| Nova reserva | Abre o assistente de reserva com esta viagem pré-selecionada. |
| Excluir | Remove a viagem permanentemente (bloqueado se houver reservas). |
Lista de passageiros em PDF
O PDF gerado contém:
- Cabeçalho com data, ID da viagem, veículo e placa.
- Dados do motorista (nome, CNH e validade) — se configurado.
- Tabela com: nome, CPF, reservado por, poltrona, embarque, desembarque, valor e status de pagamento (pago/pendente).
- Totais: passageiros, pagos, pendentes e receita total.
Viagens recorrentes
Na aba Recorrências, cada linha representa uma série. Você pode:
- Visualizar quantas viagens restam na série.
- Encerrar a recorrência (para de gerar novas viagens futuras).
Cada viagem individual de uma série pode ser editada de forma independente — alterar o preço de uma viagem não afeta as demais da mesma recorrência.
Erros comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Veículo não aparece no seletor | Nenhum veículo cadastrado com mapa de assentos | Cadastre o veículo e configure o mapa de poltronas |
| Trecho sem preço disponível ao reservar | Precificação não configurada para aquele par | Edite os preços da viagem no painel de detalhes |
| Não consigo excluir a viagem | Existem reservas ativas vinculadas | Cancele ou conclua as reservas antes de excluir |
| Mapa de ocupação não aparece | Viagem tem menos de 2 paradas | Certifique-se de ter pelo menos origem e destino |
Próximos passos
Com viagens criadas, vá para Reservas para vender as poltronas, ou Encomendas para registrar pacotes no compartimento de carga.