Actualizar un activo por ID

Actualiza un activo existente. Exige name y assetTypeId en cada llamada, aunque no cambien; el resto de los campos propios que se envían se escriben y los que no se envían quedan como estaban.

Datos que se pueden actualizar:

• name (string, obligatorio): Nombre del activo
• assetTypeId (string, obligatorio): ID del tipo de activo
• icon (object): Objeto con id (string) y color (string, formato hexadecimal #RRGGBB o #RGB)
• mainTrackerId (number): ID del tracker principal
• trackers (array): Array de objetos con id (number) y platform (string)
• plate (string): Placa del activo
• vehicleTypeId (string): ID del tipo de vehículo
• model (string): Modelo del activo
• year (number): Año del activo
• color (string): Color del activo
• make (string): Marca del activo
• chassis (string): Número de chasis
• motor (string): Número de motor
• fuel (string): Tipo de combustible
• kilometer (number): Kilometraje
• description (string): Descripción adicional
• state (string): Estado del activo
• customFields (object): Valores de los Campos personalizados, mezclados por clave: las claves enviadas se escriben, null o "" borran el valor y las ausentes no se tocan. Sin customFields, los valores quedan como estaban.

Validaciones:

• Al actualizar no se valida que la placa ni el nombre sean únicos dentro del cliente (eso se valida solo al crear)
• Después de mezclar customFields, el activo debe quedar con todos los campos obligatorios de la empresa completos, también si la llamada no envía customFields (400 CUSTOM_FIELD_VALUE_INVALID listando los que faltan)
• Si se proporciona un trackerId, se valida que el tracker pertenezca al mismo cliente

Con idField el activo se resuelve por valor (ver el parámetro). Para cambiar solo algunos campos sin reenviar name ni assetTypeId, usá el PATCH.

Permisos requeridos: access_fleet_assets

PUT /api/assets/{id}

Actualizar un activo por ID

cURL

curl --request PUT \
  --url https://api.ugps.io/api/assets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "icon": {
    "id": "<string>",
    "color": "<string>"
  },
  "mainTrackerId": 123,
  "trackers": [
    {
      "id": 123,
      "platform": "<string>"
    }
  ],
  "plate": "<string>",
  "assetTypeId": "<string>",
  "vehicleTypeId": "<string>",
  "model": "<string>",
  "year": 123,
  "color": "<string>",
  "make": "<string>",
  "chassis": "<string>",
  "motor": "<string>",
  "fuel": "<string>",
  "kilometer": 123,
  "technicalInspection": {
    "date": "2023-12-25",
    "result": "<string>",
    "resultGas": "<string>",
    "month": "<string>",
    "station": {
      "code": "<string>",
      "region": "<string>",
      "commune": "<string>",
      "concession": "<string>",
      "address": "<string>"
    }
  },
  "description": "<string>",
  "clientId": "<string>",
  "state": "<string>",
  "customFields": {
    "codigoDeInventario": "ASM-001",
    "area": "tallerMecanico",
    "arrendado": false
  },
  "currentDriver": {
    "id": "<string>",
    "name": "<string>"
  }
}
'

200

{
  "status": "success",
  "data": {
    "name": "<string>",
    "icon": {
      "id": "<string>",
      "color": "<string>"
    },
    "mainTrackerId": 123,
    "trackers": [
      {
        "id": 123,
        "platform": "<string>"
      }
    ],
    "plate": "<string>",
    "assetTypeId": "<string>",
    "kind": "vehicle",
    "vehicleTypeId": "<string>",
    "model": "<string>",
    "year": 123,
    "color": "<string>",
    "make": "<string>",
    "chassis": "<string>",
    "motor": "<string>",
    "fuel": "<string>",
    "kilometer": 123,
    "technicalInspection": {
      "date": "2023-12-25",
      "result": "<string>",
      "resultGas": "<string>",
      "month": "<string>",
      "station": {
        "code": "<string>",
        "region": "<string>",
        "commune": "<string>",
        "concession": "<string>",
        "address": "<string>"
      }
    },
    "description": "<string>",
    "clientId": "<string>",
    "state": "<string>",
    "customFields": {
      "codigoDeInventario": "ASM-001",
      "area": "tallerMecanico",
      "arrendado": false
    },
    "currentDriver": {
      "id": "<string>",
      "name": "<string>"
    }
  }
}

