Vibe Coding #5 — Motor de Facturación Eléctrica | API de Desglose Completo de Factura
Construimos un microservicio FastAPI que desglosa cada componente de una factura eléctrica española — desde precios OMIE y ajustes de liquidación hasta peajes, cargos, pérdidas e impuestos — para todas las tarifas (2.0TD a 6.4TD).
Próximamente 3 de marzo de 2026 17:30 CET EN
fastapienergiafacturacionespanatarifasomiemicroserviciopython
Recibe actualizaciones semanales
Sesiones de live coding, librerías Python para datos energéticos y tutoriales prácticos. Un email por semana, sin relleno.
Lo que construiremos
Un motor de facturación listo para producción para facturas eléctricas españolas, expuesto como servicio FastAPI para desglosar línea a línea costes de mercado, cargos regulados, pérdidas e impuestos.
Por qué importa
- Muchas herramientas de facturación ocultan la factura detrás de un total opaco en vez de explicar cada componente
- Las tarifas españolas cambian por familia ATR, periodo y año regulatorio, así que la lógica simplificada se rompe rápido
- Los equipos energéticos necesitan resultados auditables para consultoría, herramientas internas y apps de cliente
- El motor base ya funciona; este stream trata de convertirlo en un servicio desplegable y fiable
Lo que verás
- Diseño de API: Inputs, validación y formato de respuesta del microservicio
- Cobertura tarifaria: Soporte para 2.0TD, 3.0TD y 6.1TD-6.4TD
- Casos límite: Cambios de hora, liquidaciones incompletas y actualizaciones regulatorias
- Despliegue: Containerización del servicio e integración en
energy.datons.ai - Pulido del output: Cómo estructurar el desglose para frontend, informes y agentes IA
Arquitectura
Inputs
CUPS · Consumo · Datos tarifarios
Costes regulados
Billing Engine
Python · Desglose de costes
Datos de mercado
OMIE · AJOM · AJOS · SSAA
Costes regulados
Peajes · Cargos · Pérdidas · Impuestos
Desglose estructurado
FastAPI
Validación · Docs · Respuestas
Respuesta JSON
Consumidores
Frontend · Informes · Agentes IA
Stack
- Python 3.11+ · FastAPI · Pydantic · pandas · Docker · OMIE · CNMC
Para quién es
- Desarrolladores energéticos creando productos de facturación, pricing o analítica en España
- Consultores y analistas que necesitan desgloses auditables de factura
- Ingenieros de datos que convierten datos de mercado y liquidaciones en APIs de producción
Notas
- El motor de facturación ya existe; este no es un stream desde cero sino de endurecimiento y despliegue
- Los datos de referencia cubren tarifas ATR residenciales, pyme e industriales
- Explicaremos cómo se mapean las columnas principales de liquidación a componentes reales de factura
Índice
Buscar sección