> ## 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 agir quando a busca de kits mostra erro ou o distribuidor está fora do ar

Na hora de gerar a proposta, a busca de kits do distribuidor mostrou um erro, demorou demais ou voltou sem nenhum kit? Quase sempre a causa está em um destes pontos: a **conexão do distribuidor**, o **filtro da busca** ou uma **instabilidade no sistema do próprio fornecedor**. Neste artigo você aprende a ler a mensagem, a testar a conexão e a escolher o melhor caminho para não parar a venda.

## Antes de começar: de onde vêm os kits

Os kits dos distribuidores (como Aldo, Fotus, JNG, Renovigi e outros) são buscados **em tempo real no sistema de cada fornecedor**. Se o fornecedor estiver lento, com a senha vencida ou fora do ar, o Groner mostra a mensagem de erro que recebeu. Por isso algumas mensagens aparecem em inglês ou com o texto do próprio fornecedor.

---

## Parte 1: Leia a mensagem na tela de busca

### 1. Abra a busca de kits

1. Abra o negócio e clique em **Gerar Proposta**.
2. Escolha o tipo da proposta e avance até a etapa **Seleção do Gerador**.
3. No campo **Fornecedor**, escolha o distribuidor desejado, por exemplo **Com Fotus**.

![Campo Fornecedor da etapa Seleção do Gerador com a lista de distribuidores aberta](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/01-03-seletor-fornecedor_97zit7.png)

### 2. Veja o aviso que aparece

Quando algo impede a busca, o aviso aparece no meio da tela, com o botão **Tente novamente**. Também aparece uma mensagem vermelha no canto da tela.

![Etapa Seleção do Gerador mostrando a mensagem de erro Token não configurado e o botão Tente novamente](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/01-04-erro-na-busca-de-kits_4itac0.png)

### 3. Encontre a mensagem na tabela

| Mensagem na tela | O que significa | O que fazer |
| ---- | ---- | ---- |
| **Token não configurado** / **Integração com a [distribuidor] não está disponível** | O distribuidor ainda não foi conectado na sua conta, ou o acesso foi removido | Conecte o distribuidor (Parte 2) e clique em **Tente novamente** |
| **Erro na integração com a [distribuidor]: Acesso negado** | O distribuidor recusou o token ou a senha gravados na sua conta. O token pode ter sido trocado ou desativado pelo fornecedor, ou o cadastro da sua empresa no distribuidor pode estar inativo | Peça ao seu representante no distribuidor um **token novo** (ou confira a senha no portal dele), atualize na aba **Autenticação** e clique em **Testar conexão** (Parte 2) |
| **A [distribuidor] não respondeu em 60s. Selecione a marca e a potência do painel para estreitar a busca e tente de novo.** | A consulta foi grande demais ou o fornecedor está lento | Escolha a **Marca do painel** e a **Potência do módulo** e pesquise de novo |
| **A consulta a [distribuidor] passou de 60s e foi interrompida...** | O mesmo caso, depois de esgotar o tempo total da busca | Pesquise de novo com filtros mais específicos (marca e potência do painel). Se repetir, veja a Parte 3 |
| **Lista parcial: o tempo da consulta se esgotou...** | O Groner mostra os kits que conseguiu buscar a tempo | Refaça a busca com filtros mais específicos para ver o restante |
| **A Fotus não tem essa combinação de painel para a cidade de entrega...** | A marca ou a potência escolhida não existe para a cidade da instalação | Escolha outra marca ou potência. Se o negócio estiver sem CEP, preencha o **Endereço da instalação**, porque a lista de marcas é filtrada por ele |
| **Nenhum painel encontrado** | O fornecedor não tem essa marca na cidade de entrega | Troque a marca do painel |
| **Nenhum kit encontrado** | Os filtros estão muito restritos, ou o distribuidor não tem estoque para essa cidade e potência | Afrouxe os filtros (marca do inversor, fase, tensão) ou escolha outro distribuidor |
| **Erro na integração com a [distribuidor]: ...** seguido de outro texto do fornecedor | O fornecedor recusou a consulta | Leia o texto: ele costuma dizer o motivo (senha trocada, conta bloqueada, token vencido). Teste a conexão (Parte 2) |

> **Dica:** nos distribuidores da plataforma Solaryum (Fotus, Ourolux, Vertys, Avt Energy e JNG), trocar a marca do inversor muda os kits disponíveis. Se a lista vier vazia, tente outra marca.

---

## Parte 2: Teste a conexão do distribuidor

### 4. Abra a lista de distribuidores

1. No menu lateral, clique em **Configurações**.
2. Em **Vendas & Comercial**, abra **Precificação**.
3. Clique na aba **Distribuidores**.

A tela mostra quantos distribuidores estão conectados (por exemplo, **3 / 22 conectado**). Cada cartão mostra o nome, o CNPJ e o estado: **Conectada** ou **Desconectada**.

![Lista de distribuidores com o contador de conectados, um cartão de distribuidor e o estado Desconectada em destaque](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/01-01-lista-distribuidores_zpqec2.png)

### 5. Abra o distribuidor e clique em Testar conexão

1. Clique no cartão do distribuidor.
2. Na aba **Autenticação**, confira os dados de acesso (usuário e senha, ou **Token**, conforme o distribuidor).
3. Clique em **Testar conexão**.

![Janela do distribuidor Fotus com a aba Autenticação, o campo Token e o botão Testar conexão em destaque](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/01-02-config-fotus_1vw7oct.png)

O resultado mostra o motivo que o fornecedor devolveu. Como cada distribuidor funciona de um jeito, veja o que acontece ao testar:

