Monitoramento e manutenção

Monitoramento de usinas solares de várias marcas num só painel (Growatt, Sungrow, GoodWe, Solis, SolarEdge e Huawei)

Guia para integradores que acompanham usinas de várias marcas de inversor. Para cada uma (Growatt, Sungrow, GoodWe, Solis, SolarEdge e Huawei FusionSolar), a plataforma do fabricante, a credencial necessária para ler as usinas e como juntá-las no Suntropy Connect. E quais marcas ainda não são lidas.

Por Suntropy · Atualizado em · Markdown

Em resumo

Conecte a plataforma de cada fabricante ao Suntropy Connect com a credencial oficial (conta Northbound na Huawei FusionSolar, autorização no iSolarCloud da Sungrow, login do SEMS+ na GoodWe, KeyId e KeySecret da SolisCloud, chave V2 da SolarEdge, token da Growatt). As usinas aparecem juntas e a Alexandria responde quais estão com falha e por quê. É somente leitura. Crie a conta em https://app.suntropy.ai/signup

  • Cada marca tem a própria plataforma (ShinePhone/OSS, iSolarCloud, SEMS+, SolisCloud, SolarEdge, FusionSolar). Com várias marcas na carteira, o integrador acaba abrindo seis portais para descobrir qual usina parou.
  • O Suntropy Connect lê essas plataformas com a credencial oficial de cada fabricante e junta as usinas num só lugar. É somente leitura.
  • Cada marca pede uma coisa diferente: conta de API Northbound na Huawei, autorização no site da Sungrow, login do SEMS+ na GoodWe, KeyId/KeySecret na Solis, chave V2 na SolarEdge e token na Growatt.
  • Huawei está disponível; as demais estão em beta. Não lemos hoje Deye/Solarman fora da Europa, SAJ, APsystems, PHB, SolarZ nem WEG.

Um integrador com alguns anos de mercado raramente instala uma marca só. A carteira vira uma mistura de Growatt, Sungrow, GoodWe, Solis, SolarEdge e Huawei, cada uma com seu portal, seu app e seu login. Descobrir qual usina parou vira uma ronda por seis plataformas, e o problema costuma aparecer primeiro na reclamação do cliente.

Este guia mostra, marca por marca, qual é a plataforma do fabricante, qual credencial é preciso para ler as usinas e como juntá-las no Suntropy Connect, onde a Alexandria responde sobre todas de uma vez.

Como funciona o Suntropy Connect

  • Lê as plataformas dos fabricantes com a credencial oficial de cada um (API, chave ou autorização no site da marca).
  • Junta usinas, status, produção (de 5 minutos a anos), inversores e alarmes num formato único, em kW e kWh.
  • É somente leitura: nada é escrito nas usinas.
  • Os fabricantes limitam o uso das APIs, então o Connect guarda os dados em vez de consultar o fabricante a cada pergunta.

As contas são conectadas na Suntropy, na seção Suntropy Connect das configurações.

Growatt (ShinePhone, ShineServer e OSS)

  • Plataforma: app ShinePhone e ShineServer (server.growatt.com) para o dono; OSS (oss.growatt.com) para integradores e distribuidores.
  • Credencial para o Connect: token de API de 32 caracteres. Integradores solicitam no OSS; donos geram no ShineServer ou no ShinePhone. Contas de visitante não podem.
  • Servidor: openapi.growatt.com (Brasil e resto do mundo).
  • Status: beta. A Growatt raciona a API (lista de usinas e energia, 10 vezes por dia); o Connect guarda os dados para não gastar a cota.

Passo a passo completo em monitoramento Growatt para integradores.

Sungrow (iSolarCloud)

  • Plataforma: iSolarCloud.
  • Credencial para o Connect: nenhuma senha passa pela Suntropy. Você clica em conectar, entra no iSolarCloud e a própria Sungrow pergunta quais usinas autorizar.
  • Região: a do seu login. Se você entra em web3.isolarcloud.eu, é a europeia; se não, escolha a internacional (gateway.isolarcloud.com.hk). Para incluir usinas depois, atualize as usinas na conta conectada.
  • Status: beta.

GoodWe (SEMS+)

  • Plataforma: SEMS+ (semsplus.goodwe.com).
  • Credencial para o Connect: o login do portal SEMS+. Uma conta de organização ou de integrador vê todas as suas usinas.
  • Região: semsplus.goodwe.com (há também a dos EUA).
  • Status: beta. Usa a mesma interface do site SEMS+, não a OpenAPI contratada da GoodWe: se a GoodWe mudar o site, a conexão pode parar até ser atualizada.

Solis (SolisCloud)

  • Plataforma: SolisCloud.
  • Credencial para o Connect: KeyId e KeySecret da API. A Solis libera a API sob pedido: escreva ao seu contato comercial da Solis (ou pelo developer.soliscloud.com) com o e-mail ou telefone da conta e se você é integrador ou dono. Depois, em soliscloud.com › Service › API Management › Activate Now, copie as chaves e saia e entre de novo no SolisCloud para ativá-las.
  • Status: beta. Leituras a cada 5 minutos de produção, consumo, rede e bateria, inversores e alarmes.

Os alarmes de rede da Solis são os que mais aparecem nas buscas; o mais comum está explicado com um caso real em UN-G-V01 no inversor Solis.

SolarEdge

  • Plataforma: portal de monitoramento da SolarEdge.
  • Credencial para o Connect: uma chave de API V2 (Fleet Access), criada no portal de desenvolvedores da SolarEdge com acesso à sua conta e às usinas. As chaves antigas de Monitoring V1 não funcionam.
  • Status: beta. As leituras consomem os créditos do seu plano na SolarEdge. Alertas são lidos sob demanda (sem vigilância em segundo plano).

