La Especificación de la exportación de lecturas de facturación describe las columnas y las filas que contiene la salida de lectura de facturación de BEACON. Cuando las lecturas de facturación se exportan mediante el menú desplegable Actions (Acciones) en la página Monitor, se crea un archivo de hoja de cálculo en formato CSV. Estos archivos de exportación de lectura de facturación siempre incluyen el identificador (ID) de cuenta, ID de ubicación, ID de punto de servicio, ID de medidor, ID de terminal y los códigos de manipulación, junto con los datos leídos y los tiempos de lectura de hasta 100,000 medidores por exportación. Utilice los filtros para seleccionar los registros que se incluirán en una exportación de datos. Si se seleccionan más de 100,000 registros, solo se exportarán los primeros 100,000 registros.
Al utilizar la interfaz de programación de aplicaciones (Application Programming Interface, API) del Export Data Service de BEACON para realizar llamadas de lectura de facturación, utilice los filtros de ciclo, ruta y distrito a fin de programar exportaciones de hasta 100,000 registros.
La siguiente tabla describe el contenido del archivo de exportación de lecturas de facturación:
Nombre de columna | Longitud máxima | Formato | Descripción |
Account_ID | 32 | Texto | Identificador de la cuenta utilizado para fines de facturación. |
Location_ID | 40 | Texto | Identificador único de la ubicación donde se brinda el servicio. |
Service_Point_ID | 40 | Texto | Un identificador que se usa para distinguir entre múltiples conexiones de servicio en la misma ubicación. La combinación de ID de ubicación e ID de punto de servicio representa un único punto al que se debe conectar un medidor. |
Meter_ID | 24 | Texto | Identificador del medidor. Debe ser único y es obligatorio. |
Register_Number | 1 | Texto, L, 0, H, 2 o en blanco | El número de registro se utiliza para identificar si un medidor es simple o compuesto. |
Endpoint_SN | 20 | Texto | Número de serie de la terminal vinculada con el medidor especificado |
Read_Method | 7 | Texto | Una palabra que indica cómo se obtuvo la lectura del medidor, ya sea lectura de medidor automatizada (Automatic Meter Reading, AMR), fijo, manual, red o n/a. |
Lectura | 9 | Número | La lectura actual del medidor disponible dentro del periodo solicitado cuando el archivo se envió a BEACON. | Read_Unit | 8 | Texto | Unidad en la que mide el medidor. (GAL, CUBIC_FEET, CUBIC_METER, LITER, AF, OIL_BARREL, FLUID_BARREL) | Billing_Read | 9 | Número | La lectura actual del medidor establecida en la resolución esperada de la facturación. |
Billing_Read_Unit | 12 | Texto | Las unidades utilizadas para la lectura de facturación. Este valor se establece mediante los menús desplegables en Assets>Utility Settings>Billing Units (Activos>Configuración de la empresa de servicios públicos>Unidades de facturación). Una opción, ya sea: GAL, CUBIC_FEET, CF, CCF, KGAL, CUBIC_METER, LITER, IMP, AF, OIL_BARREL, FLUID_BARREL. |
Encoder_Read | 9 | Número | Lectura bruta de un medidor antes de aplicar la resolución de registro o resolución de facturación. |
Read_Time | 22 | AAAA-MM-DD hh:mm:ss | Fecha y hora de la lectura actual. (2014-09-10 10:39:41) |
Service_Point_Timezone | 64 | EE. UU./Pacífico, etc. | Nombre de la zona horaria donde se encuentra el servicio o medidor.
Para obtener una lista de nombres de zonas horarias, consulte: wikipedia.org/wiki/ Si no se proporciona la zona horaria, se utilizará la zona horaria asociada con la empresa de servicios públicos especificada a través de BEACON. |
Tamper_Code | 7 | Texto | Un código en AMR lee desde las terminales ORION CE, ORION ME y ORION SE que representa excepciones en las terminales como: Manipulación de terminal (T), Flujo inverso (R), Fuga (L), Error de comunicación de terminal/Alerta de dispositivo (D), Terminal sin uso (U), Terminal sin tapa (C), Tubería del medidor vacía (P), Batería baja en la terminal (A), Flujo inverso de la terminal (R), Terminal programada (O). |
Cómo mapear la exportación de lecturas de facturación
Utilice esta tabla para crear una hoja de cálculo para mapear los campos de la exportación de lecturas de facturación a los campos correspondientes en su sistema de facturación o sistema de información de clientes (Customer Information System, CIS). Si un determinado campo de BEACON no se puede mapear, márquelo como N/A e incluya las razones en esta hoja de cálculo.
Descripción del llenado de las lecturas de facturación | Nombre del campo del CIS del cliente | Descripción del campo del CIS del cliente |
Account_ID | ||
Location_ID | ||
Service_Point_ID | ||
Meter_ID | ||
Register_Number | ||
Endpoint_SN | ||
Read_Method | ||
Billing_Read | ||
Billing_Read_Unit | ||
Encoder_Read | ||
Read_Time | ||
Service_Point_Timezone | ||
Tamper_Code |
Antes, la columna Read se denominaba Current_Read, Billing_Read_Unit se denominaba Current_Read_Units y Read_Time se denominaba Current_Read_Time. Encoder_Read y Service_Point_Timezone son adiciones al archivo de salida.
Última actualización | ¿Qué cambió? | Lo que debe hacer |
29 de marzo de 2018 | Se actualizó el campo Read_Method para reflejar el contenido actual del archivo de exportación. | Si lo desea, revise los nombres de las columnas e incorpore Read_Method en su interfaz. |
29 de septiembre de 2017 | Se actualizaron los nombres de columna para reflejar el contenido actual del archivo de exportación. | Mapee los campos de lecturas de exportación de facturación a los campos en sus base de datos del CIS. Si lo desea, revise los nombres de las columnas e incorpore Encoder_Read y Service_Point_Timezone en su interfaz. |
29 de febrero de 2016 | Primera publicación | Mapee los campos de lecturas de exportación de facturación a los campos en sus base de datos del CIS. |