Consulta Avançada de Medidores

Através desta API, consulta-se informação avançada de medidores criados no Fracttal, contendo informações relacionadas ao ativo ao qual está vinculado e informações da última manutenção. Esta API permite filtrar para que você obtenha apenas os medidores que necessita: pelo código do ativo, o serial do medidor, o código do ativo pai e/ou a descrição da tarefa associada ao medidor.

Para obter os medidores que pertencem a um ativo específico, é necessário enviar o parâmetro “code” (código do ativo).
Para obter a informação de um medidor específico, é necessário enviar os parâmetros “code” (código do ativo) e “serial” (serial do medidor).
Para filtrar os medidores pelo ativo pai, pode-se enviar de forma opcional o parâmetro “code_parent_location” (código do ativo pai).
Para filtrar os medidores pela descrição da tarefa associada, pode-se enviar de forma opcional o parâmetro “tasks_description” (descrição da tarefa).

Parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
`code`	Texto	Opcional	Código do ativo que tem associado o medidor.
`serial`	Texto	Opcional	Serial do medidor que se deseja consultar.
`code_parent_location`	Texto	Opcional	Código do ativo pai.
`tasks_description`	Texto	Opcional	Descrição da tarefa associada ao medidor.
`start`	Inteiro	Opcional	Campo que serve para fazer a paginação de registros. É o número em que começa a paginação. Por padrão é 0
`limit`	Inteiro	Opcional	Quantidade de registros (itens) que deseja que a API retorne. Por padrão é 100 (Não pode ser superior a este valor)

Parâmetros de saída

Parâmetro	Tipo	Descrição
`description`	Texto	Descrição do Medidor
`serial`	Texto	Serial do medidor
`is_counter`	Texto	Valor que indica se o medidor é do tipo contador
`counter_offset_value`	Texto	Valor Acumulado
`counter_value`	Texto	Valor atual do medidor
`last_data`	Texto	Informação da última leitura adicionada ao medidor: -"date": data, -"value": valor, -"accumulated_value": valor acumulado
`monthly_average_data`	Texto	Valor promédio mensal
`units_description`	Texto	Descrição da unidade do medidor
`units_code`	Texto	Código da Unidade do medidor
`items_description`	Texto	Descrição do ativo ao qual pertence o medidor
`items_parent_description`	Texto	Localização à qual pertence o ativo
`id_task`	Número	Id da tarefa
`tasks_description`	Texto	Descrição da tarefa
`id_task_trigger_type`	Número	id Tipo de ativador. 1: Data, 2: Ativador quando, 3: ativador a cada, 4 ativador de eventos.
`monthly_average_auto`	Booleano	Valor que indica se a média mensal será calculada pelo sistema ou será inserida manualmente pelo usuário
`last_value_trigger`	Número	Valor de leitura na última manutenção
`last_date_maintenance`	Data	Data da última manutenção ativada por leitura
`id_company`	Número	Id da empresa
`code_parent_location`	Texto	Código do ativo pai

Exemplo:

Requisição: (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"
}