Bienvenido a la Documentación

Encuentra toda la información necesaria para integrar con las APIs de Imagina Energía. Nuestra documentación está diseñada para desarrolladores y proporciona ejemplos prácticos, guías de autenticación y referencias completas de todos nuestros endpoints.

¿Qué puedes hacer con nuestras APIs?

  • Consultar información detallada de contratos de suministro
  • Consultar tarifas disponibles por canal para uso en contratación
  • Crear nuevos contratos residenciales C1 con validaciones completas
  • Crear nuevos contratos de empresa C1 para personas jurídicas
  • Cargar y gestionar documentos asociados a contratos
  • Implementar autenticación segura con tokens JWT
  • Utilizar impersonación de canales para operaciones administrativas
  • Integrar webhooks para notificaciones asíncronas

📋 Changelog - Historial de Cambios

NUEVO v1.5 7 de Enero, 2026

Endpoint de Consulta de Tarifas

  • 💰 Nuevo endpoint GET /tarifas: Consulta el listado de tarifas disponibles para tu canal
  • ⚡ Respuesta síncrona: Obtén las tarifas inmediatamente sin callbacks ni esperas
  • 🔐 Soporte de impersonación: Consulta tarifas de otros canales con el header X-Canal
  • 📊 Auditoría completa: Cada petición se registra con request_id único para seguimiento
  • 🎯 Integración con contratos: Usa el id_tarifa en la creación de contratos residenciales y empresariales
  • 📚 Documentación completa: Guía detallada con ejemplos en curl y Python
  • 📖 Especificación OpenAPI: Archivo YAML disponible para generación de clientes
v1.4 25 de Noviembre, 2025

Sistema de Notificaciones de Cambios en Contratos

  • ✨ Notificaciones automáticas: Recibe webhooks cuando un contrato cambia de estado, subestado u otros campos monitorizados
  • 🔒 Sistema de firma unificado: Callbacks de contratación y notificaciones de cambios usan el mismo sistema HMAC-SHA256
  • 📚 Documentación de seguridad centralizada: Una única implementación de validación de firma para todos los webhooks
  • 🎯 Suscripción automática: Incluye url_notificaciones_cambios_contrato al crear un contrato
  • 📊 Auditoría completa: Todas las notificaciones enviadas se registran para trazabilidad
  • 🔄 Sistema de reintentos inteligente: Hasta 10 intentos automáticos cada 30 minutos si tu endpoint falla
  • 🏷️ Metadatos de seguimiento: Cada notificación incluye notification_id y attempt_number para trazabilidad
  • ♻️ Idempotencia facilitada: Los metadatos permiten detectar fácilmente notificaciones duplicadas
  • 📈 Visibilidad total: Sabes en qué intento estás y puedes implementar lógica diferenciada por número de reintento
v1.3 24 de Noviembre, 2025

Contratos Empresa C1

  • 🏢 Nuevo endpoint de contratos empresa C1: Ahora puedes dar de alta contratos para clientes empresariales
  • 📋 Validaciones específicas: Campos adaptados a las necesidades de clientes empresa (CIF, razón social, etc.)
  • 📚 Documentación actualizada: Ejemplos y casos de uso para contratación empresarial
v1.2 Noviembre, 2025

Mejoras en Documentación y API

  • 📚 Documentación completa de proceso de contratación con callbacks
  • 🔑 Guía mejorada de autenticación con ejemplos de impersonación
  • ⚡ Optimizaciones en el flujo asíncrono de alta de contratos
  • 🐛 Correcciones menores en validaciones de datos
v1.0 Octubre, 2025

Lanzamiento API Unificada

  • 🚀 Lanzamiento de la API unificada de contratación
  • 🏠 Endpoint de contratos residenciales C1
  • 📄 Sistema de gestión de documentos
  • 🔐 Autenticación JWT con impersonación de canales
  • 📚 Documentación interactiva OpenAPI