Home › Data Exchange

Data Exchange

Cómo se relaciona el proceso de Data Exchange con los procesos de su empresa 

BEACON modela digitalmente los servicios de agua creando registros en la base de datos que vinculan o aprovisionan una cuenta, una ubicación y un punto de servicio con la tecnología de medición instalada allí, normalmente un medidor y, si corresponde, una terminal de infraestructura de medición avanzada (AMI) o de lectura de medidor automatizada (AMR) para capturar y transmitir datos de uso y operativos.

Para realizar este modelado, utilizamos archivos de valores separados por comas (CSV) para transmitir información desde sus sistemas de facturación y otros sistemas de información a BEACON. Estos archivos CSV son hojas de cálculo de solo texto en las que cada columna identifica el tipo de información y cada fila contiene los datos correspondientes para un registro o servicio individual.

Esta estructura le permite configurar, actualizar y revisar información a gran escala. Ya sea que necesite actualizar un solo servicio o muchos, el proceso de Data Exchange respalda sus procesos comerciales diarios, desde la facturación a clientes hasta mudanzas residenciales y comerciales, cambios de medidores y terminales, y monitoreo de consumo.

Especificación de Data Exchange 

El término «Especificación de Data Exchange» se refiere a una familia de especificaciones que definen nombres de columnas precisos, límites de caracteres y reglas de formato para importar, sincronizar y actualizar datos de servicios públicos en BEACON. Puede descargar aquí una versión de la Especificación de Data Exchange.

La Especificación de Data Exchange incluye campos para recopilar y mantener información relacionada con lo siguiente:

Cuentas: ID, nombre del titular de la cuenta e información de contacto, dirección de facturación, entre otros.

Ubicaciones: ID, dirección del punto de servicio, datos de geolocalización del medidor/punto de servicio y otros detalles sobre la ubicación, como el número de ocupantes, los valores de evapotranspiración, si la ubicación tiene una piscina, etc.

Puntos de servicio: ID que se usa para distinguir múltiples conexiones en una sola ubicación (por ejemplo, un punto de servicio con un medidor de agua potable y un medidor diferente para riego), datos de geolocalización (utilizados para mayor precisión cuando hay más de un punto de servicio en una única ubicación), número de ruta, etc.

Medidores: Número de serie, fabricante, modelo, tamaño, etiqueta de flujo continuo/flujo intermitente esperado, unidad de medida, resolución, fecha de instalación, fecha de eliminación, etc.

Acuerdos de servicio: ID, fechas de inicio y finalización del servicio.

Configuraciones de terminales: Número de serie, tipo, fecha de instalación y fecha de eliminación.

AMR y lecturas manuales: Secuencia de lectura, códigos de alerta y límites de lectura altos/bajos para medidores.

BEACON utiliza distintos tipos de archivos de Data Exchange, cada uno con su propia estructura definida, y detecta automáticamente el tipo de archivo según las columnas presentes en un archivo determinado.

Archivos de cuentas y activos: este es el tipo de archivo que usará con mayor frecuencia; estos archivos se utilizan para configurar nuevas cuentas, aprovisionar y cambiar medidores y terminales, transferir etiquetas y otros datos esenciales desde sus sistemas de facturación e información a BEACON. Consulte Terminología para obtener un desglose completo de los campos disponibles en este tipo de archivo de Data Exchange.

Archivos de actualización de ID: utilice este tipo de archivo cuando cambie de proveedor de facturación y desee actualizar o cambiar los ID de su cuenta, ubicación, punto de servicio y medidor. Los archivos de actualización de ID realizan una búsqueda y reemplazo global de los campos clave, evitando los llamados servicios huérfanos que resultan de pasar incorrectamente nuevos ID a BEACON sin cambiar los ID antiguos. Consulte Actualizar ID para obtener más detalles. 

Lecturas del medidores de intervalo: estos archivos le permiten importar lecturas de intervalos recopiladas con soluciones de AMR y AMI de Badger Meter y de otros proveedores. Para obtener más información, consulte Importar lecturas del medidor de intervalo.

Lecturas de medidor de facturación: use este tipo de archivo para importar lecturas de facturación actuales e históricas. Para una mejor comprensión, consulte Importar lecturas de medidor de facturación. 

Exportaciones de lecturas de facturación: estos archivos definen la salida de lecturas de facturación de BEACON. Consulte la Especificación de Exportación de lecturas de facturación para obtener más información. NOTA: Recomendamos encarecidamente trabajar con nuestro equipo de Servicios de Software al configurar sus archivos de exportación de lecturas de facturación.

Archivos de exportación configurados: utilizados para sistemas de facturación que no pueden manejar archivos de facturación en formato CSV, nuestro equipo de Servicios de Software le ayudará a configurar sus archivos de exportación en formato C o formato D para que se alineen con su software de facturación.


Advertencias y excepciones

