Cadastros - Configurar Cadastros Personalizados

O que é

Esta página permite criar e gerenciar schemas de cadastros personalizados: estruturas de dados próprias da agência que adicionam informações além dos campos nativos do Viagilize. Cada schema funciona como um "tipo de cadastro" - por exemplo, "Cheques", "Kits de Viagem", "Materiais Promocionais" ou "Documentos de Saúde" - com seus próprios campos configuráveis.

Os schemas são vinculados a uma ou mais entidades do sistema (excursões, clientes ou reservas), e os registros podem aparecer em telas específicas do admin ou no Portal Minha Conta do cliente. O usuário normalmente chega aqui quando precisa coletar dados que o sistema não tem nativamente, como controle interno ou requisitos legais específicos da operação.

Como usar

1. Vá em Configurações > Cadastros Personalizados no sidebar.
2. Confira o contador no canto superior direito (atual/limite) para saber se ainda há espaço no plano contratado.
3. Clique em Novo Cadastro (botão flutuante azul, canto superior direito).
4. Em Informações Básicas, preencha:
   • Nome - obrigatório, até 100 caracteres, identifica o cadastro nas demais telas.
   • Descrição - opcional, até 1000 caracteres, aparece como subtítulo no card da listagem.
5. Em Aparência, escolha:
   • Ícone - abre o seletor de ícones FontAwesome (padrão fa-folder-open).
   • Cor - color picker com input hexadecimal (padrão #6366f1), usada como fundo do ícone no card.
6. Em Entidades Vinculadas, selecione pelo menos uma das opções (Excursões, Clientes, Reservas) clicando no card correspondente. A seleção é obrigatória.
7. Em Onde exibir (telas do admin), marque os sub-locais onde os registros devem aparecer:
   • Para Excursão: Edição da excursão (aba Cadastros) ou Financeiro da excursão.
   • Para Cliente: Página do cliente.
   • Para Reserva: Página da reserva.
8. Se selecionou Clientes, aparece a seção Portal do Cliente (Minha Conta):
   • Marque Exibir no menu do Minha Conta para que o cliente final preencha pelo portal.
   • Escolha o modo: Apenas 1 registro (formulário único) ou Múltiplos registros (lista com criar/editar/excluir).
   • Se o modo for Apenas 1 registro, pode marcar Mostrar alerta de pendência no dashboard para exibir um card "Formulário pendente" no topo do Minha Conta até o cliente preencher.
9. Em Campos, clique em Adicionar Campo para cada informação a coletar. Para cada campo configure:
   • Label - obrigatório, aparece como rótulo do input.
   • Chave - gerada automaticamente a partir do label (slug com underscore), somente leitura.
   • Tipo - Texto, Texto longo, Número, Valor monetário, Data, Data e hora, Seleção única, Seleção múltipla, Sim/Não, E-mail, Telefone, URL/Link ou CPF/CNPJ.
   • Obrigatório - marca o campo como mandatório.
   • Na listagem - exibe o campo na visualização em lista dos registros.
   • Totalizar - apenas para tipos Número e Valor monetário; soma os valores na listagem.
   • Opções (uma por linha) - só para Seleção única e Seleção múltipla.
   • Valor padrão - só para Seleção única; deve coincidir com uma das opções.
10. Use as setas de cima/baixo no canto esquerdo de cada campo para reordenar, ou o ícone de lixeira para remover.
11. Clique em Criar Cadastro (ou Salvar Alterações na edição) ao final da página.

Casos especiais

Schema com registros existentes

Ao excluir, o modal de confirmação informa quantos registros vinculados serão removidos junto. A exclusão é em cascata e definitiva - os registros não voltam.

Ativar e desativar sem excluir

O indicador Ativo / Inativo no rodapé do card alterna o status do schema. Schemas inativos somem das telas de preenchimento mas mantêm registros e configuração intactos. Útil para tirar do ar temporariamente sem perder dados.

Limite do plano atingido

Quando você chega no limite de cadastros personalizados, o botão Novo Cadastro é substituído por Fazer Upgrade, que leva para a página de planos. As ações de edição continuam disponíveis nos schemas existentes.

Portal Minha Conta exige entidade Cliente

A opção Exibir no menu do Minha Conta só aparece se Clientes estiver entre as entidades vinculadas. Se o cliente for removido das entidades depois, o controller silenciosamente desativa aparece_minha_conta no save.

Alerta de pendência exige modo único

A opção Mostrar alerta de pendência no dashboard só aparece e só é persistida quando o modo é Apenas 1 registro e a exibição no Minha Conta está marcada. Em modo múltiplo o alerta é descartado no save.

Reordenar schemas na listagem

A ordem dos cards segue a coluna ordem. Existe endpoint reorder que aceita o array de IDs e atualiza as posições - usado por integrações de drag-and-drop.

Erros comuns e como resolver

• "O nome é obrigatório." - Causa: campo Nome vazio. Solução: preencher antes de salvar.
• "É necessário adicionar pelo menos um campo." - Causa: tentou salvar sem campos ou com a lista vazia após remover todos. Solução: clicar em Adicionar Campo e configurar ao menos um.
• "Selecione pelo menos uma entidade vinculada." - Causa: nenhum dos cards (Excursões, Clientes, Reservas) foi selecionado. Solução: clicar em pelo menos um card antes de salvar.
• "Você atingiu o limite de X cadastros personalizados do seu plano. Faça upgrade para criar mais." - Causa: tentou abrir o formulário de criação ou salvar com o limite do plano esgotado. Solução: excluir um schema não utilizado ou contratar plano superior em Configurações > Plano.

Onde encontrar

• URL: /admin/configuracoes/cadastros-personalizados
• Caminho no menu: Configurações > Cadastros Personalizados
• Permissão necessária: cadastros_personalizados.config
• Módulo necessário: nenhum (sujeito a limite de quantidade por plano)

Veja também

• Cadastros Personalizados - Visualizar registros
• Dados da Empresa