Conecta SolisCloud: cómo obtener las llaves de la API

Planes MasterActualizado el

SolisCloud no deja que otra plataforma lea tus plantas con tu usuario y contraseña: pide dos llaves de API, el API Key ID (un número de 19 dígitos) y el API Key Secret. Y no las da de inmediato: primero le pides a Solis que active la API de tu cuenta. Son tres pasos, y el primero depende de Solis: no publica un plazo para México; en Estados Unidos y Canadá promete abrirla en 24 horas.

Mientras Solis responde, tus clientes no se quedan sin reporte: captura o importa la producción como explica Envía reportes de producción.

1. Pide a Solis que active la API

  • Abre un ticket en el Centro de Servicio de Solis: solis-service.solisinverters.com/en/support/tickets/new.
  • Elige el tipo de solicitud API Access Request y escribe el correo de tu cuenta de SolisCloud. Usa el de la cuenta principal de tu empresa, no el de un usuario que diste de alta dentro de ella: Solis busca tu organización por ese correo. Si lo tienes a la mano, agrega el nombre y el código de tu organización (Organization Code).
  • Pide acceso de solo lectura para monitorear la producción de tus plantas. El acceso por API no es control remoto del inversor; Zenit solo lee.
  • Espera la confirmación de Solis por correo.

El Centro de Servicio de Solis está en inglés. Este texto basta: «Hello, please enable API access (API Access Request) for our SolisCloud account [correo]. Organization: [nombre], Organization Code: [código]. We need read-only API access to monitor our plants' production from our monitoring platform, Zenit. Thank you.» Pregúntale a Zenit te lo redacta con tus datos.

2. Activa la API y copia tus llaves

Cuando Solis confirme, hazlo desde una computadora: Solis pide no hacerlo desde el celular. Los nombres son los que usa SolisCloud en inglés.

  • Cierra sesión en SolisCloud y vuelve a entrar, para que aparezca la opción nueva.
  • En el menú de la izquierda abre Service › API Management. En algunas cuentas está en Basic Settings › API Management.
  • Presiona Activate now, espera unos segundos a que se habilite Agree and activate y presiónalo.
  • Presiona View Key › Agree and Continue › Verification Code y desliza la flecha azul hasta que diga Sent Successfully.
  • Copia el código de 6 dígitos que llega a tu correo (revisa spam: caduca pronto), pégalo en Vcode y presiona OK.
  • Verás tu KeyID (el API Key ID, de 19 dígitos) y tu KeySecret. Cópialos completos. SolisCloud también muestra una API URL: Zenit no la necesita.

3. Conecta la cuenta en Zenit

  • En Monitoreo, presiona Configurar (el engrane) y busca la tarjeta SolisCloud.
  • Presiona Agregar Credenciales. Si quieres, ponle un nombre a la cuenta para reconocerla.
  • Pega el KeyID en API Key ID y el KeySecret en API Key Secret, sin espacios.
  • Presiona Probar Conexión: si Solis responde, Zenit guarda la cuenta. Tus plantas Solis llegan con la siguiente sincronización, que corre cada hora; para no esperar, presiona Sincronizar Todo en Monitoreo.

Solo los administradores de tu organización ven Configurar. Las cuentas extra de una marca que ya conectaste no consumen el límite de plataformas de tu plan.

Preguntas frecuentes

Solis responde que no encuentra mi cuenta

Escribe desde el correo de la cuenta principal de tu empresa en SolisCloud, no el de un usuario agregado dentro de ella, e incluye el nombre y el código de tu organización. Solis busca primero cuentas de organización y luego de propietario: si la tuya es de propietario, dilo en el ticket.

Solis dice que la API es solo para el dueño de la planta

Hay instaladores con la API activa en su cuenta de organización: insiste en que es para monitorear, de solo lectura. Si aun así te la niegan, el dueño puede pedirla desde su propia cuenta de SolisCloud y compartirte sus llaves; agrégalas en la misma tarjeta con Agregar otra cuenta.

La conexión funciona pero no aparece ninguna planta

Las llaves leen solo las plantas de la cuenta que las generó. Suele pasar con las llaves de un usuario dentro de la organización o de una cuenta sin plantas: genéralas desde la cuenta principal, la que tiene tus plantas. Si una planta está en la cuenta de tu cliente o de tu distribuidor, necesitas las llaves de esa cuenta.

«Probar Conexión» falla

Revisa que copiaste el KeyID completo (19 dígitos) y el KeySecret sin espacios, y que la API ya esté activa: el paso 2 termina con el código de Vcode. Si Solis acaba de confirmar, cierra sesión en SolisCloud, vuelve a entrar y repite el paso 2.

Artículos relacionados

¿Te quedó alguna duda? Escríbenos a soporte@zenitmaster.com — contestamos el mismo día hábil.