Skip to content

Validación — Integraciones externas

Uso interno. No exponer como material para stakeholders.

Estado

  • Última actualización: 2026-08-02
  • Owner: Desarrollo / documentación

Contradicción resuelta

La versión anterior listaba Supabase Auth, Supabase Postgres y Supabase Storage como integraciones de sy-energy. No lo son. Ver el detalle en Validación — Arquitectura y tecnologías.

Las integraciones reales, verificadas contra código, son: API de CENACE, portal SIM vía bots, Factura.com, MEM, CFE TX, servicio de demanda y AWS (SQS, S3, Systems Manager).

Gaps abiertos

GapDetalleQuién lo cierra
Colas por botFalta confirmar qué cola concreta conecta sy-energy con cada bot del SIM en producción.DevOps
DLQ y reintentosNo está documentado si hay colas de mensajes muertos ni la política de reintentos por integración.Desarrollo
Origen de precios MEMFalta confirmar si sy-energy lee la base del MEM directamente o consume la API de mem-api.Desarrollo
Credenciales de CENACENo está documentado su vencimiento, rotación ni quién las administra.Infraestructura
Contingencia de timbradoProveedor único sin alternativa. Falta decidir plan si falla durante un cierre.Facturación / Desarrollo
MonitoreoNo hay monitoreo de disponibilidad; las fallas se detectan por sus efectos.Infraestructura
OwnersFalta definir owner técnico por integración.Liderazgo técnico

Riesgos identificados

  • Fragilidad del SIM. La operación con CENACE depende de navegar un portal web con bots. Cualquier cambio de interfaz los rompe sin aviso previo y sin alternativa documentada.
  • Punto único de falla en timbrado. Sin proveedor alterno, una caída de Factura.com durante el día 1 o el día 4 detiene la facturación.
  • Fallas silenciosas de cola. Los comandos que despachan reportan éxito aunque ningún worker procese. Es la causa más frecuente de diagnósticos equivocados.