| Tipo de acesso | Distribuidores | O que o teste faz |
| ---- | ---- | ---- |
| **Usuário e senha** | Aldo, Adias Solar, Renovigi, FortLev, Bold Energy, Sol Mais, Bel Energy, ConectoWay, Solfácil e Suno | Entra no fornecedor, renova o acesso e grava o novo. Se a senha estiver errada, o acesso antigo é limpo |
| **Token colado** | Fotus, Ourolux, Vertys, Avt Energy e JNG | Faz uma consulta simples com o token informado. O token que você digitou **não é apagado** se falhar |
| **Sem teste** | Weg, Weg Customizada, Acroni, PHB e Helte | O botão não existe para esses distribuidores |

> **Atenção:** se o teste falhar por senha trocada, conta bloqueada ou verificação em duas etapas, resolva primeiro no site do distribuidor e depois atualize os dados no Groner.

### 6. Troque o token ou a senha recusados

Se a busca ou o teste mostrar **Acesso negado**:

1. Fale com o seu representante no distribuidor e peça um **token de integração novo** (Fotus, Ourolux, Vertys, Avt Energy e JNG) ou confirme o **usuário e a senha** de acesso ao portal (Bel Energy, Aldo e os demais da linha "Usuário e senha").
2. Pergunte também se o cadastro da sua empresa no distribuidor está **ativo** e se o token foi liberado **para a integração com a Groner**: com o cadastro inativo, ou com um token gerado para outra plataforma, até um token novo é recusado.
   - Se o token novo continuar dando **Acesso negado**, confira se você colou exatamente o token recebido (sem espaços) e informe ao distribuidor o dia e o horário do teste, para ele verificar do lado dele.
3. Em **Configurações › Vendas & Comercial › Precificação › Distribuidores**, abra o cartão do distribuidor e a aba **Autenticação**.
4. Clique no valor atual de **Token** (ou de **Usuário** e **Senha**), cole o dado novo e confirme em **Salvar (✓)**.
5. Clique em **Testar conexão** e confira se o resultado é de sucesso.
6. Volte ao negócio e clique em **Tente novamente** na busca de kits.

> Cada distribuidor tem o próprio acesso. Se vários deram **Acesso negado** ao mesmo tempo, troque o acesso de cada um deles.

---

## Parte 3: O distribuidor está fora do ar. E agora?

O Groner **não mostra um aviso automático de "distribuidor fora do ar"**. Você percebe pelo erro ou pela demora. Veja como confirmar e o que fazer:

1. **Teste a conexão** (Parte 2). Se o teste passa e a busca continua vazia, o problema costuma estar no sistema do fornecedor.
2. **Confira se outros distribuidores da mesma plataforma também falham.** **Fotus, Ourolux, Vertys, Avt Energy e JNG usam a mesma plataforma (Solaryum)**. Quando ela está instável, todos podem falhar ao mesmo tempo, mesmo com a sua conexão correta.
3. **Aguarde um pouco e clique em Tente novamente.** A maioria das instabilidades passa em minutos.
4. **Não pare a venda.** Enquanto o fornecedor não volta, use uma alternativa:
   - escolha **outro distribuidor** conectado;
   - use um **Kit Customizado** ou um **Kit Fechado** que você já tenha cadastrado;
   - gere a proposta pelo tipo **Orçamento**, se a sua conta tiver o módulo.

---

## Parte 4: Kit híbrido que não aparece em 127 V ou 220 V

Para sistemas híbridos, a busca respeita os filtros **Fase** (monofásico, bifásico ou trifásico) e **Tensão** do cartão do distribuidor.

1. Confira se a **Fase** e a **Tensão** estão de acordo com a instalação.
2. Teste também outra combinação de **Fase** e **Tensão** (por exemplo, 127 V e 220 V) e outros distribuidores.
3. Lembre que o resultado depende do **catálogo do distribuidor**: se ele não tiver kit híbrido bifásico para a sua cidade, a lista virá vazia mesmo sem erro.
4. Nesse caso, use um **Kit Customizado** (monte com o inversor híbrido e a bateria que você cadastrou) ou um **Kit Fechado**.

---

## Se o problema continuar

Abra uma tarefa no suporte informando:

- o **nome do negócio** e do **distribuidor**;
- a **mensagem exata** que apareceu (um print ajuda);
- os **filtros** que você usou (marca do painel, potência, fase e tensão);
- o **horário** em que aconteceu e se **outros distribuidores** também falharam.

Nunca envie token ou senha do distribuidor em mensagem ou imagem de atendimento.

## Perguntas frequentes

**Por que aparece texto em inglês no erro?**
O Groner repassa o que o distribuidor respondeu. Algumas mensagens vêm do sistema do fornecedor e não são traduzidas.

**Preciso conectar de novo o distribuidor quando a busca falha?**
Só se a mensagem falar de token, senha ou acesso. Use o botão **Testar conexão** para confirmar.

**A Fotus e a JNG deram erro juntas. O problema é na minha conta?**
Depende da mensagem. Se for demora ou erro genérico, provavelmente é instabilidade da plataforma que as duas usam. Se a mensagem for **Acesso negado**, o distribuidor recusou o acesso gravado na sua conta: troque o token de cada um (Parte 2, passo 6).

**O cartão mostra Conectada, mas aparece Acesso negado. Por quê?**
O estado **Conectada** não garante que o distribuidor ainda aceita o acesso gravado. Quando o fornecedor troca ou desativa o token, a busca passa a ser recusada. Use **Testar conexão** para confirmar e troque o acesso (Parte 2, passo 6).