Excursões - Pacote de Viagem

O que é

A página Pacote de Viagem é o painel completo que uma viagem ganha quando o Tipo de Produto é Pacote de Viagem - o modo usado para pacotes aéreos, marítimos ou combinados, em que o seu cliente não depende de um ônibus fretado pela sua empresa. Diferente de uma excursão comum (que gira em torno de transporte, embarques e assentos), aqui o centro é o roteiro, os serviços contratados com fornecedores (hotel, transfer, seguro, passeio) e os documentos que acompanham a venda: cotação para o cliente, voucher para o fornecedor e o inventário reservado com prazo de devolução.

Você chega aqui depois de criar a viagem já com o Tipo de Produto Pacote de Viagem, clicando no botão Pacote (menu de outras páginas da viagem, logo abaixo do título). A página é dividida em abas, e cada aba resolve uma parte da operação: Dados do Pacote (destino, hotel, regime), Roteiro (dia a dia), Componentes (serviços com fornecedor, custo e margem), Logística (veículos, embarques, guias e paradas, quando o pacote também usa transporte próprio), Voos, Cruzeiro, Rooming (em alguns casos), Cotações, Vouchers e Allotment. As abas com fluxo mais longo têm artigo próprio - veja a seção Veja também ao final.

Como usar

1. Garanta que a viagem foi criada com Tipo de Produto = Pacote de Viagem (veja Criar Excursão). Se a viagem for do tipo padrão, com transporte rodoviário, esta página não existe: tentar abri-la devolve o erro "Esta funcionalidade e exclusiva para pacotes de viagem.".
2. Abra a viagem e clique no botão Pacote (ícone de globo, com o texto "· outras páginas" ao lado, logo abaixo do título) para entrar na página dedicada. Você também chega direto pela URL /admin/excursoes/{excursao}/pacote.
3. Na aba Dados do Pacote, aberta por padrão, preencha País, Estado e Cidade (com campos de texto livre quando o país não é Brasil), Hotel, Categoria, Regime de hospedagem, Documentos necessários e Observações do pacote. O campo Duração (noites) é somente leitura: é calculado automaticamente a partir da Data de Início e Data de Fim cadastradas na viagem - para mudar o número de noites, ajuste as datas na edição da viagem, não aqui.
4. Clique em Salvar (botão roxo no rodapé do card) para gravar os Dados do Pacote. Esse é o único botão da página que recarrega a tela inteira - as demais abas salvam por AJAX, com toast de confirmação, sem sair da página.
5. Navegue pelas abas seguintes conforme a necessidade do pacote: Roteiro para montar o dia a dia, Componentes para registrar cada serviço contratado com fornecedor (com custo e margem), Logística se o pacote também usa transporte próprio, Voos e Cruzeiro para os trechos aéreo e marítimo, Cotações para gerar propostas comerciais ao cliente, Vouchers para os documentos que vão para cada fornecedor, e Allotment para controlar blocos de quartos, vagas ou ingressos reservados com prazo de devolução.

Casos especiais

Nem toda aba aparece para todo mundo

Além da permissão base excursoes.edit (que dá acesso à página), quatro abas exigem permissão própria: Rooming, Cotações, Vouchers e Allotment. Um usuário pode abrir a página e ver só um subconjunto das abas - isso costuma confundir quem espera ver todas. O bloco com Custo NET, Preço Venda e Margem, no topo da aba Componentes, também só aparece para quem tem a permissão de visualizar custos.

Rooming: no Pacote ou em Hospedagem, nunca nos dois

A aba Rooming só aparece quando o módulo Hospedagem está desligado. Com o módulo ligado, a distribuição de quartos passa a ser feita em Editar > Hospedagem - uma versão mais completa, com hospedaria, tipos de quarto reutilizáveis e alocação automática. Ativar o módulo Hospedagem depois de já ter usado o Rooming simplificado do pacote não apaga os dados antigos, mas esconde a aba: os quartos cadastrados aqui ficam fora de vista. Veja Rooming List do Pacote de Viagem para mais detalhes.

Pacote sem transporte próprio

A aba Logística reaproveita os mesmos blocos de Veículos, Embarques, Guias e Paradas usados numa excursão comum, mas aqui ela é opcional: um pacote 100% aéreo ou marítimo pode deixá-la vazia sem impedir a publicação ou a venda do pacote.

Lançar um componente como custo em Contas a Pagar

Na aba Componentes, cada serviço com custo preenchido ganha um botão de cifrão (visível só para quem edita o Financeiro) que cria uma conta a pagar de verdade no módulo Financeiro, com fornecedor, valor e vencimento já preenchidos a partir do componente. Clicar de novo não duplica a conta: o sistema reconhece que já existe uma conta em aberto com a mesma viagem, descrição e valor, e devolve essa conta em vez de criar outra. Depois de criada, a conta segue vida própria - editar ou pagar ela no Financeiro não altera mais o componente de origem.

Erros comuns

• "Esta funcionalidade e exclusiva para pacotes de viagem." (erro 422) - Causa: a viagem aberta está com Tipo de Produto Excursão (transporte rodoviário), não Pacote de Viagem. Solução: altere o tipo na edição da viagem, ou crie uma nova viagem já como Pacote de Viagem.
• "Selecione (ou cadastre) um cliente para a cotação." - Causa: tentativa de salvar uma cotação, na aba Cotações, sem escolher um cliente no modal. Solução: selecione um cliente já cadastrado na busca do modal, ou use o link de cadastro rápido dentro dele mesmo.
• Uma aba (Rooming, Cotações, Vouchers ou Allotment) não aparece - Causa: o usuário não tem a permissão específica daquela aba, ou, no caso do Rooming, o módulo Hospedagem está ativo. Solução: peça ao Proprietário ou Gerente para liberar a permissão no perfil de acesso; para o Rooming, procure a distribuição de quartos em Editar > Hospedagem.
• O botão de lançar componente como custo não aparece - Causa: o usuário não tem permissão para editar o Financeiro, ou o componente ainda não tem custo unitário nem custo fixo preenchido. Solução: preencha o custo no componente e confirme a permissão do usuário.

Onde encontrar

• URL: /admin/excursoes/{excursao}/pacote
• Caminho no menu: Viagens (Excursões) > abra uma viagem do tipo Pacote de Viagem > botão Pacote (menu de outras páginas)
• Permissão necessária: editar as viagens; algumas abas exigem permissão própria (Rooming, Cotações, Vouchers, Allotment, visualizar custos)
• Módulo necessário: nenhum - é parte do núcleo de Excursões. A aba Rooming depende do módulo Hospedagem estar desligado.

Veja também

• Excursões - Criar Excursão
• Excursões - Categorias e Preços
• Pacote de Viagem - Roteiro dia a dia
• Excursões - Voos do Pacote de Viagem
• Excursões - Pacote de Viagem: Cruzeiro
• Excursões - Pacote de Viagem · Rooming List
• Excursões - Allotment do Pacote de Viagem