SolarEdge (Publicador independiente) (versión preliminar)
El conector SolarEdge proporciona la oppurtunity para mostrar los datos del sistema en otras aplicaciones.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Richard Wierenga |
| URL | https://knowledge-center.solaredge.com/ |
| Correo Electrónico | rwconnectors@gmail.com |
| Metadatos del conector | |
|---|---|
| Publicador | Richard Wierenga |
| Sitio web | https://www.solaredge.com/ |
| Directiva de privacidad | https://monitoring.solaredge.com/solaredge-web/p/license |
| Categorías | Internet de las cosas; Datos |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| clave_api | securestring | La api_key de esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Datos técnicos del inversor |
Devolver datos de inversores específicos para un período de tiempo determinado. |
| Detalles del sitio |
Muestra los detalles del sitio, como el nombre, la ubicación, el estado, etc. |
| Energía del sitio |
Devolver las medidas de energía del sitio |
| Energía del sitio |
Devolver las medidas de energía del sitio en resolución de 15 minutos |
| Energía del sitio: detallado |
Medidas detalladas de energía del sitio desde medidores, como consumo, exportación (alimentación), importación (compra), etc. |
| Energía del sitio: detallado |
Medidas detalladas de energía del sitio desde medidores, como consumo, exportación (alimentación), importación (compra), etc. |
| Energía del sitio: período de tiempo |
Devuelve la energía total del sitio producida durante un período determinado. |
| Flujo de energía del sitio |
Recupera el flujo de energía actual entre todos los elementos del sitio, incluida la matriz PV, el almacenamiento (batería), las cargas (consumo) y la cuadrícula. |
| Información de almacenamiento |
Obtenga información detallada sobre el almacenamiento de las baterías: el estado de energía, energía y energía de duración. |
| Información general del sitio |
La respuesta incluye la energía actual del sitio, energía diaria, energía mensual, energía anual y energía del tiempo de vida. |
| Inventario de sitios |
Devuelve el inventario de equipos SolarEdge en el sitio, incluyendo inversores/SMIs, baterías, medidores, puertas de enlace y sensores. |
| Lista de componentes |
Devolver una lista de inversores/SMIs en el sitio específico |
| Lista de sitios |
Devuelve una lista de sitios relacionados con el token especificado, que es la cuenta api_key. Esta API acepta parámetros para una búsqueda, ordenación y paginación convenientes. |
| Obtener datos de medidores |
Devuelve para cada medidor en el sitio su lectura de energía de duración, metadatos y el dispositivo al que está conectado. |
| Obtener lista de sensores |
Devuelve una lista de todos los sensores del sitio y el dispositivo al que están conectados. |
| Registro de cambios de equipos |
Devuelve una lista de reemplazos de componentes de equipo ordenados por fecha. Este método es aplicable a inversores, optimizadores, baterías y puertas de enlace. |
| Ventajas del entorno del sitio |
Devuelve todos los beneficios ambientales basados en la producción energética del sitio: emisiones de CO2 guardadas, árboles equivalentes plantados y bombillas encendidas durante un día. |
Datos técnicos del inversor
Devolver datos de inversores específicos para un período de tiempo determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
Número de serie del equipo
|
equipment_id | True | string |
Número de serie del equipo |
|
Inicio (fecha y hora) para obtener datos del inversor
|
startTime | True | string |
Inicio (fecha y hora) para obtener datos del inversor |
|
Final (fecha y hora) para obtener datos del inversor
|
endTime | True | string |
Final (fecha y hora) para obtener datos del inversor |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
count
|
data.count | integer |
Recuento de respuestas |
|
telemetrías
|
data.telemetries | array of object |
telemetrías |
|
threePhaseInverterTelemetry
|
data.telemetries.threePhaseInverterTelemetry | array of object |
threePhaseInverterTelemetry |
|
date
|
data.telemetries.threePhaseInverterTelemetry.date | string |
date |
|
totalActivePower
|
data.telemetries.threePhaseInverterTelemetry.totalActivePower | string |
totalActivePower |
|
dcVoltage
|
data.telemetries.threePhaseInverterTelemetry.dcVoltage | float |
dcVoltage |
|
groundFaultResistance
|
data.telemetries.threePhaseInverterTelemetry.groundFaultResistance | float |
groundFaultResistance |
|
powerLimit
|
data.telemetries.threePhaseInverterTelemetry.powerLimit | float |
powerLimit |
|
totalEnergy
|
data.telemetries.threePhaseInverterTelemetry.totalEnergy | integer |
totalEnergy |
|
temperatura
|
data.telemetries.threePhaseInverterTelemetry.temperature | float |
Temperatura en Celsius |
|
inversorMode
|
data.telemetries.threePhaseInverterTelemetry.inverterMode | string |
Estado del inversor, es decir, OFF, STARTING, MPPT, etc. |
|
operationMode
|
data.telemetries.threePhaseInverterTelemetry.operationMode | integer |
Integer 0 On-grid, 1 Operating in off-grid mode with PV or Battery, 2 operating in off-grid mode with generator |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acVoltage | float |
acVoltage |
|
acFrequency
|
data.telemetries.threePhaseInverterTelemetry.L1Data.acFrequency | float |
acFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.activePower | integer |
activePower |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L1Data.reactivePower | integer |
reactivePower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L1Data.cosPhi | integer |
cosPhi |
|
vL1To2
|
data.telemetries.threePhaseInverterTelemetry.vL1To2 | float |
vL1To2 |
|
vL2To3
|
data.telemetries.threePhaseInverterTelemetry.vL2To3 | float |
vL2To3 |
|
vL3To1
|
data.telemetries.threePhaseInverterTelemetry.vL3To1 | float |
vL3To1 |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acVoltage | float |
acVoltage |
|
acFrequency
|
data.telemetries.threePhaseInverterTelemetry.L2Data.acFrequency | float |
acFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.activePower | integer |
activePower |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L2Data.reactivePower | integer |
reactivePower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L2Data.cosPhi | integer |
cosPhi |
|
acCurrent
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acCurrent | float |
acCurrent |
|
acVoltage
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acVoltage | float |
acVoltage |
|
acFrequency
|
data.telemetries.threePhaseInverterTelemetry.L3Data.acFrequency | float |
acFrequency |
|
apparentPower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.apparentPower | integer |
apparentPower |
|
activePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.activePower | integer |
activePower |
|
reactivePower
|
data.telemetries.threePhaseInverterTelemetry.L3Data.reactivePower | integer |
reactivePower |
|
cosPhi
|
data.telemetries.threePhaseInverterTelemetry.L3Data.cosPhi | integer |
cosPhi |
Detalles del sitio
Muestra los detalles del sitio, como el nombre, la ubicación, el estado, etc.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
details.id | integer |
Identificador del sitio |
|
nombre
|
details.name | string |
El nombre del sitio |
|
accountId
|
details.accountId | integer |
La cuenta a la que pertenece este sitio |
|
estado
|
details.status | string |
Estado de los sitios |
|
peakPower
|
details.peakPower | float |
Los sitios peakPower |
|
divisa
|
details.currency | string |
Moneda de los sitios |
|
installationDate
|
details.installationDate | string |
Fecha y hora de instalación del sitio, formato aaaa-mm-dd hh:mm:ss |
|
ptoDate
|
details.ptoDate | string |
Permiso para operar la fecha |
|
notas
|
details.notes | string |
Notas |
|
type
|
details.type | string |
Tipo de sitio |
|
country
|
details.location.country | string |
País de los sitios |
|
city
|
details.location.city | string |
La ciudad de sitios |
|
address
|
details.location.address | string |
La dirección de los sitios |
|
dirección2
|
details.location.address2 | string |
La dirección de los sitios2 |
|
archivo comprimido
|
details.location.zip | string |
El archivo ZIP de sitios |
|
timeZone
|
details.location.timeZone | string |
La zona horaria de sitios |
|
countryCode
|
details.location.countryCode | string |
Código de país de sitios |
|
alertQuantity
|
details.alertQuantity | integer |
Número de alertas abiertas en este sitio |
|
alertSeverity
|
details.alertSeverity | string |
La gravedad de alerta más alta de este sitio |
|
IMAGE_URI
|
details.uris.IMAGE_URI | string |
Identificador URI de la imagen de sitios |
Energía del sitio
Devolver las medidas de energía del sitio
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
Granularidad de agregación
|
timeUnit | True | string |
Granularidad de agregación, los valores permitidos son QUARTER_OF_AN_HOUR, HOUR, DAY, WEEK, MONTH, YEAR |
|
Fecha de inicio para devolver la medición de energía
|
startDate | True | string |
Fecha de inicio para devolver la medición de energía |
|
La fecha de finalización devuelve la medición de energía
|
endDate | True | string |
La fecha de finalización devuelve la medición de energía |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
energy.timeUnit | string |
Unidad de tiempo solicitada |
|
unidad
|
energy.unit | string |
Unidades de medida |
|
measuredBy
|
energy.measuredBy | string |
Origen de medidas |
|
values
|
energy.values | array of object |
Measurements |
|
date
|
energy.values.date | string |
Fecha y hora |
|
value
|
energy.values.value | float |
Potencia medida (es decir, Watt) en la fecha y hora especificadas |
Energía del sitio
Devolver las medidas de energía del sitio en resolución de 15 minutos
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
La fecha y hora de inicio
|
startTime | True | string |
La fecha y hora de inicio (aaaa-mm-dd hh:mm:ss) para obtener medidas de energía |
|
La fecha y hora de inicio
|
endTime | True | string |
La fecha y hora de inicio (aaaa-mm-dd hh:mm:ss) para obtener medidas de energía |
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
power.timeUnit | string |
Unidad de tiempo (es decir, QUARTER_OF_AN_HOUR) |
|
unidad
|
power.unit | string |
Unidad de medida (es decir, Watt) |
|
measuredBy
|
power.measuredBy | string |
Origen de medidas |
|
values
|
power.values | array of object |
Measurements |
|
date
|
power.values.date | string |
Fecha y hora |
|
value
|
power.values.value | float |
Potencia medida (es decir, Watt) en la fecha y hora especificadas |
Energía del sitio: detallado
Medidas detalladas de energía del sitio desde medidores, como consumo, exportación (alimentación), importación (compra), etc.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
Granularidad de agregación
|
timeUnit | True | string |
Granularidad de agregación, los valores permitidos son QUARTER_OF_AN_HOUR, HOUR, DAY, WEEK, MONTH, YEAR |
|
La hora de inicio medida por energía en formato aaaa-MM-DD hh:mm:ss
|
startTime | True | string |
La hora de inicio medida por energía en formato aaaa-MM-DD hh:mm:ss |
|
Tiempo de finalización medido de energía en formato aaaa-MM-DD hh:mm:ss
|
endTime | True | string |
Tiempo de finalización medido de energía en formato aaaa-MM-DD hh:mm:ss |
|
Seleccionar solo medidores específicos
|
Meters | True | string |
Seleccione solo medidores específicos, si se devuelve todo en blanco. Los valores permitidos son PRODUCTION, CONSUMPTION, SelfConsumption, FeedIn, Purchased |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
energyDetails.timeUnit | string |
Unidad de tiempo solicitada |
|
unidad
|
energyDetails.unit | string |
Unidades de medida |
|
Metros
|
energyDetails.meters | array of object |
Metros |
|
type
|
energyDetails.meters.type | string |
type |
|
values
|
energyDetails.meters.values | array of object |
values |
|
date
|
energyDetails.meters.values.date | string |
Fecha y hora |
|
value
|
energyDetails.meters.values.value | float |
Potencia medida (es decir, Watt) en la fecha y hora especificadas |
Energía del sitio: detallado
Medidas detalladas de energía del sitio desde medidores, como consumo, exportación (alimentación), importación (compra), etc.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
La hora de inicio medida por energía
|
startTime | True | string |
La hora de inicio medida por energía en formato aaaa-MM-DD hh:mm:ss |
|
Tiempo de finalización medido por energía
|
endTime | True | string |
Tiempo de finalización medido de energía en formato aaaa-MM-DD hh:mm:ss |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
powerDetails.timeUnit | string |
Unidad de tiempo solicitada |
|
unidad
|
powerDetails.unit | string |
Unidades de medidas |
|
Metros
|
powerDetails.meters | array of object |
Contadores |
|
type
|
powerDetails.meters.type | string |
Tipo de medidor (Production/Consumption/SelfConsumption/FeedIn (export)/Purchased(import)) |
|
values
|
powerDetails.meters.values | array of object |
Pares de fecha y potencia para cada fecha |
|
date
|
powerDetails.meters.values.date | string |
Fecha y hora |
|
value
|
powerDetails.meters.values.value | float |
Potencia para la fecha y hora especificadas |
Energía del sitio: período de tiempo
Devuelve la energía total del sitio producida durante un período determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
Fecha de inicio para devolver la medición de energía
|
startDate | True | string |
Fecha de inicio para devolver la medición de energía |
|
La fecha de finalización devuelve la medición de energía
|
endDate | True | string |
La fecha de finalización devuelve la medición de energía |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
energy
|
timeFrameEnergy.energy | float |
Resumen de energía |
|
unidad
|
timeFrameEnergy.unit | string |
Unidad de energía (Wh) |
|
measuredBy
|
timeFrameEnergy.measuredBy | string |
Origen de las medidas |
|
date
|
timeFrameEnergy.startLifetimeEnergy.date | string |
Información de fecha de inicio proporcionada |
|
energy
|
timeFrameEnergy.startLifetimeEnergy.energy | float |
Energía de fecha de inicio |
|
unidad
|
timeFrameEnergy.startLifetimeEnergy.unit | string |
Unidad de fecha de inicio (Wh) |
|
date
|
timeFrameEnergy.endLifetimeEnergy.date | string |
Información de fecha de finalización proporcionada |
|
energy
|
timeFrameEnergy.endLifetimeEnergy.energy | float |
Energía de fecha de finalización |
|
unidad
|
timeFrameEnergy.endLifetimeEnergy.unit | string |
Unidad de fecha de finalización (Wh) |
Flujo de energía del sitio
Recupera el flujo de energía actual entre todos los elementos del sitio, incluida la matriz PV, el almacenamiento (batería), las cargas (consumo) y la cuadrícula.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
unidad
|
siteCurrentPowerFlow.unit | string |
Unidades de medida (por ejemplo, Watt) |
|
connections
|
siteCurrentPowerFlow.connections | array of object |
Tabla que incluye todas las relaciones entre los elementos y las direcciones de flujo de energía (generar elemento y elemento de consumo) |
|
desde
|
siteCurrentPowerFlow.connections.from | string |
Elemento que proporciona energía |
|
to
|
siteCurrentPowerFlow.connections.to | string |
Elemento que consume energía |
|
estado
|
siteCurrentPowerFlow.GRID.status | string |
Estado de la cuadrícula (Activo/ Inactivo/ Deshabilitado) |
|
currentPower
|
siteCurrentPowerFlow.GRID.currentPower | float |
corriente de alimentación de la cuadrícula |
|
estado
|
siteCurrentPowerFlow.LOAD.status | string |
Estado de carga (Activo/ Inactivo/ Deshabilitado) |
|
currentPower
|
siteCurrentPowerFlow.LOAD.currentPower | float |
carga actual de Energía |
|
estado
|
siteCurrentPowerFlow.PV.status | string |
Estado de PV (Activo/ Inactivo/ Deshabilitado) |
|
currentPower
|
siteCurrentPowerFlow.PV.currentPower | float |
energía PV actual |
|
estado
|
siteCurrentPowerFlow.STORAGE.status | string |
Estado de almacenamiento (Activo/ Inactivo/ Deshabilitado) |
|
currentPower
|
siteCurrentPowerFlow.STORAGE.currentPower | float |
energía de almacenamiento actual |
|
chargeLevel
|
siteCurrentPowerFlow.STORAGE.chargeLevel | integer |
ChargeLevel de almacenamiento |
|
crítico
|
siteCurrentPowerFlow.STORAGE.critical | boolean |
¿Es crítico para el almacenamiento? |
|
timeLeft
|
siteCurrentPowerFlow.STORAGE.timeLeft | integer |
En el modo de copia de seguridad, tiempo especificado antes de que se agote el almacenamiento |
Información de almacenamiento
Obtenga información detallada sobre el almacenamiento de las baterías: el estado de energía, energía y energía de duración.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
Identificador del sitio
|
startTime | True | string |
Identificador del sitio |
|
Identificador del sitio
|
endTime | True | string |
Identificador del sitio |
|
Devolver datos solo para números de serie de batería específicos
|
serials | string |
Devolver datos solo para números de serie de batería específicos, la lista está separada por comas. Si se omite, la respuesta incluye todas las baterías del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
batteryCount
|
storageData.batteryCount | integer |
El número de baterías incluye en la respuesta |
|
Baterías
|
storageData.batteries | array of object |
Una lista de objetos de batería |
|
placa de identificación
|
storageData.batteries.nameplate | integer |
Capacidad nominal de la batería |
|
serialNumber
|
storageData.batteries.serialNumber | string |
Número de serie de la batería |
|
número de modelo
|
storageData.batteries.modelNumber | string |
Número de modelo de batería |
|
telemetryCount
|
storageData.batteries.telemetryCount | integer |
Número de telemetría de esta batería en la respuesta |
|
telemetrías
|
storageData.batteries.telemetries | array of object |
Una lista de telemetría de datos de almacenamiento |
|
Timestamp
|
storageData.batteries.telemetries.timeStamp | string |
Marca de tiempo de telemetría en el formato AAAA-MM-DD HH:MM:SS |
|
poder
|
storageData.batteries.telemetries.power | integer |
La potencia positiva indica que la batería está cargando, el negativo está descargando |
|
batteryState
|
storageData.batteries.telemetries.batteryState | integer |
Puede ser uno de los siguientes 0 (no válido), 1 (en espera), 2 (mgmt térmico), 3 (habilitado), 4 (error) |
|
lifeTimeEnergyCharged
|
storageData.batteries.telemetries.lifeTimeEnergyCharged | float |
Energía cargada de la batería en Wh, durante la duración de la batería |
|
lifeTimeEnergyDischarged
|
storageData.batteries.telemetries.lifeTimeEnergyDischarged | float |
La energía descargada de la batería en Wh, durante la duración de la batería |
|
fullPackEnergyAvailable
|
storageData.batteries.telemetries.fullPackEnergyAvailable | integer |
La energía máxima (Wh) que se puede almacenar actualmente en la batería |
|
internalTemp
|
storageData.batteries.telemetries.internalTemp | integer |
Temperatura interna de la batería en Celsius |
|
ACGridCharging
|
storageData.batteries.telemetries.ACGridCharging | integer |
Cantidad de energía de CA utilizada para cargar la batería desde la cuadrícula dentro de un intervalo de fechas especificado en Wh |
|
stateOfCharge
|
storageData.batteries.telemetries.stateOfCharge | integer |
el estado de carga de la batería como porcentaje de la capacidad disponible. Los valores están en el intervalo de 0 a 100 |
Información general del sitio
La respuesta incluye la energía actual del sitio, energía diaria, energía mensual, energía anual y energía del tiempo de vida.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
lastUpdateTime
|
overview.lastUpdateTime | string |
lastUpdateTime |
|
energy
|
overview.lifeTimeData.energy | float |
Número de energía de duración |
|
energy
|
overview.lastYearData.energy | float |
Número de energía del año pasado |
|
energy
|
overview.lastMonthData.energy | float |
Número de energía |
|
energy
|
overview.lastDayData.energy | float |
Número de energía del último día |
|
poder
|
overview.currentPower.power | float |
Número de energía actual |
|
measuredBy
|
overview.measuredBy | string |
Medida por |
Inventario de sitios
Devuelve el inventario de equipos SolarEdge en el sitio, incluyendo inversores/SMIs, baterías, medidores, puertas de enlace y sensores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Metros
|
Inventory.meters | array of object |
Lista de medidores para el sitio especificado |
|
nombre
|
Inventory.meters.name | string |
Nombre del medidor |
|
manufacturer
|
Inventory.meters.manufacturer | string |
Fabricante de medidores |
|
model
|
Inventory.meters.model | string |
Modelo de medidor |
|
firmwareVersion
|
Inventory.meters.firmwareVersion | string |
Meter firmwareVersion |
|
connectedSolaredgeDeviceSN
|
Inventory.meters.connectedSolaredgeDeviceSN | string |
– Nombre del dispositivo SolarEdge al que está conectado el medidor |
|
type
|
Inventory.meters.type | string |
Tipo de medidor, por ejemplo, "Producción" |
|
forma
|
Inventory.meters.form | string |
físico para un medidor HW o virtual si se calcula mediante aritmética entre otros medidores |
|
sensores
|
Inventory.sensors | array of object |
Lista de sensores para el sitio especificado |
|
connectedSolaredgeDeviceSN
|
Inventory.sensors.connectedSolaredgeDeviceSN | string |
– Nombre del dispositivo SolarEdge al que está conectado el sensor |
|
id
|
Inventory.sensors.id | string |
Id. del sensor |
|
connectedTo
|
Inventory.sensors.connectedTo | string |
nombre del dispositivo al que está conectado, por ejemplo, "Puerta de enlace 1" |
|
categoría
|
Inventory.sensors.category | string |
Categoría del sensor, por ejemplo, RADIANCE |
|
type
|
Inventory.sensors.type | string |
Tipo de sensor, por ejemplo, "Plano de radiación de matriz" |
|
gateways
|
Inventory.gateways | array of object |
Lista de puertas de enlace para el sitio especificado |
|
nombre
|
Inventory.gateways.name | string |
Nombre del inversor, por ejemplo, Inversor 1 |
|
firmwareVersion
|
Inventory.gateways.firmwareVersion | string |
El firmwareversion del equipo |
|
SN
|
Inventory.gateways.SN | string |
Número de serie del equipo, por ejemplo, 7F123456-00 |
|
Baterías
|
Inventory.batteries | array of object |
Lista de baterías para el sitio especificado |
|
nombre
|
Inventory.batteries.name | string |
El nombre de la batería |
|
manufacturer
|
Inventory.batteries.manufacturer | string |
El fabricante de la batería |
|
model
|
Inventory.batteries.model | string |
El modelo de batería |
|
firmwareVersion
|
Inventory.batteries.firmwareVersion | string |
FirmwareVersion de la batería |
|
connectedInverterSn
|
Inventory.batteries.connectedInverterSn | string |
– número de serie del inversor /puerta de enlace a la que está conectada la batería |
|
nameplateCapacity
|
Inventory.batteries.nameplateCapacity | integer |
capacidad de la placa de nombres de la batería según lo proporcionado por el fabricante. |
|
SN
|
Inventory.batteries.SN | string |
Número de serie de la batería |
|
Inversores
|
Inventory.inverters | array of object |
Lista de inversores para el sitio especificado |
|
nombre
|
Inventory.inverters.name | string |
Nombre del inversor |
|
manufacturer
|
Inventory.inverters.manufacturer | string |
El fabricante del inversor |
|
model
|
Inventory.inverters.model | string |
El modelo de inversor |
|
firmwareVersion
|
Inventory.inverters.firmwareVersion | string |
FirmwareVersion del inversor |
|
SN
|
Inventory.inverters.SN | string |
Número de serie del inversor |
|
connectedOptimizers
|
Inventory.inverters.connectedOptimizers | integer |
Número de optimizadores conectados al inversor |
Lista de componentes
Devolver una lista de inversores/SMIs en el sitio específico
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
count
|
reporters.count | integer |
Recuento de componentes de sitios |
|
list
|
reporters.list | array of object |
list |
|
componentname
|
reporters.list.componentname | string |
Nombre del componente |
|
manufacturer
|
reporters.list.manufacturer | string |
Fabricante del componente |
|
Modelo
|
reporters.list.Model | string |
El modelo de componentes |
|
Número de serie
|
reporters.list.SerialNumber | string |
El componente serialNumber |
Lista de sitios
Devuelve una lista de sitios relacionados con el token especificado, que es la cuenta api_key. Esta API acepta parámetros para una búsqueda, ordenación y paginación convenientes.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
count
|
sites.count | integer |
Cantidad de sitios que se devuelven. |
|
sitio web
|
sites.site | array of object |
sitio web |
|
SiteID
|
sites.site.id | integer |
Identificador del sitio. |
|
nombre
|
sites.site.name | string |
El nombre del sitio |
|
accountId
|
sites.site.accountId | integer |
La cuenta a la que pertenece este sitio |
|
estado
|
sites.site.status | string |
Estado del sitio |
|
peakPower
|
sites.site.peakPower | float |
Potencia máxima del sitio |
|
lastUpdateTime
|
sites.site.lastUpdateTime | string |
Fecha y hora de la última actualización del sitio, formato aaaa-mm-dd hh:mm:ss |
|
installationDate
|
sites.site.installationDate | string |
Fecha y hora de instalación del sitio, formato aaaa-mm-dd hh:mm:ss |
|
ptoDate
|
sites.site.ptoDate | string |
Permiso para operar la fecha |
|
notas
|
sites.site.notes | string |
Notas |
|
type
|
sites.site.type | string |
Tipo de sitio |
|
country
|
sites.site.location.country | string |
País de los sitios |
|
city
|
sites.site.location.city | string |
La ciudad de sitios |
|
address
|
sites.site.location.address | string |
La dirección de los sitios |
|
dirección2
|
sites.site.location.address2 | string |
La dirección de los sitios2 |
|
archivo comprimido
|
sites.site.location.zip | string |
El archivo ZIP de sitios |
|
timeZone
|
sites.site.location.timeZone | string |
La zona horaria de sitios |
|
countryCode
|
sites.site.location.countryCode | string |
Código de país de sitios |
|
manufacturerName
|
sites.site.primaryModule.manufacturerName | string |
ManufacturerName del modelo principal |
|
modelName
|
sites.site.primaryModule.modelName | string |
ModelName del modelo principal |
|
maximumPower
|
sites.site.primaryModule.maximumPower | float |
MaximumPower del modelo principal |
|
temperatureCoef
|
sites.site.primaryModule.temperatureCoef | float |
Temperatura del modelo principalCoef |
Obtener datos de medidores
Devuelve para cada medidor en el sitio su lectura de energía de duración, metadatos y el dispositivo al que está conectado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
Granularidad de agregación
|
timeUnit | string |
Granularidad de agregación, los valores permitidos son QUARTER_OF_AN_HOUR, HOUR, DAY, WEEK, MONTH, YEAR |
|
|
La hora de inicio medida por energía en formato aaaa-MM-DD hh:mm:ss
|
startTime | True | string |
La hora de inicio medida por energía en formato aaaa-MM-DD hh:mm:ss |
|
Tiempo de finalización medido de energía en formato aaaa-MM-DD hh:mm:ss
|
endTime | True | string |
Tiempo de finalización medido de energía en formato aaaa-MM-DD hh:mm:ss |
|
Seleccionar solo medidores específicos
|
meters | string |
Seleccione solo medidores específicos. Si se omite este valor, se devuelven todas las lecturas del medidor. Los valores permitidos son Production, Consumption, FeedIn, Purchased |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
timeUnit
|
meterEnergyDetails.timeUnit | string |
Granularidad de agregación |
|
unidad
|
meterEnergyDetails.unit | string |
Unidad de medidores devueltos (Wh) |
|
Metros
|
meterEnergyDetails.meters | array of object |
Valores por medidor |
|
meterSerialNumber
|
meterEnergyDetails.meters.meterSerialNumber | string |
meterSerialNumber |
|
connectedSolaredgeDeviceSN
|
meterEnergyDetails.meters.connectedSolaredgeDeviceSN | string |
Inversor al que está conectado el medidor |
|
model
|
meterEnergyDetails.meters.model | string |
Modelo de medidor |
|
meterType
|
meterEnergyDetails.meters.meterType | string |
Tipo de medidor Producción, Consumo, FeedIn o Comprado |
|
values
|
meterEnergyDetails.meters.values | array of object |
Valores por medidor por fecha |
|
date
|
meterEnergyDetails.meters.values.date | string |
Marca de tiempo de medición |
|
value
|
meterEnergyDetails.meters.values.value | float |
Lectura de energía de la vida útil |
Obtener lista de sensores
Devuelve una lista de todos los sensores del sitio y el dispositivo al que están conectados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
count
|
SiteSensors.count | integer |
Recuento de sensores de sitios |
|
list
|
SiteSensors.list | array of object |
Lista por puerta de enlace |
|
connectedTo
|
SiteSensors.list.connectedTo | string |
Nombre de la puerta de enlace a la que está conectado el sensor |
|
count
|
SiteSensors.list.count | integer |
Recuento de sensores de puertas de enlace |
|
sensores
|
SiteSensors.list.sensors | array of object |
sensores |
|
nombre
|
SiteSensors.list.sensors.name | string |
Nombre del sensor |
|
medición
|
SiteSensors.list.sensors.measurement | string |
Qué mide el sensor, por ejemplo, SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
|
type
|
SiteSensors.list.sensors.type | string |
qué mide el sensor, por ejemplo, SensorGlobalHorizontalIrradiance, SensorDiffusedIrradiance, SensorAmbientTemperature |
Registro de cambios de equipos
Devuelve una lista de reemplazos de componentes de equipo ordenados por fecha. Este método es aplicable a inversores, optimizadores, baterías y puertas de enlace.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
|
Número de serie del equipo
|
equipment_id | True | string |
Número de serie del equipo |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
count
|
ChangeLog.count | integer |
count |
|
serialNumber
|
ChangeLog.list.serialNumber | string |
Número de serie corto de equipo |
|
partNumber
|
ChangeLog.list.partNumber | string |
modelo inversor/batería/optimizador/puerta de enlace |
|
date
|
ChangeLog.list.date | string |
Fecha de sustitución de ese componente de equipo |
Ventajas del entorno del sitio
Devuelve todos los beneficios ambientales basados en la producción energética del sitio: emisiones de CO2 guardadas, árboles equivalentes plantados y bombillas encendidas durante un día.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador del sitio
|
site_id | True | integer |
Identificador del sitio |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
unidades
|
envBenefits.gasEmissionSaved.units | string |
unidades para el resto de los resultados |
|
co2
|
envBenefits.gasEmissionSaved.co2 | float |
Co2 en kg o lb |
|
so2
|
envBenefits.gasEmissionSaved.so2 | float |
So2 en kg o lb |
|
Nox
|
envBenefits.gasEmissionSaved.nox | float |
NOX en kg o lb |
|
árbolesPlanted
|
envBenefits.treesPlanted | float |
Plantación equivalente de árboles nuevos para reducir los niveles de CO2 |
|
Bombillas
|
envBenefits.lightBulbs | float |
número de bombillas que podrían haber sido alimentados por el sitio durante un día |