Independientemente del tipo de archivo, BEACON devuelve errores y advertencias cuando encuentra problemas con las importaciones de archivos. Para garantizar un intercambio de datos preciso, revise el Informe de excepciones creado durante el proceso de importación para solucionar problemas y corregir archivos antes de continuar con la importación. Consulte las Preguntas frecuentes sobre errores de Data Exchange y las Preguntas frecuentes sobre advertencias de Data Exchange para obtener información clave sobre cómo manejar excepciones. Tenga en cuenta que los errores impiden el procesamiento de un archivo o un registro específico en un archivo.

Considere las advertencias como notificaciones que le informan sobre una acción inminente. Si esa acción es la que desea realizar, puede continuar con la importación de forma segura. Si la acción no fue la que usted pretendía, puede realizar los cambios correspondientes antes de continuar. 


Procesar con cuidado 

Antes de procesar el primer archivo CSV, lea Archivos CSV y Excel y siga las instrucciones para preservar la fidelidad de los datos. 

Información esencial

Tamaño mínimo del archivo de importación: Los archivos de importación pueden ser tan pequeños como de dos filas: una para los nombres de las columnas (también conocidos como encabezados de columna) y una segunda fila para los datos asociados a cada columna en el archivo.

Tamaño máximo del archivo de importación: 70 MB. 

Tamaño máximo del archivo de exportación: Se puede devolver un máximo de 1 048 576 registros (1 024*1 024) en una sola operación de exportación.

Delimitadores: BEACON admite los siguientes delimitadores en orden de precedencia: comas, tabulaciones, punto y coma, dos puntos, barras verticales, tildes. 

Extensiones de archivo admitidas: .csv, .txt, .dat y .a. También deberían funcionar otros formatos que no transmiten información con formato de texto en el archivo.

 

Campos mínimos
Los campos mínimos requeridos para realizar varias operaciones en BEACON dependen de si está configurando, también llamado aprovisionamiento, un servicio por primera vez o actualizando un servicio existente.  

Para aprovisionar un servicio, es decir, asociar una cuenta y una ubicación y su(s) punto(s) de servicio con un medidor y, si corresponde, una terminal de AMI o de AMR, por primera vez, debe importar como mínimo estos campos:

Account_ID, Location_ID, Meter_ID, Endpoint_SN y Endpoint_Point_Type, junto con Meter_Size, Register_Unit_of_Measure y Register_Resolution. Consulte Terminología para obtener descripciones detalladas de estos y todos los demás campos en la Especificación de Data Exchange de cuentas y activos.

Si el servicio ya existe o si anteriormente aprovisionó una terminal de AMI o de AMR en particular, BEACON recordará su Endpoint_Type. De manera similar, BEACON recuerda Meter_Size, Register_Unit_of_Measure y Register_Resolution cuando el medidor ha sido aprovisionado previamente. 

Si es posible, proporcione las fechas en sus archivos. Es decir, Service_Agreement_Start_Date, Meter_Install_Date, Endpoint_Install_Date y, si corresponde, Service_Agreement_End_Date, Meter_Removal_Date y Endpoint_Removal_Date. Si su sistema de facturación no le permite proporcionar fechas, BEACON utilizará fechas predeterminadas. Para conocer más detalles, consulte Terminología.

Los campos mínimos requeridos varían según los datos que usted cargue. Por ejemplo, lecturas de facturación, lecturas del medidor de intervalo y otras operaciones. Encontrará los requisitos para cada operación en las páginas de Ayuda que corresponden a esas Especificaciones de intercambio de Data Exchange. 

Mejores prácticas de importación
Las empresas de servicios públicos con menos de 10 000 servicios pueden sentirse seguras al cargar los registros de todos sus servicios en un solo archivo de intercambio de datos.

Carga de deltas: para empresas de servicios públicos de todos los tamaños, se recomiendan archivos de intercambio de datos que contengan solo los registros de servicios que hayan tenido cambios recientes (deltas), como cambios de medidor y de terminal, cambios en el estado de la cuenta, entre otros.

Algunas empresas de servicios públicos cargan deltas durante la semana y cargan registros de todos sus servicios periódicamente, por ejemplo, una vez al mes o una vez a la semana. Esto ayuda a garantizar que se actualicen las cuentas y servicios nuevos o modificados que se omitieron accidentalmente en el proceso de actualización. 

Al cambiar de proveedor de facturación, siempre utilice archivos de actualización de ID para actualizar los ID de cuenta, los ID de ubicación, los ID de punto de servicio y los ID de medidor. Realizar estos cambios sin utilizar un archivo de actualización de ID puede, y de hecho lo hace, romper el vínculo entre los correos electrónicos de los clientes y el ID de cuenta que permite a sus clientes acceder al portal web y a las aplicaciones móviles de EyeOnWater. 

Data Exchange en profundidad
Las siguientes secciones del Centro de Integración de BEACON le ayudarán a sincronizar sus sistemas CIS y de facturación con BEACON utilizando archivos de Data Exchange. 

 

 

Knowledge Base

 

 

Knowledge Base Archive

User Guide
Follow via Email

Enter your email address to get new content notifications by email.