Authorizations

Authorization · string · header · required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Path Parameters

id · string · required

ID del recurso

Query Parameters

idField · string

Resuelve el activo por valor en vez de por id: el segmento {id} de la ruta pasa a ser el valor buscado. Acepta plate, name o el Nombre interno de un Campo personalizado activo con Valor único (rules.unique). El texto se compara sin distinguir mayúsculas, tildes ni espacios de los extremos. Sin coincidencia responde 404 ASSET_NOT_FOUND; si más de un activo tiene el valor (patente o nombre repetidos), 409 ASSET_ID_FIELD_AMBIGUOUS con los activos en details.assets; un campo que no es plate, name ni un campo único, 400 ASSET_ID_FIELD_INVALID. Sin idField, {id} es el id del activo.

Example:

"codigoDeInventario"

Body

application/json

Cuerpo del PUT: los mismos campos del activo, con name y assetTypeId obligatorios en cada llamada. Los campos propios que se envían se escriben; customFields se mezcla por clave.

name · string · required

icon · object · required

Show child attributes

mainTrackerId · number · required

trackers · object[] · required

Show child attributes

plate · string · required

assetTypeId · string · required

kind · enum<string>

Familia canonica del activo. Se rellena de forma compatible con tipos antiguos.

Available options: vehicle, generic

vehicleTypeId · string

ID del tipo de vehículo asociado al activo (opcional)

model · string

Modelo del activo (opcional)

year · number

color · string

Color del activo (opcional)

make · string

chassis · string

Número de chasis del activo (opcional)

motor · string

Número de motor del activo (opcional)

fuel · string

Tipo de combustible del activo (opcional)

kilometer · number

Kilometraje del activo (opcional)

technicalInspection · object

Revisión técnica del vehículo (opcional). La puebla la consulta vehicular por patente y también se puede editar a mano. Solo aplica a activos de kind vehicle: en los generic se limpia.

Show child attributes

description · string

Descripción adicional del activo (opcional)

clientId · string

state · string

Estado del activo (opcional)

customFields · object

Valores de los Campos personalizados de la empresa, una clave por Nombre interno (GET /api/custom-fields lista las definiciones). Formato por tipo: text string (se guarda recortado, hasta 1.000 caracteres), number número, date YYYY-MM-DD, select el value de una opción activa, boolean true o false.

En las respuestas (GET de lista y detalle) siempre está presente, con solo los campos activos: una clave ausente significa «sin valor»; los valores de un campo archivado no salen y vuelven al restaurarlo.

Al escribir (POST, PUT, PATCH) se mezcla por clave: las claves enviadas se escriben, null o "" borran el valor y las ausentes no se tocan. Una clave desconocida, de un campo archivado o con un valor que no cumple el tipo o las reglas responde 400 CUSTOM_FIELD_VALUE_INVALID nombrando la clave. En POST y PUT, después de mezclar, el activo debe quedar con todos los campos obligatorios completos (400 listando los que faltan); el PATCH solo falla si vacía un obligatorio. El 400 trae en details la clave (key) y, si aplica, la regla que no se cumple (rule), o los obligatorios que faltan (missingFields).

Show child attributes

Example:

{
  "codigoDeInventario": "ASM-001",
  "area": "tallerMecanico",
  "arrendado": false
}

currentDriver · object | null

Conductor vigente del activo (vínculo conductor-activo abierto).

Show child attributes

Response

200

application/json

Activo actualizado exitosamente

status · string

Example:

"success"

data · object

Show child attributes