Resumen

Documentación de Kommodo SIPS API

Información de versión

Versión : 1

Esquema URI

Servidor : api.kommodo.com
Ruta base : /
Esquemas : HTTPS

Rutas

Obtener información sobre consumos de puntos de suministro

POST /sips/v1/buscar/consumos

Descripción

Obtiene información sobre consumos de puntos de suministro, usando filtros de manera opcional

Parámetros

Tipo Nombre Descripción Esquema

Body

body
obligatorio

Petición de búsqueda

PeticionBusqueda

Respuestas

Código HTTP Descripción Esquema

200

Resultados de la búsqueda. Contiene el campo "scrollId" para ser utilizado en la siguiente petición perteneciente a la búsqueda y así obtener los siguientes resultados de la misma

RespuestaBusquedaConsumos

401

No autorizado

Sin contenido

403

Prohibido

Sin contenido

422

No se pudo procesar la petición

ErrorApi

Consume

  • application/json

Produce

  • application/json

Ejemplo de solicitud HTTP

Solicitud body
{
  "limite" : 1,
  "filtros" : {
    "distribuidoras" : [ "EDP", "IBERDROLA" ],
    "tarifas" : [ "3.0A" ],
    "conImpagos" : false,
    "tiposOptimizacion" : [ "Optimizable" ],
    "ahorroOptimizacion" : {
      "desde" : 1,
      "hasta" : 5000
    },
    "conPenalizacionExcesosReactiva" : false,
    "energiaActivaEnMWh" : {
      "desde" : 0.01,
      "hasta" : 10
    },
    "energiaActivaPorPeriodoEnMWhOPorcentaje" : {
      "rangoConPeriodo" : {
        "rango" : {
          "desde" : 20,
          "hasta" : 25
        },
        "periodo" : 1
      },
      "unidad" : "Porcentaje"
    },
    "potenciaContratadaPorPeriodoEnkW" : {
      "rango" : {
        "desde" : 10,
        "hasta" : 500
      },
      "periodo" : 1
    },
    "potenciaMaximaPorPeriodoEnkW" : {
      "rango" : {
        "desde" : 1,
        "hasta" : 5000
      },
      "periodo" : 1
    },
    "fechaFinContrato" : {
      "desde" : "2015-09-12",
      "hasta" : "2016-11-14"
    }
  }
}

Ejemplo de respuesta HTTP

