Incidentes de CENACE / ECD

Cuándo usar este documento

Cuando falta información de CENACE: no llegó un ECD, faltan días de energía, o un cálculo depende de datos que no están.

Audiencia

Soporte y operación energética.

Estado documental

• Estado: Borrador
• Última actualización: 2026-08-02
• Owner: Pendiente
• SME requerido: integraciones / operación energética
• Fuente resumida: comandos de sincronización de ECD y verificación de energía.

Antes de diagnosticar: el desfase

La sincronización diaria pide el ECD de hace 5 días, porque CENACE no publica de inmediato.

Antigüedad del ECD faltante	Interpretación
1 a 4 días	Normal. Todavía no le tocaba sincronizarse.
5 a 7 días	Revisar: pudo fallar la tarea o CENACE se retrasó.
Más de 7 días	Anormal. Investigar.

Confundir la fecha de operación con la fecha de ejecución es el error de diagnóstico más común en este dominio.

Síntomas

Síntoma	Ir a
Falta el ECD de una fecha puntual	Un ECD faltante
Faltan ECD de varios días seguidos	Falla sostenida de sincronización
Falta el ECD de una sola subcuenta	Una subcuenta no sincroniza
Los cálculos pass-through dan cero	Energía incompleta
CENACE cambió información ya facturada	Reliquidación

Un ECD faltante

Diagnóstico:

1. Confirmar que la fecha ya debió sincronizarse, según el desfase.
2. Buscar la entrada del día en ecd-sync.log.
3. Revisar queue:failed por trabajos de sincronización fallidos.

Recuperación:

php artisan ecd:sync-store <fecha-operación> <subcuenta>

Es más preciso que reejecutar ecd:sync completo, que reencolaría todo.

Validación: el ECD existe para esa fecha y subcuenta, y los cálculos que dependían de él ya pueden correr.

Falla sostenida de sincronización

Síntoma: faltan varios días consecutivos en todas las subcuentas.

Causas probables, en orden:

1. Credenciales del participante ante CENACE vencidas o rotadas.
2. API de CENACE no disponible.
3. Workers de cola caídos, por lo que nada se descargó.
4. Cron detenido, por lo que la tarea nunca corrió.

Diagnóstico: empezar por lo más barato — cron y workers — antes de sospechar del servicio externo. Ver Diagnóstico de batch, scheduler y bots.

Recuperación: resuelta la causa, recuperar el rango:

php artisan ecd:sync --from=<fecha-inicio> --to=<fecha-fin>

Recuperar un rango largo genera volumen

Encola una petición por día y por subcuenta. Vigilar que los workers den abasto y que la cola no se sature.

Una subcuenta no sincroniza

Síntoma: el resto sincroniza bien; una subcuenta específica no.

Causas probables:

• La subcuenta no está registrada en el sistema.
• Sus credenciales son distintas o están vencidas.
• CENACE no publicó para esa subcuenta ese día.

Diagnóstico: intentar la descarga puntual y leer el error concreto:

php artisan ecd:sync-store <fecha-operación> <subcuenta>

Energía incompleta

Síntoma: los cálculos pass-through dan cero o importes anormalmente bajos.

Diagnóstico:

php artisan passthrough:check-cenace-energy <fecha-inicio> <fecha-fin>

Solo verifica; no escribe datos. Si reporta energía faltante, ese es el problema.

Recuperación:

1. Identificar y recuperar los ECD faltantes con ecd:sync-store.
2. Volver a correr check-cenace-energy hasta que reporte completo.
3. Recalcular los componentes pass-through del periodo.
4. Regenerar los estados de cuenta afectados.

No facturar con energía incompleta

Si check-cenace-energy reporta faltantes, cualquier importe calculado sobre ese periodo será menor al real. Corregir antes de emitir.

Reliquidación

Síntoma: CENACE republica información de un periodo que ya se calculó, y posiblemente ya se facturó.

El sistema distingue liquidación, liquidación en cero y reliquidación, pero no existe un procedimiento documentado para propagar una reliquidación a un periodo ya facturado.

Acción: escalar a desarrollo y facturación antes de recalcular nada. Un recálculo sobre un periodo facturado puede dejar el estado de cuenta y el comprobante fiscal en desacuerdo.

Impacto

Un ECD faltante no se manifiesta como error de ECD. Se manifiesta como:

Efecto	Cuándo aparece
Facturas que no se crearon	Al día siguiente.
Cálculos pass-through en cero	Durante el cierre mensual.
Estados de cuenta con importes bajos	Al revisar el cierre, o cuando reclama el cliente.

Por eso conviene detectarlo en la revisión diaria y no en el cierre.

Evidencia mínima

• Fecha de operación y subcuenta.
• Instancia del participante.
• Resultado de check-cenace-energy para el periodo.
• Fragmento de log sanitizado.
• Acción tomada y resultado.

Riesgos y gaps

• No hay alerta por ECD faltante.
• No hay procedimiento para reliquidaciones posteriores a la facturación.
• No está documentado el catálogo de subcuentas por participante.
• No está documentado el manejo de la cola de ECD faltantes.

Próxima revisión

Al documentar el procedimiento de reliquidación.