Como criar regras para Kits Customizados

As regras dizem à Groner quais itens entram em cada Kit Customizado além do módulo e do inversor: estruturas, cabos, conectores, proteções, mão de obra. Cada regra liga um insumo a uma fórmula que calcula a quantidade desse insumo, conforme os dados do projeto. Este artigo mostra como criar, testar e manter as regras.

Antes de começar

• Você precisa de um usuário com perfil Administrador.
• Estes cadastros precisam estar prontos, porque a regra depende deles:
• • Inversores, com tipo, fase, tensão, entradas e MPPT. Veja Como cadastrar inversores para Kits Customizados.
  • Módulos, com potência e área. Veja Como cadastrar módulos para Kits Customizados.
  • Categorias de insumos. Veja Cadastrando Categorias e Fornecedores de Insumos (Orçamento).
  • Insumos, cada um com categoria e preço de venda válido para a loja do negócio. Veja Como cadastrar Insumos (Orçamento).

⚠️ Insumo sem categoria ou sem preço faz a geração do kit parar com erro. Confira os dois antes de usar o insumo numa regra.

Passo 1 – Acessar a tela de regras

1. Acesse Configurações > Vendas & Comercial > Precificação > Kits Customizados Regras.
2. A tela abre na aba Regras de insumo, com todas as regras cadastradas. A aba Restrições técnicas, ao lado, serve para outra coisa: impedir combinações, como microinversor com módulo acima de 600 W. Veja Como configurar microinversores no Kit Customizado.

No topo da tela ficam a busca, o Filtro (por fase, tipo, tipo de telhado e tensão), a Ajuda, o Importar, o Modelo da planilha e o botão de nova regra.

Passo 2 – Criar a regra

1. Clique em + Kit Customizado Regra.

2. Preencha o Nome. Ele identifica a regra e não pode se repetir. Use nomes que digam o que a regra faz, por exemplo MC4 por entrada do inversor.
3. Escolha o Insumo que a regra acrescenta ao kit.

4. Preencha quando a regra vale:

⚠️ Se Tipos de telhado, Tipos ou Fases ficar vazio, a regra nunca é aplicada. É a causa mais comum de "o item não entrou no kit". Use Selecionar tudo quando a regra vale para todas as opções.

As opções de Tipos, Fases e Tensões vêm dos inversores ativos cadastrados. Se um tipo não aparece na lista, confira o cadastro do inversor.

5. Escreva a Fórmula (próximo passo) e clique em Confirmar.

Passo 3 – Escrever a fórmula

O resultado da fórmula é a quantidade do insumo, não o valor. O valor que entra no kit é a quantidade × o preço de venda do insumo. Se o resultado for zero ou negativo, o insumo fica fora daquele kit.

• O botão Interpolar lista as variáveis e copia a que você clicar.
• O ícone de expandir, no canto do campo, abre o editor de fórmula. Nele você monta condições e testa o resultado com valores de exemplo antes de salvar.

Regras de escrita

• Use ponto como separador decimal: 2.5, e não 2,5.
• Escreva as funções exatamente assim, com as mesmas maiúsculas e minúsculas: if, ifs, Ceiling, Floor, Max, Min e Round(valor, casas). ceiling ou Ceilling dão erro.
• Não deixe a fórmula vazia: uma regra sem fórmula impede a geração do kit. Para uma quantidade fixa, digite só o número, por exemplo 1.

Funções

Variáveis

Exemplos de fórmulas

Exemplo 1 – Um par de MC4 por entrada do inversor

Fórmula: [[Entradas]]

Inversor com 3 entradas e par de MC4 a R$ 10,00 → 3 pares × R$ 10,00 = R$ 30,00 no kit.

Exemplo 2 – Uma estrutura a cada 4 módulos

Fórmula: Ceiling([[QuantidadeModulos]] / 4)

Projeto com 25 módulos → 25 ÷ 4 = 6,25 → o Ceiling arredonda para cima → 7 estruturas. Com estrutura a R$ 50,00, entram R$ 350,00 no kit.

Exemplo 3 – Quantidade por faixa de potência

Fórmula:

ifs([[PotenciaCC]] <= 3, 20,
    [[PotenciaCC]] <= 5, 30,
    [[PotenciaCC]] <= 7, 40,
    50)

• Até 3 kWp → 20 unidades
• Até 5 kWp → 30 unidades
• Até 7 kWp → 40 unidades
• Acima de 7 kWp → 50 unidades

As condições são lidas em ordem e vale a primeira verdadeira. O último valor, sem condição, é o padrão.

Exemplo 4 – Um item por inversor, de cada modelo

Fórmula: [[QuantidadeInversor]]

Num kit com 2 inversores de um modelo e 1 de outro, a regra roda duas vezes: entram 2 unidades para o primeiro modelo e 1 para o segundo.

Exemplo 5 – Mão de obra por módulo, com mínimo

Fórmula: Max(8, [[QuantidadeModulos]])

Cobra por módulo, mas nunca menos que 8 unidades.