Respuesta 200
{
  "total" : 167,
  "scrollId" : "cXVlcnlUaGVuRmV0Y2g7Njs2MjA2OTc5OjhiRXdVWVV1VFJDeHg2NE84OUVIX3c7NjIwNjk4MDo4YkV3VVlVdVRSQ3h4NjRPODlFSF93OzYyMDY5ODE6OGJFd1VZVXVUUkN4eDY0Tzg5RUhfdzs2MTA2NzE3OlBDNlVNRVhIUmxTaWZxeEFISDNseEE7Njk4MjM1OTplRU10TERraFJJRzBHZ3g1ZktfNWZBOzY5ODIzNjA6ZUVNdExEa2hSSUcwR2d4NWZLXzVmQTswOw==",
  "consumosRaw" : [ {
    "cups" : "ES0026000025137313FT0F",
    "fechaInicioMesConsumo" : "2016-04-06",
    "fechaFinMesConsumo" : "2016-05-05",
    "codigoTarifaATR" : "3.0A",
    "consumoEnergiaActivaEnWh" : {
      "consumoEnergiaActivaEnWhP1" : 785,
      "consumoEnergiaActivaEnWhP2" : 1540,
      "consumoEnergiaActivaEnWhP3" : 385,
      "consumoEnergiaActivaEnWhP4" : 0,
      "consumoEnergiaActivaEnWhP5" : 0,
      "consumoEnergiaActivaEnWhP6" : 0
    },
    "consumoEnergiaReactivaEnVArh" : {
      "consumoEnergiaReactivaEnVArhP1" : 93,
      "consumoEnergiaReactivaEnVArhP2" : 229,
      "consumoEnergiaReactivaEnVArhP3" : 127,
      "consumoEnergiaReactivaEnVArhP4" : 28,
      "consumoEnergiaReactivaEnVArhP5" : 78,
      "consumoEnergiaReactivaEnVArhP6" : 45
    },
    "potenciaDemandadaEnW" : {
      "potenciaDemandadaEnWP1" : 10,
      "potenciaDemandadaEnWP2" : 10,
      "potenciaDemandadaEnWP3" : 7,
      "potenciaDemandadaEnWP4" : 9,
      "potenciaDemandadaEnWP5" : 9,
      "potenciaDemandadaEnWP6" : 7
    }
  }, {
    "cups" : "ES0026000025137313FT0F",
    "fechaInicioMesConsumo" : "2016-05-06",
    "fechaFinMesConsumo" : "2016-06-03",
    "codigoTarifaATR" : "3.0A",
    "consumoEnergiaActivaEnWh" : {
      "consumoEnergiaActivaEnWhP1" : 751,
      "consumoEnergiaActivaEnWhP2" : 1598,
      "consumoEnergiaActivaEnWhP3" : 460,
      "consumoEnergiaActivaEnWhP4" : 0,
      "consumoEnergiaActivaEnWhP5" : 0,
      "consumoEnergiaActivaEnWhP6" : 0
    },
    "consumoEnergiaReactivaEnVArh" : {
      "consumoEnergiaReactivaEnVArhP1" : 99,
      "consumoEnergiaReactivaEnVArhP2" : 269,
      "consumoEnergiaReactivaEnVArhP3" : 150,
      "consumoEnergiaReactivaEnVArhP4" : 36,
      "consumoEnergiaReactivaEnVArhP5" : 99,
      "consumoEnergiaReactivaEnVArhP6" : 57
    },
    "potenciaDemandadaEnW" : {
      "potenciaDemandadaEnWP1" : 10,
      "potenciaDemandadaEnWP2" : 10,
      "potenciaDemandadaEnWP3" : 8,
      "potenciaDemandadaEnWP4" : 9,
      "potenciaDemandadaEnWP5" : 9,
      "potenciaDemandadaEnWP6" : 7
    }
  } ],
  "consumosMensualizados" : [ {
    "cups" : "ES0026000025137313FT0F",
    "ultimoMovimientoContratacion" : "2016-03-08",
    "perfilConsumo" : "D",
    "potenciasContratadasEnkW" : {
      "potenciaContratadaEnkWP1" : 18,
      "potenciaContratadaEnkWP2" : 18,
      "potenciaContratadaEnkWP3" : 18,
      "potenciaContratadaEnkWP4" : 0,
      "potenciaContratadaEnkWP5" : 0,
      "potenciaContratadaEnkWP6" : 0
    },
    "consumos" : [ {
      "anio" : 2016,
      "mes" : 5,
      "potenciasMaximasMesEnkW" : {
        "potenciaMaximaMesEnkWP1" : 10,
        "potenciaMaximaMesEnkWP2" : 10,
        "potenciaMaximaMesEnkWP3" : 8,
        "potenciaMaximaMesEnkWP4" : 0,
        "potenciaMaximaMesEnkWP5" : 0,
        "potenciaMaximaMesEnkWP6" : 0
      },
      "potenciasMaximasInteranualesEnkW" : {
        "potenciaMaximaInteranualEnkWP1" : 29,
        "potenciaMaximaInteranualEnkWP2" : 29,
        "potenciaMaximaInteranualEnkWP3" : 22,
        "potenciaMaximaInteranualEnkWP4" : 0,
        "potenciaMaximaInteranualEnkWP5" : 0,
        "potenciaMaximaInteranualEnkWP6" : 0
      },
      "potenciasMaximasAnioEnkW" : {
        "potenciaMaximaAnioEnkWP1" : 10,
        "potenciaMaximaAnioEnkWP2" : 10,
        "potenciaMaximaAnioEnkWP3" : 8,
        "potenciaMaximaAnioEnkWP4" : 0,
        "potenciaMaximaAnioEnkWP5" : 0,
        "potenciaMaximaAnioEnkWP6" : 0
      },
      "energiasActivasMesEnkWh" : {
        "energiaActivaMesEnkWhP1" : 806,
        "energiaActivaMesEnkWhP2" : 1692,
        "energiaActivaMesEnkWhP3" : 477,
        "energiaActivaMesEnkWhP4" : 0,
        "energiaActivaMesEnkWhP5" : 0,
        "energiaActivaMesEnkWhP6" : 0
      },
      "energiasActivasInteranualEnkWh" : {
        "energiaActivaInteranualEnkWhP1" : 1996,
        "energiaActivaInteranualEnkWhP2" : 4512,
        "energiaActivaInteranualEnkWhP3" : 1115,
        "energiaActivaInteranualEnkWhP4" : 0,
        "energiaActivaInteranualEnkWhP5" : 0,
        "energiaActivaInteranualEnkWhP6" : 0
      },
      "energiasActivasInteranualEnPorcentaje" : {
        "energiaActivaInteranualEnPorcentajeP1" : 26,
        "energiaActivaInteranualEnPorcentajeP2" : 59,
        "energiaActivaInteranualEnPorcentajeP3" : 15,
        "energiaActivaInteranualEnPorcentajeP4" : 0,
        "energiaActivaInteranualEnPorcentajeP5" : 0,
        "energiaActivaInteranualEnPorcentajeP6" : 0
      },
      "energiasActivasAcumuladoEnkWh" : {
        "energiaActivaAcumuladoEnkWhP1" : 3063,
        "energiaActivaAcumuladoEnkWhP2" : 6655,
        "energiaActivaAcumuladoEnkWhP3" : 1786,
        "energiaActivaAcumuladoEnkWhP4" : 0,
        "energiaActivaAcumuladoEnkWhP5" : 0,
        "energiaActivaAcumuladoEnkWhP6" : 0
      },
      "energiasReactivasMesEnkVArh" : {
        "energiaReactivaMesEnkVArhP1" : 141,
        "energiaReactivaMesEnkVArhP2" : 382,
        "energiaReactivaMesEnkVArhP3" : 214,
        "energiaReactivaMesEnkVArhP4" : 0,
        "energiaReactivaMesEnkVArhP5" : 0,
        "energiaReactivaMesEnkVArhP6" : 0
      },
      "energiasReactivasInteranualEnkVArh" : {
        "energiaReactivaInteranualEnkVArhP1" : 326,
        "energiaReactivaInteranualEnkVArhP2" : 896,
        "energiaReactivaInteranualEnkVArhP3" : 497,
        "energiaReactivaInteranualEnkVArhP4" : 0,
        "energiaReactivaInteranualEnkVArhP5" : 0,
        "energiaReactivaInteranualEnkVArhP6" : 0
      },
      "energiasReactivasAcumuladoEnkVArh" : {
        "energiaReactivaAcumuladoEnkVArhP1" : 3063,
        "energiaReactivaAcumuladoEnkVArhP2" : 6655,
        "energiaReactivaAcumuladoEnkVArhP3" : 1786,
        "energiaReactivaAcumuladoEnkVArhP4" : 0,
        "energiaReactivaAcumuladoEnkVArhP5" : 0,
        "energiaReactivaAcumuladoEnkVArhP6" : 0
      }
    }, {
      "anio" : 2016,
      "mes" : 6,
      "potenciasMaximasMesEnkW" : {
        "potenciaMaximaMesEnkWP1" : 10,
        "potenciaMaximaMesEnkWP2" : 10,
        "potenciaMaximaMesEnkWP3" : 8,
        "potenciaMaximaMesEnkWP4" : 0,
        "potenciaMaximaMesEnkWP5" : 0,
        "potenciaMaximaMesEnkWP6" : 0
      },
      "potenciasMaximasInteranualesEnkW" : {
        "potenciaMaximaInteranualEnkWP1" : 39,
        "potenciaMaximaInteranualEnkWP2" : 39,
        "potenciaMaximaInteranualEnkWP3" : 30,
        "potenciaMaximaInteranualEnkWP4" : 0,
        "potenciaMaximaInteranualEnkWP5" : 0,
        "potenciaMaximaInteranualEnkWP6" : 0
      },
      "potenciasMaximasAnioEnkW" : {
        "potenciaMaximaAnioEnkWP1" : 10,
        "potenciaMaximaAnioEnkWP2" : 10,
        "potenciaMaximaAnioEnkWP3" : 8,
        "potenciaMaximaAnioEnkWP4" : 0,
        "potenciaMaximaAnioEnkWP5" : 0,
        "potenciaMaximaAnioEnkWP6" : 0
      },
      "energiasActivasMesEnkWh" : {
        "energiaActivaMesEnkWhP1" : 882,
        "energiaActivaMesEnkWhP2" : 1773,
        "energiaActivaMesEnkWhP3" : 555,
        "energiaActivaMesEnkWhP4" : 0,
        "energiaActivaMesEnkWhP5" : 0,
        "energiaActivaMesEnkWhP6" : 0
      },
      "energiasActivasInteranualEnkWh" : {
        "energiaActivaInteranualEnkWhP1" : 2878,
        "energiaActivaInteranualEnkWhP2" : 6285,
        "energiaActivaInteranualEnkWhP3" : 1669,
        "energiaActivaInteranualEnkWhP4" : 0,
        "energiaActivaInteranualEnkWhP5" : 0,
        "energiaActivaInteranualEnkWhP6" : 0
      },
      "energiasActivasInteranualEnPorcentaje" : {
        "energiaActivaInteranualEnPorcentajeP1" : 27,
        "energiaActivaInteranualEnPorcentajeP2" : 58,
        "energiaActivaInteranualEnPorcentajeP3" : 15,
        "energiaActivaInteranualEnPorcentajeP4" : 0,
        "energiaActivaInteranualEnPorcentajeP5" : 0,
        "energiaActivaInteranualEnPorcentajeP6" : 0
      },
      "energiasActivasAcumuladoEnkWh" : {
        "energiaActivaAcumuladoEnkWhP1" : 3063,
        "energiaActivaAcumuladoEnkWhP2" : 6655,
        "energiaActivaAcumuladoEnkWhP3" : 1786,
        "energiaActivaAcumuladoEnkWhP4" : 0,
        "energiaActivaAcumuladoEnkWhP5" : 0,
        "energiaActivaAcumuladoEnkWhP6" : 0
      },
      "energiasReactivasMesEnkVArh" : {
        "energiaReactivaMesEnkVArhP1" : 159,
        "energiaReactivaMesEnkVArhP2" : 396,
        "energiaReactivaMesEnkVArhP3" : 220,
        "energiaReactivaMesEnkVArhP4" : 0,
        "energiaReactivaMesEnkVArhP5" : 0,
        "energiaReactivaMesEnkVArhP6" : 0
      },
      "energiasReactivasInteranualEnkVArh" : {
        "energiaReactivaInteranualEnkVArhP1" : 485,
        "energiaReactivaInteranualEnkVArhP2" : 1292,
        "energiaReactivaInteranualEnkVArhP3" : 717,
        "energiaReactivaInteranualEnkVArhP4" : 0,
        "energiaReactivaInteranualEnkVArhP5" : 0,
        "energiaReactivaInteranualEnkVArhP6" : 0
      },
      "energiasReactivasAcumuladoEnkVArh" : {
        "energiaReactivaAcumuladoEnkVArhP1" : 3063,
        "energiaReactivaAcumuladoEnkVArhP2" : 6655,
        "energiaReactivaAcumuladoEnkVArhP3" : 1786,
        "energiaReactivaAcumuladoEnkVArhP4" : 0,
        "energiaReactivaAcumuladoEnkVArhP5" : 0,
        "energiaReactivaAcumuladoEnkVArhP6" : 0
      }
    } ]
  } ],
  "optimizacionesPotencia" : [ {
    "cups" : "ES0026000025137313FT0F",
    "estadoCups" : "Optimizable",
    "periodoAnalizado" : {
      "periodoAnalizadoFechaIni" : "2016-03-08",
      "periodoAnalizadoFechaFin" : "2016-07-06"
    },
    "potenciasOptimizadas" : {
      "potenciaOptimizadaP1" : 21,
      "potenciaOptimizadaP2" : 20,
      "potenciaOptimizadaP3" : 15,
      "potenciaOptimizadaP4" : 0,
      "potenciaOptimizadaP5" : 0,
      "potenciaOptimizadaP6" : 0
    },
    "costeEstimadoEnPeriodoOptimizado" : 468.98,
    "ahorroEstimadoEnPeriodoConOptimizacion" : -34.67,
    "costesEstimadosDeAcometida" : 130.73,
    "observaciones" : {
      "potenciaSimuladaExcedeMaxDisponible" : false
    }
  } ],
  "excesosReactiva" : [ {
    "cups" : "ES0026000025137313FT0F",
    "periodoAnalizado" : {
      "periodoAnalizadoFechaIni" : "2016-03-08",
      "periodoAnalizadoFechaFin" : "2016-07-06"
    },
    "penalizaciones" : {
      "penalizacionP1" : 8.35,
      "penalizacionP2" : 23.81,
      "penalizacionP3" : 0,
      "penalizacionP4" : 0,
      "penalizacionP5" : 0,
      "penalizacionP6" : 0
    }
  } ]
}

