Enphase Energy IQ8P-3P / IQ Gateway Commercial 2

Sistema de microinversores fotovoltaicos comerciales

Los microinversores Enphase IQ8 Commercial solo informan a su IQ Gateway Commercial 2, por comunicación por línea eléctrica. Edge mide el campo FV mediante un EpiSensor ZEM en el circuito de CA fotovoltaico. La API local del gateway también sirve JSON por HTTPS en la LAN, pero cada petición necesita un token emitido por la nube de Enphase: un año para el propietario del sistema, 12 horas para un instalador.

Microinversores Enphase IQ8 Commercial con IQ Gateway Commercial 2
  • IQ Gateway local API (JSON over HTTPS)

Sistema de microinversores fotovoltaicos comerciales

Preguntar a un ingeniero

Compatibilidad

Compatible con EpiSensor Edge mediante un EpiSensor ZEM en el circuito de CA fotovoltaico

La ficha técnica del IQ8 Commercial indica la comunicación por línea eléctrica como única interfaz de los microinversores, y la monitorización requiere un IQ Gateway Commercial 2. Las fuentes no publican ningún mapa Modbus para el gateway. Edge mide la producción FV mediante un EpiSensor ZEM con TC en el circuito de CA del campo FV. La nota técnica TEB-00060-2.0 de Enphase documenta API JSON locales en el gateway que un flujo personalizado en el espacio de trabajo Node-RED de Edge puede leer con un token bearer emitido por Enphase.

IQ8P-3P-72-E-US, IQ8P-3P-72-E-DOM-US e IQ8H-3P-72-E-US con IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P), según las fichas técnicas DSH-00236-8.0 y DSH-00212-4.0 y la nota técnica TEB-00060-2.0 (software del IQ Gateway 7.0.x o posterior). Comprobación en la instalación: compare la potencia FV del ZEM con la Enphase App o con la lectura de producción del gateway en el mismo intervalo. Ninguna función de control, limitación de exportación o perfil de red de Enphase pasa a Edge.

Conéctalo con

Ruta hacia Edge

Para la potencia y la energía FV en la conexión de CA del campo, sin cuenta ni token de Enphase

  • Cableado
  • Edge
  • Plataformas
Sistema de microinversores fotovoltaicos comerciales
Interfaz
Gateway
Edge
Salida
IQ8P-3P / IQ Gateway Commercial 2Circuitos derivados IQ8 Commercial, trifásicos a 120/208 VAC
EpiSensor ZEMMide la salida de CA combinada de los microinversores con sus propios TC e informa por la red inalámbrica de EpiSensor
ZGW-20 GatewayEjecuta Edge en local
EpiSensor EdgeCliente de protocolo + modelo de puntos
Plataforma del clienteMQTT · API · archivos
TC en el circuito de CA fotovoltaico
Inalámbrico de EpiSensor
Se ejecuta en local
Envío opcional de datos
Un electricista cualificado instala los TC del ZEM en las tres fases del circuito de CA fotovoltaico, aguas abajo de los circuitos derivados y dentro de los valores nominales de tensión y corriente del propio ZEM. El ZEM informa por la red inalámbrica de EpiSensor, así que no cambia ningún ajuste, cuenta ni software de Enphase. El detalle por microinversor sigue en la Enphase App. La salida hacia la plataforma del cliente es opcional; Edge sigue siendo el sistema local de referencia.

Cuando el propietario de la instalación facilita un token de Enphase y el gateway está en la misma LAN que la Gateway con Edge

  • Cableado
  • Edge
  • Plataformas
Sistema de microinversores fotovoltaicos comerciales
Interfaz
Gateway
Edge
Salida
IQ8P-3P / IQ Gateway Commercial 2Microinversores IQ8 Commercial, comunicación por línea eléctrica
Ethernet protegidaLAN segmentada
ZGW-20 GatewayEjecuta Edge en local
EpiSensor EdgeCliente de protocolo + modelo de puntos
Plataforma del clienteMQTT · API · archivos
Ethernet
Ethernet protegida
Se ejecuta en local
Envío opcional de datos
El gateway sirve su API local por HTTPS con un certificado autofirmado. Cada petición lleva la cabecera Authorization: Bearer seguida de un token generado en la nube de Enphase para el número de serie de ese gateway. Un token de propietario dura un año y uno de instalador 12 horas, así que el flujo necesita un plan de renovación. Solo se usan peticiones GET. La salida hacia la plataforma del cliente es opcional; Edge sigue siendo el sistema local de referencia.

Modelos

