Código de Medida

Aclaración dudas técnicas

Resolución CREG 038 de 2014
Todos los derechos reservados para XM S.A. E.S.P.
Agenda

Aspectos Regulatorios

 Especificaciones Funcionales y Técnicas

 Introducción a SOA

 Arquitectura Servicio Reporte Lecturas

 Ejemplo de implementación y consumo

Objetivos

 Presentar los diferentes aspectos técnicos que hasta el

momento se tiene del servicio Web de reporte de lecturas de
contadores definido en la resolución CREG 038 – 2014

Todos los derechos reservados para XM S.A. E.S.P.

 Resolver inquietudes referente a la documentación técnica
expuesta por XM en el portal
http://www.xm.com.co/Pages/Codigo-de-Medida.aspx

 Cumplir con el cronograma del plan de adecuaciones del

código de medida
Código de Medida Resol. CREG 038 de 2014
 La Resolución CREG038 de 2014 Tópicos vigentes desde el 14 de mayo
está vigente desde el 14 de mayo de 2014:
de 2014.  Se retira el envío de lecturas de
 La resolución CREG 038 de 2014 energía reactiva al ASIC.

Todos los derechos reservados para XM S.A. E.S.P.

exige unos requisitos mínimos en los  No se penaliza por superar plazo de
equipos de medida, además de normalización de equipos de medida.
permitir la interrogación a los agentes
Tópicos vigentes desde el 14 de
interesados, y de contar con un
agosto de 2014:
sistema automático de interrogación y
envío de información al ASIC.  Reducción de los plazos regulados
para el envío de información de
 La resolución comprende etapas y lecturas de contadores de fronteras
plazos tanto para los agentes como embebidas sin telemedida
para el ASIC
Tópicos vigentes desde el 14 de mayo
de 2015:
 El CAC establecerá los indicadores de
gestión sobre las funciones asignadas
al ASIC en este Código, previa
consulta con los usuarios, agentes y
terceros interesados.
Código de Medida Resol. CREG 038 de 2014
Tópicos vigentes desde el 14 de mayo
de 2016:

 El reporte de lecturas debe ser

automático y se hará a través de

Todos los derechos reservados para XM S.A. E.S.P.

servicios web entre el centro de
gestión de medidas (CGM) y el ASIC.
 No se permiten cambios de lecturas,
excepto para fronteras reguladas.
 Se reducen los plazos regulados para
el envío de lecturas de contadores –
fronteras de reporte diario
 No se penaliza por no envío de Tópicos vigentes desde el 14 de
lecturas, automáticamente se declara noviembre de 2016:
en falla la frontera por el ASIC.  La primera verificación quinquenal de
 Nuevo envío de lecturas de los sistemas de medición debe
contadores de respaldo al ASIC. realizarse treinta (30) meses después
de la entrada en vigencia de la presente
resolución
ASIC-Código Medida-Res CREG 038 de 2014
Tópicos vigentes desde el 14 de mayo
de 2016:

 El reporte de lecturas debe ser

automático y se hará a través de

Todos los derechos reservados para XM S.A. E.S.P.

servicios web entre el centro de
gestión de medidas (CGM) y el ASIC.
 No se permiten cambios de lecturas,
excepto para fronteras reguladas.
 Se reducen los plazos regulados para
el envío de lecturas de contadores –
fronteras de reporte diario
 No se penaliza por no envío de Tópicos vigentes desde el 14 de
lecturas, automáticamente se declara noviembre de 2016:
en falla la frontera por el ASIC.  La primera verificación quinquenal de
 Nuevo envío de lecturas de los sistemas de medición debe
contadores de respaldo al ASIC. realizarse treinta (30) meses después
de la entrada en vigencia de la presente
resolución
ASIC-Código Medida-Res CREG 038 de 2014
Vigente desde el
14 de mayo de
2014

• Publicación Plan de
adecuaciones para
Sistema de 6 meses

Todos los derechos reservados para XM S.A. E.S.P.

implementación del
gestión de la aplicativo Web
seguridad de la
información Servicio Web para
ISO/IEC 27001 el reporte de
lecturas
• Adecuación Sistemas
12 meses para los RF y reportes de
lectura ASIC

Cancelación 18 meses • Ejecución pruebas piloto

Adecuación fronteras en falla
formatos de por recurrencia o
registro de por superar
fronteras plazos de
normalización
• Corrección y ajustes por
24 meses RF y ASIC
Auditoria
sistemas de
medición
ASIC - Código Medida-Res CREG 038 de 2014