Obtener información estructural de puntos de suministro

POST /sips/v1/buscar/puntosSuministro

Descripción

Obtiene información estructural de puntos de suministro, usando filtros de manera opcional

Parámetros

Tipo Nombre Descripción Esquema

Body

body
obligatorio

Petición de búsqueda

PeticionBusqueda

Respuestas

Código HTTP Descripción Esquema

200

Resultados de la búsqueda. Contiene el campo "scrollId" para ser utilizado en la siguiente petición perteneciente a la búsqueda y así obtener los siguientes resultados de la misma

< RespuestaBusquedaPuntosSuministro > array

401

No autorizado

Sin contenido

403

Prohibido

Sin contenido

422

No se pudo procesar la petición

ErrorApi

Consume

  • application/json

Produce

  • application/json

Ejemplo de solicitud HTTP

Solicitud body
{
  "limite" : 1,
  "filtros" : {
    "distribuidoras" : [ "EDP", "IBERDROLA" ],
    "tarifas" : [ "3.0A" ],
    "conImpagos" : false,
    "tiposOptimizacion" : [ "Optimizable" ],
    "ahorroOptimizacion" : {
      "desde" : 1,
      "hasta" : 5000
    },
    "conPenalizacionExcesosReactiva" : false,
    "energiaActivaEnMWh" : {
      "desde" : 0.01,
      "hasta" : 10
    },
    "energiaActivaPorPeriodoEnMWhOPorcentaje" : {
      "rangoConPeriodo" : {
        "rango" : {
          "desde" : 20,
          "hasta" : 25
        },
        "periodo" : 1
      },
      "unidad" : "Porcentaje"
    },
    "potenciaContratadaPorPeriodoEnkW" : {
      "rango" : {
        "desde" : 10,
        "hasta" : 500
      },
      "periodo" : 1
    },
    "potenciaMaximaPorPeriodoEnkW" : {
      "rango" : {
        "desde" : 1,
        "hasta" : 5000
      },
      "periodo" : 1
    },
    "fechaFinContrato" : {
      "desde" : "2015-09-12",
      "hasta" : "2016-11-14"
    }
  }
}

Ejemplo de respuesta HTTP

Respuesta 200
{
  "total" : 167,
  "scrollId" : "cXVlcnlUaGVuRmV0Y2g7Njs2MjA2OTc5OjhiRXdVWVV1VFJDeHg2NE84OUVIX3c7NjIwNjk4MDo4YkV3VVlVdVRSQ3h4NjRPODlFSF93OzYyMDY5ODE6OGJFd1VZVXVUUkN4eDY0Tzg5RUhfdzs2MTA2NzE3OlBDNlVNRVhIUmxTaWZxeEFISDNseEE7Njk4MjM1OTplRU10TERraFJJRzBHZ3g1ZktfNWZBOzY5ODIzNjA6ZUVNdExEa2hSSUcwR2d4NWZLXzVmQTswOw==",
  "puntosSuministro" : [ {
    "codigoEmpresaDistribuidora" : "R1-001",
    "cups" : "ES0026000025137313FT0F",
    "nombreEmpresaDistribuidora" : "IBERDROLA DISTRIBUCION ELECTRICA, S.A.",
    "codigoREEComercializadora" : "0927",
    "descripcionComercializadora" : "IBERDROLA CLIENTES, S. A",
    "direccionSuministro" : {
      "codigoPostalPS" : "01240",
      "municipioPS" : "01001",
      "codigoProvinciaPS" : "01"
    },
    "fechaAltaSuministro" : "",
    "codigoTarifaATREnVigor" : "001",
    "tarifaATREnVigor" : "2.0A",
    "codigoTensionV" : "09",
    "tensionV" : "2X220",
    "informacionBIE" : {
      "potenciaMaximaBIEW" : 3
    },
    "informacionAPM" : {
      "potenciaMaximaAPMW" : 0
    },
    "codigoClasificacionPS" : "05",
    "clasificacionPS" : "Punto de medida tipo 5",
    "codigoDisponibilidadICP" : "1",
    "tipoPerfilConsumo" : "Pa",
    "valorDerechosExtensionW" : 3,
    "valorDerechosAccesoW" : 3,
    "codigoPropiedadEquipoMedida" : "1",
    "propiedadEquipoMedida" : "Distribuidor",
    "codigoPropiedadICP" : "1",
    "propiedadICP" : "Distribuidor",
    "potenciasContratadasEnW" : {
      "potenciaContratadaEnWP1" : 3300,
      "potenciaContratadaEnWP2" : 0,
      "potenciaContratadaEnWP3" : 0,
      "potenciaContratadaEnWP4" : 0,
      "potenciaContratadaEnWP5" : 0,
      "potenciaContratadaEnWP6" : 0
    },
    "fechaUltimoMovimientoContrato" : "2012-03-12",
    "fechaUltimoCambioComercializador" : "2012-03-12",
    "fechaLimiteDerechosReconocidos" : "",
    "fechaUltimaLectura" : "2018-02-28",
    "informacionImpagos" : "Sin impagos",
    "importeDepositoGarantiaEuros" : 0,
    "tipoIdTitular" : "NIF",
    "esViviendaHabitual" : "0",
    "codigoComercializadora" : "",
    "codigoTelegestion" : "01",
    "telegestion" : "Telegestión operativa con Curva de Carga Horaria",
    "codigoFasesEquipoMedida" : "M",
    "codigoAutoconsumo" : "00",
    "cnae" : "9820",
    "codigoModoControlPotencia" : "1",
    "codigoPSContratable" : "1",
    "aplicacionBonoSocial" : "1"
  } ]
}

Definiciones

ConsumoEnergiaActivaEnWh

Contiene el consumo de energía activa que registre en origen el equipo de medida para cada periodo, en Wh y sin decimales.

Nombre Descripción Esquema

consumoEnergiaActivaEnWhP1
obligatorio

Consumo de energía activa en Wh para el periodo de discriminación 1.

number (int32)

consumoEnergiaActivaEnWhP2
obligatorio

Consumo de energía activa en Wh para el periodo de discriminación 2.

number (int32)

consumoEnergiaActivaEnWhP3
obligatorio

Consumo de energía activa en Wh para el periodo de discriminación 3.

number (int32)

consumoEnergiaActivaEnWhP4
obligatorio

Consumo de energía activa en Wh para el periodo de discriminación 4.

number (int32)

consumoEnergiaActivaEnWhP5
obligatorio

Consumo de energía activa en Wh para el periodo de discriminación 5.

number (int32)

consumoEnergiaActivaEnWhP6
obligatorio

Consumo de energía activa en Wh para el periodo de discriminación 6.

number (int32)

ConsumoEnergiaReactivaEnVArh

Contiene el consumo de energía reactiva que registre en origen el equipo de medida para cada periodo, en voltio-amperio reactivo hora y sin decimales.

Nombre Descripción Esquema

consumoEnergiaReactivaEnVArhP1
obligatorio

Consumo de energía reactiva en voltio-amperio reactivo hora para el periodo de discriminación 1.

number (int32)

consumoEnergiaReactivaEnVArhP2
obligatorio

Consumo de energía reactiva en voltio-amperio reactivo hora para el periodo de discriminación 2.

