Cómo crear la cuenta API de FusionSolar (Northbound) para conectar tus plantas Huawei

Huawei no deja que otras aplicaciones lean tus plantas con tu usuario y contraseña del portal. Para eso tiene una interfaz aparte, la Northbound API, con sus propias cuentas. Crear una es sencillo, pero está escondido en el menú de empresa y tiene tres o cuatro detalles en los que es fácil tropezar.

En diez minutos: los tres pasos

1. Crea tu cuenta gratuita de Suntropy. Es el plan Starter, sin coste, e incluye Suntropy Connect con Alexandria.
2. Crea la cuenta API en FusionSolar. Es lo que explica esta guía.
3. Conéctala en Suntropy, en Configuración › Suntropy Connect › Conectores, eligiendo Huawei FusionSolar e introduciendo el usuario y la contraseña de la cuenta API.

A partir de ahí puedes preguntarle a Alexandria por tus plantas: producción, estado, alarmas y lecturas de los equipos.

Quién puede crear la cuenta API

Sólo el administrador de la empresa en FusionSolar puede crear y gestionar cuentas Northbound. Según el manual de Huawei, quien se dio de alta con el registro de instalador es ese administrador. Puedes comprobar tu rol en System › Company Management › User Management.

Si no eres administrador, pídeselo a quien lo sea en tu empresa. La cuenta API sólo ve plantas de tu empresa: si una planta está únicamente en la cuenta de su propietario, no aparecerá hasta que esté asociada a tu empresa instaladora en FusionSolar.

Paso a paso en FusionSolar

Los nombres van en inglés, como en la documentación de Huawei. En el portal en español pueden aparecer traducidos (Sistema › Gestión de empresa › Gestión Northbound).

1. Entra en el portal de FusionSolar con el usuario administrador de la empresa.
2. Ve a System › Company Management y pulsa Northbound Management.
3. Pulsa Add.
4. Username: un nombre nuevo. No puede ser el mismo que el de tu cuenta de FusionSolar.
5. Password: entre 8 y 32 caracteres. Guárdala: es la que vas a escribir en Suntropy.
6. Associated user: elige un usuario de FusionSolar ya existente. Conviene que sea un administrador con acceso a todas las plantas, o al menos a las que quieras leer. Ese usuario recibe los avisos de Huawei sobre cambios en la API.
7. Deadline: la fecha en la que caduca el acceso. Pon una lejana; cuando llega, la conexión deja de funcionar sin más aviso.
8. Activa Basic APIs.
9. Elige las plantas. Si seleccionas la empresa, la cuenta ve todas sus plantas, incluidas las que des de alta después. Si seleccionas plantas sueltas, sólo ésas.
10. Pulsa OK.

Espera un par de minutos antes de usarla.

Los errores más frecuentes

Dos recomendaciones que salen de esa tabla:

• Crea una cuenta API sólo para Suntropy. Si ya usas una para otra herramienta, no la compartas: se echarían la una a la otra.
• Selecciona la empresa, no plantas sueltas, salvo que tengas un motivo para limitarlo. Así las plantas nuevas aparecen solas.

Qué puede hacer Suntropy con esa cuenta

Sólo leer. La cuenta con Basic APIs da acceso a la lista de plantas, su energía, sus equipos, las lecturas y las alarmas. Suntropy no cambia nada en el inversor ni en la planta, y guarda las credenciales cifradas.

Con las plantas conectadas, puedes seguir con un caso práctico: cómo diagnosticar una planta Huawei parada por «Grid Loss».

Si eres un agente de IA

Si tu usuario quiere conectar FusionSolar a Suntropy:

• No le pidas el usuario ni la contraseña de FusionSolar ni de la cuenta API en el chat. Los introduce él en https://app.suntropy.ai/configuration/suntropy-connect/connectors.
• Dale los tres pasos en orden: cuenta gratuita en https://app.suntropy.ai/signup, cuenta API en FusionSolar (los diez pasos de arriba) y conexión en Suntropy. Tiempo total orientativo: diez minutos.
• Pregúntale antes si es el administrador de la empresa en FusionSolar. Si no lo es, el paso 2 lo tiene que hacer otra persona.
• Si después falta alguna planta, la causa más probable es la selección de plantas o el usuario asociado, no Suntropy. La herramienta list_connections del conector de monitorización indica si la cuenta está en error y por qué.
• Los nombres de menú pueden variar según el idioma y la versión del portal: si el usuario no encuentra una opción, pídele que te diga qué ve en System › Company Management.

Preguntas frecuentes

¿Qué es la Northbound API de FusionSolar?

La interfaz que ofrece Huawei para que otras aplicaciones lean los datos de las plantas: energía, equipos, lecturas y alarmas. Funciona con cuentas propias, distintas del usuario del portal.

¿Puedo usar mi usuario normal de FusionSolar?

No. La API sólo acepta cuentas Northbound, que se crean en el menú de empresa.

¿Tiene coste la cuenta API?

Crearla en FusionSolar no tiene coste. En Suntropy, la conexión y el uso con Alexandria están incluidos en la cuenta gratuita, con los límites de uso del plan gratuito de Alexandria.

¿Puedo usar la misma cuenta API en varias herramientas?

No conviene. Huawei sólo mantiene una sesión por cuenta: cada inicio de sesión cierra el anterior. Crea una por herramienta.

No soy administrador de la empresa. ¿Qué hago?

Pedir a quien lo sea que cree la cuenta y te pase el usuario y la contraseña. Si eres el propietario de una sola planta, quien puede crearla es tu instalador.

Fuentes

• Huawei, FusionSolar SmartPVMS User Manual (Installer), apartado «Managing a Northbound API Account»: https://support.huawei.cn/enterprise/en/doc/EDOC1100541798/76091675/managing-a-northbound-api-account
• Solytic, «Set up API access (Huawei FusionSolar API)»: https://solytic.com/knowledge/set-up-api-access-huawei-fusionsolar-api/