Plan de Adecuaciones - Código de Medida

Actividad Duración Fecha inicio Fecha Final
Entrega de los borradores al CAC del documento con la especificación técnica del servicio Web,
1 día vie 24/10/14 vie 24/10/14
Formatos del reporte de lecturas y plan de adecuaciones

Todos los derechos reservados para XM S.A. E.S.P.

Entrega del documento con la especificación técnica del servicio Web, Formatos del reporte de
1 día vie 14/11/14 vie 14/11/14
lecturas y plan de adecuación
Atención de inquietudes del documento de especificación a los agentes vía correo electrónico o
4 días lun 17/11/14 jue 20/11/14
telefónica.
Realizar implementación del Servicio WEB en XM incluyendo el acuerdo CNO 701 129 días lun 17/11/14 jue 14/05/15
Realizar adecuaciones técnicas para el consumo del servicio Web por los agentes que incluya el
129 días lun 17/11/14 jue 14/05/15
acuerdo CNO 701
Reunión 1 aclaración dudas agentes Medellín 1 día lun 19/01/15 lun 19/01/15
Reunión 2 aclaración dudas agentes Medellín 1 día lun 02/03/15 mar 03/03/15
Adecuaciones DGP 66 días vie 15/05/15 vie 14/08/15
Publicación nuevas funcionalidades adecuaciones DGP 5 días lun 17/08/15 vie 21/08/15
Pruebas Piloto 85 días vie 15/05/15 jue 10/09/15
Preparar pruebas con 3 Agentes y Cenace 5 sem. vie 15/05/15 jue 18/06/15
Capacitación 1 2 sem. vie 19/06/15 jue 02/07/15
Capacitación 2 2 sem. vie 03/07/15 jue 16/07/15
Capacitación 3 2 sem. vie 17/07/15 jue 30/07/15
Apoyo técnico en solución de dificultades de los agentes 5 sem. vie 31/07/15 jue 03/09/15
Incorporar observaciones finales 1 sem vie 04/09/15 jue 10/09/15
Ajustes RF y ASIC 175 días vie 11/09/15 jue 12/05/16
Ajustes RF y ASIC 175 días vie 11/09/15 jue 12/05/16
 SERVICIO WEB - RES 038 - 2014
REPORTE DE LECTURAS CRUDAS
Todos los derechos reservados para XM S.A. E.S.P.
Definiciones Básicas

Submercado : Unidad atómica de Demanda cuyo consumo se calcula como

la sumatoria de las fronteras que entran menos las que salen.

Todos los derechos reservados para XM S.A. E.S.P.

Frt001 Frt003

Submercado
DemSbm = (Frt001 + Frt002) – (Frt003 + Frt004)

Frt002 Frt004

Frontera : Punto donde debe ser medida la energía de intercambio entre dos
Submercados, uno de los cuales es Importador y el otro Exportador.

Frontera
SbmExp SbmImp
Definiciones Básicas

Contador : Equipo de medida asociado a una Frontera. Puede ser

Principal o de Respaldo.

Todos los derechos reservados para XM S.A. E.S.P.

ContadorP
SbmExp SbmImp
ContadorR
Proceso Básico

Interrogación de Contadores
Una vez finaliza el día de Operación, esta
actividad es adelantada por el CGM, dentro de

Todos los derechos reservados para XM S.A. E.S.P.

los plazos regulatorios predefinidos.

Centralización de Lecturas en el CGM

El CGM contará con un repositorio centralizado
para garantizar el almacenamiento histórico de
esta información.

Envío de lecturas al ASIC

Con base en una aplicación propia de cada
CGM, se tomarán las lecturas almacenadas
en el repositorio central, se construirá el
mensaje en el formato requerido por el ASIC y
se invocará el Servicio Web, por medio del
cual se reportarán estas lecturas al ASIC.
Proceso Básico
Recepción del archivo de Lecturas Crudas
Una vez el Servicio Web recibe el
mensaje, le retorna al CGM un mensaje
con un código de control. Este mensaje le

Todos los derechos reservados para XM S.A. E.S.P.

indica a la Aplicación del CGM, que el
archivo fue recibido. El código de control
se podrá utilizar mas tarde para invocar la
retroalimentación respectiva.

Procesamiento y Validación del Archivo

Una vez recibido el Mensaje y de manera
asíncrona, el servicio inicia el proceso de
validación del archivo : Plazo regulatorio,
Estructura, Pertenencia de las Fronteras al
CGM, validación de los datos horarios y
finalmente, validación de rangos de
confianza.
Proceso Básico
Almacenamiento
De acuerdo con las validaciones, alguna
información se acepta y otra se rechaza.
La violación de las Bandas de confianza
no genera rechazo, pero si se identifican

