Experiências - Visão Geral

O que é

O módulo Experiências é o catálogo de passeios, atividades e tours que sua agência vende avulso, sem o pacote rodoviário tradicional de uma excursão. Cada experiência tem horários recorrentes (que geram sessões com data e vagas), categorias de preço (adulto, criança, idoso, etc.), extras opcionais, temporadas de ajuste de valor, vendas online com voucher e QR Code, e check-in individual no dia.

A página /admin/passeios lista tudo que está cadastrado na sua empresa e é o ponto de entrada para o módulo. A partir daqui você acessa o cadastro de uma nova experiência, edita uma existente, abre o calendário de sessões, duplica para criar variações e controla o status entre rascunho, publicado e arquivado. Este artigo é a porta de entrada do módulo: os fluxos específicos (cadastro, edição, vendas, pacotes, gift cards) ficam nos artigos relacionados.

Como usar

1. Vá em Módulos > Passeios / Experiências no sidebar. A URL é /admin/passeios.
2. No topo da lista, confira os quatro cartões de estatísticas: Total de Experiências, Publicados, Ativos e Vendas este mês.
3. Use a barra de filtros para localizar uma experiência:
   • Buscar experiência... - busca livre por nome.
   • Status - filtra por Rascunho, Publicado ou Arquivado.
   • Tipo - filtra por Passeio, Experiência, Aventura ou Day Use.
4. Cada card da lista mostra nome, status, tipo, localização, duração, faixa de preço, total de vendas ativas e quantidade de horários cadastrados. As três primeiras categorias de preço aparecem como tags coloridas.
5. Para criar uma nova experiência, clique em Nova Experiência (botão teal no canto superior direito). Veja o artigo de cadastro para o passo a passo completo.
6. Para abrir uma experiência existente, use os botões na barra inferior do card:
   • Editar - abre o formulário completo com abas de dados, horários, extras, temporadas, fotos e SEO.
   • Visualizar - mostra a página de detalhes com estatísticas e sessões futuras.
   • Sessões - abre o calendário mensal com as sessões geradas pelos horários.
7. Para ações secundárias, abra o dropdown de três pontos à direita do card: Duplicar, Ativar/Desativar e Excluir.

Casos especiais

Cadastrar uma experiência

Use o botão Nova Experiência no canto superior direito. O formulário cobre dados básicos, localização, mídia, categorias de preço, horários recorrentes, extras, temporadas e SEO. Ao salvar, o sistema gera automaticamente as sessões futuras a partir dos horários ativos. Detalhes no artigo de criação.

Configurar categorias, horários, extras e temporadas

Esses blocos são editados dentro de cada experiência (botão Editar no card). Categorias definem os preços por tipo de pessoa (adulto, criança, idoso) e podem consumir estoque de equipamento. Horários definem a recorrência (diária, semanal ou data específica) e quantas vagas cada sessão terá. Extras são itens opcionais com cobrança por pessoa, por reserva ou por unidade. Temporadas aplicam ajuste percentual ou fixo no preço em períodos definidos.

Vender online com voucher QR Code

As experiências publicadas (status Publicado + flag Mostrar no site + flag Ativo) aparecem no site público da sua empresa. A venda gera uma PasseioVenda com itens (PasseioVoucherItem), cada um com um QR Code único para check-in. Acompanhe as vendas em /admin/passeios/vendas.

Check-in no dia da experiência

Cada item da venda tem um voucher individual com QR Code. O guia ou recepcionista valida o voucher pelo QR (ou número) no momento da chegada, registrando o uso. Vouchers cancelados ou já usados são bloqueados.

Criar um pacote combinando experiências

Pacotes (PacotePasseio) agrupam várias experiências em uma única oferta, geralmente com desconto. A gestão fica em /admin/pacotes-passeios - veja o artigo de pacotes.

Criar e vender gift cards

Gift cards são créditos pré-pagos resgatáveis em qualquer experiência do catálogo. A gestão fica em /admin/gift-cards - veja o artigo de gift cards.

Duplicar uma experiência

No dropdown de ações de um card, clique em Duplicar. O sistema cria uma cópia com todos os relacionamentos (categorias, horários, extras, fotos, temporadas, waivers), gera as sessões e abre direto na tela de edição com status rascunho.

Modo exclusivo de passeios

empresas cujo negócio é só passeios (sem excursões rodoviárias) podem ativar o modo exclusivo em /admin/passeios/configuracoes, que promove o módulo a item raiz do menu e ajusta a navegação. Veja o artigo de configurações.

Erros comuns e como resolver

• "Não é possível excluir uma experiência com vendas ativas." - Causa: tentativa de excluir uma experiência que tem PasseioVenda em status reservado, confirmado ou usado. Solução: cancele ou conclua todas as vendas ativas antes de excluir, ou apenas Desative a experiência (pelo dropdown) para retirá-la do site sem perder o histórico.
• Experiência não aparece no site - Causa: status diferente de Publicado, flag Mostrar no site desligada ou flag Ativo desligada. Solução: edite a experiência e ajuste os três campos; lembre-se que Inativo prevalece mesmo com status Publicado.
• Sessões não foram geradas após salvar - Causa: nenhum horário foi cadastrado ou todos estão inativos. Solução: edite a experiência, adicione ao menos um horário ativo e salve; as sessões futuras são geradas automaticamente. Para forçar regeneração, use a ação Gerar sessões dentro da página de sessões.

Onde encontrar

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

Veja também

• Criar Experiência
• Editar Experiência
• Dashboard Experiências
• Vendas de Experiências
• Pacotes de Experiências
• Gift Cards
• Configurações Experiências