Centros de carga
Objetivo
Documentar la entidad central del sistema: el punto donde se consume la energía y alrededor del cual gira todo lo demás.
Responsabilidad del módulo
Administrar los centros de carga, sus identificadores y su relación con clientes, contratos, demanda y facturación.
Audiencia
Operación, soporte y desarrollo interno.
Estado documental
- Estado: Borrador
- Última actualización: 2026-08-02
- Owner: Pendiente
- SME requerido: operaciones / energía
- Fuente resumida: modelo de centros de carga, consultas de contratos activos y comandos que operan por RMU.
Por qué es la entidad central
Casi todo el sistema se organiza por centro de carga:
- la demanda se mide por centro de carga;
- el contrato se firma por centro de carga;
- los cálculos pass-through se ejecutan por centro de carga y fecha;
- el estado de cuenta se genera por centro de carga y mes;
- la factura deriva del estado de cuenta.
Por eso el RMU es el parámetro de casi todos los comandos operativos.
Identificadores
| Identificador | Qué es | Dónde se usa |
|---|---|---|
| RMU | Identificador operativo del centro de carga. | Parámetro --rmu de la mayoría de los comandos. |
| RPU | Registro permanente del usuario, vincula con la información de CFE. | Mapeo de demanda. |
| Element key | Clave de elemento en los documentos de CENACE. | Cálculos por ECD. |
Un centro de carga mal identificado no produce error: produce datos asignados al cliente equivocado.
Relaciones
Cliente
└── Centro de carga (RMU)
├── Contrato (tipo de producto + vigencia)
├── Demanda (5 min / horaria / mensual)
├── Cálculos pass-through (por fecha de operación)
└── Estado de cuenta (mensual) → FacturaContratos
La relación entre centro de carga y contrato tiene una regla estricta:
Exactamente un contrato activo
Para generar el estado de cuenta de un periodo debe haber un solo contrato activo. Con cero, o con más de uno, la generación falla para ese centro de carga y notifica al administrador.
Ocurre típicamente cuando se renueva un contrato y las vigencias se traslapan un día, o cuando el contrato nuevo empieza antes de que termine el anterior.
El tipo de producto del contrato (fixed, fixed-with-energy-loss, pass-through) determina cómo se calcula el importe. Ver Billing.
Comandos relacionados
| Comando | Uso |
|---|---|
contracts:active --date= | Exporta a CSV los contratos activos en una fecha. Es la evidencia previa a un cierre. |
file:statement-account --rmu= --year= --month= | Estado de cuenta de un centro de carga. |
calculate:by-passthrough --rmu= --year= --month= | Cálculo integral del mes. |
passthrough:* con --rmu= | Componentes de costo por fecha de operación. |
demand:* con --rmu= | Correcciones de demanda. |
calculate:by-charge-center --slug=year-capacity --year= | Capacidad anual por centro de carga. |
Los comandos de despacho (dispatch:by-charge-center) omiten --rmu para procesar todos los centros de carga. Es cómodo y también riesgoso: multiplica el volumen por el número de centros.
Alta de un centro de carga
Pendiente de documentar con operación. Los puntos a cubrir:
- datos mínimos requeridos;
- asignación de RMU y RPU;
- vinculación con cliente y participante;
- creación del contrato y su vigencia;
- verificación de que la demanda empieza a llegar.
Errores comunes
| Síntoma | Causa probable |
|---|---|
| El centro de carga no genera estado de cuenta | Cero o más de un contrato activo en el periodo. |
| La demanda se asigna al centro equivocado | Mapeo incorrecto de RPU. |
| Un centro nuevo no aparece en los cálculos | Falta contrato vigente, o el alta quedó incompleta. |
| Los comandos por RMU responden "no encontrado" | RMU mal escrito, o se está trabajando en la instancia de otro participante. |
Evidencia esperada
- CSV de contratos activos del periodo.
- Demanda presente para el centro de carga en el periodo.
- Estado de cuenta generado.
Riesgos y gaps
- No está documentado el procedimiento de alta y baja de un centro de carga.
- No hay validación previa que detecte traslapes de vigencia de contratos antes del cierre.
- No está documentada la trazabilidad de cambios en el mapeo de RPU.
- Falta documentar el modelo de datos y sus relaciones a nivel de tablas.
Próxima revisión
Al documentar el modelo de datos.