Todos los derechos reservados para XM S.A. E.S.P.

las fronteras que se salen de este rango.

Alimentación del Portal

Con base en la información anterior, se
alimenta un portal en el cual se puede
consultar el estado detallado de la
transacción.
Retroalimentación
Pasados unos segundos (o minutos)
desde la misma aplicación del CGM, se
puede solicitar la retroalimentación del
estado de la transacción, utilizando el
Código de Control en el llamado inicial al
servicio. (Se estima un minuto por cada
1000 contadores procesados).
Portal de Consulta

Acceso al Portal de Consulta Futuro del Portal

 Desde un enlace en la Página Web de Se espera utilizar este mismo

XM, se tendrá acceso al Portal donde Portal para ofrecer a los

Todos los derechos reservados para XM S.A. E.S.P.

se podrá consultar el estado de las usuarios información
últimas transacciones (estimamos que adicional, relacionada con los
es suficiente con información de los cálculos de Demanda,
últimos 7 días). Generación y Pérdidas (Esta
funcionalidad está por fuera del
 Por seguridad, el acceso estará alcance inicial).
restringido a usuarios con clave y cada
uno de estos solo podrá ver la
información de su propiedad.

 La primera información que visualizará

el usuario, será un semáforo por cada
transacción realizada en los últimos
días.
Aspectos Técnicos
Seguridad
• El Servicio contará con los elementos
técnicos de seguridad necesarios, para
garantizar el uso exclusivo por parte de

Todos los derechos reservados para XM S.A. E.S.P.

los usuarios con clave, registrados en
nuestro Directorio Activo. Usabilidad
• El servicio podrá ser invocado desde
cualquier plataforma tecnológica, ya
que en su diseño se tuvo el cuidado de
manejar tipos de datos muy estándar.

Escalabilidad
• En el diseño del servicio se
consideraron aspectos relativos al
manejo de la concurrencia, es decir,
muchos usuarios podrán invocar
simultáneamente el servicio.
Reporte de Lecturas – Servicio Web

C1
1 Servicio Web
XML

Todos los derechos reservados para XM S.A. E.S.P.

CGM SW

2
Cn
1
1

3
BD-XM

PORTAL
4

Auditor
 Arquitectura
Servicio Reporte Lecturas Crudas Contadores
Todos los derechos reservados para XM S.A. E.S.P.
SOA: Arquitectura Orientada a Servicios
Vista Conceptual

GUI
Enterprise Consumidores de
Frontend Servicios
Layer

Process Servicios de
Layer Proceso

Enterprise Service Bus

Orchestration
Layer Servicios
Compuestos

Servicios
Basic Básicos
Layer

BI DWH
OP BL Sistemas

Servicios de Otros Sistemas

Modelo de datos Corporativo
Reportes
SOA - Servicios Básicos

Son servicios que proveen funcionalidad básica de negocio y no tiene

sentido dividirlos en múltiples servicios. Se dividen en servicios
básicos de datos y servicios básicos de lógica.

Todos los derechos reservados para XM S.A. E.S.P.

Servicios Básicos de Datos: Servicios Básicos de Lógica:
leen o escriben datos desde o representan reglas de negocio
en el backend. Generalmente fundamentales. Generalmente
representan operaciones procesan algunos datos de
fundamentales de negocio en entrada y entregan un
el backend resultado.

• La función de estos servicios es la de encapsular (wrap) la

funcionalidad del backend.
• Los servicios básicos sólo deben acceder a un backend.
• Son de ejecución corta y conceptualmente no manejan estado.
• Deben cumplir las propiedades ACID (Atomic - Consistent –
Isolated – Durable)
SOA - Servicios Compuestos

 Representan la primera categoría de servicios que están

compuestos de otros servicios ya sean básicos u otros

Todos los derechos reservados para XM S.A. E.S.P.

servicios compuestos, esto se conoce como orquestación.

 Los servicios compuestos operan a un nivel más alto que los

servicios básicos, pero al igual que estos son de ejecución
corta y conceptualmente no manejan estado.

 Un servicio compuesto puede acceder a varios backends a

través de servicios básicos
SOA – Servicios de Negocio

Son servicios que representan flujos de trabajo o procesos de

negocio de larga duración.

Todos los derechos reservados para XM S.A. E.S.P.

 Desde el punto de vista del negocio, un servicio de proceso