number (int32)

consumoEnergiaReactivaEnVArhP3
obligatorio

Consumo de energía reactiva en voltio-amperio reactivo hora para el periodo de discriminación 3.

number (int32)

consumoEnergiaReactivaEnVArhP4
obligatorio

Consumo de energía reactiva en voltio-amperio reactivo hora para el periodo de discriminación 4.

number (int32)

consumoEnergiaReactivaEnVArhP5
obligatorio

Consumo de energía reactiva en voltio-amperio reactivo hora para el periodo de discriminación 5.

number (int32)

consumoEnergiaReactivaEnVArhP6
obligatorio

Consumo de energía reactiva en voltio-amperio reactivo hora para el periodo de discriminación 6.

number (int32)

ConsumoMensualizado

Información sobre los consumos mensualizados de un punto de suministro en un mes y año concreto.

Nombre Descripción Esquema

anio
obligatorio

Año

string (AAAA)

energiasActivasAcumuladoEnkWh
obligatorio

Consumo de energía activa anual acumulada para cada periodo, en kilovatios-hora sin decimales.

EnergiasActivasAcumuladoEnkWh

energiasActivasInteranualEnkWh
obligatorio

Consumo de energía activa interanual acumulada para cada periodo, en kilovatios-hora sin decimales.

EnergiasActivasInteranualEnkWh

energiasActivasMesEnkWh
obligatorio

Consumo de energía activa mensual para cada periodo, en kilovatios-hora sin decimales.

EnergiasActivasMesEnkWh

energiasReactivasAcumuladoEnkVArh
obligatorio

Consumo de energía reactiva anual acumulada para cada periodo, en kilo voltio-amperio reactivo hora sin decimales.

EnergiasReactivasAcumuladoEnkVArh

energiasReactivasInteranualEnkVArh
obligatorio

Consumo de energía reactiva interanual acumulada para cada periodo, en kilo voltio-amperio reactivo hora sin decimales.

EnergiasReactivasInteranualEnkVArh

energiasReactivasMesEnkVArh
obligatorio

Consumo de energía reactiva mensual para cada periodo, en kilo voltio-amperio reactivo hora sin decimales.

EnergiasReactivasMesEnkVArh

mes
obligatorio

Mes

string (MM)

potenciasMaximasAnioEnkW
obligatorio

Consumo de potencia máxima anual para cada periodo, en kilovatios sin decimales.

PotenciasMaximasAnioEnkW

potenciasMaximasInteranualesEnkW
obligatorio

Consumo de potencia máxima internanual para cada periodo, en kilovatios sin decimales.

PotenciasMaximasInteranualesEnkW

potenciasMaximasMesEnkW
obligatorio

Consumo de potencia máxima mensual para cada periodo, en kilovatios sin decimales.

PotenciasMaximasMesEnkW

ConsumoRaw

Información sobre el consumo en bruto de un punto de suministro.

Nombre Descripción Esquema

codigoDHEquipoDeMedida
opcional

Información de la discriminación horaria del equipo de medida. CNMC - Tabla 35.

string

codigoTarifaATR
obligatorio

Código de la tarifa de acceso vigente en el mes (o periodo bimestral) para el que se está informando el consumo. CNMC - Tabla 17

string

codigoTipoLectura
opcional

Información sobre la procedencia de la lectura.. CNMC - Tabla 44.

string

consumoEnergiaActivaEnWh
obligatorio

Contiene el consumo de energía activa registre en origen el equipo de medida para cada periodo, en Wh y sin decimales.

ConsumoEnergiaActivaEnWh

consumoEnergiaReactivaEnVArh
obligatorio

Consumo de energía reactiva en origen el equipo de medida para cada periodo, en voltio-amperio reactivo hora sin decimales.

ConsumoEnergiaReactivaEnVArh

cups
obligatorio

Código CUPS del Punto de Suministro

string

fechaFinMesConsumo
obligatorio

Fecha fin del periodo mensual de consumo (criterio fecha incluida). Para aquellos puntos de suministro con lectura bimestral, este campo informará el fin de periodo bimestral (con criterio fecha incluida).

string (AAAA-MM-DD)

fechaInicioMesConsumo
obligatorio

Fecha inicio del periodo mensual de consumo (criterio fecha excluida - el consumo de la fecha informada en este campo no está incluido en el periodo). Para aquellos puntos de suministro con lectura bimestral, este campo informará el inicio de periodo bimestral (con criterio fecha excluida).

string (AAAA-MM-DD)

potenciaDemandadaEnW
obligatorio

Contiene la potencia demandada en origen el equipo de medida para cada periodo, en vatios sin decimales.

PotenciasDemandadasEnW

ConsumosMensualizados

Información sobre los consumos mensualizados de un punto de suministro.

Nombre Descripción Esquema

consumos
obligatorio

Información sobre los consumos mensualizados de un punto de suministro en un mes y año concreto.

< ConsumoMensualizado > array

cups
obligatorio

Código CUPS del Punto de Suministro

string

perfilConsumo
obligatorio

Perfil de consumo de REE. Se informará según los siguientes valores: "Pa" - Tipo perfil a, "Pb" - Tipo perfil b, "Pc" - Tipo perfil c, "Pd" - Tipo perfil d. (Vacío si no disponible)

string

potenciasContratadasEnkW
obligatorio

Potencia contratada para cada periodo de discriminación horaria en kilovatios y sin decimales.

PotenciasContratadasEnkW

ultimoMovimientoContratacion
obligatorio

Fecha del último movimiento de contratación.

string (AAAA-MM-DD)

DireccionSuministro

Información sobre la localización del punto de suministro.

Nombre Descripción Esquema

codigoPostalPS
obligatorio

Codigo postal

string

codigoProvinciaPS
obligatorio

Código INE de la provincia

string

municipioPS
obligatorio

Código INE del municipio (Vacío si no disponible)

string

EnergiasActivasAcumuladoEnkWh

Consumo de energía activa anual acumulada para cada periodo, en kilovatios-hora sin decimales.

Nombre Descripción Esquema

energiaActivaAcumuladoEnkWhP1
obligatorio

Consumo de energía activa anual acumulada en kilovatios-hora para el periodo de discriminación 1.

number (int32)

energiaActivaAcumuladoEnkWhP2
obligatorio

Consumo de energía activa anual acumulada en kilovatios-hora para el periodo de discriminación 2.

number (int32)

energiaActivaAcumuladoEnkWhP3
obligatorio

Consumo de energía activa anual acumulada en kilovatios-hora para el periodo de discriminación 3.

number (int32)

energiaActivaAcumuladoEnkWhP4
obligatorio

Consumo de energía activa anual acumulada en kilovatios-hora para el periodo de discriminación 4.

number (int32)

energiaActivaAcumuladoEnkWhP5
obligatorio

Consumo de energía activa anual acumulada en kilovatios-hora para el periodo de discriminación 5.

number (int32)

energiaActivaAcumuladoEnkWhP6
obligatorio

Consumo de energía activa anual acumulada en kilovatios-hora para el periodo de discriminación 6.

number (int32)

EnergiasActivasInteranualEnkWh

Consumo de energía activa interanual acumulada para cada periodo, en kilovatios-hora sin decimales.

Nombre Descripción Esquema

energiaActivaInteranualEnkWhP1
obligatorio

Consumo de energía activa interanual acumulada en kilovatios-hora para el periodo de discriminación 1.

number (int32)

energiaActivaInteranualEnkWhP2
obligatorio

Consumo de energía activa interanual acumulada en kilovatios-hora para el periodo de discriminación 2.

number (int32)

energiaActivaInteranualEnkWhP3
obligatorio

Consumo de energía activa interanual acumulada en kilovatios-hora para el periodo de discriminación 3.

number (int32)

energiaActivaInteranualEnkWhP4
obligatorio

Consumo de energía activa interanual acumulada en kilovatios-hora para el periodo de discriminación 4.

number (int32)

energiaActivaInteranualEnkWhP5
obligatorio

Consumo de energía activa interanual acumulada en kilovatios-hora para el periodo de discriminación 5.

number (int32)

energiaActivaInteranualEnkWhP6
obligatorio

