🔐 Autenticación

Todos los endpoints aceptan dos esquemas (require_any_auth):

• Token estático: Authorization: Bearer <API_SECUR_TOKEN>.
• JWT (HS256): Authorization: Bearer <jwt> firmado con JWT_SECRET o JWT_SECRET_1. Consulta la guía de autenticación.

🌐 Ventana de datos

Los endpoints de esta página trabajan sobre los últimos 12 meses naturales completos disponibles en SIPS para el CUPS. La fuente de datos es neuro360.es/api/apiSips + las potencias contratadas (SIPS técnicos).

📊 Consumos Mensualizados (Mendix · XML)

Devuelve el consumo eléctrico total por mes natural durante los últimos 12 meses en formato XML compatible con Mendix. Cada nodo agrega los consumos de todos los períodos (P1..P6) en un único valor ConsumoWh.

Parámetros de Ruta

Cabeceras de la respuesta

• Content-Type: application/xml

Campos del XML

✅ Ejemplo de respuesta (200)

<?xml version="1.0" encoding="utf-8"?>
<ConsumosMensualizadosSIPs>
    <ConsumosMensualizadosSIPS>
        <CUPS>ES0031405678912345AB1F</CUPS>
        <codigoTarifaATR>2.0TD</codigoTarifaATR>
        <Mes>1</Mes>
        <DiasPeriodo>31</DiasPeriodo>
        <ConsumoWh>312450</ConsumoWh>
        <MesRef>202501</MesRef>
        <Edit>true</Edit>
    </ConsumosMensualizadosSIPS>
</ConsumosMensualizadosSIPs>

❌ Respuestas de error

• 400 – CUPS mal formado o SIPS devuelve un payload no esperado.
• 401 – Falta autenticación o token inválido.
• 404 – Falta el parámetro cups.
• 500 – Error interno o de conexión con SIPS.

💻 Ejemplo cURL

curl -X GET "https://api.imaginaenergia.com/sips_datos_consumos_mendix/ES0031405678912345AB1F" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Accept: application/xml"

⚡ Consumos Mensualizados por Períodos (Mendix · XML)

Idéntico al anterior pero desglosando el consumo en cada uno de los 6 períodos tarifarios (ConsumoWhP1..ConsumoWhP6). Útil para facturación detallada en tarifas 3.0TD / 6.1TD.

Campos del XML

✅ Ejemplo de respuesta (200)

<?xml version="1.0" encoding="utf-8"?>
<ConsumosMensualizadosSIPs>
    <ConsumosMensualizadosSIPS>
        <CUPS>ES0031405678912345AB1F</CUPS>
        <codigoTarifaATR>3.0TD</codigoTarifaATR>
        <Mes>2</Mes>
        <DiasPeriodo>28</DiasPeriodo>
        <ConsumoWhP1>120000</ConsumoWhP1>
        <ConsumoWhP2>95000</ConsumoWhP2>
        <ConsumoWhP3>72000</ConsumoWhP3>
        <ConsumoWhP4>0</ConsumoWhP4>
        <ConsumoWhP5>0</ConsumoWhP5>
        <ConsumoWhP6>0</ConsumoWhP6>
        <MesRef>202502</MesRef>
        <Edit>true</Edit>
    </ConsumosMensualizadosSIPS>
</ConsumosMensualizadosSIPs>

📅 Consumos Anuales por Períodos (Mendix · JSON)

Resumen consolidado de los últimos 12 meses para el CUPS. Combina:

• Datos técnicos del CUPS (tarifa ATR, potencias contratadas, dirección, CP, provincia).
• Consumo anual agregado por período (CAE_P1..CAE_P6) en Wh.
• Porcentajes de reparto por período (PCT_P1..PCT_P6).
• Conversiones derivadas en kWh y kW para uso directo en el frontend / Mendix.
• Enriquecimientos: tarifa_atr_mapped y sistema_electrico (zona peninsular, Baleares, Canarias, Ceuta o Melilla, según provincia).

Campos destacados de la respuesta

✅ Ejemplo de respuesta (200)

{
  "CUPS": "ES0031405678912345AB1F",
  "TarifaATR": "2.0TD",
  "tarifa_atr_mapped": "2.0TD",
  "Provincia_PS": "28",
  "CP_PS": "28013",
  "sistema_electrico": "peninsula",
  "potenciasContratadasEnWP1": 4600,
  "potenciasContratadasEnWP2": 4600,
  "potenciasContratadasEnWP1_kw": 4.6,
  "potenciasContratadasEnWP2_kw": 4.6,
  "CAE_P1": 1200000,
  "CAE_P2": 950000,
  "CAE_P3": 720000,
  "CAE_P4": 0, "CAE_P5": 0, "CAE_P6": 0,
  "PCT_P1": 41.8,
  "PCT_P2": 33.1,
  "PCT_P3": 25.1,
  "ConsumoAnualWh": 2870000,
  "consumoAnual_kwh": 2870.0,
  "consumoAnualP1_kwh": 1200.0,
  "consumoAnualP2_kwh": 950.0,
  "consumoAnualP3_kwh": 720.0
}

📈 Consumo Anual + Detalle Mensual (JSON)

Misma estructura que /sips_datos_anuales_mendix pero incorporando además el desglose mensual de los últimos 12 meses. Es el endpoint utilizado por la SPA para pintar gráficos de consumo.

Junto a los campos anuales, la respuesta añade una lista (o conjunto de claves derivadas, según el cliente Mendix) con los consumos mensuales por período listos para representación gráfica.

🧪 Consumos Anuales (Mendix · PRE)

Variante del endpoint anual JSON pensada para el entorno PRE de Mendix. Internamente invoca la misma función que /sips_datos_anuales_mendix/<cups> y la respuesta tiene exactamente la misma estructura.

Se mantiene como ruta separada para que el entorno PRE pueda evolucionar de forma independiente sin afectar a las integraciones productivas. Si tu flujo Mendix de PRO está apuntando aquí, debería migrarse a la ruta sin sufijo.