representa un flujo macro, el cual es un flujo de actividades de
larga ejecución que es interrumpible ( normalmente por un
humano).

 Normalmente estos servicios son controlados desde diferentes

Frontends y por ello pueden ser interrumpidos por un humano.

 A diferencia de los tipos de servicio anteriores, un servicio de

proceso, usualmente, tiene un estado que permanece estable
entre múltiples llamadas. Por ejemplo, carrito de compras en
Amazon, cada vez que se agrega un libro los que había pedido
antes permanecen.
Drivers de Arquitectura
Drivers de Negocio

 Este servicio inicia pruebas en Junio de 2015 y queda en

producción en Enero de 2016. A partir de esta fecha debe quedar
estable durante la vigencia del nuevo Código de Medida.

Todos los derechos reservados para XM S.A. E.S.P.

 Automatizar el reporte de las lecturas crudas de los contadores,
minimizar errores de digitación y eliminar en lo posible la
intervención humana en el proceso.

 Validar que las lecturas reportadas sean responsabilidad del Centro

de Gestión de Medidas que las reporta.

 Realizar las validaciones de las estructuras de los datos y la

completitud de los mismos.
Drivers de Negocio

 Validar que los valores numéricos no tengan caracteres especiales

ni valores inferiores a cero.

Todos los derechos reservados para XM S.A. E.S.P.

 Verificar que el reporte de lecturas se realice en los plazos definidos
por la regulación.

 Validar Rangos de confianza

 Los datos generados por el servicio serán utilizados como insumo

por la aplicación encargada de realizar los cálculos de Demanda,
Generación y Pérdidas.
Atributos de Calidad – Restricciones Técnicas

 La arquitectura del sistema debe estar orientada a servicios (SOA).

 El servicio será desarrollado con tecnologías Microsoft,

Todos los derechos reservados para XM S.A. E.S.P.

específicamente con Windows Communication Foundation.

 El servicio que se va construir contará con las siguientes capas:

• Contrato
• Lógica de negocio
• Acceso a datos
Atributos de Calidad – Formatos

Formato para el manejo de fechas: YYYY-MM-DD hh:mm:ss (24h)

Todos los derechos reservados para XM S.A. E.S.P.

Precisión numérica y redondeo:

 Almacenamiento: Solamente se
almacenarán dos cifras decimales.
 Cálculos: El resultado de los cálculos se
redondea por encima a dos decimales.
 Presentación de información al
usuario: Siempre se muestra con dos
decimales.
 Información intercambiada con otros
sistemas: Se trabaja con dos decimales.
Atributos de Calidad - Alertas

Se debe definir cual es la desviación

Todos los derechos reservados para XM S.A. E.S.P.

permitida entre la lectura del contador
principal y el contador de respaldo.

No-repudio: Se previene la negación

de la autoría de una acción que tuvo
lugar o reclamar la autoría de una
acción que no se llevó a cabo. ¿Están
en capacidad de utilizar Firmas
Digitales todos los CGM?

Common Information Model - CIM

Atributos de Calidad - Performance

Latencia: El tiempo que tarde el

servicio en procesar una solicitud debe

Todos los derechos reservados para XM S.A. E.S.P.

ser inferior a 1 minuto por cada 1000
fronteras (24.000 Registros).

Escalabilidad: El sistema deberá estar

en la capacidad de mantener su
correcta funcionalidad incluso con una
tasa acelerada de crecimiento en la
información mensual.

Se estima una ejecución de 150 a 200

veces por día.
Atributos de Calidad - Fiabilidad

La disponibilidad del sistema debe ser

7x24 los 365 días del año.

Todos los derechos reservados para XM S.A. E.S.P.

El sistema deberá mantener la
integridad de la información ante fallas

Los datos reportados por un centro de

recolección solo deben estar disponibles
para ese centro de recolección.

El servicio deberá ser desplegado en una

plataforma que cuente con esquemas de
balanceo de cargas y replicación.
Atributos de Calidad - Seguridad

 HTTPS

Todos los derechos reservados para XM S.A. E.S.P.

 Autenticación y
Autorización

 Directorio Activo

 Auditoría, Monitoreo y
Administración
Atributos de Calidad - Interoperabilidad

Se debe garantizar la utilización de

estándares abiertos y se deben
construir ejemplos para el consumo de

Todos los derechos reservados para XM S.A. E.S.P.

los servicios en java y en .Net.

La estrategia de interoperabilidad se
basará en la utilización de los
estándares proporcionados por la
W3C y por WS-I de Oasis.

