Neste tutorial, você vai entender como configurar seu documento ou proposta para exibir, de forma automática, os componentes do kit solar (cabos, conectores, estruturas etc.) utilizados em um projeto no SolarMarket.
🎥 Veja a explicação no vídeo, ou em texto, abaixo do vídeo:
O que são chaves de componentes do kit?
As chaves de componentes são códigos utilizados para inserir automaticamente no documento de proposta doc informações detalhadas sobre os equipamentos do sistema solar. Modelos de proposta no web, dispensam esse tipo de configuração com chaves. Essas chaves permitem retornar:
-
Nome do componente
-
Quantidade do componente
Essas chaves possuem um número no final, chave de número incremental, ao qual especifica qual componente se trata.
Exemplo de chaves de componente
-
[comp_nome_1]→ Nome do 1° componente do kit fotovoltaico, sem ser o módulo e inversor -
[comp_qtd_1]→ Quantidade desse 1° componente -
[comp_nome_2]→ Nome do 2° componente do kit fotovoltaico, sem ser o módulo e inversor -
[comp_qtd_2]→ Quantidade desse 2° componente
Onde encontrar essas chaves?
Você pode visualizar todas essas chaves em: Configurações → Proposta Comercial → Variáveis Disponíveis → Tabela de Variáveis
Na tabela, procure pelo grupo chamado “Sistema Solar” — é lá que estarão listadas as chaves de módulos, inversores e estruturas.
Abaixo são apresentadas essas duas chaves.
Exemplos prático
1° Exemplo: Na figura abaixo você pode notar a descrição de um kit fechado da WEG.
Para que todos os componentes adicionais (além dos módulos e inversores) sejam exibidos automaticamente na proposta, é necessário inserir duas chaves para cada componente: uma para o nome do item e outra para a quantidade.
-
Para exibir o nome do componente "Protetor surto CA SPW02-275-20", utilize a chave:
[kit_comp_nome_1] -
Para exibir a quantidade desse protetor, utilize a chave:
[kit_comp_qtd_1]
2° Exemplo: Neste exemplo, temos um kit da ALDO que conta com 6 componentes adicionais.
⚠️ Importante!
Você deve ter percebido que o kit da WEG possui 7 componentes enquanto que o da ALDO possui 6 componentes.
A quantidade de componentes varia bastante entre kits e fornecedores. Por isso, antes de configurar seu modelo, analise a média de itens usados nos kits que você costuma vender.
Você pode, por exemplo:
-
Criar um template com 10 pares de chaves, se costuma trabalhar com kits mais completos.
-
Ou criar versões diferentes do template (com 5, 7 ou 10 componentes), de acordo com a complexidade dos kits que oferece.
Ao configurar por exemplo 10 chaves de nome de componentes no template de proposta e gerar uma proposta com kit de 6 componentes, 6 virão puxando as informações de forma correta e as outras 4 chaves não terão informações a puxar, então virá a informação “undefined”.
✅ Como evitar o erro “Undefined”
Você tem duas opções simples para evitar esse problema:
-
Criar variáveis customizadas: Se os kits que costuma utilizar possuem padrão na quantidade de componentes (como 5, por exemplo), você pode criar variáveis personalizadas para cada uma delas.
-
Criar diferentes modelos para cada cenário: Outra opção é configurar vários modelos com diferentes quantidades de chaves de componentes. Por exemplo:
-
Um modelo para receber kits com 5 componentes
-
Um modelo para receber kits com 6 componentes
-
Um modelo para receber kits com 7 componentes
-
🔗 Artigos relacionados
Como cadastrar ou editar modelos de documentos?
Como configurar um template de proposta ou documento?
Como criar uma variável customizada para o seu template de proposta doc?