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

# Como configurar microinversores no Kit Customizado

Este artigo mostra como fazer o **Kit Customizado** montar kits com **microinversor**: como cadastrar o micro para que o sistema conte **um micro a cada N módulos**, como escrever as **fórmulas** dos itens que acompanham o micro (cabo tronco, terminação, conectores) e como **impedir que a proposta ofereça micro com um módulo acima do que o fabricante aceita**, por exemplo um módulo de 700 W num micro que aceita até 600 W.

## Antes de começar

- Você precisa de um usuário com perfil **Administrador**.
- O Kit Customizado já precisa estar funcionando: permissão **Proposta com a KitCustomizado**, linha na **Base de Precificação** que atenda o fornecedor Kit Customizado, módulos cadastrados e regras de insumo. Se ainda não está, siga primeiro [Como gerar propostas com Kits Customizados](https://ajuda.groner.app/pt-br/article/como-gerar-propostas-com-kits-customizados-1v0cndt/).
- Tenha em mãos a **ficha técnica (datasheet)** do microinversor: potência, quantos módulos ele atende e a potência máxima de módulo que ele aceita.

## Como a Groner monta um kit com microinversor

Na hora de gerar a proposta, a Groner faz esta conta:

1. **Quantidade de módulos** = potência desejada ÷ potência do módulo, arredondada para cima.
2. **Quantidade de micros** = quantidade de módulos ÷ valor do campo **MPPT** do micro, arredondada para cima.
3. **Potência CA do kit** = quantidade de micros × potência do micro.
4. Cada **regra de insumo** que se encaixa no projeto acrescenta o seu item ao kit.

**Exemplo** com potência desejada de 6,00 kWp, módulo de 600 W e micro de 2 kW que atende 4 módulos:

| Conta | Resultado |
| --- | --- |
| Módulos: 6.000 ÷ 600 | **10 módulos** |
| Micros: 10 ÷ 4 = 2,5, arredondado para cima | **3 micros** |
| Potência CA: 3 × 2 kW | **6,00 kW** |

> **Importante:** no kit com micro, a Groner **não** descarta o kit pela faixa de overload, como faz com o inversor string. Para cada micro cadastrado do tipo escolhido, sai um kit.

## Passo 1 – Cadastrar o microinversor do jeito certo

Acesse **Configurações > Vendas & Comercial > Precificação > Inversores** e cadastre o micro (na tabela ou pela planilha de importação). Três campos fazem toda a diferença:

| Campo | O que preencher no micro | Exemplo |
| --- | --- | --- |
| **Tipo** | Um nome que contenha **[micro]**, com os colchetes | `Microinversor [micro]` |
| **MPPT** | Quantos **módulos** cada micro atende (não é o número de MPPTs da ficha) | `4` |
| **Potência** | A potência do micro, em **kW** | `2` |

- **Sem o [micro] no Tipo**, a Groner trata o equipamento como inversor string: tenta combinar inversores pela faixa de overload e não conta "um micro a cada N módulos". É a causa mais comum de proposta com quantidade de micros errada ou de "Nenhum kit encontrado" com micro.
- O texto antes do [micro] é livre e é o que o vendedor vê no filtro **Tipo**. Use o mesmo nome em todos os micros que devem aparecer juntos.
- Preencha também **Fase**, **Tensão**, **Overload máximo** (qualquer valor acima de zero, por exemplo 150) e deixe o inversor **ativo**. Inversor inativo ou com overload máximo vazio não entra em kit nenhum.

> **Já tem regras e propostas usando outro nome de tipo?** As regras de insumo e as restrições técnicas reconhecem o tipo **pelo nome**. Se você trocar "Microinversor" por "Microinversor [micro]", abra cada regra de insumo do micro e marque o tipo novo no campo **Tipos**.

![Tela de Inversores com a coluna Potência máx. do módulo (W) preenchida em dois inversores](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/01-inversores-micro_15z0b39.png)

## Passo 2 – Criar as regras dos itens do micro

Os itens que acompanham o micro (cabo tronco, terminação, conectores, estrutura) entram por **regras de insumo**, em **Configurações > Vendas & Comercial > Precificação > Kits Customizados Regras**, aba **Regras de insumo**.

Em cada regra:

- Em **Tipos**, marque o tipo do micro (por exemplo **Microinversor [micro]**). Assim a regra só entra em kit com micro.
- Em **Tipos de telhado** e **Fases**, marque as opções em que o item vale. Esses três campos são obrigatórios: se um deles ficar vazio, a regra **nunca** é aplicada.
- O resultado da **fórmula** é a **quantidade** do item. O valor no kit é a quantidade × o preço de venda do insumo.

### Variáveis mais úteis para micro

| Variável | O que vale no kit com micro |
| --- | --- |
| `[[QuantidadeInversores]]` | Quantidade de micros do kit (no exemplo, 3) |
| `[[QuantidadeModulos]]` | Quantidade de módulos (no exemplo, 10) |
| `[[PotenciaModulo]]` | Potência de um módulo, em W |
| `[[PotenciaCC]]` | Potência dos módulos do kit, em kWp |
| `[[PotenciaCA]]` | Soma da potência dos micros, em kW |
| `[[FabricanteInversor]]` | Fabricante do micro, em texto |

### Exemplos de fórmulas para micro

| Item | Fórmula | No exemplo (3 micros, 10 módulos) |
| --- | --- | --- |
| Um conector de cabo tronco por micro | `[[QuantidadeInversores]]` | 3 |
| Uma terminação a cada trecho de até 3 micros | `Ceiling([[QuantidadeInversores]] / 3)` | 1 |
| Cabo tronco: 2 metros por micro, mais 5 metros de sobra | `[[QuantidadeInversores]] * 2 + 5` | 11 |
| Um par de conectores por módulo | `[[QuantidadeModulos]]` | 10 |
| Kit de monitoramento só acima de 4 micros | `if([[QuantidadeInversores]] > 4, 1, 0)` | 0 (o item fica fora do kit) |

Regras da escrita da fórmula:

- 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)`.
- Resultado **zero ou negativo** tira o item do kit. Use isso para itens condicionais, como no último exemplo.
- Não deixe a fórmula vazia: uma regra sem fórmula impede a geração do kit. Para quantidade fixa, digite só o número, por exemplo `1`.

Para o passo a passo da tela de regras, veja [Como criar regras para Kits Customizados](https://ajuda.groner.app/pt-br/article/como-criar-regras-para-kits-customizados-1c29nnz/).

## Passo 3 – Impedir micro com módulo acima do limite

Cada microinversor aceita módulos até uma certa potência. Um micro de 4 entradas que aceita até 600 W, por exemplo, não deve aparecer na proposta com um módulo de 700 W. A Groner tem **duas formas** de travar isso, e você pode usar as duas juntas:

| | Restrição técnica | Limite no cadastro do inversor |
| --- | --- | --- |
| **Onde fica** | Kits Customizados Regras, aba **Restrições técnicas** | Inversores, coluna **Potência máx. do módulo (W)** |
| **Vale para** | Todos os inversores do tipo marcado | Só aquele inversor |
| **Precisa ligar a validação de compatibilidade?** | Não, vale sempre que estiver ativa | Sim |
| **Quando usar** | Uma regra simples para todos os micros, como "micro só com módulo de até 600 W" | Micros com limites diferentes entre si |

### Opção A – Restrição técnica (a mais direta)

1. Acesse **Configurações > Vendas & Comercial > Precificação > Kits Customizados Regras**.
2. Abra a aba **Restrições técnicas**.
3. Clique em **+ Restrição**.
4. Preencha:
   - **Nome**: um nome que explique a regra, por exemplo `Micro até 600 W`;
   - **Tipos de inversor**: marque o tipo do micro, por exemplo **Microinversor [micro]**;
   - **Potência máx. do módulo (W)**: o valor da ficha do fabricante, em número inteiro, por exemplo `600`.
5. Deixe **Restrição ativa** ligada e clique em **Salvar**.

![Diálogo "Nova restrição técnica" preenchido com Micro até 600 W, tipo Microinversor e 600 W](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/02-restricao-nova_15aq8hb.png)

A restrição aparece na lista. Pela chave ao lado dela, você liga e desliga sem perder o cadastro. Pelo lápis você edita, e pela lixeira você exclui (a Groner pede confirmação).

![Aba Restrições técnicas com duas restrições, uma ativa e uma inativa](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/03-restricoes-lista_119nwx3.png)

**O que muda na proposta:** ao gerar uma proposta com Kit Customizado, se o vendedor escolher o tipo marcado na restrição e um painel acima do limite, a pesquisa para com a mensagem:

> A restrição técnica "Micro até 600 W" não permite Microinversor [micro] com módulo acima de 600 W, e o painel (nome do painel) tem 700 W. Escolha um painel de até 600 W ou outro tipo de inversor.

Com um painel de até 600 W, ou com outro tipo de inversor, a proposta segue normalmente.

### Opção B – Limite por inversor

1. Acesse **Configurações > Vendas & Comercial > Precificação > Dimensionamento**.
2. Em **Compatibilidade módulo × inversor**, ligue **Validar compatibilidade módulo × inversor**.
3. Acesse **Inversores**, dê um duplo clique na coluna **Potência máx. do módulo (W)** do micro, informe o valor da ficha do fabricante (por exemplo `600`) e clique em **Salvar**. Deixe a coluna vazia para não limitar aquele inversor.

Com a validação ligada, cada inversor é conferido com o módulo escolhido nesta ordem:

1. **Ficha técnica**: tensão e corrente do módulo contra os limites do inversor, quando os dois cadastros têm esses dados.
2. **Potência máx. do módulo**: se faltar a ficha técnica, vale o limite em W do inversor.
3. Sem nenhum dos dois, o inversor continua aparecendo, como antes.

**O que muda na proposta:** o inversor que não aceita o painel fica de fora, e a Seleção do Gerador mostra um aviso com o nome de cada um e o motivo, por exemplo "aceita módulo de até 600 W (o módulo tem 700 W)". Em cada kit aparece o selo **Compatibilidade**, que diz como ele foi conferido: **Conferido pela ficha técnica**, **Conferido pelo limite em W** ou **Sem dados para conferir**. Se nenhum inversor aceitar o painel, a pesquisa explica o motivo de cada um em vez de mostrar uma lista vazia.

![Seleção do Gerador com o aviso "2 inversores ficaram de fora por incompatibilidade com o módulo"](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/05-aviso-inversores-fora_ehtntn.png)

> **A validação de compatibilidade vale para todos os inversores**, não só para os micros. Se você preencher a ficha técnica (tensão e corrente) de módulos e inversores string, eles também passam a ser conferidos.

## Problemas comuns

**A quantidade de micros saiu errada (por exemplo, 1 micro para 10 módulos)**
O Tipo do micro não tem **[micro]**, ou o campo **MPPT** está com o número de MPPTs da ficha em vez da quantidade de módulos que o micro atende. Corrija os dois no cadastro do inversor.

**"Nenhum kit encontrado" ao escolher o micro**
Confira se o micro está **ativo**, tem **Overload máximo** preenchido e tem a **Fase** e a **Tensão** escolhidas no filtro. Sem o [micro] no Tipo, o kit também pode não sair por causa da faixa de overload.

**"A restrição técnica … não permite …"**
O painel escolhido passa do limite da restrição. Escolha um painel de menor potência ou outro tipo de inversor. Se o limite estiver errado, ajuste a restrição em **Restrições técnicas**.

**"Nenhum inversor é compatível com o módulo …"**
Com a validação de compatibilidade ligada, nenhum inversor do filtro aceita o painel. A mensagem lista o motivo de cada um. Troque o painel, o tipo ou o fabricante, ou revise o limite e a ficha técnica dos inversores.

**O item do micro (cabo tronco, terminação) não entrou no kit**
Confira se a regra tem marcados o tipo do micro em **Tipos**, o tipo de telhado do negócio em **Tipos de telhado** e a fase escolhida em **Fases**, e se a fórmula dá um resultado maior que zero.

## Perguntas frequentes

**A restrição vale para propostas que já foram geradas?**
Não. Ela vale para as próximas pesquisas de kit. Propostas já geradas não mudam. Revise as que já estão com o cliente.

**A restrição vale para kits de distribuidor e kits fechados?**
Não. Ela vale para propostas com **Kit Customizado**, em que a Groner monta o kit.

**Posso ter restrições diferentes para tipos diferentes?**
Sim. Crie uma restrição para cada caso, por exemplo "Micro até 600 W" para microinversor e "Híbrido até 670 W" para híbrido.

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [Como gerar propostas com Kits Customizados](https://ajuda.groner.app/pt-br/article/como-gerar-propostas-com-kits-customizados-1v0cndt/)
- [Como criar regras para Kits Customizados](https://ajuda.groner.app/pt-br/article/como-criar-regras-para-kits-customizados-1c29nnz/)
- [Como cadastrar inversores para Kits Customizados](https://ajuda.groner.app/pt-br/article/como-cadastrar-inversores-para-kits-customizados-61npi6/)
- [O que são regras para Kits Customizados?](https://ajuda.groner.app/pt-br/article/o-que-sao-regras-para-kits-customizados-1itxmhz/)

<!-- groner-suporte:veja-tambem:fim -->