Experiências - Pacotes de Experiências

O que é

Pacote de Experiências é um produto composto: você seleciona duas ou mais experiências já publicadas no catálogo e oferece o conjunto com preço diferenciado. A página lista todos os pacotes da sua empresa, exibe três cartões de estatísticas (Total de Pacotes, Publicados e Ativos no Site) e concentra as ações de criação, edição, ativação, exclusão e geração de SEO assistido por IA.

O usuário normalmente chega aqui depois de já ter cadastrado as experiências individuais no Catálogo, quando quer montar combos sazonais, ofertas temáticas (por exemplo "Aventura + Gastronomia") ou aumentar o ticket médio com agrupamentos. Cada pacote pode trabalhar em três modos de preço - fixo, sob consulta ou híbrido - e três modos de desconto - percentual, valor fixo ou preço sobrescrito.

Como usar

1. No sidebar, acesse Módulos > Experiências > Pacotes.
2. Para criar um novo pacote, clique em Novo Pacote (botão teal no canto superior direito do cabeçalho).
3. Em Dados do Pacote, preencha:
   • Nome do Pacote - título exibido no site e no admin (obrigatório).
   • Descrição Curta - resumo de até 500 caracteres usado em cards de listagem.
   • Descrição Completa - texto livre para a página de detalhe do pacote.
4. No card Modo de Preço, escolha entre Fixo, Sob Consulta ou Híbrido. No modo Sob Consulta o preço fica interno (não aparece no site) e o cliente vê um botão "Solicitar cotação".
5. No card Desconto (ou Preço Interno quando o modo é Sob Consulta) defina:
   • Tipo de Desconto - Percentual (%) ou Valor Fixo (R$).
   • Desconto - valor numérico aplicado sobre o subtotal das experiências.
   • Preço Fixo (R$) - opcional; quando preenchido sobrepõe o desconto e o cliente sempre paga este valor.
6. Em Experiências Incluídas, use o seletor + Adicionar experiência ao pacote... para anexar experiências (mínimo 2). Cada item mostra suas categorias com preço e pode ser reordenado pelo ícone de arrastar ou removido pelo X vermelho.
7. No card SEO, opcionalmente clique em Gerar com IA (botão violeta) para que o serviço Gemini preencha Meta Title, Meta Description e Meta Keywords a partir do nome, descrição curta e experiências escolhidas.
8. Na coluna lateral, em Publicação, ajuste:
   • Status - Rascunho, Publicado ou Arquivado.
   • Ativo - controla se o pacote está habilitado.
   • Mostrar no Site - define se aparece na vitrine pública.
   • Destaque - empurra o pacote para o topo da listagem.
9. Em Validade e Limites, defina Válido a partir de, Válido até e Limite de Vendas (deixe vazio para ilimitado).
10. No rodapé, clique em Criar Pacote (ou Salvar Alterações na edição). O botão Criar e continuar editando salva e mantém o formulário aberto para refinar SEO ou imagens.

Casos especiais

Filtrar e localizar pacotes existentes

Use a barra Buscar pacote... para filtrar por nome (busca case-insensitive) e o seletor Todos status para limitar a Rascunho, Publicado ou Arquivado. Os filtros se acumulam na URL e podem ser combinados - o link Limpar filtros restaura a listagem completa.

Ativar e desativar sem permissão de editar o pacote

No dropdown de Ações de cada linha (ícone de três pontos à direita), use Desativar (quando ativo) ou Ativar (quando inativo) para alternar o campo ativo sem entrar no formulário. A ação dispara um PATCH em /admin/pacotes-passeios/{pacotesPasseio}/toggle-status e mostra um toast de confirmação. Esta opção exige a permissão de editar as experiências.

Pacote com preço fixo

Quando um valor é informado no campo Preço Fixo (R$), ele substitui qualquer desconto configurado: o cliente sempre paga exatamente o valor fixo, independentemente das categorias e quantidades escolhidas. Para usar somente desconto percentual ou em reais, deixe o campo Preço Fixo vazio.

Pacote sob consulta

Selecionando o modo Sob Consulta, o preço deixa de ser exibido no site. O cliente passa a ver um botão único "Solicitar cotação" que abre o formulário de cotação com o pacote pré-carregado. Mesmo nesse modo é possível definir um preço interno, usado em orçamentos e vendas registradas pelo admin.

Modo híbrido de preço

No modo Híbrido o preço da tabela continua visível e, em paralelo, aparece um botão secundário "Solicitar cotação personalizada" voltado para grupos custom. Útil quando o pacote tem uma versão padrão precificada e admite negociação.

Excluir um pacote

A ação Excluir aparece em vermelho no fim do dropdown de Ações e dispara o componente <x-confirm-delete-modal />. Exige a permissão de excluir as experiências. A exclusão é definitiva.

Erros comuns e como resolver

• "O campo passeios deve ter no mínimo 2 itens." - Causa: o pacote foi enviado com menos de duas experiências. Solução: anexe pelo menos duas experiências no card Experiências Incluídas antes de salvar.
• "O campo valor desconto é obrigatório." - Causa: o tipo de desconto foi definido mas o valor numérico ficou em branco. Solução: informe o desconto (0 é aceito, vazio não). Se quiser preço sobrescrito, preencha Preço Fixo (R$) e qualquer valor de desconto numérico.
• "O campo validade fim deve ser uma data posterior ou igual a validade início." - Causa: a data final é anterior à inicial. Solução: ajuste Válido até para uma data igual ou maior que Válido a partir de.
• "O passeio selecionado é invalido." - Causa: alguma das experiências escolhidas foi apagada entre carregar o formulário e salvar. Solução: recarregue a página e selecione novamente as experiências disponíveis.
• "Integração com IA não configurada." - Causa: o botão Gerar com IA foi acionado sem chave Gemini ativa na sua empresa. Solução: peça ao Proprietário que configure a integração de IA em Configurações > Integrações ou preencha o SEO manualmente.

Onde encontrar

• URL: /admin/pacotes-passeios
• Caminho no menu: Módulos > Experiências > Pacotes
• Permissão necessária: ver as experiências (para listar e visualizar), editar as experiências (para criar, editar e alternar status), excluir as experiências (para excluir)
• Módulo necessário: passeios-experiencias

Veja também

• Experiências - Visão Geral
• Catálogo de Experiências
• Criar Experiência
• Vendas de Experiências