Consumo de energía activa interanual acumulada en kilovatios-hora para el periodo de discriminación 6.

number (int32)

EnergiasActivasMesEnkWh

Consumo de energía activa mensual para cada periodo, en kilovatios-hora sin decimales.

Nombre Descripción Esquema

energiaActivaMesEnkWhP1
obligatorio

Consumo de energía activa mensual en kilovatios-hora para el periodo de discriminación 1.

number (int32)

energiaActivaMesEnkWhP2
obligatorio

Consumo de energía activa mensual en kilovatios-hora para el periodo de discriminación 2.

number (int32)

energiaActivaMesEnkWhP3
obligatorio

Consumo de energía activa mensual en kilovatios-hora para el periodo de discriminación 3.

number (int32)

energiaActivaMesEnkWhP4
obligatorio

Consumo de energía activa mensual en kilovatios-hora para el periodo de discriminación 4.

number (int32)

energiaActivaMesEnkWhP5
obligatorio

Consumo de energía activa mensual en kilovatios-hora para el periodo de discriminación 5.

number (int32)

energiaActivaMesEnkWhP6
obligatorio

Consumo de energía activa mensual en kilovatios-hora para el periodo de discriminación 6.

number (int32)

EnergiasReactivasAcumuladoEnkVArh

Consumo de energía reactiva anual acumulada para cada periodo, en kilo voltio-amperio reactivo hora sin decimales.

Nombre Descripción Esquema

energiaReactivaAcumuladoEnkVArhP1
obligatorio

Consumo de energía reactiva anual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 1.

number (int32)

energiaReactivaAcumuladoEnkVArhP2
obligatorio

Consumo de energía reactiva anual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 2.

number (int32)

energiaReactivaAcumuladoEnkVArhP3
obligatorio

Consumo de energía reactiva anual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 3.

number (int32)

energiaReactivaAcumuladoEnkVArhP4
obligatorio

Consumo de energía reactiva anual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 4.

number (int32)

energiaReactivaAcumuladoEnkVArhP5
obligatorio

Consumo de energía reactiva anual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 5.

number (int32)

energiaReactivaAcumuladoEnkVArhP6
obligatorio

Consumo de energía reactiva anual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 6.

number (int32)

EnergiasReactivasInteranualEnkVArh

Consumo de energía reactiva interanual acumulada para cada periodo, en kilo voltio-amperio reactivo hora sin decimales.

Nombre Descripción Esquema

energiaReactivaInteranualEnkVArhP1
obligatorio

Consumo de energía reactiva interanual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 1.

number (int32)

energiaReactivaInteranualEnkVArhP2
obligatorio

Consumo de energía reactiva interanual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 2.

number (int32)

energiaReactivaInteranualEnkVArhP3
obligatorio

Consumo de energía reactiva interanual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 3.

number (int32)

energiaReactivaInteranualEnkVArhP4
obligatorio

Consumo de energía reactiva interanual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 4.

number (int32)

energiaReactivaInteranualEnkVArhP5
obligatorio

Consumo de energía reactiva interanual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 5.

number (int32)

energiaReactivaInteranualEnkVArhP6
obligatorio

Consumo de energía reactiva interanual acumulada en kilo voltio-amperio reactivo hora para el periodo de discriminación 6.

number (int32)

EnergiasReactivasMesEnkVArh

Consumo de energía reactiva mensual para cada periodo, en kilo voltio-amperio reactivo hora sin decimales.

Nombre Descripción Esquema

energiaReactivaMesEnkVArhP1
obligatorio

Consumo de energía reactiva mensual en kilo voltio-amperio reactivo hora para el periodo de discriminación 1.

number (int32)

energiaReactivaMesEnkVArhP2
obligatorio

Consumo de energía reactiva mensual en kilo voltio-amperio reactivo hora para el periodo de discriminación 2.

number (int32)

energiaReactivaMesEnkVArhP3
obligatorio

Consumo de energía reactiva mensual en kilo voltio-amperio reactivo hora para el periodo de discriminación 3.

number (int32)

energiaReactivaMesEnkVArhP4
obligatorio

Consumo de energía reactiva mensual en kilo voltio-amperio reactivo hora para el periodo de discriminación 4.

number (int32)

energiaReactivaMesEnkVArhP5
obligatorio

Consumo de energía reactiva mensual en kilo voltio-amperio reactivo hora para el periodo de discriminación 5.

number (int32)

energiaReactivaMesEnkVArhP6
obligatorio

Consumo de energía reactiva mensual en kilo voltio-amperio reactivo hora para el periodo de discriminación 6.

number (int32)

ErrorApi

Contiene información acerca de un error ocurrido durante una petición al servidor

Nombre Descripción Esquema

codigo
obligatorio

Código de error. El significado de cada código es el siguiente: - "KSIPS-001": Búsqueda caducada. El intervalo máximo entre peticiones de una misma búsqueda es de 5 minutos. Cuando ocurra esto, será necesaria una nueva petición de búsqueda sin "scrollId" para reiniciar la búsqueda.

enum (KSIPS-001)

mensaje
obligatorio

Mensaje descriptivo acerca del error

string

ExcesosReactiva

Información sobre los consumos mensualizados de un punto de suministro.

Nombre Descripción Esquema

cups
obligatorio

Código CUPS del Punto de Suministro

string

penalizaciones
obligatorio

Penalizaciones calculadas en € con hasta dos decimales para cada periodo.

< PenalizacionesReactiva > array

periodoAnalizado
obligatorio

Periodo temporal sobre el que se ha realizado el análisis. Si el CUPS no se ha podido optimizar todos los campos vienen vacíos.

PeriodoAnalizado

FiltrosBusqueda

Filtros de la petición de búsqueda. Si un filtro admite varios valores, actúa como una disyunción (OR). Si se indican varios filtros a la vez, actúa como una conjunción (AND).

Nombre Descripción Esquema

ahorroOptimizacion
opcional

Rango de ahorro (en €) tras optimización

Rango

codigosPostales
opcional

Lista de códigos postales

< string > array

conImpagos
opcional

Impagos

boolean

conPenalizacionExcesosReactiva
opcional

Penalización por reactiva

boolean

distribuidoras
opcional

Lista de nombres de distribuidoras y/o marcas

< enum (EDP, IBERDROLA, UNIONFENOSA, VIESGO, ENDESA, SEVILLANA, FECSA, UNELCO, GESA, ERZ) > array

energiaActivaEnMWh
opcional

Rango de energía activa (en MW) sobre la agregación de todos los periodos

Rango

energiaActivaPorPeriodoEnMWhOPorcentaje
opcional

Rango de energía activa (en MW o porcentaje) considerando únicamente el periodo especificado

RangoConPeriodoYUnidad

fechaFinContrato
opcional

Rango de fechas para filtrar puntos de suministro según su fin de contrato

RangoFechas

listaCups
opcional

Lista de CUPS

< string > array

potenciaContratadaPorPeriodoEnkW
opcional

Rango de potencia contratada considerando únicamente el periodo especificado

RangoConPeriodo

potenciaMaximaPorPeriodoEnkW
opcional

Rango de potencia máxima considerando únicamente el periodo especificado

RangoConPeriodo

provincias
opcional

Lista de códigos INE de provincias

< string > array

tarifas
opcional

Lista de tarifas

< enum (2.0A, 2.0NA, 2.0DHA, 2.1A, 2.1DHA, 2.0DHS, 2.1DHS, 3.0A, 3.1A, 6.1, 6.1A, 6.2, 6.3, 6.4, 6.5, 6.1B, Otras) > array

tiposCliente
opcional

Lista de tipos de clientes

< enum (Residencial, Negocio, Otros) > array

tiposOptimizacion
opcional

Lista de tipos de optimización

< enum (AproximacionAOptimizacion, PotencialmenteOptimizable, Optimizable, NoOptimizable, NoAplica) > array

tiposTarifa
opcional

Lista de tipos de tarifas

< enum (2.x, 3.x, 6.x, Otras) > array

InformacionAPM

Información sobre el punto de suministro relativa al Acta de Puesta en Marcha.

Nombre Descripción Esquema

codigoAPM
opcional

Código del Acta de Puesta en Marcha.

string

