> ## 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). # [Monitoramento] Como criar usuário de API no FusionSolar # Como criar usuário de Gestão de API no FusionSolar A criação de um **usuário de Gestão de API no portal Huawei FusionSolar** é o procedimento prévio obrigatório para liberar a comunicação de dados das suas usinas com o **Groner Monitoramento**. Por meio desse usuário exclusivo, o portal da fabricante gera credenciais dedicadas para que a plataforma da Groner colete telemetria, curvas de produção e códigos de alarme dos inversores de forma automatizada, sem comprometer a senha administrativa principal da sua conta. Siga o passo a passo abaixo para realizar essa configuração diretamente no portal do fabricante. --- ## Antes de começar: Requisitos e Permissões ||| ⚠️ **Permissão necessária no FusionSolar:** Esta configuração só pode ser realizada pelo **Usuário Master** (administrador principal da empresa) no FusionSolar. Contas com perfil de instalador comum ou operador de planta não visualizam a opção de API. | Dica de segurança: **Nunca utilize a mesma senha do seu acesso pessoal ao FusionSolar.** O usuário de Gestão de API atua como uma ponte de comunicação entre sistemas. Criar uma senha exclusiva para ele garante a segurança da sua conta e evita que futuras alterações de senha pessoal interrompam a telemetria das usinas. --- ## Passo a Passo no Portal Huawei FusionSolar ### 1. Acesse o portal FusionSolar 1. Abra a página de login do servidor da Huawei: [Portal FusionSolar (LA5)](https://la5.fusionsolar.huawei.com/pvmswebsite/login/build/index.html); 2. Faça login informando o e-mail e a senha da sua empresa. ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/novo-usuario-img-1_qv9leq.png) --- ### 2. Acesse a área de Gerenciamento de Empresa 1. No menu superior da tela, localize e passe o cursor do mouse sobre a aba **Mais**; 2. No menu suspenso que se abrir, clique em **Gerenciamento de empresa**. ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/novo-usuario-img-2_1k1sfpf.png) --- ### 3. Selecione a aba Gestão de API 1. Na barra de navegação da área da empresa, clique na aba **Gestão de API** (*API Management*); 2. A tela exibirá a listagem de usuários de API já cadastrados na sua conta. 3. No canto superior da tabela de usuários, clique no botão **+ Adicionar** (ou *Add*); * A janela de criação do usuário de API será exibida. ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/novo-usuario-img-3_tzk0e4.png) || Caso a aba "Gestão de API" não apareça no menu, seu usuário atual não possui privilégios de Master. Entre em contato com o responsável pela conta principal da sua integradora para obter esse nível de acesso ou solicitar a criação do usuário. --- ### 4. Preencha os dados do usuário de API Preencha os campos do formulário com atenção aos seguintes pontos: * **Nome de usuário:** Digite um nome para identificar a finalidade da conexão. * *Sugestões recomendadas:* `GronerAPI`, `IntegradorGronerAPI` ou `GronerMonitoramento`. * **Tempo de vencimento:** Escolha uma data futura bem distante (recomendamos definir **5 a 10 anos à frente**). Isso garante que o usuário não expire de surpresa, evitando paradas na sincronização de dados. * **Senha:** Defina uma senha nova e segura, exclusiva para a API. * A senha precisa conter letras maiúsculas, letras minúsculas, números e caracteres especiais (exemplo: `!@#$%`); * Anote e guarde essa senha com cuidado. Ela não poderá ser consultada posteriormente após o salvamento. ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/image_9unsbq.png) ||| ⚠️ **Importante:** Anote o **Nome de usuário** e a **Senha** criados. Esses serão exatamente os valores utilizados posteriormente para conectar o FusionSolar ao **Groner Monitoramento**. --- ### 5. Selecione a opção API básica 1. No campo de seleção de permissões de serviço (*Scope*), marque a opção **API básica**; 2. Essa opção autoriza o envio dos pacotes fundamentais de telemetria, dados de geração em tempo real e relatórios de alarmes dos inversores. ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/image_sffug4.png) --- ### 6. Escolha as plantas que serão monitoradas 1. Na lista de usinas exibida na parte inferior da janela, marque as caixas de seleção das plantas fotovoltaicas que devem ser liberadas; 2. Você pode selecionar usinas individualmente ou marcar todas as plantas da carteira da empresa. ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/image_zq1xvz.png) || Informação técnica: **Apenas as plantas marcadas nesta lista terão os dados liberados para a API.** Quando sua empresa comissionar novas usinas no futuro, será necessário voltar a esta tela, editar o usuário de API e marcar as novas plantas para que comecem a transmitir. --- ### 7. Confirme a criação do usuário 1. Clique no botão **Confirmar** no canto inferior direito da janela de configuração; 2. Uma janela pop-up de confirmação será exibida na tela. Clique em **OK** novamente para confirmar a criação. ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/image_k5xwwy.png) Pronto! Seu novo usuário de Gestão de API está criado e ativo no FusionSolar. --- ## ⚡ Boas Práticas: Limite de 100 usinas por usuário de API Para assegurar uma comunicação rápida e estável, preste atenção à política de requisições da fabricante: | Dica de operação: A infraestrutura em nuvem da Huawei aplica limites de consultas (*rate limiting*) por credencial de API. Por esse motivo, **recomenda-se associar no máximo 100 usinas por usuário de Gestão de API**. ### O que fazer se sua empresa tem mais de 100 usinas: Caso sua carteira possua mais de 100 usinas Huawei ativas: 1. Crie múltiplos usuários de Gestão de API sequenciais no portal (ex: `GronerAPI_01`, `GronerAPI_02`, `GronerAPI_03`); 2. Distribua até 100 usinas em cada um dos usuários criados; 3. Assim, a coleta das usinas será distribuída em canais paralelos, garantindo alta velocidade e evitando filas de espera na sincronização. --- ## Dúvidas Frequentes ### A opção "Gestão de API" não está disponível no meu menu Essa funcionalidade é restrita pela Huawei exclusivamente ao usuário Master da integradora. Se você utiliza uma conta secundária ou de técnico instalador, solicite ao titular da conta Master da empresa que realize o procedimento. ### Esqueci a senha do usuário de Gestão de API. Como recuperar? O portal da Huawei não permite visualizar a senha já cadastrada. Caso tenha esquecido ou perdido a senha: 1. Acesse **Mais ➡️ Gerenciamento de empresa ➡️ Gestão de API**; 2. Localize o usuário, clique em **Modificar** e cadastre uma nova senha; 3. Lembre-se de atualizar essa nova senha nas configurações de conexão do seu sistema de monitoramento. ### Cadastrei uma nova usina no FusionSolar e ela não aparece no monitoramento A autorização de novas usinas na Huawei é sempre manual: 1. Acesse a aba **Gestão de API**; 2. Clique no ícone de edição (lápis / **Modificar**) ao lado do seu usuário de API; 3. Na lista de usinas, marque a caixa de seleção da nova planta instalada e clique em **OK** para salvar.