Excursões - Voos do Pacote de Viagem

O que é

A aba Voos fica dentro da edição de uma excursão do tipo Pacote de Viagem e serve para registrar manualmente as informações aéreas da viagem: companhia, número do voo, aeroportos de origem e destino, data, horários de partida e chegada, classe e franquia de bagagem. Cada voo cadastrado vira um card visual no grid e também aparece nos PDFs de roteiro e voucher de viagem entregues ao cliente.

O cadastro é manual - o sistema não consulta GDS nem APIs de companhias aéreas. Você normalmente chega aqui depois de criar o pacote de viagem (tipo pacote_viagem) e definir o roteiro, para informar os passageiros sobre os trechos aéreos contratados. Os voos também são opcionais: pacotes sem componente aéreo (cliente vai por conta própria) podem deixar a aba vazia.

Como usar

1. Vá em Excursões no sidebar e abra um pacote de viagem (tipo_excursao = pacote_viagem). Se a excursão for do tipo padrão com transporte, a aba Voos não aparece.
2. Clique na aba Voos (ícone de avião) no topo da edição.
3. Clique em Adicionar Voo (botão azul no canto superior direito do bloco Informações de Voo).
4. No modal Novo Voo, preencha os campos:
   • Tipo (obrigatório) - escolha entre Ida, Volta ou Conexão. O tipo define a cor do selo exibido no card (verde, azul ou âmbar respectivamente).
   • Cia Aérea - nome da companhia (ex.: LATAM, GOL, Azul).
   • Número Voo - código do voo (ex.: LA3421).
   • Origem e Destino - códigos IATA de três letras dos aeroportos (ex.: GRU, FLN). São esses códigos que aparecem em destaque no card.
   • Data - data de operação do voo.
   • Partida e Chegada - horários no formato HH:MM.
   • Classe - econômica, executiva ou primeira classe.
   • Bagagem - texto livre (ex.: 23kg despachada + 10kg mão).
   • Observações - campo livre para alertas internos (ex.: "embarque prioritário", "fila preferencial").
5. Clique em Adicionar para salvar o voo novo (ou Salvar se estiver editando um existente). O card aparece imediatamente no grid e um toast confirma "Voo salvo".

Os voos ficam organizados por ordem de cadastro (campo ordem preenchido automaticamente). Cada novo voo entra no final da lista.

Casos especiais

Voos de ida e volta

Cadastre um voo por trecho. Ida e volta são registros separados, com Tipo diferente. O selo colorido no canto superior esquerdo do card facilita identificar visualmente cada um (verde para Ida, azul para Volta).

Voos com conexão

Para trajetos com escala, cadastre cada perna como um voo separado: o trecho principal como Ida (ou Volta) e o trecho da escala como Conexão (selo âmbar). Use a observação para indicar tempo de conexão ou troca de terminal quando relevante.

Pacote sem componente aéreo

Se o pacote é apenas terrestre ou o cliente compra a passagem por conta, deixe a aba vazia. A mensagem Nenhum voo cadastrado aparece no centro do bloco e o PDF de roteiro não exibe a seção de voos.

Pacote de viagem que vira excursão (ou vice-versa)

A aba Voos só existe para pacotes (pacote_viagem). Se você mudar o tipo_excursao para excursao (com transporte próprio), a aba some - mas os voos previamente cadastrados ficam no banco e voltam a aparecer se você reverter o tipo.

Erros comuns e como resolver

• "Esta funcionalidade é exclusiva para pacotes de viagem." (HTTP 422) - Causa: tentativa de chamar a API de voos em uma excursão com tipo_excursao diferente de pacote_viagem. Solução: confirme que a excursão é do tipo pacote no cartão de dados gerais.
• "The horario partida does not match the format H:i." - Causa: horário enviado fora do padrão HH:MM. Solução: digite no formato 24h com dois dígitos para hora e minuto (ex.: 08:45, 22:10).
• "The aeroporto origem field may not be greater than 10 characters." - Causa: tentativa de salvar um código de aeroporto com mais de 10 caracteres. Solução: use o código IATA (3 letras) ou ICAO (4 letras) padrão.
• "The número voo field may not be greater than 20 characters."
  • Causa: texto longo demais no campo do número do voo. Solução: use apenas a sigla e o número (ex.: LA3421), sem descrições extras.

Onde encontrar

• URL: /admin/excursoes/{excursao}/edit - aba Voos dentro da edição do pacote.
• Caminho no menu: Excursões > (abrir um pacote de viagem) > Voos
• Permissão necessária: ver as viagens para visualizar e editar as viagens para cadastrar/editar/remover (trava de acesso aplicado no grupo api/excursoes/{excursao}/pacote).
• Módulo necessário: nenhum (o módulo Pacote de Viagem é parte do core de Excursões).

Veja também

• Visão Geral das Excursões
• Criar Excursão
• Tabela de Preços
• Gerenciar Passageiros