fechaCaducidadAPM
opcional

Fecha de caducidad del Acta de Puesta en Marcha.

string

fechaEmisionAPM
opcional

Fecha de emisión del Acta de Puesta en Marcha.

string

potenciaMaximaAPMW
obligatorio

Potencia máxima en vatios del punto de suministro, según consta en el acta de autorización de puesta en marcha.

string

InformacionBIE

Información sobre el punto de suministro relativa al Boletín del Instalador Eléctrico.

Nombre Descripción Esquema

codigoBIE
opcional

Código del Boletín del Instalador Eléctrico.

string

fechaCaducidadBIE
opcional

Fecha de caducidad del Boletín del Instalador Eléctrico.

string

fechaEmisionBIE
opcional

Fecha de emisión del Boletín del Instalador Eléctrico.

string

potenciaMaximaBIEW
obligatorio

Potencia máxima en vatios del punto de suministro, según consta en el Boletín de Instalaciones Eléctricas.

string

ObservacionesOptimizacionPotencia

Flags que indican alguna consideración sobre el cálculo.

Nombre Descripción Esquema

potenciaSimuladaExcedeMaxDisponible
obligatorio

Indica si la potencia simulada excede el máximo disponible.

boolean

OptimizacionesPotencia

Información sobre los consumos mensualizados de un punto de suministro.

Nombre Descripción Esquema

ahorroEstimadoEnPeriodoConOptimizacion
obligatorio

Valor numérico en € con hasta dos decimales que representa el coste estimado ….. TODO

number (double)

costeEstimadoEnPeriodoOptimizado
obligatorio

Valor numérico en € con hasta dos decimales que representa el coste estimado ….. TODO

number (float)

costesEstimadosDeAcometida
obligatorio

Valor numérico en € con hasta dos decimales, que representa los costes de acometida (derechos de extensión, enganche, etc.) estimados realizando esta optimización.

number (double)

cups
obligatorio

Código CUPS del Punto de Suministro

string

estadoCups
obligatorio

Indica el estado del CUPS respecto a la optimización de potencia. Los campos pueden ser: "Optimizado", "Optimizable", "Potencialmente optimizable", "Aproximación a la optimización", "No aplica"

string

observaciones
obligatorio

Flags que indican alguna consideración sobre el cálculo.

ObservacionesOptimizacionPotencia

periodoAnalizado
obligatorio

Periodo temporal sobre el que se ha realizado el análisis. Si el CUPS no se ha podido optimizar todos los campos vienen vacíos.

PeriodoAnalizado

potenciasOptimizadas
obligatorio

Potencias optimizadas en kilovatio para cada periodo.

< PotenciasOptimizadasEnkW > array

PenalizacionesReactiva

Penalizaciones calculadas en € con hasta dos decimales para cada periodo.

Nombre Descripción Esquema

penalizacionP1
obligatorio

Penalización calculada en € para el periodo de discriminación 1.

number (double)

penalizacionP2
obligatorio

Penalización calculada en € para el periodo de discriminación 2.

number (double)

penalizacionP3
obligatorio

Penalización calculada en € para el periodo de discriminación 3.

number (double)

penalizacionP4
obligatorio

Penalización calculada en € para el periodo de discriminación 4.

number (double)

penalizacionP5
obligatorio

Penalización calculada en € para el periodo de discriminación 5.

number (double)

penalizacionP6
obligatorio

Penalización calculada en € para el periodo de discriminación 6.

number (double)

PeriodoAnalizado

Periodo temporal sobre el que se ha realizado análisis de optimización de potencia o penalización por reactiva. Si el CUPS no se ha podido optimizar todos los campos vienen vacíos.

Nombre Descripción Esquema

periodoAnalizadoFechaFin
obligatorio

Fecha de fin del periodo analizado.

string (AAAA-MM-DD)

periodoAnalizadoFechaIni
obligatorio

Fecha de inicio del periodo analizado.

string (AAAA-MM-DD)

PeticionBusqueda

Contiene datos asociados a una petición de búsqueda. En la primera petición de una búsqueda son opcionales los campos "limite" y "filtros", siendo ignorado el campo "scrollId". En subsiguientes peticiones se debe especificar el "scrollId" retornado en la anterior respuesta de resultados de búsqueda, siendo ignorados los campos "limite" y "filtros". El intervalo máximo entre peticiones de una misma búsqueda es de 5 minutos. Si se supera dicho intervalo, la busqueda se considera caducada, retornando el código de error "KSIPS-001". Cuando ocurra esto, será necesaria una nueva petición de búsqueda sin "scrollId" para reiniciar la búsqueda.

Nombre Descripción Esquema

filtros
opcional

Filtros de la petición de búsqueda

FiltrosBusqueda

limite
opcional

Especifica el número máximo de puntos de suministro a retornar por cada petición. Dicho valor no puede ser mayor que 5. Si este campo se omite, su valor será 5.

number (int32)

scrollId
opcional

Indica el "scrollId" a usar en la siguiente petición de búsqueda

string

PotenciasContratadasEnW

Potencia contratada para cada periodo de discriminación horaria en vatios y sin decimales.

Nombre Descripción Esquema

potenciaContratadaEnWP1
obligatorio

Potencia contratada en vatios para el periodo de discriminación 1.

number (int32)

potenciaContratadaEnWP2
obligatorio

Potencia contratada en vatios para el periodo de discriminación 2.

number (int32)

potenciaContratadaEnWP3
obligatorio

Potencia contratada en vatios para el periodo de discriminación 3.

number (int32)

potenciaContratadaEnWP4
obligatorio

Potencia contratada en vatios para el periodo de discriminación 4.

number (int32)

potenciaContratadaEnWP5
obligatorio

Potencia contratada en vatios para el periodo de discriminación 5.

number (int32)

potenciaContratadaEnWP6
obligatorio

Potencia contratada en vatios para el periodo de discriminación 6.

number (int32)

PotenciasContratadasEnkW

Potencia contratada para cada periodo de discriminación horaria en kilovatios y sin decimales.

Nombre Descripción Esquema

potenciaContratadaEnkWP1
obligatorio

Potencia contratada en kilovatios para el periodo de discriminación 1.

number (int32)

potenciaContratadaEnkWP2
obligatorio

Potencia contratada en kilovatios para el periodo de discriminación 2.

number (int32)

potenciaContratadaEnkWP3
obligatorio

Potencia contratada en kilovatios para el periodo de discriminación 3.

number (int32)

potenciaContratadaEnkWP4
obligatorio

Potencia contratada en kilovatios para el periodo de discriminación 4.

number (int32)

potenciaContratadaEnkWP5
obligatorio

Potencia contratada en kilovatios para el periodo de discriminación 5.

number (int32)

potenciaContratadaEnkWP6
obligatorio

Potencia contratada en kilovatios para el periodo de discriminación 6.

number (int32)

PotenciasDemandadasEnW

Potencia demandada para cada periodo de discriminación horaria en vatios y sin decimales.

Nombre Descripción Esquema

potenciaDemandadaEnWP1
obligatorio

Potencia demandada en vatios para el periodo de discriminación 1.

number (int32)

potenciaDemandadaEnWP2
obligatorio

Potencia demandada en vatios para el periodo de discriminación 2.

number (int32)

potenciaDemandadaEnWP3
obligatorio

Potencia demandada en vatios para el periodo de discriminación 3.

number (int32)

potenciaDemandadaEnWP4
obligatorio

Potencia demandada en vatios para el periodo de discriminación 4.

number (int32)

potenciaDemandadaEnWP5
obligatorio

Potencia demandada en vatios para el periodo de discriminación 5.

number (int32)

potenciaDemandadaEnWP6
obligatorio

Potencia demandada en vatios para el periodo de discriminación 6.

number (int32)

PotenciasMaximasAnioEnkW

Consumo de potencia máxima anual para cada periodo, en kilovatios sin decimales.

Nombre Descripción Esquema

potenciaMaximaAnioEnkWP1
obligatorio

Consumo de potencia máxima anual en kilovatios para el periodo de discriminación 1.

number (int32)

potenciaMaximaAnioEnkWP2
obligatorio

Consumo de potencia máxima anual en kilovatios para el periodo de discriminación 2.

