Ir al contenido

GetAssetsUpdated

Lista los activos de un tipo de activo cuyos datos se modificaron en un periodo, con su identificador, su número de serie y su nombre. Una integración que mantiene su propia copia de sus camiones, remolques u otros equipos lo llama de forma programada y, después, lee cada activo de la lista con GetAsset.

Cómo iniciar sesión y leer la respuesta: Autenticación, Respuestas.

GET /api/v1/GetAssetsUpdated?AssetType=1&FromDate=2026-10-01&ToDate=2026-10-31T23:59:59
Token: your-token
Parámetro Obligatorio Significado
AssetType Sí El identificador del tipo de activo, un número entero de 1 a 255. GetAsset lo devuelve como TypeID.
FromDate Sí El inicio del periodo, en UTC: una fecha, yyyy-MM-dd, o una fecha y hora, yyyy-MM-ddTHH:mm:ss.
ToDate Sí El final del periodo, en UTC, en la misma forma. Como máximo 365 días después de FromDate.
  • Envíe los tres parámetros. Sin uno de ellos, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404 (consulte Errores).
  • Los dos extremos están incluidos. Una fecha sin hora significa la medianoche al inicio de ese día, por lo que ToDate=2026-10-31 deja fuera los cambios hechos más tarde el 31 de octubre. Para incluir ese día entero, envíe 2026-10-31T23:59:59 o 2026-11-01.
  • Escriba la hora con la T, como arriba. TrakIT elimina los espacios de las fechas, por lo que 2026-10-31 23:59:59 se rechaza. Consulte Fechas y horas.

Un activo aparece en la lista cuando sus datos se modificaron por última vez dentro del periodo: con Edit Detail en la página del activo o mediante una importación, o cuando se retiró.

No cuentan: añadir el activo, vincularlo o desvincularlo, ni los cambios en sus campos de activo, empresas, archivos o posiciones. Un activo nuevo solo aparece en la lista cuando sus datos se modifican por primera vez.

Solo cuenta el último cambio: un activo modificado en su periodo y de nuevo después solo aparece en el periodo posterior. Pida periodos consecutivos, cada uno empezando donde terminó el anterior, y cada activo cuyos datos cambien aparecerá al menos una vez.

Regla Info si no se cumple
El encabezado Token contiene un token válido. Token missing in header, Token invalid or expired, u otra respuesta indicada en Token de inicio de sesión
El usuario es un administrador del sistema con acceso a la API. API User must be SysAdmin with API Access
FromDate no está vacío. FromDate is required
ToDate no está vacío. ToDate is required
AssetType es un número entero de 1 a 255. Asset Type is invalid
FromDate es una fecha. FromDate is not valid
ToDate es una fecha. ToDate is not valid
ToDate no es anterior a FromDate. ToDate must be later than FromDate
Las fechas tienen como máximo 365 días de diferencia. Days between FromDate and ToDate cannot exceed 365

Si tiene éxito, RetInfo lista los activos, por orden de identificador, y RowsAffected indica cuántos hay. La lista incluye los activos de todas las empresas, sea cual sea su estado.

{
"Code": 1,
"Info": "",
"RetInfo": [
{ "AssetID": 48211, "AssetSerial": "EXTRK012", "AssetName": "Truck 12" },
{ "AssetID": 48236, "AssetSerial": "EXTRK015", "AssetName": "Truck 15" }
],
"RowsAffected": 2,
"Scalar": null,
"Identity": 0
}
Campo Significado
AssetID El identificador del activo. Lea el activo con GetAsset.
AssetSerial El Serial del activo.
AssetName El Name del activo.

Cuando no se modificó ningún activo del tipo en el periodo, o no existe ningún tipo de activo con ese identificador, la respuesta tiene Code 0 e Info No data found.