Excursões - Pacote de Viagem: Cruzeiro

O que é

A aba Cruzeiro concentra as informações específicas do trecho marítimo de um Pacote de Viagem que envolve navio. É onde a operação registra a companhia marítima, o navio, os portos de embarque e retorno, as datas de partida e chegada e o itinerário de portos visitados. Esses dados são exibidos no roteiro do passageiro, no voucher de viagem e na comunicação pré-embarque (e-mail e WhatsApp).

O usuário normalmente chega aqui depois de criar a excursão como tipo Pacote de Viagem e abrir a tela de gestão do pacote. A aba só existe nesse modo - não aparece em excursões com transporte rodoviário. A alocação de cabines por passageiro não é feita aqui: ela acontece na aba Rooming, que oferece os tipos cabine_interna, cabine_externa, cabine_varanda e cabine_suite.

Como usar

1. Vá em Excursões no sidebar e abra a excursão que está marcada como Pacote de Viagem.
2. Clique no botão de gestão do pacote para entrar na tela com abas.
3. Clique na aba Cruzeiro (ícone de bóia salva-vidas, sexta aba na ordem padrão).
4. Preencha os campos do trecho marítimo:
   • Companhia - nome da operadora do navio (ex.: MSC, Costa, Royal Caribbean). Aparece em vouchers e comunicados.
   • Navio - nome do navio (ex.: MSC Preziosa).
   • Porto de Embarque - cidade/UF onde o passageiro embarca (ex.: Santos/SP).
   • Porto de Retorno - cidade/UF onde o cruzeiro termina.
   • Partida - data e hora exatas em que o navio zarpa (campo datetime-local).
   • Chegada - data e hora previstas de retorno ao porto final.
   • Itinerário - texto livre com a sequência de portos visitados (ex.: Santos - Ilhabela - Búzios - Santos).
   • Observações - instruções extras visíveis internamente.
5. Clique em Salvar Cruzeiro no canto inferior direito do card. O toast confirma "Cruzeiro salvo.".

Todos os campos são opcionais - você pode salvar com preenchimento parcial e voltar depois para completar. A tela funciona como upsert: o mesmo botão Salvar cria o registro na primeira vez e atualiza nas próximas.

Casos especiais

Pacote sem cruzeiro

Se o Pacote de Viagem não inclui trecho marítimo, simplesmente não preencha a aba. Nada é exigido para publicar a excursão. A aba fica disponível mesmo em pacotes terrestres ou aéreos puros, mas só gera registro quando o botão Salvar Cruzeiro é clicado.

Remover dados do cruzeiro

Quando já existem dados salvos, o link vermelho Remover aparece no canto superior direito do card. Ele abre uma confirmação ("Remover os dados do cruzeiro?") e, se confirmada, apaga o registro inteiro do trecho marítimo. Útil quando o pacote foi reconfigurado e deixou de incluir navio. A remoção não afeta passageiros nem cabines já alocados na aba Rooming.

Cabines, decks e número da cabine

A aba Cruzeiro guarda apenas o cabeçalho da viagem marítima. Número da cabine, deck e categoria (interna, externa, varanda, suíte) são controlados em outros pontos:

• Os tipos de cabine ficam na aba Rooming, no campo Tipo de Quarto ao criar ou editar um quarto (opções cabine_interna, cabine_externa, cabine_varanda, cabine_suite).
• O modelo guarda também numero_cabine e categoria_cabine (Interna, Externa, Varanda, Suíte), úteis para integrações futuras e impressão em vouchers.

Funcionalidade exclusiva de Pacote de Viagem

A página inteira de gestão do pacote - e portanto a aba Cruzeiro - é restrita a excursões com tipo_excursao = pacote_viagem. Tentar acessar de uma excursão comum retorna o erro 422 - Esta funcionalidade e exclusiva para pacotes de viagem.. Para liberar o acesso, mude o tipo da excursão na tela de criação ou crie uma nova como Pacote de Viagem.

Erros comuns e como resolver

• "Erro ao salvar." - Aparece como toast vermelho quando a API recusa o salvamento. Causa frequente: formato inválido em Partida ou Chegada (use o seletor datetime-local do navegador, não digite manualmente). Solução: limpe o campo e selecione novamente pelo calendário.
• "Esta funcionalidade e exclusiva para pacotes de viagem." - Excursão não está marcada como Pacote de Viagem. Solução: ajuste o tipo na criação/edição da excursão ou abra a versão Pacote dessa viagem.
• A aba não aparece - A barra de abas pode estar rolada horizontalmente em telas menores. Solução: arraste a barra de abas para a direita ou abra em tela maior - a aba Cruzeiro é a sexta na ordem padrão.

Onde encontrar

• URL: /admin/excursoes/{excursao}/edit (aba Cruzeiro do modo Pacote de Viagem)
• URL direta: /admin/excursoes/{excursao}/pacote/edit#cruzeiro
• Caminho no menu: **Excursões > [abrir excursão tipo Pacote de Viagem]

  Aba Cruzeiro**

• Permissão necessária: editar as viagens
• Módulo necessário: nenhum

Veja também

• Excursões - Visão Geral
• Excursões - Criar Excursão
• Excursões - Gerenciar Passageiros