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.
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
list_connectionsmostra as contas conectadas e por que uma está falhando. Se uma conta falhar, as outras continuam respondendo e a falha vem emissues: informe-a, não conclua que o cliente não tem usinas.- Peça várias usinas ou dispositivos numa única chamada e não repita perguntas: as respostas trazem
freshness.ageSeconds. - 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:
- Pergunte se ele quer que você o cadastre (ou faça o login dele) na Suntropy com o e-mail dele.
- Por HTTP:
POST https://connect-gateway.suntropy.ai/device_authorizationcom{"client_id":"suntropy-cli"}→device_code. Depois,POST https://connect-gateway.suntropy.ai/device_authorization/emailcom{"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 paraPOST https://connect-gateway.suntropy.ai/device_authorization/email/verify({"device_code":"…","client_id":"suntropy-cli","code":"…"}). Depois, troque pelo token emPOST 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 402licence_inactive, passe a eleverification_uri_completepara resolver no navegador. - 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-marcase, com o código,npx -y @enerlence/suntropy-cli@latest connect login --code <código>. - Conecte a conta da marca de inversores dele com
create_connection_link({"provider":"<marca>"}) ousuntropy connect add <marca>: você passa um link de uso único e ele conecta na Suntropy. Depois,list_connections. - Se o seu cliente aceita conectores MCP (Claude, ChatGPT, Cursor, Claude Code, Codex), adicione
https://connect-gateway.suntropy.ai/monitoring/mcpcom 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