API Endpoints
Fracttal →

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 y/o por el serial del 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).

Parámetros de entrada

ParámetroTipoRequeridoDescripción
codeTextoOpcionalCódigo del activo que tiene asociado el medidor.
serialTextoOpcionalSerial del medidor que se desea consultar.
startEnteroOpcionalCampo que sirve para hacer la paginación de registros. Es el número en el que comienza la paginación. Por defecto es 0
limitEnteroOpcionalCantidad 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ámetroTipoDescripción
descriptionTextoDescripción del Medidor
serialTextoSerial del medidor
is_counterTextoValor que te indica si el medidor es de tipo contador
counter_offset_valueTextoValor Acumulado
counter_valueTextoValor actual del medidor
last_dataTextoInformación de la última lectura agregada al medidor:
-"date": fecha,
-"value": valor,
-"accumulated_value": valor acumulado
monthly_average_dataTextoValor promedio mensual
units_descriptionTextoDescripción de la unidad del medidor
units_codeTextoCódigo de la Unidad del medidor
items_descriptionTextoDescripción del activo al cuál pertenece el medidor
parent_descriptionTextoLocalización a la cual pertenece el activo
monthly_average_autoBooleanoValor que indica si el promedio mensual será calculado por el sistema o lo ingresará manualmente el usuario
last_value_triggerNúmeroValor de lectura en el último mantenimiento
last_date_maintenanceFechaFecha del último mantenimiento activado por lectura

Ejemplo:

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

{
    "success": true,
    "message": "200",
    "data": [
        {
            "id": 177136,
            "is_counter": true,
            "active": true,
            "description": "Nuevo Medidor Refrigerador",
            "serial": "0",
            "counter_value": 2405,
            "counter_offset_value": 0,
            "id_unit": 6,
            "units_code": "KM",
            "units_description": "KILOMETROS",
            "id_parent_meter": null,
            "parent_meter_description": " {}",
            "monthly_average_data": 1,
            "id_item": 20005233,
            "items_id_type_item": 2,
            "items_code": "SVPRACT13",
            "items_description": "SV REFRIGERADOR DE VACUNAS",
            "items_id_priority": null,
            "items_id_group": null,
            "items_id_group_2": null,
            "items_field_2": "SV SAMSUNG",
            "items_field_3": "SV C13 D",
            "items_field_4": "SV 001827",
            "items_parent_description": "// ",
            "id_task": 2466764,
            "tasks_description": "Mantenimiento cada 600km",
            "id_task_trigger_type": 3,
            "last_value_trigger": "1805",
            "last_date_maintenance": "2022-05-27T16:48:28.432111+00:00",
            "id_company": 1190
        }
    ],
    "total": 1
}
Language
Click Try It! to start a request and see the response here!