API para desarrolladores
La API de CFE: recibos, tarifas, dispositivos y ahorro
Conecta tu cuenta de CFE y tus equipos, una sola vez. Batu normaliza recibos, tarifas, consumo, monitoreo y cálculos de ahorro, y los expone por API o por MCP para el asistente de IA que ya usas.
Paso 1
Conecta CFE y tus equipos
Autorizas la cuenta de CFE y conectas tus dispositivos, una sola vez. Sin capturas de pantalla, sin entrar a un portal distinto cada mes.
Paso 2
Batu descarga y normaliza
Cada periodo, Batu baja los recibos y estructura el consumo, las tarifas y los datos de tus equipos en un formato consistente.
Paso 3
Consume por API o por MCP
Tu producto pide los datos por API y recibe JSON, o tu asistente de IA los consulta directo por MCP.
De descargar PDFs a consumir datos
Los datos de CFE viven en un portal pensado para personas, no para sistemas: hay que entrar contrato por contrato, descargar cada recibo y capturar los números a mano. A escala, eso es días de trabajo manual cada mes, y una fuente constante de errores.
La API de Batu invierte el flujo: conectas tu cuenta de CFE una vez y los recibos, el consumo y las tarifas quedan disponibles como datos estructurados, listos para usarse en tu sistema.
Es el mismo problema con los dispositivos que monitoreas: cada marca de inversor tiene su propio dashboard, sin una vista unificada. La misma API resuelve los dos: CFE y equipos, un solo contexto de datos en vez de varios portales fragmentados.
¿Por qué no desarrollar esto por tu cuenta?
El portal de CFE no es una API: no tiene contrato, ni versiones, ni garantías. Cambia sin avisar (el login, los formatos, los captchas), y cuando cambia, tu scraper se rompe justo en el cierre de facturación. Mantener eso vivo no es un proyecto de una vez, es una tarea permanente. Y no es solo CFE: cada dispositivo que monitoreas trae su propio SDK que mantener.
Así se ve integrar cada fuente por tu cuenta
Cada dispositivo y el portal de CFE llegan por su cuenta, en unidades distintas, y alguien tiene que normalizarlos, cruzarlos con el contrato y calcular la tarifa a mano.
Míralo con Batu ↗
- 1
Un SDK por marca
Huawei, SMA, Fronius, el portal de CFE: cada fuente trae su propia integración.
- 2
Normalizar unidades
Cada fabricante reporta distinto; alguien tiene que hacerlo comparable a mano.
- 3
Cruzar contratos y tarifas
Juntar el consumo con el contrato de cada cliente y aplicar las reglas de CFE según su tarifa.
- 4
Sumar desempeño esperado
Integrar aparte con Helioscope u otro proveedor para tener el punto de comparación.
Cada SDK, cada unidad, cada regla de tarifa: es tuyo, paso por paso.
Batu ya resuelve esto a escala. Tú te concentras en tu producto; la conexión con CFE y con tus dispositivos la mantenemos nosotros.
Dos formas de consumirlo: API o MCP
El mismo contexto de datos (recibos, tarifas, dispositivos, ahorro), según cómo lo quieras usar.
API REST
Para cuando construyes tu propio producto encima de los datos: cotizadores, reportes a clientes, tu propio dashboard. Autenticas con una API key y consumes JSON. Ejemplos abajo en curl, JavaScript y Python.
Ver ejemplos de código →MCP para tu asistente de IA
Para cuando quieres que un asistente que ya usas (Claude, Cursor, o cualquier cliente MCP) consulte tus datos de energía en español, sin que escribas código de integración. Prueba una conversación real abajo.
Elige una pregunta abajo y mira lo que hace.
Pregúntale algo
Endpoints principales
Rutas principales. La referencia completa vive en la documentación de la API.
| Categoría | Recurso | Método | Ruta | Qué devuelve |
|---|---|---|---|---|
| CFE | Recibos | GET | /api/v1/bills | Recibos de CFE de un contrato (RPU), con desglose de conceptos: energía, demanda, factor de potencia y total. |
| Dispositivos | Resumen de energía | GET | /api/v1/sites/:id/energy-summary | kWh, kW pico y generación esperada de un sitio en una ventana, con desglose por horario (base/intermedia/punta). |
| Resultados | Ahorro | GET | /api/v1/sites/:id/savings-window | Reporte de ahorro por ciclo de facturación, con la razón cuando el ahorro aún no está configurado. |
Empieza en minutos
Autentícate con tu API key. Los ejemplos cubren recibos de CFE, resumen de energía y ahorro, o conecta el servidor MCP a tu asistente.
Recibos de CFE
# Autenticación: API key como Bearer token en el encabezado Authorization
curl https://app.batuenergy.com/api/v1/bills?rpu=TU_RPU \
-H "Authorization: Bearer TU_API_KEY"{
"status": "success",
"data": [
{
"id": "bil_01JQ2K7R8MW3XZ",
"total": "84560.00",
"year_month": "2026-05",
"due_date": "2026-05-18",
"tariff": "GDMTH",
"payment_status": "paid",
"contract": { "rpu": "123456789012", "pricing_zone": "Jalisco", "is_monitored": true },
"concepts": { "kwh": "12450", "demandaMaxima": "48.20", "factorPotencia": "94.2" }
}
],
"concept_meaning": {
"kwh": { "label": "kWh Totales", "units": "kWh" }
}
}concept_meaning.Para quién es
- Instaladores, EPCs e integradores solares: cotiza con datos reales de consumo, no con capturas manuales, y automatiza el reporte de ahorro a tus clientes.
- Comercializadores y proveedores de energía: descarga recibos y factura sobre datos de CFE normalizados, sin construir ni mantener tu propio scraper del portal.
- Equipos de datos y producto: integra recibos, consumo, tarifas y datos de dispositivos en tus sistemas con una sola API en lugar de varios portales frágiles.
- Equipos que ya usan un asistente de IA: conecta el MCP y consulta el contexto energético completo desde Claude, Cursor o tu cliente MCP, sin escribir integración.
¿Gestionas el consumo de tu propia empresa multi-sitio en vez de construir sobre la API? Eso lo cubre la plataforma de Batu.
Aprende más
- Cómo leer el recibo de CFE: qué conceptos entrega la API (energía, demanda, factor de potencia).
- Mapa del Sistema Eléctrico Nacional: contexto de tarifas y demanda por región de CFE.
- Calcula el costo de implementar Batu: estima créditos y plan según tu volumen de recibos y sitios.
Preguntas frecuentes
¿Qué es la API de CFE de Batu?
Es una API REST que entrega los datos de un contrato de CFE en JSON: los recibos (con su desglose de energía, demanda y factor de potencia), las series de consumo y las tarifas por zona. Conectas la cuenta de CFE una vez y Batu descarga y normaliza los datos por ti; tu sistema los consume por API, con los datos ya estructurados y listos para usar.
¿Puedo descargar recibos de CFE por API?
Sí. El recurso de recibos devuelve los recibos de un RPU con su desglose de conceptos, listo para facturar, conciliar o reportar a tus clientes. En lugar de descargar PDFs manualmente cada mes, tu integración pide los recibos y recibe datos estructurados.
¿La API solo da datos de CFE, o también de mis dispositivos?
También de tus dispositivos. Más allá de recibos y tarifas, la API expone el estado de monitoreo de tu flota, resúmenes de energía por sitio, las series de tiempo crudas de cada inversor o medidor conectado, y el reporte de ahorro por ciclo. Es el mismo contexto energético que ves en el portal, disponible como datos.
¿Qué es el MCP de Batu y en qué se diferencia de la API REST?
El MCP (Model Context Protocol) conecta el mismo contexto de datos directo a un asistente de IA (Claude, Cursor o cualquier cliente MCP), sin que tú escribas código de integración. Le preguntas en español y el asistente llama las herramientas de Batu por ti. La API REST sigue siendo el camino cuando construyes tu propio producto encima de los datos; el MCP es para cuando quieres que un asistente ya existente los use.
¿Cómo me autentico y cuáles son los límites de uso?
La autenticación es por API key en el encabezado Authorization (o como variable de entorno para el MCP). Los límites de uso y el modelo de créditos se documentan en la referencia de la API que recibes al solicitar acceso.
¿La API sirve para integradores y comercializadores?
Sí. Está pensada para instaladores, EPCs y comercializadores que construyen su propia oferta de energía sobre los datos de CFE y de los dispositivos que monitorean: cotización con datos reales, facturación a clientes y reportes automáticos. Tú tienes la batuta; Batu toca la parte de los datos.
Conecta CFE y tus dispositivos. Consume datos, no capturas.
Solicita acceso a la API y empieza a integrar recibos, tarifas, dispositivos y ahorro en tu producto, o en tu asistente de IA por MCP.