Consultar lecturas de un medidor

A través de esta API es posible consultar la lista de las lecturas insertadas en un medidor de Fracttal.

En este servicio web es posible filtrar para obtener todas las lecturas de medidor asociadas a un activo en particular o para obtener todas las lecturas de un medidor específico.

El parámetro para consultar las lecturas de medidores asociados a un activo es:

  • Code: Código del activo al cual el medidor está asociado

Los parámetros para consultar las lecturas de un medidor en particular son:

  • Code: Código del activo al cual el medidor está asociado
  • Serial: Serial del medidor

Esta API permite filtrar por fecha de la lectura para que obtenga las lecturas del medidor que necesite.

Parámetros de entrada

ParámetroTipoRequeridoDescripción
codeTextoOpcionalCódigo del activo que tiene el medidor asociado
type_dateTextoOpcionalTipo de fecha para hacer la consulta. Puede ser:

Valor | Descripción
date | Fecha de creación
date_reading | Fecha de la lectura
serialTextoOpcionalSerial del medidor que se desea consultar
sinceTextoOpcionalFecha inicial, aplica para la fecha de lectura. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC' Ejemplo:'2016-07-12T20:00:00-03′
untilTextoOpcionalFecha final, aplica para la fecha de lectura. Formato: 'YYYY-MM-DDTHH:MM:SS-UTC' Ejemplo:'2016-07-12T20:00:00-03′
code_locationTextoOpcionalCódigo de la localización
startEnteroOpcionalCampo que sirve para hacer la paginación de registros. Es el número en el cual comienza la paginación. Por defecto es 0
limitEnteroOpcionalCantidad de registros (elementos) que desea que la API retorne. Por defecto es 100 (No puede ser superior a este valor)

Parámetros de salida

ParámetroTipoDescripción
date_readingTextoFecha de la lectura
dateTextoFecha de la inserción en Fracttal
datajsonInformación de la lectura:

Parámetro | Descripción
date | Fecha de la lectura
value | Valor
accumulated_value | Valor acumulado
units_descriptionTextoDescripción de la Unidad del medidor
units_codeTextoCódigo de la unidad
trigger_runBooleanoTrue cuando lanza una tarea, false en caso contrario
sourceTextoFuente de la lectura: API, WORK_ORDER, MANUAL
related_work_orders_tasksJsonLista de órdenes de trabajo vinculadas:

Campo | Descripción
wo_folio | Folio de la orden de trabajo
id_work_order | Id de la orden de trabajo
id_work_order_task | Id de la tarea de la orden de trabajo

Ejemplo:

Solicitud: (GET)https://app.fracttal.com/api/meters_reading_list/?code=EQM027&serial=12345656

{
  "success": true,
  "message": "200",
  "data": [
   {
    "success": true,
    "message": "200",
    "data": [
        {
            "id_meter": 1157,
            "date_reading": "2019-08-21T14:07:13+00:00",
            "date": "2019-08-21T14:07:13.932837+00:00",
            "data": {
                "date": "2019-08-21T14:07:13+00:00",
                "value": -8.701,
                "accumulated_value": -8.701
            },
            "units_description": "TEMPERATURA",
            "units_code": "C",
            "trigger_run": false,
            "source": "MANUAL"
           
        },
        {
           
            "id_meter": 1157,
            "date_reading": "2019-08-21T14:06:03+00:00",
            "date": "2019-08-21T14:06:03.714035+00:00",
            "data": {
                "date": "2019-08-21T14:06:03+00:00",
                "value": -8.737,
                "accumulated_value": -8.737
            },
            "units_description": "TEMPERATURA",
            "units_code": "C",
            "trigger_run": false,
            "source": "API",
           
           
        },
        {
            "id_meter": 1157,
            "date_reading": "2019-08-21T14:05:12+00:00",
            "date": "2019-08-21T14:05:14.151536+00:00",
            "data": {
                "date": "2019-08-21T14:05:12+00:00",
                "value": -8.769,
                "accumulated_value": -8.769
            },
            "units_description": "TEMPERATURA",
            "units_code": "C",
            "trigger_run": false,
            "source": "WORK_ORDER"
        }
  ],
  "total": 3
}

PROBAR CONEXIÓN

Language