Actualizar un medidor

put

https://app.fracttal.com/api/meters/{code}

Actualiza la descripción y el serial de un medidor existente y habilitado.

Mediante este EndPoint se puede actualizar la descripción y el serial de un medidor existente y habilitado. Los demás campos del medidor no se modifican con este servicio.

Parámetros de entrada

Parámetro	Tipo	Requerido	Descripción
`code` (en la URL)	texto	Sí	Código del medidor a actualizar, enviado como segmento de la URL. Ejemplo: `/api/meters/456-fd3`.
`code`	texto	Sí	Código del medidor, enviado también en el body.
`isAccumulatorCounter`	booleano	Sí	Indica si el medidor es un contador acumulador. Debe coincidir con el valor registrado en el medidor.
`unit`	texto	Sí	Unidad de medida del medidor (ej. `Kilómetros`, `kWh`). Debe coincidir con la unidad registrada en el medidor.
`description`	texto	Condicional	Nueva descripción del medidor. No puede estar vacía ni superar 500 caracteres.
`serial`	texto	Condicional	Nuevo número de serie del medidor. No puede estar vacío ni superar 100 caracteres.

Reglas de actualización

Se debe enviar al menos uno de los campos description o serial. Si solo se envía uno, el otro conserva su valor actual.

Los parámetros code, isAccumulatorCounter y unit son siempre obligatorios, aunque no se modifiquen.

No es posible actualizar un medidor deshabilitado.

En esta versión solo se pueden modificar description y serial.

Parámetros de salida

Parámetro	Tipo	Descripción
`code`	texto	Código del medidor.
`description`	texto	Descripción del medidor.
`serial`	texto	Número de serie del medidor.
`unit`	texto	Unidad de medida del medidor.
`isAccumulatorCounter`	booleano	Indica si el medidor es un contador acumulador.
`enabled`	booleano	Indica si el medidor está habilitado.
`lastReading`	número	Última lectura registrada del medidor.
`readingDate`	texto	Fecha de la última lectura.

Errores

Código	Causa
`400`	Falta alguno de los parámetros obligatorios (`code`, `isAccumulatorCounter` o `unit`).
`400`	No se envió ninguno de los campos `description` o `serial`.
`400`	`description` o `serial` están vacíos, o superan la longitud máxima permitida (500 y 100 caracteres respectivamente).
`400`	`isAccumulatorCounter` o `unit` no coinciden con los valores registrados en el medidor.
`400`	El formato del código del medidor es inválido.
`401`	No autenticado: la autenticación falló o no se encontró la información necesaria para autenticar la solicitud.
`403`	El usuario no tiene permisos para realizar la acción.
`404`	No se encontró el medidor solicitado.
`405`	Operación no permitida: no es posible editar un medidor deshabilitado.

Ejemplo

Request body

{
    "code": "456-fd3",
    "isAccumulatorCounter": true,
    "unit": "Kilómetros",
    "description": "Kilómetros - COMPACTADOR ACTUALIZADO",
    "serial": "Compactador_v2"
}

Response `200`

{
    "success": true,
    "message": "200",
    "data": [
        {
            "code": "456-fd3",
            "description": "Kilómetros - COMPACTADOR ACTUALIZADO",
            "serial": "Compactador_v2",
            "unit": "Kilómetros",
            "isAccumulatorCounter": true,
            "enabled": true,
            "lastReading": 15230.5,
            "readingDate": "2026-09-30T14:20:00.000000+00:00"
        }
    ],
    "total": 1
}

Response — Medidor deshabilitado (`405`)

{
    "success": false,
    "message": "405",
    "data": null
}

Response — Medidor no encontrado (`404`)

{
    "success": false,
    "message": "404",
    "data": null
}

OpenAPI definition

{
  "openapi": "3.1.0",
  "info": {
    "title": "medidores",
    "version": "1-Es"
  },
  "servers": [
    { "url": "https://app.fracttal.com/api/meters" }
  ],
  "security": [{}],
  "paths": {
    "/{code}": {
      "put": {
        "summary": "Actualizar un medidor",
        "description": "",
        "operationId": "actualizar-un-medidor",
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}

Responses

Language

Loading…

Response

Choose an example:

application/json