Saltar a contenido

Carga de curvas horarias

En este documento se documentará el procedimiento necesario a seguir para tener configurado el ERP para cargar periódicamente todos los documentos con curvas horárias

Funcionamiento

Esta funcionalidad nos permite descargar de los portales de las distribuidoras las curvas CCH generadas para los contratos integrados en el sistema de telegestión y de los integrados en el sistema de telemedida. Este servicio se debe ofrecer a través del protocolo SFTP (FTP por SSH). Se pueden descargar los distintos tipos de curva definidos por la CNMC:

  • CCH_FACT: Curva utilizada para facturar.Se distribuye en el formato F5D y no puede contener agujeros. El formato RF5D és idéntico al format F5D y se utiliza para las curvas de las facturas rectificadas
  • CCH_VAL: Curva validada. Sólo incluye aquellos registros horarios que el contador ha dado por válido y se distribuye en el formato P5D. Puede no estar completa y por lo tanto no es utilizable para facturar mediante curva
  • CCH_CONS: Curva facturada (CCH_FACT) en formato CCH_CONS preparada para ser distribuirda al consumidor
  • TG_F1: Curva utilizada para facturar. Se distribuye en el formato F1 y no puede contener agujeros.
  • TG_P1: Curva validada. Sólo incluye aquellos registros horarios que el contador ha dado por válidos y se distribuye en el formato P1. Es posible que no este completa por lo tanto, no es utilizable para facturar mediante curva

Las curvas de almacenan en el servidor mongodb, cada una en una colección diferente, y son accesibles desde el ERP a través del contador.

El sistema de configura de la siguiente forma:

  • Servidores SFTP: Servidores SFTP definidos por las distribuidoras. En algunos casos, las distribuidoras se agrupan y utilizan un solo servidor compartido
  • Proveedores: Cada proveedor referencia un servicio SFTP concreto y define qué archivos de los disponibles se quiere descargar. Se registra la fecha del último archivo descargado para poder llevar el control de los ficheros ya descargados.

Configuración del cliente ERP

Instalación del módulo

Necesitamos el módulo llamado "giscedata_telegestio_comer" para llevar a cabo esta tarea. Para comprobar si el módulo está instalado o instalarlonos debemos dirigir a Administración> Administración de módulos> Módulos. Aquí buscaremos el módulo y lo instalaremos si es necesario.

configurar conexiones SFTP

Con el fin de que el ERP sepa dónde ir a buscar los archivos de curvas debemos crear registros que se lo indiquen. Yendo a Infraestructura > Telegestión comer > Config > SFTP Connections podremos crear entradas para cada sftp de cada distribuidora que nos interese. Tendremos que indicar:

  • Descripción: Nombre descriptivo del servidor.
  • Servidor: Dirección del servidor SFTP
  • Puerto: Puerto en el cual está escuchando el servidor
  • Usuario: Usuario de acceso suministrado por la Distribuidora
  • Password: Palabra clave de acceso al servidor

En algunos casos, puede ser necesario utilitzar claves privadas para acceder a los servidores tal como permite el protocolo SSH y por extensión SFTP.

  • Binario de la clave Privada: Clave privada utilizada para el intercambio de claves
  • Password de la clave privada: Si se da el caso, password de la clave privada

Los campos directorio raíz y el directorio de lectura no se utilizan por el momento

Configuración SFTP

Confirmar proveedores

En este paso debemos crear registros nuevos para todas las empresas distribuidoras de las que recibimos curvas horarias. Para ello vamos a Infraestructura > Telegestión comer > Config > Proveedor TG de Comercializadora y creamos los nuevos registros

La configuración se realiza de la siguiente forma:

  • Descripción: Descripción del proveedor
  • Habilitado: Especifica si este proveedor está habilitado. Sólo se descargan sus archivos si el proveedor está habilitado
  • Utilidad: Dsitribuidor para el que se descargan ficheros
  • Utility sftp service: Configuració SFTP utilitzada de les configurades en el punt anterior