Descargar
ModelosInterfazRuta hacia Edge
IQ8P-3P-72-E-US / IQ8P-3P-72-E-DOM-US480 VA de pico, 475 VA continuos; comunicación por línea eléctrica con el gatewayMida el circuito de CA combinado con un ZEM; los informes por unidad proceden de /api/v1/production/inverters.
IQ8H-3P-72-E-US384 VA de pico, 380 VA continuos; ya no se fabricaMismas vías que el IQ8P-3P en las instalaciones existentes.
IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P)Sondea hasta 276 microinversores; Wi-Fi, Ethernet opcional, TC de producción con calidad de facturaciónLea su API local con un token de propietario, o déjelo intacto y use la vía del ZEM.

Especificaciones

Los microinversores IQ8P-3P e IQ8H-3P están diseñados para pequeñas instalaciones comerciales trifásicas de cuatro hilos a 120/208 VAC, con un módulo FV por microinversor. Se comunican con el IQ Gateway Commercial 2 por línea eléctrica, y las dos opciones de monitorización necesitan ese gateway.2

Potencia de salida de pico
480 VA (IQ8P-3P); 384 VA (IQ8H-3P)2
Tensión nominal
208 V (183 a 229 V) o 220 V (198 a 242 V), F-F, 60 Hz2
Microinversores por circuito derivado de 20 A
12 (IQ8P-3P); 15 (IQ8H-3P)2
Comunicación de los microinversores
Comunicación por línea eléctrica (PLC)2
Envolvente de los microinversores
NEMA Type 6 / IP67; -40 a 65 °C2
Capacidad del gateway
Hasta 276 microinversores sondeados3
Interfaces del gateway
Wi-Fi 802.11 b/g/n, Ethernet opcional, E/S digitales, API local3
Medida de producción del gateway
Calidad de facturación, ±0,5 %, tres TC de producción de 400 A incluidos3
Validez del token de la API local
1 año (propietario del sistema); 12 horas (instalador)1

Interfaz

Mediciones documentadas y límites de integración para IQ8P-3P / IQ Gateway Commercial 2.

  • GET /info no necesita token y devuelve en XML el número de serie, la referencia y la versión de software del gateway (por ejemplo, D7.4.22).
  • GET /api/v1/production/inverters devuelve, por microinversor, serialNumber, lastReportDate (segundos epoch), devType, lastReportWatts y maxReportWatts. Enphase indica que se actualiza una vez cada cinco minutos.
  • GET /ivp/pdm/energy devuelve wattHoursToday, wattHoursSevenDays, wattHoursLifetime y wattsNow de los microinversores (pcu) y de los contadores de producción y consumo del gateway (eim).
  • GET /ivp/meters/readings devuelve los valores de los TC de producción y consumo (activePower en W, reactivePower en var, voltage, current, freq, energía acumulada) por contador y por canal de fase, actualizados una vez cada cinco minutos.
  • GET /ivp/meters/gridReading devuelve tensión, corriente, frecuencia y potencias activa y reactiva por fase en la conexión a red. Una potencia activa negativa significa exportación.
  • Las peticiones a la API local llevan Authorization: Bearer <token>; la nota técnica solo marca /info como accesible sin token. El gateway usa un certificado autofirmado.

Evaluación

Microinversores IQ8P-3P e IQ8H-3P con IQ Gateway Commercial 2, según las fichas técnicas DSH-00236-8.0 y DSH-00212-4.0 y la nota técnica TEB-00060-2.0. Compare la lectura del ZEM o de la API con la Enphase App en el mismo intervalo.

InteroperabilidadLimitado
La API local está documentada con endpoints y JSON de ejemplo, pero cada lectura depende de un token emitido en la nube con una vigencia fija, y no se publica ningún mapa Modbus.13
PrecisiónCompatible con condiciones
Los TC de producción del gateway tienen calidad de facturación, ±0,5 %; los valores de la API local se actualizan cada cinco minutos.13
SeguridadCompatible con condiciones
Con software 7.0.x o posterior, las API locales necesitan un token bearer por HTTPS; el certificado del gateway es autofirmado.1
FiabilidadLimitado
Las lecturas se actualizan cada cinco minutos y los tokens de instalador caducan a las 12 horas, así que la vía de la API necesita renovación y tratamiento de datos desactualizados.1
RobustezCompatible con condiciones
Los microinversores son NEMA Type 6 / IP67 de -40 a 65 °C; el gateway es IP30 y necesita una ubicación interior o una envolvente NEMA 3R.23
EscalabilidadCompatible con condiciones
Un gateway sondea hasta 276 microinversores; las instalaciones mayores necesitan un gateway y un token por número de serie de gateway.13
Ciclo de vidaCompatible con condiciones
Las fichas técnicas y la nota técnica incluyen historial de revisiones; el IQ8H-3P ya no se fabrica.12

