Consulta avanzada de medidores

Mediante esta API se consulta información avanzada medidores creados en Fracttal, contiene información relacionada al activo al que está vinculado e información del último mantenimiento. Esta API te permite filtrar para que obtengas sólo los medidores que necesitas: por el código del activo, el serial del medidor, el código del activo padre y/o la descripción de la tarea asociada al medidor.

Para obtener los medidores que pertenecen a un activo específico, es necesario enviar el parámetro “code” (código del activo).
Para obtener la información de un medidor en específico, es necesario enviar los parámetros “code” (código del activo) y “serial” (serial del medidor).
Para filtrar los medidores por el activo padre, se puede enviar de forma opcional el parámetro “code_parent_location” (código del activo padre).
Para filtrar los medidores por la descripción de la tarea asociada, se puede enviar de forma opcional el parámetro “tasks_description” (descripción de la tarea).

Parámetros de entrada

Parámetro	Tipo	Requerido	Descripción
`code`	Texto	Opcional	Código del activo que tiene asociado el medidor.
`serial`	Texto	Opcional	Serial del medidor que se desea consultar.
`code_parent_location`	Texto	Opcional	Código del activo padre.
`tasks_description`	Texto	Opcional	Descripción de la tarea asociada al medidor.
`start`	Entero	Opcional	Campo que sirve para hacer la paginación de registros. Es el número en el que comienza la paginación. Por defecto es 0
`limit`	Entero	Opcional	Cantidad de registros (items) que desea que el API devuelva. Por defecto es 100 (No puede ser superior a éste valor)

Parámetros de salida

Parámetro	Tipo	Descripción
`description`	Texto	Descripción del Medidor
`serial`	Texto	Serial del medidor
`is_counter`	Texto	Valor que te indica si el medidor es de tipo contador
`counter_offset_value`	Texto	Valor Acumulado
`counter_value`	Texto	Valor actual del medidor
`last_data`	Texto	Información de la última lectura agregada al medidor: -"date": fecha, -"value": valor, -"accumulated_value": valor acumulado
`monthly_average_data`	Texto	Valor promedio mensual
`units_description`	Texto	Descripción de la unidad del medidor
`units_code`	Texto	Código de la Unidad del medidor
`items_description`	Texto	Descripción del activo al cuál pertenece el medidor
`items_parent_description`	Texto	Localización a la cual pertenece el activo
`id_task`	Número	Id de la tarea
`tasks_description`	Texto	Descripción de la tarea
`id_task_trigger_type`	Número	id Tipo de activador. 1: Fecha, 2: Activador cuando, 3: activador cada , 4 activador de eventos.
`monthly_average_auto`	Booleano	Valor que indica si el promedio mensual será calculado por el sistema o lo ingresará manualmente el usuario
`last_value_trigger`	Número	Valor de lectura en el último mantenimiento
`last_date_maintenance`	Fecha	Fecha del último mantenimiento activado por lectura
`id_company`	Número	Id de la empresa
`code_parent_location`	Texto	Código del activo padre

Ejemplo:

Petición: (GET)https://app.fracttal.com/api/meters_advanced/ACT-001

{
    "success": true,
    "message": "200",
    "data": [
        {
            "id": 11111,
            "is_counter": true,
            "active": true,
            "description": "",
            "serial": "",
            "counter_value": 1369,
            "last_data": {
                "date": "2024-07-29T20:32:25.637+00:00",
                "value": 0,
                "accumulated_value": 1369
            },
            "counter_offset_value": 1369,
            "id_unit": 2208,
            "units_code": "hs",
            "units_description": "horas",
            "id_parent_meter": null,
            "parent_meter_description": " {}",
            "monthly_average_data": 111,
            "id_item": 1111,
            "items_id_type_item": 1,
            "items_code": "ACT-0001",
            "items_description": "ACT-0001",
            "items_id_priority": 1,
            "items_id_group": null,
            "items_id_group_2": null,
            "items_field_2": null,
            "items_field_3": null,
            "items_field_4": null,
            "items_parent_description": "",
            "id_task": 111,
            "tasks_description": "",
            "id_task_trigger_type": 3,
            "last_value_trigger": "1000",
            "last_date_maintenance": null,
            "code_parent_location": "PACT-0001",
            "id_company": 188
        }
    ],
    "total": "1"
}