number (int32)

potenciaMaximaAnioEnkWP3
obligatorio

Consumo de potencia máxima anual en kilovatios para el periodo de discriminación 3.

number (int32)

potenciaMaximaAnioEnkWP4
obligatorio

Consumo de potencia máxima anual en kilovatios para el periodo de discriminación 4.

number (int32)

potenciaMaximaAnioEnkWP5
obligatorio

Consumo de potencia máxima anual en kilovatios para el periodo de discriminación 5.

number (int32)

potenciaMaximaAnioEnkWP6
obligatorio

Consumo de potencia máxima anual en kilovatios para el periodo de discriminación 6.

number (int32)

PotenciasMaximasInteranualesEnkW

Consumo de potencia máxima interanual para cada periodo, en kilovatios sin decimales.

Nombre Descripción Esquema

potenciaMaximaInteranualEnkWP1
obligatorio

Consumo de potencia máxima interanual en kilovatios para el periodo de discriminación 1.

number (int32)

potenciaMaximaInteranualEnkWP2
obligatorio

Consumo de potencia máxima interanual en kilovatios para el periodo de discriminación 2.

number (int32)

potenciaMaximaInteranualEnkWP3
obligatorio

Consumo de potencia máxima interanual en kilovatios para el periodo de discriminación 3.

number (int32)

potenciaMaximaInteranualEnkWP4
obligatorio

Consumo de potencia máxima interanual en kilovatios para el periodo de discriminación 4.

number (int32)

potenciaMaximaInteranualEnkWP5
obligatorio

Consumo de potencia máxima interanual en kilovatios para el periodo de discriminación 5.

number (int32)

potenciaMaximaInteranualEnkWP6
obligatorio

Consumo de potencia máxima interanual en kilovatios para el periodo de discriminación 6.

number (int32)

PotenciasMaximasMesEnkW

Consumo de potencia máxima mensual para cada periodo, en kilovatios sin decimales.

Nombre Descripción Esquema

potenciaMaximaMesEnkWP1
obligatorio

Consumo de potencia máxima mensual en kilovatios para el periodo de discriminación 1.

number (int32)

potenciaMaximaMesEnkWP2
obligatorio

Consumo de potencia máxima mensual en kilovatios para el periodo de discriminación 2.

number (int32)

potenciaMaximaMesEnkWP3
obligatorio

Consumo de potencia máxima mensual en kilovatios para el periodo de discriminación 3.

number (int32)

potenciaMaximaMesEnkWP4
obligatorio

Consumo de potencia máxima mensual en kilovatios para el periodo de discriminación 4.

number (int32)

potenciaMaximaMesEnkWP5
obligatorio

Consumo de potencia máxima mensual en kilovatios para el periodo de discriminación 5.

number (int32)

potenciaMaximaMesEnkWP6
obligatorio

Consumo de potencia máxima mensual en kilovatios para el periodo de discriminación 6.

number (int32)

PotenciasOptimizadasEnkW

Potencias optimizadas en kilovatio para cada periodo.

Nombre Descripción Esquema

potenciaOptimizadaP1
obligatorio

Potencia optimizada en kilovatio para el periodo de discriminación 1.

number (int32)

potenciaOptimizadaP2
obligatorio

Potencia optimizada en kilovatio para el periodo de discriminación 2.

number (int32)

potenciaOptimizadaP3
obligatorio

Potencia optimizada en kilovatio para el periodo de discriminación 3.

number (int32)

potenciaOptimizadaP4
obligatorio

Potencia optimizada en kilovatio para el periodo de discriminación 4.

number (int32)

potenciaOptimizadaP5
obligatorio

Potencia optimizada en kilovatio para el periodo de discriminación 5.

number (int32)

potenciaOptimizadaP6
obligatorio

Potencia optimizada en kilovatio para el periodo de discriminación 6.

number (int32)

PuntoSuministro

Información estructural sobre el punto de suministro

Nombre Descripción Esquema

aplicacionBonoSocial
opcional

Bono social aplicado por el comercializador de referencia. Se informará según los siguientes valores: “0” - no se aplica bono social, “1” - sí se aplica bono social.

string

clasificacionPS
obligatorio

Clasificación del punto de suministro según los "Nombres de tipos de punto de medida" actualmente en vigor, y definidos en el Reglamento unificado de puntos de medida del sistema eléctrico, aprobado por Real Decreto 1110/2007, de 24 de agosto.

string

cnae
opcional

CNAE. CNMC - Tabla 66.

string

codigoAccesibilidadContador
opcional

Información sobre la accesibilidad del contador. Se informará según los siguientes valores: "1" - Punto de suministro accesible, "2" - Contador no accesible (para acceder se necesita la colaboración del usuario), "3" - Accesibilidad condicionada.

string

codigoAutoconsumo
obligatorio

Se informará según los siguientes valores: "00" - si no existe autoconsumo "01" - si es un autoconsumo tipo 1 "2A" - si es un autoconsumo tipo 2 con dos contratos de acceso uno para el consumidor asociado y otro para los servicios auxiliares (SSAA), "2B" - si es un autoconsumo tipo 2 con un único contrato de acceso para el consumidor asociado y para los servicios auxiliares, "2G" – si el punto de suministro corresponde con los servicios auxiliares (SSAA) de un autoconsumo tipo 2. (Vacío si no disponible)

string

codigoClaseExpediente
opcional

Tipo de expediente abierto. Se informará según los siguientes valores: "I" - Inspección, "N" - Nuevos suministros

string

codigoComercializadora
obligatorio

Debido a la interposición del recurso contencioso administrativo ordinario el Tribunal Supremo contra el Real Decreto 1074/2015, se adopta la medida cautelar consistente en la suspensión de la eficacia del concreto inciso "ac) empresa comercializadora que realiza actualmente el suministro". Por lo tanto, este campo se informará vacío hasta nuevo aviso.

string

codigoDHEquipoDeMedida
opcional

Código de la información de la discriminación horaria del equipo de medida. CNMC - Tabla 35.

string

codigoDisponibilidadICP
obligatorio

Disponibilidad de Interruptor de Control de Potencia. Se informará según los siguientes valores: "0" - si el ICP no está instalado. "1" - si el ICP está instalado. (Vacío si no disponible)

string

codigoEmpresaDistribuidora
obligatorio

Código de la empresa distribuidora del registro de distribuidores de energía eléctrica del MINETUR (formato "R1-XXX"), definido en https://sedeaplicaciones.minetur.gob.es/eee/indiceCalidad/distribuidores.aspx, en cuya red están conectados los puntos de suministro que se informan

string

codigoFasesEquipoMedida
obligatorio

Se informará según los siguientes valores: "M" - si el equipo de monofásico, "T" - si el equipo es trifásico. (Vacío si no disponible)

string

codigoModoControlPotencia
opcional

Se informará según los siguientes valores: "1" - ICP, "2" - Maximetro, "3" - Control de potencia en contador de telegestión, "4" - Sin control de potencia.

string

codigoMotivoExpediente
opcional

Si existe un expediente abierto se especificará el motivo del expediente con alguno de los códigos de la tabla "Motivos Expediente". Se informará según los siguientes valores: "01" - Aumento potencia, "02" - Cambio tensión, "03" - Cambio tarifa, "04" - Nuevo suministro, "05" - Colectivo nueva construcción, "06" - Colectivo electrificación rural, "07" - Informativo Plan urbanístico, "08" - Informativo Plan industrial, "09" - Informativo Productor de Régimen Especial, "10" - Colectivo reconstrucción vivienda, "11" - TCT No relacionado a NNSS, "12" - TCT Relacionado a NNSS, "13" - Colectivo renovación de Instalaciones de enlace varios suministros, "14" - Renovación de instalaciones de enlace.

string

codigoPSContratable
opcional

Indicativo que define si el Punto de Suministro es contratable tras el cierre de un expediente. Se informará según los siguientes valores: "0" - No contratable, "1" - Contratable.

string

codigoPeriodicidadFacturacion
opcional

Código de la periodicidad de la facturación: mensual o bimestral. CNMC - Tabla 108.

string

codigoPropiedadEquipoMedida
obligatorio