Manter as regras

• Editar: clique no lápis da regra, ajuste e clique em Confirmar.
• Duplicar: clique no ícone de copiar para criar uma variação de uma regra existente. Troque o nome, porque ele não pode se repetir.
• Excluir: clique na lixeira e confirme.
• Atualizar várias de uma vez: veja o passo a passo logo abaixo.
• Importar por planilha: clique em Modelo para baixar a planilha (ela traz a aba "Como preencher"), preencha uma linha por regra e use Importar.
• • Vários valores vão na mesma célula, separados por ponto e vírgula (;).
  • Tipos de telhado, concessionárias e lojas são localizados pelo nome. Nome não encontrado é ignorado sem aviso: se nenhum tipo de telhado for reconhecido, a regra fica sem telhado e não é aplicada.
  • Uma linha com o mesmo nome de uma regra já cadastrada atualiza essa regra. As outras são criadas.
  • Um código de insumo inexistente interrompe a importação naquela linha. As linhas anteriores já ficam salvas.
• Ajuda na própria tela: o botão Ajuda abre um resumo de tudo isso, com as variáveis e os exemplos.

Atualizar várias regras de uma vez (edição em massa)

Use quando precisar acrescentar ou trocar tipos, fases, tensões, concessionárias ou lojas em muitas regras ao mesmo tempo, sem abrir uma por uma. Um caso comum: você cadastrou um tipo de inversor novo (por exemplo, HÍBRIDO STRING) e quer que as regras que já existem passem a valer para ele também.

1. Na aba Regras de insumo, se quiser, use o Filtro para mostrar só as regras que vão mudar (por exemplo, filtrando pelo tipo STRING).
2. No rodapé da tabela, aumente as linhas por página para 50, assim você marca mais regras de uma vez.
3. Marque as regras na caixa da esquerda de cada linha. A caixa do cabeçalho marca todas as regras da página. Se as regras ocupam várias páginas, faça o processo uma página por vez.
4. Clique em Atualizar kits selecionados, logo acima da tabela.
5. Na janela, escolha só o que vai mudar. No exemplo, em Tipo, marque apenas HÍBRIDO STRING. Os campos que você deixar em branco mantêm o que cada regra já tem.
6. Na chave entre Substituir e Incrementar, escolha:
7. • Incrementar: acrescenta o que você marcou ao que a regra já tem. Uma regra com STRING e MICRO fica com STRING, MICRO e HÍBRIDO STRING. Se a regra já tinha o valor, ele não se repete.
   • Substituir: troca o que a regra tinha pelo que você marcou. Uma regra com STRING e MICRO ficaria só com HÍBRIDO STRING.
7. Marque a caixa Estou ciente que essa operação irá… e clique em Confirmar.
8. Abra uma das regras pelo lápis e confira se o campo ficou como esperado.

⚠️ A opção padrão da chave é Substituir. Para só acrescentar um tipo novo, mude para Incrementar antes de confirmar.

⚠️ Cuidado com regras que estão sem tipo hoje: elas não são aplicadas a nenhum kit. Se forem marcadas no incremento, passam a valer só para o tipo acrescentado. Deixe-as desmarcadas se não for essa a intenção.

A edição em massa não muda tipos de telhado, fórmula, insumo nem nome. Para esses, edite a regra ou use a importação por planilha.

Problemas comuns

O item não entrou no kit
Confira se a regra tem marcados o tipo de telhado do negócio, o tipo e a fase escolhidos na proposta, e, se preenchidas, a tensão, a concessionária e a loja. Depois confira se a fórmula dá um resultado maior que zero.

Cadastrei um tipo de inversor novo e as regras não valem para ele
As regras só valem para os tipos marcados nelas. Acrescente o tipo novo em todas de uma vez pela edição em massa (seção "Atualizar várias regras de uma vez", acima), com a chave em Incrementar.

"Regra: (nome), Fórmula: (fórmula), Erro: (mensagem)"
A fórmula da regra indicada tem erro de escrita. Os mais comuns são vírgula como separador decimal, função com maiúscula errada e variável digitada errado (por exemplo [[Entrada]] no lugar de [[Entradas]]). Teste a fórmula no editor.

"O insumo (nome) não tem nenhum preço cadastrado!"
Cadastre o preço de venda do insumo para a loja do negócio.

"O insumo (nome) está sem categoria cadastrada…"
Defina a categoria no cadastro do insumo.

A quantidade de entradas saiu menor do que eu esperava
[[Entradas]] conta cada modelo de inversor uma vez: dois inversores iguais de 3 entradas contam 3. Se todos os inversores daquele tipo têm o mesmo número de entradas, use [[QuantidadeInversores]] vezes esse número, por exemplo [[QuantidadeInversores]] * 3.

Veja também

• O que são regras para Kits Customizados?
• Como gerar propostas com Kits Customizados
• Como configurar microinversores no Kit Customizado
• Como cadastrar Insumos (Orçamento)
• Como criar fórmulas para Custos Extras

Atualizado em: 23/10/2026