Configuración

Leer el último informe de un microinversor desde la API local

Un HTTPS GET de solo lectura en la LAN de la instalación, con la respuesta de ejemplo de la propia Enphase en la nota técnica TEB-00060-2.0. El token es un marcador de posición; el ejemplo es de Enphase, no una captura de una instalación.

Petición
GET https://<gateway IP>/api/v1/production/inverters con las cabeceras Accept: application/json y Authorization: Bearer <token>.
Respuesta de ejemplo de Enphase
[{"serialNumber": "121935144671", "lastReportDate": 1654171836, "devType": 1, "lastReportWatts": 15, "maxReportWatts": 38}]
Decodificación
lastReportWatts 15 es la última potencia activa notificada en W. maxReportWatts 38 es la potencia más alta que esa unidad ha notificado nunca, no un valor nominal.
Marca de tiempo
lastReportDate 1654171836 son segundos epoch: 2 de junio de 2022, 12:10:36 UTC. Úsela como hora del valor, no como hora de la petición.
Fallo de autenticación
Sin un token válido la petición falla; el ejemplo curl de Enphase usa -f para que una redirección no autenticada aparezca como error. Trátelo como dato ausente y renueve el token.

Aceptación: Acepte la vía de la API cuando la suma de lastReportWatts de todas las unidades, o wattsNow de production.pcu, concuerde con la potencia FV del ZEM en la misma ventana de cinco minutos. Mantenga el ZEM como medida continua cuando caduque el token.

  1. Empezar por el ZEM en el circuito FV

    Mida el campo FV donde se unen sus circuitos derivados, con TC del ZEM en las tres fases y el sentido de importación registrado. No necesita cuenta de Enphase y sigue funcionando si caduca un token. Compare su potencia con la Enphase App en el mismo intervalo.

  2. Decidir quién es el titular del token

    Esta guía usa la nota técnica TEB-00060-2.0. El token se obtiene en entrez.enphaseenergy.com o en enlighten.enphaseenergy.com/entrez-auth-token?serial_num= seguido del número de serie del gateway, con sesión iniciada con credenciales de Enphase. El token del propietario del sistema dura un año; el de un instalador, 12 horas. Acuerde con el propietario quién lo genera y lo renueva.

  3. Comprobar el gateway sin token

    Desde la LAN de la instalación, haga GET https://<gateway IP>/info. Responde sin token y devuelve el número de serie y la versión de software. Con software 7.0.x o posterior, las demás API locales de la nota técnica necesitan el token.

  4. Leer la producción con el token bearer

    Envíe GET https://<gateway IP>/ivp/pdm/energy con las cabeceras Accept: application/json y Authorization: Bearer <token>. Acepte el certificado autofirmado del gateway solo para ese host. Mapee wattsNow y wattHoursLifetime dentro de production.pcu.

  5. Respetar el intervalo de actualización y dejar el control en Enphase

    Enphase actualiza las lecturas de inversores y contadores una vez cada cinco minutos, así que no sondee más rápido y conserve lastReportDate como marca de tiempo del valor. La limitación de exportación, los perfiles de red y las E/S digitales del gateway siguen en el sistema de Enphase.

Preguntas comunes

¿Necesita token la API local del Enphase IQ Gateway?
Sí, con el software del IQ Gateway 7.0.x o superior. El token se genera en la nube de Enphase para el número de serie del gateway. El token de un propietario del sistema es válido durante un año y el de un instalador durante 12 horas. La nota técnica marca /info como accesible sin token.1
¿Con qué frecuencia cambian los valores de la API local?
Enphase indica que las lecturas de los contadores, la producción por microinversor y los informes de consumo se actualizan una vez cada cinco minutos. Un sondeo más rápido devuelve los mismos valores.1
¿Qué significa una lectura de red negativa?
En /ivp/meters/gridReading, una potencia activa negativa significa exportación a la red y un valor positivo, importación.1

Fuentes

  1. Accessing IQ Gateway local APIs and local UI using token, nota técnica TEB-00060-2.0-EN, junio de 2025 (se abre en una nueva pestaña) Enphase Energy
  2. IQ8 Commercial Microinverters, ficha técnica DSH-00236-8.0-EN, junio de 2026 (se abre en una nueva pestaña) Enphase Energy
  3. IQ Gateway Commercial 2, ficha técnica DSH-00212-4.0-EN-US, mayo de 2025 (se abre en una nueva pestaña) Enphase Energy

Lectura adicional

Los nombres de productos y las marcas comerciales pertenecen a sus propietarios. La publicación no implica respaldo ni relación comercial.