Código del propietario del equipo de medida. CNMC - Tabla 32 (Vacío si no disponible)

string

codigoPropiedadICP
obligatorio

Código de la Propiedad de Interruptor de Control de Potencia, que incluye tipo de propietario del ICP. CNMC - Tabla 32 (Vacío si no disponible)

string

codigoTarifaATREnVigor
obligatorio

Código de la tarifa de acceso en vigor. CNMC - Tabla 17

string

codigoTelegestion
obligatorio

Código de la información sobre la disponibilidad del equipo de medida efectivamente integrado en el sistema de telegestión. CNMC - Tabla 111. (Vacío si no disponible)

string

codigoTensionMedida
opcional

Código de la tensión del Equipo de medida situado a una tensión distinta a la del suministro. CNMC - Tabla 64.

string

codigoTensionV
obligatorio

Código de la tensión en voltios de la conexión del punto de suministro a las redes. CNMC - Tabla 64

string

codigoTipoContrato
opcional

Información sobre el tipo de contrato de acceso (i.e. anual, eventual, temporada, etc.)

string

codigoTipoSuministro
opcional

Descriptor del tipo de suministro imprescindible que permite conocer entre otras cosas, cuando se puede contratar una sola potencia (tarifas 2.X) contratada con maxímetro o si se trata de un suministro fotovoltaico. (i.e. Almacén, alumbrado público, Ascensores, etc.). CNMC - Tabla 62.

string

cups
obligatorio

Código CUPS del Punto de Suministro

string

dhEquipoDeMedida
opcional

Información de la discriminación horaria del equipo de medida.

string

direccionSuministro
obligatorio

Dirección del punto de suministro

DireccionSuministro

esViviendaHabitual
obligatorio

En relación al uso del punto de suministro cuando el titular es persona física. Se informará según los siguientes valores: "0" - cuando no sea vivienda habitual, "1" - cuando sea vivienda habitual. Vacío - cuando no sea una persona física

string

fechaAltaSuministro
obligatorio

Fecha de alta del suministro (Vacío si no disponible)

string (AAAA-MM-DD)

fechaLimiteDerechosReconocidos
obligatorio

Fecha límite de los derechos de extensión reconocidos. (Vacío si no disponible)

string (AAAA-MM-DD)

fechaUltimaLectura
obligatorio

Fecha de la última lectura firme. (Vacío si no disponible)

string (AAAA-MM-DD)

fechaUltimoCambioComercializador
opcional

Fecha del último cambio de comercializador. (Vacío si no disponible)

string (AAAA-MM-DD)

fechaUltimoMovimientoContrato
obligatorio

Fecha del último movimiento de contratación a efectos tarifarios. (Vacío si no disponible)

string (AAAA-MM-DD)

importeDepositoGarantiaEuros
obligatorio

Importe del depósito de garantía suscrito por el titular del punto de suministro, en euros. En caso de inexistencia del depósito de garantía se especificará con el valor cero.

number (int32)

informacionAPM
obligatorio

Información sobre APM

InformacionAPM

informacionBIE
obligatorio

Información sobre BIE

InformacionBIE

informacionImpagos
obligatorio

Información relativa a los impagos en que los consumidores hayan incurrido. Se informará según los siguientes valores: "Con impagos" - si existen impagos (adicionalmente se incluirá información sobre la cuantía en euros si se dispone de ella), "Sin impagos" si no existen impagos. (Vacío si no disponible)

string

marcaEmpresaDistribuidora
opcional

Marca de la empresa distribuidora
Ejemplo : "ERZ"

string

motivoEstadoNoContratable
opcional

Información sobre el motivo del estado "No contratable" tras el cierre de un expediente (i.e. falta documentación, etc.).

string

nombreClasificacionPS
opcional

Nombre de la clasificación del punto de suministro según los "Nombres de tipos de punto de medida" actualmente en vigor, y definidos en el Reglamento unificado de puntos de medida del sistema eléctrico, aprobado por Real Decreto 1110/2007, de 24 de agosto.

string

nombreEmpresaDistribuidora
obligatorio

Nombre de la empresa distribuidora del registro de distribuidores de energía eléctrica del MINETUR

string

periodicidadFacturacion
opcional

Periodicidad de la facturación: mensual o bimestral.

string

potenciaCGPW
opcional

Potencia en vatios permitida en la Caja General de Protección.

string

potenciasContratadasEnW
obligatorio

Potencia contratada para cada periodo de discriminación horaria en vatios y sin decimales

PotenciasContratadasEnW

propiedadEquipoMedida
obligatorio

Propietario del equipo de medida.

string

propiedadICP
obligatorio

Propiedad de Interruptor de Control de Potencia, que incluye tipo de propietario del ICP.

string

relacionTransformacionIntensidad
opcional

Se indica la intensidad del primario / intensidad del secundario (i.e. 20/1000).

string

tarifaATREnVigor
obligatorio

Tarifa de acceso en vigor.

string

telegestion
obligatorio

Información sobre la disponibilidad del equipo de medida efectivamente integrado en el sistema de telegestión.

string

tensionV
obligatorio

Tensión en voltios de la conexión del punto de suministro a las redes.

string

tipoIdTitular
obligatorio

Tipo de identificador del titular del contrato. CNMC - Tabla 6. (Vacío si no disponible)

string

tipoPerfilConsumo
obligatorio

Nombre del tipo de Perfil de Consumo según los tipos de perfil en vigor en cada momento. Se informará según los siguientes valores: "Pa" - Tipo perfil a, "Pb" - Tipo perfil b, "Pc" - Tipo perfil c, "Pd" - Tipo perfil d. (Vacío si no disponible)

string

valorDerechosAccesoW
obligatorio

Valor de los derechos de acceso en vatios que tenga reconocidos el punto de suministro.

string

valorDerechosExtensionW
obligatorio

Valor de los derechos de extensión en vatios que tenga reconocidos el punto de suministro.

string

Rango

Filtro tipo rango numérico

Nombre Descripción Esquema

desde
obligatorio

Límite inferior del rango (inclusive)

number (int32)

hasta
obligatorio

Límite superior del rango (inclusive)

number (int32)

RangoConPeriodo

Filtro tipo rango para un periodo específico

Nombre Descripción Esquema

periodo
obligatorio

Periodo (del 1 al 6)

number (int32)

rango
obligatorio

Rango

Rango

RangoConPeriodoYUnidad

Filtro tipo rango para un periodo y unidad específicos

Nombre Descripción Esquema

rangoConPeriodo
obligatorio

Rango para un periodo específico

RangoConPeriodo

unidad
obligatorio

Unidad sobre la que se aplicará el rango definido

enum (MWh, Porcentaje)

RangoFechas

Filtro tipo rango de fechas

Nombre Descripción Esquema

desde
obligatorio

Límite inferior del rango (inclusive)

string (AAAA-MM-DD)

hasta
obligatorio

Límite superior del rango (inclusive)

string (AAAA-MM-DD)

RespuestaBusquedaConsumos

Resultados de información de consumos sobre la búsqueda de puntos de suministro

Nombre Descripción Esquema

consumosMensualizados
obligatorio

Lista de consumos mensualizados de los puntos de suministro encontrados

< ConsumosMensualizados > array

consumosRaw
obligatorio

Lista de consumos en bruto de los puntos de suministro encontrados

< ConsumoRaw > array

excesosReactiva
obligatorio

Lista de información sobre excesos de reactiva de los puntos de suministro encontrados

< ExcesosReactiva > array

optimizacionesPotencia
obligatorio

Lista de información sobre optimizaciones de potencia de los puntos de suministro encontrados

< OptimizacionesPotencia > array

scrollId
obligatorio

Indica el "scrollId" a usar en la siguiente petición de búsqueda

string

total
obligatorio

Número total de resultados

number (int64)

RespuestaBusquedaPuntosSuministro

Resultados de información estructural sobre la búsqueda de puntos de suministro

Nombre Descripción Esquema

puntosSuministro
obligatorio

Lista de información estructural de los puntos de suministro encontrados

< PuntoSuministro > array

scrollId
obligatorio

Indica el "scrollId" a usar en la siguiente petición de búsqueda

string

total
obligatorio

Número total de resultados

number (int64)