Se debe garantizar que la

infraestructura sobre la que esté
desplegado el servicio se encuentre
en capacidad de recibir peticiones
desde otro tipo de plataformas.
Diseño
 Diagrama de procesos

Todos los derechos reservados para XM S.A. E.S.P.

Mensajes

Con base en las entidades de negocio identificadas se deben

construir los mensajes XML que se utilizaran para el intercambio

Todos los derechos reservados para XM S.A. E.S.P.

de información.

MsgIn : Mensaje de entrada con las Lecturas de Contadores

Entidad Atributo Tipo

Encabezado Código CGM Texto (CgmXXXX)
Fecha de Operación Date (yyyy-mm-dd)
Cuerpo Código Frontera Text0 (FrtXXXXX)
Tipo Contador Char (P – R)
Acumulativo Bool
Periodo Int
Valor * 25 int
Mensajes
Con base en las entidades de negocio identificadas se deben
construir los mensajes XML que se utilizaran para el intercambio de
información.

Todos los derechos reservados para XM S.A. E.S.P.

MsgIn : Mensaje de entrada con las Lecturas de Contadores

Entidad Atributo Tipo

Encabezado Código CGM Texto (CgmXXXX)
Fecha de Operación Date (yyyy-mm-dd)
Cuerpo Código Frontera Text0 (FrtXXXXX)
Tipo Contador Char (P – R)
Acumulativo Bool
Periodo Int
Valor * 25 int

MsgOut : Mensaje de salida que indica el recibo del mensaje anterior y

retorna el código de la transacción.

Entidad Atributo Tipo

TransaccionID Identificador Texto (TXXXXXX)
Transacción
Operaciones

Se deben construir los contratos de los servicios que utilizaran para el

intercambio de información:

Todos los derechos reservados para XM S.A. E.S.P.

Acuerdos de Niveles de Servicio

 Se deben definir los ANS para las diferentes categorías de servicios

que se implementen. Es importante resaltar que estos ANS deben
tener en cuenta factores como el volumen de datos que debe ser

Todos los derechos reservados para XM S.A. E.S.P.

transferido y la criticidad de las operaciones para los que son
requeridos.

 La definición y validación de los ANS es una tarea conjunta de las

áreas de procesos y técnica.
Excepciones

Excepciones Técnicas
 ET001: El servicio no se encuentra disponible
 ET002: Se presentaron problemas en la comunicación con el servicio
 ET003: La base de datos no se encuentra disponible

Todos los derechos reservados para XM S.A. E.S.P.

 ET004: Se presentaron inconsistencias en la ejecución de la transacción
 ET005: El mensaje excede el máximo tamaño permitido
 ET006: No está autenticado para consumir el servicio
 ET007: No está autorizado para consumir el servicio

Excepciones de Negocio
 EN001: El archivo de lecturas no cumple con el formato y la estructura establecida
 EN002: La frontera no pertenece al centro de gestión de medidas
 EN003: El reporte de las lecturas no se encuentra dentro del plazo regulatorio
 EN004: El valor de la energía no se encuentra dentro de las bandas de confianza
 EN005: El valor horario de la lectura es negativo
 EN006: Se presentaron inconsistencias. Para ver detalle consulte el portal.
WSDL

Se deben construir los WSDL con los conjuntos de operaciones que

podrán solicitarse a los servicios, los tipos de respuestas que
retornaran estas operaciones y los mensajes que se utilizaran para

Todos los derechos reservados para XM S.A. E.S.P.

la invocación de las mismas.
 Vista Lógica

Todos los derechos reservados para XM S.A. E.S.P.

Tecnologías

 Sistemas Operativos: Windows Server 2008.

 Portal: Microsoft SharePoint Server 2010.

Todos los derechos reservados para XM S.A. E.S.P.

 Servidor de aplicaciones: Internet Information
Server 7.0 o superior

 Servidor base de datos: Microsoft SQL Server

2008 R2 o superior.

 Microsoft .Net Framework: 4.0 o superior.

Microsoft Enterprise Library 4.0 o superior.

 Servidor de reportes: Microsoft SQL Server

Reporting Services 2008 R2

 Clientes: Diversos
Pruebas

 XM pondrá a disposición de los Agentes un ambiente de pruebas

independiente del ambiente productivo.

Todos los derechos reservados para XM S.A. E.S.P.

 De todas maneras como lo plantea la resolución, tendremos el
segundo semestre de 2015 para realizar pruebas conjuntas con
todos los Agentes y de éstas podrían resultar algunos ajustes
finales.