Opcionais - Editar

O que é

Esta tela reúne todas as informações de um item opcional já cadastrado: o complemento que você oferece junto de uma excursão ou de uma experiência, como um seguro viagem, um transfer ou um almoço à parte. É aqui que você ajusta nome, preço, forma de cobrança, estoque, em quais viagens o item aparece, a imagem que o cliente vê e a localização onde o serviço acontece.

Você chega aqui a partir da lista de Opcionais, clicando para editar um item do catálogo, geralmente depois de perceber que o preço mudou, que faltou vincular o item a uma nova excursão, ou que é hora de adicionar fotos e definir o ponto de encontro.

Como usar

1. Na lista de Opcionais, abra o item que você quer alterar. Você chega nesta tela com o nome do opcional já escrito no subtítulo do cabeçalho.
2. O formulário está dividido em três abas, no topo do cartão: Dados Gerais, Mídia e Localização. Você pode ir e voltar entre elas à vontade - nada é gravado até você clicar em salvar.
3. Na aba Dados Gerais, preencha:
   • Nome - o texto que o cliente lê na hora da compra (obrigatório).
   • Descrição Curta - resumo de uma linha que acompanha o item no checkout.
   • Preço - o valor do item, em reais.
   • Base de cobrança - decide como o preço é aplicado: por pessoa cobra de cada passageiro, por reserva cobra um valor único no pedido, por unidade deixa o cliente escolher a quantidade.
   • Quantidade máxima por venda - limite de unidades por compra (deixe em branco para não limitar).
   • Descrição Completa, Duração (minutos) e Ordem de exibição - detalhes complementares.
   • O que inclui e O que não inclui - um item por linha.
   • Excursões onde aparece e Experiências onde aparece - marque as viagens que devem oferecer este item (veja a seção abaixo).
   • Os interruptores Controlar estoque, Obrigatório (auto-incluído), Aceita cupom de desconto, Destaque e Ativo.
4. Na aba Mídia, defina a Imagem de Capa, um Vídeo (URL do YouTube) opcional e adicione fotos na Galeria de Fotos.
5. Na aba Localização, informe onde o serviço acontece: Local/Destino, Endereço, País, Estado/Cidade, Ponto de Encontro e a posição no mapa.
6. Clique em Salvar Alterações para gravar tudo o que foi preenchido nas três abas de uma vez e voltar para a lista. Use Salvar e continuar editando para gravar e permanecer nesta mesma tela.

O que você precisa saber antes

• O opcional só aparece para venda nas viagens marcadas. Mesmo com o item Ativo, se nenhuma excursão nem experiência estiver marcada em "Excursões onde aparece" / "Experiências onde aparece", ele não é oferecido em lugar nenhum - nem no checkout, nem na reserva. O mesmo item pode ser vinculado a várias viagens ao mesmo tempo.
• A seção "Experiências onde aparece" só existe se sua empresa tiver o módulo Experiências Turísticas ativo. Sem o módulo, a seção nem aparece no formulário. Se você desativar o módulo depois de já ter vinculado experiências, os vínculos continuam gravados por baixo dos panos - eles só ficam invisíveis enquanto o módulo estiver desligado.
• "Obrigatório (auto-incluído)" adiciona o item sozinho ao carrinho do cliente, sem ele precisar marcar nada. Use com cuidado em item pago, para não surpreender o cliente na hora de fechar a compra.
• Desligar "Controlar estoque" remove o limite de vendas do item. O campo Estoque total só aparece com o interruptor ligado; desligado, o opcional passa a vender sem limite de quantidade.
• As três abas são gravadas juntas. Só existe um botão de salvar para o formulário inteiro: você pode preencher Dados Gerais, passar para Mídia e Localização sem perder o que já digitou, mas nada é gravado até clicar em Salvar Alterações (ou Salvar e continuar editando).
• A Galeria de Fotos aceita até 10 imagens (JPG, PNG ou WebP, até 10 MB cada). Ela já funciona normalmente nesta tela de edição, porque o opcional editado já está salvo - o aviso de "salve o cadastro primeiro" só aparece na tela de criação de um item novo.
• Cancelar descarta qualquer alteração feita nas três abas e volta para a lista de Opcionais.

Casos especiais

Empresa fora do Brasil ou com serviço prestado em outro país

Na aba Localização, ao trocar o campo País para algo diferente de Brasil, os campos Estado e Cidade viram texto livre, em vez do seletor de estado brasileiro com busca de cidade.

Definir a localização pelo mapa

No campo Localização no Mapa você pode digitar o endereço e clicar em Buscar, clicar diretamente no ponto certo do mapa, ou arrastar o marcador já posicionado para ajustar. As coordenadas ficam gravadas junto do opcional; o link Remover localização aparece assim que houver um ponto marcado e limpa a marcação.

Erros comuns e como resolver

• "O campo nome é obrigatório." - Causa: o campo Nome ficou em branco. Solução: preencha o nome do item antes de salvar.
• "O campo preço é obrigatório." - Causa: o campo Preço ficou vazio ou o valor não foi reconhecido. Solução: digite o valor no formato R$ 0,00.
• "Erro ao atualizar opcional: ..." - Causa: falha inesperada ao gravar (por exemplo, um vínculo com excursão que não existe mais). Solução: recarregue a página e tente salvar de novo; se persistir, confira se as excursões e experiências marcadas ainda existem.
• "Limite máximo de 10 fotos atingido." - Causa: a galeria já tem o máximo de imagens permitido. Solução: remova uma foto existente antes de enviar uma nova.

Onde encontrar

• URL: /admin/opcionais/{opcional}/edit
• Caminho no menu: Módulos > Opcionais, no botão de editar de cada item da lista
• Permissão necessária: opcionais.edit
• Addon necessário: Opcionais