Excursões - Tabela de Preços

O que é

A Tabela de Preços é o cartão Tabela de Preços que aparece dentro da edição da excursão (e também no wizard de criação). Ela monta uma matriz em que cada linha é um ponto de embarque (ou uma variação, no caso de pacote de viagem) e cada coluna é uma categoria de passageiro. Em cada cruzamento você define o valor que será cobrado de quem comprar aquela combinação.

Você normalmente chega aqui depois de já ter cadastrado as categorias e os pontos de embarque da excursão. Sem categorias e (para excursões com transporte) sem embarques, a matriz não aparece - o sistema exibe a mensagem orientando a cadastrá-los antes. Cada célula salva automaticamente ao perder o foco, sem precisar de um botão Salvar global.

Como usar

1. Vá em Excursões no sidebar e abra a excursão desejada.
2. Role até o cartão Tabela de Preços (ícone de moeda, ao lado do indicador da faixa de preço).
3. Para cada cruzamento Embarque × Categoria (ou Variação × Categoria em pacotes com variações), digite o valor no campo com prefixo R$. Use formato brasileiro (1.500,00).
4. Clique fora do campo (ou tecle Enter) para salvar. Uma borda verde pisca rapidamente confirmando o sucesso; uma borda vermelha indica erro e mostra a mensagem abaixo da tabela.
5. Para zerar uma combinação que tinha valor cadastrado, apague o conteúdo e saia do campo: o registro é removido do banco.

O indicador no topo do cartão exibe a faixa de preço atual da matriz (menor – maior). Se nenhum valor foi cadastrado, mostra Sem preços.

Casos especiais

Marcar uma combinação como cortesia (R$ 0,00)

Para registrar um passageiro sem cobrança, marque o checkbox Cortesia abaixo do campo de valor. Um modal de confirmação abre lembrando que o valor será zerado; confirme em Sim, marcar cortesia. A célula passa a exibir o rótulo verde Cortesia no lugar do campo de valor. Desmarcar o checkbox remove o registro e libera o campo para um novo valor.

Pacote de viagem com variações

Quando a excursão é do tipo pacote_viagem e tem variações cadastradas (hospedagem, acomodação, refeição, transporte), as linhas da matriz passam a ser as variações. Se também existem embarques cadastrados, cada linha vira a combinação Variação · Embarque (ex: "Quarto Duplo · Saída Centro"). Um aviso roxo no topo do cartão lembra que o cliente vai escolher a variação no checkout. Internamente o id da linha vira v{variacaoId}-e{embarqueId} para preservar a chave.

Pacote de viagem só com embarques

Pacote de viagem sem variações mas com embarques ativos se comporta igual a uma excursão tradicional: linha por embarque, coluna por categoria.

Pacote de viagem sem variações nem embarques

A matriz colapsa para uma única linha chamada Preço do Pacote, com uma coluna por categoria. É o cenário mais simples, usado quando o cliente vai por conta própria e não há ponto de partida configurado.

Excursão com múltiplos transportes

A matriz aceita preços diferenciados também por veículo (campo transporte_id na rota POST/PUT precos). Hoje o cartão padrão monta apenas a matriz embarque × categoria; preços com transporte específico permanecem visíveis e editáveis individualmente via API.

Erros comuns e como resolver

• "Já existe um preço cadastrado para esta combinação" - Causa: tentativa de criar um segundo registro para o mesmo embarque, categoria e transporte. Solução: edite o valor existente em vez de cadastrar novo.
• "Categoria não pertence a esta excursão" - Causa: a categoria enviada foi excluída ou pertence a outra excursão. Solução: recarregue a página e selecione uma categoria válida do dropdown.
• "Ponto de embarque não pertence a esta excursão" - Causa: o embarque foi removido entre a abertura da tela e o salvamento. Solução: recarregue a excursão e refaça o lançamento.
• "Transporte não pertence a esta excursão" - Causa: id de veículo inválido para a excursão. Solução: valide a relação na aba de Transportes antes de reenviar.
• "Este preço possui passageiros vinculados." - Causa: tentativa de remover um preço usado por reservas já confirmadas. Solução: o sistema apenas desativa o preço (ativo = false) para preservar o histórico; novos passageiros não conseguirão escolher essa combinação, mas os existentes continuam válidos.
• "Cadastre primeiro as categorias de passageiros e os pontos de embarque" - Causa: matriz vazia por falta de pré-requisitos. Solução: cadastre embarques e categorias antes de voltar para a aba de preços.

Onde encontrar

• URL: /admin/excursoes/{excursao}/edit#card-precos
• Caminho no menu: Excursões > (abrir excursão) > Tabela de Preços
• Permissão necessária: ver as viagens para visualizar e editar as viagens para alterar (a permissão vale para a área inteira api/excursoes/{excursao}).
• Módulo necessário: nenhum.

Veja também

• Visão Geral das Excursões
• Pontos de Embarque
• Criar Excursão
• Gerenciar Passageiros
• Financeiro da Excursão