> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Funções de Engenharia: identifique o papel de cada insumo no projeto

# 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.

| Campo | Para que serve |
| --- | --- |
| **Nome** | Como você chama a função — *Ramal de Entrada* |
| **Código** | Gerado automaticamente do nome (*ramal-de-entrada*). Só leitura |
| **Ordem** | Posição na lista de seleção. Menor aparece primeiro |
| **Ativo** | Desligado, some das opções — sem apagar o histórico |

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.