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

> Qué es la cuenta API Northbound de Huawei FusionSolar, quién puede crearla, los pasos en el portal (usuario, contraseña, usuario asociado, fecha límite, Basic APIs y plantas) y los errores más frecuentes. En unos diez minutos tienes tus plantas Huawei conectadas a Suntropy.

- URL: https://www.suntropy.ai/blog/cuenta-api-fusionsolar-northbound/
- Publicado: 2026-10-13 · Actualizado: 2026-10-13
- Editor: Suntropy (software con IA para instaladores de autoconsumo, https://www.suntropy.ai)

## En resumen

- Para leer tus plantas Huawei desde otra herramienta no sirve tu usuario del portal: hace falta una **cuenta API** («Northbound»), que se crea dentro del propio FusionSolar.
- Sólo puede crearla el **administrador de la empresa** en FusionSolar. Si te registraste como instalador, normalmente eres tú.
- Se crea en **System › Company Management › Northbound Management › Add**: usuario y contraseña nuevos, un usuario asociado, una fecha límite, **Basic APIs** activado y las plantas (o la empresa entera).
- Con eso, conectar tus plantas a Suntropy son **unos diez minutos**: crear la cuenta gratuita, crear la cuenta API y conectarla.

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

| Qué pasa | Causa habitual |
|---|---|
| No aparece «Northbound Management» en el menú | Tu usuario no es administrador de la empresa |
| La conexión se cierra sola cada cierto tiempo | Estás usando la misma cuenta API en dos sitios: cada inicio de sesión cierra el anterior |
| Faltan plantas | No se seleccionaron al crear la cuenta, o el usuario asociado no tiene acceso a ellas |
| Dejó de funcionar de un día para otro | Llegó la fecha límite (deadline) |
| Los datos llegan con retraso o se cortan | Huawei limita mucho las consultas por cuenta |

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»](/blog/diagnostico-incidencia-inversor-fotovoltaico/).

## 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/

---

Conecta tus plantas Huawei y pregúntale a Alexandria: Con la cuenta gratuita de Suntropy conectas FusionSolar y Alexandria te dice qué plantas fallan, qué alarmas tienen y qué le pasó a cada una. Es sólo lectura. Cuenta gratuita: https://app.suntropy.ai/signup