🔍 Consulta de Datos CUPS (Gas)

Obtiene información completa y técnica del punto de suministro de gas mediante el SIPS. Es equivalente al endpoint `/sips/{cups}` pero adaptado a la terminología del sector gasista.

Diferencias técnicas con Electricidad:

• Peaje: Se devuelve en el campo peaje o codigoPeajeEnVigor (ej: RL.1, RL.2).
• Consumo: Los consumos se expresan en kWh (a diferencia de electricidad que a veces se maneja en Wh internamente).

Ejemplo de Respuesta JSON:

{
  "cups": "ES0201000000000000AB1F",
  "direccion": {
    "tipo_via": "CALLE",
    "nombre_via": "ESPAÑA",
    "numero": "25",
    "codigo_postal": "28001",
    "municipio": "MADRID",
    "provincia": "MADRID"
  },
  "titular": {
    "nombre": "MARIA LOPEZ GARCIA",
    "tipo_documento": "NIF",
    "numero_documento": "87654321B"
  },
  "peaje": "RL.2",
  "distribuidora": "NEDGIA S.A.",
  "comercializadora": "IMAGINA ENERGIA S.A.",
  "estado": "activo",
  "fecha_alta": "2021-10-10"
}

📊 Consumos Mensualizados Gas (Mendix)

Este endpoint está diseñado específicamente para integraciones con Mendix, devolviendo un histórico de consumo mensual en formato Mendix (XML).

Formato XML de Respuesta:

<?xml version="1.0" encoding="utf-8"?>
<ConsumosMensualizadosSIPs>
    <ConsumosMensualizadosSIPS>
        <CUPS>ES0201000000000000AB1F</CUPS>
        <codigoPeajeEnVigor>RL.2</codigoPeajeEnVigor>
        <Mes>10</Mes>
        <DiasPeriodo>31</DiasPeriodo>
        <ConsumoWh>152000</ConsumoWh>
        <MesRef>202510</MesRef>
        <Edit>true</Edit>
    </ConsumosMensualizadosSIPS>
</ConsumosMensualizadosSIPs>

⚡ Consumos por Períodos Gas (Mendix)

Similar al anterior, pero desglosa el consumo mensualizado en los períodos tarifarios estándar del gas (normalmente P1 y P2) en formato Mendix (XML).

Formato XML de Respuesta:

<?xml version="1.0" encoding="utf-8"?>
<ConsumosMensualizadosSIPs>
    <ConsumosMensualizadosSIPS>
        <CUPS>ES0201000000000000AB1F</CUPS>
        <codigoPeajeEnVigor>RL.2</codigoPeajeEnVigor>
        <Mes>11</Mes>
        <DiasPeriodo>30</DiasPeriodo>
        <ConsumoWhP1>85000</ConsumoWhP1>
        <ConsumoWhP2>67000</ConsumoWhP2>
        <MesRef>202511</MesRef>
        <Edit>true</Edit>
    </ConsumosMensualizadosSIPS>
</ConsumosMensualizadosSIPs>

📅 Consumos Anuales de Gas (Mendix)

Devuelve un resumen consolidado del último año móvil (ultimos 12 meses) de consumo de gas en formato Mendix (JSON), optimizado para procesos de valoración de ofertas.

Campos destacados en JSON:

• ConsumoAnualWh: Total de consumo en el año (suma de P1 y P2).
• CAE_P1 / CAE_P2: Consumo acumulado por período.
• consumoAnual_kwh: Conversión directa a kWh redondeada.

Ejemplo de JSON:

{
  "CUPS": "ES0201000000000000AB1F",
  "TarifaATR": "RL.2",
  "ConsumoAnualWh": 1450200,
  "CAE_P1": 850100,
  "CAE_P2": 600100,
  "consumoAnual_kwh": 1450.2,
  "PCT_P1": 58.6,
  "PCT_P2": 41.4
}

📈 Detalle Mensual para Gráficos (JSON)

Este es el endpoint utilizado por la interfaz web para renderizar gráficos de consumo histórico de gas. Devuelve el desglose de consumos de cada uno de los últimos 12 meses.

Estructura de la respuesta:

{
  "cups": "ES0201000000000000AB1F",
  "desglose_mensual": [
    {
      "mes": "2025-01",
      "cups": "ES0201000000000000AB1F",
      "consumoEnWhP1": 12500,
      "consumoEnWhP2": 9800
    },
    {
      "mes": "2025-02",
      "cups": "ES0201000000000000AB1F",
      "consumoEnWhP1": 13200,
      "consumoEnWhP2": 10500
    }
  ]
}