Funções de Engenharia

O problema que isso resolve

Imagine que o seu diagrama unifilar precisa mostrar qual cabo vai no ramal de entrada.

Sem as funções, a única saída é pedir pelo nome:

[[Item(nome:contains:cabo 6mm)NomeKitSimulacao]]

E aí começam os problemas: um cadastro escreve "CABO 6MM PVC 750V", outro "Cabo Flexível 6,0mm²", outro troca a bitola por causa da distância. O documento passa a mostrar o item errado — ou nada.

Com as Funções de Engenharia você inverte a lógica: em vez de descrever como o item se chama, você declara o que ele faz no projeto. Aí o documento pede exatamente isso:

[[Item(funcao:contains:ramal de entrada)NomeKitSimulacao]]

O produto pode mudar de marca, bitola ou fornecedor — o papel dele continua o mesmo, e o documento nunca erra.

1. Cadastrar as funções

Vá em Configurações → Vendas & Comercial → Precificação → Funções de Engenharia e clique em Funções de engenharia para adicionar.

Você decide quais funções fazem sentido para a sua operação. As mais usadas por integradoras:

• Ramal de Entrada
• Circuito CA
• String CC
• Aterramento
• Proteção CA
• Proteção CC
• Medição
• Estrutura

💡 Não precisa criar todas de uma vez. Comece pelas que você realmente usa nos documentos.

2. Vincular aos insumos

Um insumo pode ter mais de uma função — um cabo 6mm pode servir ao Ramal de Entrada e ao Circuito CA. Ele aparecerá nas duas buscas.

Há duas formas de vincular:

Na listagem (recomendado para preencher vários)

Em Configurações → Precificação → Insumos, a coluna Funções de engenharia tem um seletor em cada linha. Marque as funções e salve — a alteração é aplicada na hora, e você segue para o próximo item sem sair da tela.

É o caminho mais rápido para classificar o catálogo de uma vez.

No detalhe do insumo

Abra o insumo (botão Detalhes) e use o campo Funções no projeto de engenharia. Útil quando você já está editando aquele item.

3. Usar nos documentos

Depois de vincular, é só pedir pela função no modelo (proposta, documento ou contrato — funciona no editor visual e em modelos Word):

Ramal de entrada: [[Item(funcao:contains:ramal de entrada)NomeKitSimulacao]]
Comprimento: [[Item(funcao:contains:ramal de entrada)QuantidadeKitSimulacao]] m

Aterramento: [[Item(funcao:contains:aterramento)NomeKitSimulacao]]
String CC: [[Item(funcao:contains:string)NomeKitSimulacao]]

Mostrar um trecho só se a função existir

{{if [[Qtd(funcao:contains:protecao ca)KitSimulacao]] > 0}}
Proteção CA: [[Item(funcao:contains:protecao ca)NomeKitSimulacao]]
{{endif}}

Se o kit não tiver item com essa função, a linha inteira desaparece do documento.

Listar todos os itens de uma função

Materiais de aterramento: [[Lista(funcao:contains:aterramento)NomeKitSimulacao]]
Total: [[Soma(funcao:contains:aterramento)ValorKitSimulacao]]

Ver as funções de um item

[[Item(codigo:eq:cabo6)FuncaoKitSimulacao]]

→ Ramal de Entrada, Circuito CA

📘 A gramática completa dos códigos (seletores, campos, filtros, condicionais) está no artigo
"Interpolação de itens do kit".

4. Pontos de atenção

A função é gravada quando o kit é montado. Propostas geradas antes de você vincular as funções não têm essa informação — vincule primeiro, depois gere a proposta.

Vale para o seu catálogo de Insumos. Kits que vêm prontos de distribuidores (Aldo, WEG, FortLev) não passam pelo seu cadastro, então não têm função. Para esses, use nome: ou categoria:.

Acento e maiúscula não importam. funcao:contains:protecao encontra "Proteção CA" normalmente.

Prefira contains a eq. Com contains você acerta mesmo sem lembrar o nome exato da função.

Excluir uma função remove o vínculo dos insumos. Se a ideia é só tirá-la de circulação, desative em vez de excluir.

5. Exemplo completo: bloco de um unifilar

COMPONENTES DO SISTEMA

Módulos: [[Soma(categoria:contains:modulo)QuantidadeKitSimulacao]]x [[Item(categoria:contains:modulo)NomeKitSimulacao]]
Inversor: [[Item(categoria:contains:inversor)NomeKitSimulacao]]

CABEAMENTO E PROTEÇÃO
Ramal de entrada: [[Item(funcao:contains:ramal de entrada;senao:conforme projeto)NomeKitSimulacao]]
Circuito CA: [[Item(funcao:contains:circuito ca;senao:conforme projeto)NomeKitSimulacao]]
String CC: [[Item(funcao:contains:string;senao:conforme projeto)NomeKitSimulacao]]
Aterramento: [[Item(funcao:contains:aterramento;senao:conforme projeto)NomeKitSimulacao]]

{{if [[Qtd(funcao:contains:protecao)KitSimulacao]] > 0}}
Dispositivos de proteção: [[Lista(funcao:contains:protecao)NomeKitSimulacao]]
{{endif}}

Dúvidas sobre um modelo específico? Chame o suporte da Groner com o nome do modelo e o código que você escreveu — a gente ajusta junto.

Atualizado em: 28/07/2026