Por cada tipo de archivo a descargar se deben definir varios parámetros. Los más delicados son el nombre de los archivos y la fecha de acceso.

Para cada apartado:

  • Habilitado: Habilita este tipo de ficheros
  • File syntax : Formato de archivo (ver Formato del nombre de archivo)
  • Remote Folder: Directorio donde empieza la búsqueda recursiva. Per defecto la raíz del servidor SFTP (/)
  • Acces date: Fecha del fichero descargado más reciente

Se definen 6 apartados:

  • F5D Settings: Ficheros CCH_FACT en formato F5D.
  • P5D Settings: Ficheros CCH_VAL en formato P5D.
  • CCHCONS Settings: Ficheros CCH_CONS en formato CCH_CONS.
  • RF5D Settings: Sobreescriven las curvas CCH_FACT
  • F1 Settings: Ficheros TG_F1 en formato F1.
  • P1 Settings: Ficheros TG_P1 en formato P1.

La descarga se automatizará mediante un cron o tarea programada del servidor, normalmente una vez al día. Cada vez se descargarán los archivos de los apartados "habilitados" de todos los proveedores "habilitados" que tengan el formato definido.

Los archivos se almacenan localmente en el servidor para su posterior proceso en la dirección definida por la variable de configuración tg_comer_cch_dir tal como se comenta aquí

Configuración Proveedor

Nombre de los ficheros de Curvas

Los ficheros de curvas tienen un nombre definido por la CNMC. El sistema de descarga de curvas utiliza expresiones regulares para decidir qué archivos se descarga y en qué colección los almacena.

El formato definido puede variar según el fichero.

  • Ficheros F5D, P5D y RF5D: El formato es Z5D_YYYY_XXXX_aaaammdd.v. La Z se debe sustituir por el tipo de fichero F, P o RF. Las YYYY se deben sustituir por el código de distribuidora (código REE). Las XXXX se deben de sustituir por el código de comercializadora (código REE). La aaaammdd se debe sustituir por la fecha de generación del fichero. La v se debe sustituir por la versión del fichero.

  • Ficheros F1 y P1: El formato es Z1_YYYY_AAAAMMDD_aaaammdd.v. La Z se debe sustituir por el tipo de fichero F o P. Las YYYY se deben sustituir por el código de distribuidora (código REE). La AAAAMMDD se debe sustituir por la fecha a la que corresponden los datos que contiene el fichero. La aaaammdd se debe sustituir por la fecha de generación del fichero. La v se debe sustituir por la versión del fichero.

Expresión del formato de fichero

El sistema hará una búsqueda recursiva en el servidor SFTP buscando los ficheros que cumplan con el formato especificado. Para especificar un formato de fichero genérico que permita al sistema encontrar todos los ficheros correctos, se puede utilizar una expresión regular.

Por ejemplo:

F5D_0999_0888_(\d{8})

Con este formato el sistema encontrará todos los ficheros F5D de nuestra distribuidora de ejemplo 0999 y de la comercializadora especifica 0888 sin filtrar por fechas, tan solo necesitará 8 caracteres numéricos después del último guión bajo. Como no especificamos nada para la versión del fichero que queremos las cogerá todas.

Consejo

En un servidor SFTP compartido, se pueden utilizar las expresiones regulares para descargar los archivos de todas las distribuidoras con una sola configuración de proveedor. Por ejemplo:

P5D_(\d{4})_0888_(\d{8})

En este caso se descargarán todos los archivos P5D de nuestra comercializadora (0888) independientemente de la distribuidora, que siempre será un código de cuatro caracteres numéricos (\d{4})

Fecha de descarga

Es una fecha puramente informativa para saber cuando fue la última vez que se leyó el contenido del servidor SFTP.

Creación de nueva variable de configuración

Tenemos que crear una nueva variable de configuración llamada tg_comer_cch_dir con la ruta donde queremos que se guarden los archivos descargados de los servidores sftp. Administración > Configuración > Propiedades > Variables de configuración

Atención

Los ficheros descargados no se borrarán