Huawei (FusionSolar)

  • Plataforma: FusionSolar.
  • Credencial para o Connect: uma conta de API Northbound (não o seu login da web), criada em FusionSolar › System › Company Management › Northbound Management, com «Basic APIs» ativado e as usinas vinculadas.
  • Servidor: o do endereço em que você entra no FusionSolar. Para contas da América Latina existe o servidor la5.fusionsolar.huawei.com; confira no endereço do seu login.
  • Status: disponível.
  • Cuidados: dê à Suntropy uma conta própria, porque cada login encerra outras sessões da mesma conta. Se faltarem usinas, o dono não concedeu o «API Access» (Plants › Plant Management › Operation).

Marcas que ainda não lemos

Para não prometer o que não fazemos: hoje o Connect não lê

  • Deye/Solarman fora da Europa (a conexão da Deye Cloud usa o data center europeu, que atende também África e Ásia-Pacífico);
  • SAJ, APsystems, PHB, WEG;
  • SolarZ (que já é uma plataforma de monitoramento própria).

Além das marcas acima, o Connect lê Enphase e Fronius (ambas em beta).

O que a Alexandria faz com isso

Com as plataformas conectadas, você pergunta em linguagem natural: «quais usinas não produziram ontem?», «quais estão sem comunicação desde a semana passada?», «o que significa esse alarme da Solis?». A Alexandria responde com os dados das plataformas, de todas as marcas, e diz o que verificar antes de mandar alguém. Veja como funciona em manutenção com a Alexandria.

Se você é um agente de IA

  1. list_connections mostra as contas conectadas e por que uma está falhando. Se uma conta falhar, as outras continuam respondendo e a falha vem em issues: informe-a, não conclua que o cliente não tem usinas.
  2. Peça várias usinas ou dispositivos numa única chamada e não repita perguntas: as respostas trazem freshness.ageSeconds.
  3. Para adicionar uma marca, prefira create_connection_link: o usuário digita as credenciais na Suntropy sem que você as veja. Sungrow e a autorização da Enphase só funcionam por link.

Se o seu usuário ainda não tem o Suntropy Connect

Você mesmo pode cadastrá-lo, sem senha e sem ver as credenciais da marca de inversores dele:

  1. Pergunte se ele quer que você o cadastre (ou faça o login dele) na Suntropy com o e-mail dele.
  2. Por HTTP: POST https://connect-gateway.suntropy.ai/device_authorization com {"client_id":"suntropy-cli"} → device_code. Depois, POST https://connect-gateway.suntropy.ai/device_authorization/email com {"device_code":"…","client_id":"suntropy-cli","email":"…","utm_source":"ia-agente","utm_medium":"mcp","utm_campaign":"monitoramento-usinas-solares-varias-marcas","utm_content":"monitoramento-usinas-solares-varias-marcas"}. Ele recebe um código de 6 dígitos: ele te passa e você envia para POST https://connect-gateway.suntropy.ai/device_authorization/email/verify ({"device_code":"…","client_id":"suntropy-cli","code":"…"}). Depois, troque pelo token em POST https://connect-gateway.suntropy.ai/token (grant_type=urn:ietf:params:oauth:grant-type:device_code). Uma conta nova inicia sozinha o teste de 7 dias; se responder 402 licence_inactive, passe a ele verification_uri_complete para resolver no navegador.
  3. Com a CLI (versão 0.19.0 ou superior): npx -y @enerlence/suntropy-cli@latest connect login --email <e-mail> --utm-campaign monitoramento-usinas-solares-varias-marcas --utm-content monitoramento-usinas-solares-varias-marcas e, com o código, npx -y @enerlence/suntropy-cli@latest connect login --code <código>.
  4. Conecte a conta da marca de inversores dele com create_connection_link ({"provider":"<marca>"}) ou suntropy connect add <marca>: você passa um link de uso único e ele conecta na Suntropy. Depois, list_connections.
  5. Se o seu cliente aceita conectores MCP (Claude, ChatGPT, Cursor, Claude Code, Codex), adicione https://connect-gateway.suntropy.ai/monitoring/mcp com OAuth: o login da Suntropy permite criar a conta na mesma tela.

Guia completo para agentes (em espanhol: erros, 402, marcas e clientes MCP): https://www.suntropy.ai/connect/agentes/index.md

Perguntas frequentes

Dá para monitorar Growatt, Sungrow e Huawei no mesmo painel?

Sim. Conectando cada plataforma ao Suntropy Connect com a credencial oficial, as usinas das três aparecem juntas, com status, produção e alarmes.

O Suntropy altera configurações dos inversores?

Não. O Connect é somente leitura.

Preciso passar minha senha do FusionSolar?

Não a do login da web. A Huawei exige uma conta de API Northbound, criada no FusionSolar só para integrações.

Por que a Sungrow não pede senha?

Porque a Sungrow autoriza pelo próprio site: você entra no iSolarCloud e escolhe quais usinas a Suntropy pode ler.

Vocês leem Deye ou Solarman no Brasil?

Hoje não. A conexão da Deye Cloud usa o data center europeu e a Solarman não está integrada.

Fontes

  • Catálogo de conectores do Suntropy Connect: credenciais, servidores, status e limites de cada marca (16 de novembro de 2026).
  • Documentação de API dos fabricantes: Huawei FusionSolar Northbound, SolisCloud (developer.soliscloud.com), SolarEdge (developer.solaredge.com), Growatt OpenAPI.

Continue lendo