Ir al contenido

GetAsset

Devuelve un activo, como un camión, un remolque o un equipo, con sus datos, sus vínculos con otros activos y sus campos de activo. Utilícelo para copiar un activo en su propio sistema, por ejemplo cada activo que GetAssetsUpdated lista como modificado.

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

GET /api/v1/GetAsset?ID=48211
Token: your-token
Parámetro Obligatorio Significado
ID Sí El identificador del activo, un número entero: la columna ID de Gestión de activos.

Sin ID, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404 (consulte Errores).

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
Existe un activo con ese identificador. No such ID: ..., con Code -1

Si tiene éxito, RetInfo es el activo. Las horas están en UTC, sin zona horaria (consulte Fechas y horas).

{
"Code": 1,
"Info": "",
"RetInfo": {
"AssetID": 48211,
"AssetName": "Truck 12",
"TypeID": 1,
"AssetSerial": "EXTRK012",
"Remarks": "",
"Value": 85000.00,
"OwnerID": 0,
"Added": "2026-10-05T07:42:10.513",
"LinkedTo": 0,
"LinkedName": null,
"CatID": 4,
"GPSVendorCode": null,
"GPSVendorName": null,
"Resp": "JSMITH",
"RespName": "John Smith",
"LinkTime": null,
"Status": 0,
"AcqDate": "2026-09-30T00:00:00",
"InSvcDate": "2026-10-05T00:00:00",
"RetDate": null,
"RetRemarks": null,
"OfficeID": 3,
"SecOffID": null,
"CountryName": null,
"GetAddr": null,
"UserLoc": null,
"ULocFullName": null,
"Updated": "2026-10-20T14:30:05.437",
"UpdatedBy": "JSMITH",
"UpdatedByName": "John Smith",
"EntName": null,
"CatName": "Prime Mover",
"AddedBy": "JSMITH",
"AddedByName": "John Smith",
"LinkedTypeName": null,
"OfficeName": "Example Logistics Ltd",
"SubCount": 1,
"LinkedAsset": "Trailer - Trailer 7",
"TypeName": "Truck",
"HasGPS": false,
"YardMove": false,
"Active": true,
"AssetData": [
{
"FieldName": "Engine Number",
"Code": "ENGNO",
"Value": "EN-000123",
"Remarks": null,
"DataType": 2,
"Updated": "2026-10-05T07:45:31.020",
"UserID": "JSMITH"
}
]
},
"RowsAffected": 0,
"Scalar": null,
"Identity": 0
}

Las etiquetas en negrita son las de los datos del activo.

Campo Significado
AssetID El identificador del activo.
AssetName, AssetSerial Name y Serial.
TypeID, TypeName El tipo de activo: su identificador y su nombre. Use TypeID con GetAssetsUpdated.
CatID, CatName Category: su identificador y su nombre.
Status El estado del activo, como número: 0 In Service, 1 In Storage, 2 Under Repair, 3 Awaiting Disposal, 4 Retired, 5 Sold, 6 Written Off, 7 Lost, 8 Stolen.
Active true cuando el estado es In Service o In Storage.
OwnerID, EntName Owned By: el identificador y el nombre de la entidad propietaria. 0 y null para un activo propio.
Value Asset Value, o null.
Remarks Remarks.
Resp, RespName Responsible: el identificador de usuario y el nombre del usuario, o null.
OfficeID, OfficeName Company, la empresa principal del activo: su identificador y su nombre.
SecOffID Los identificadores de las demás empresas que comparten el activo, separados por comas, o null.
AcqDate, InSvcDate Acquired e In Service, o null.
RetDate, RetRemarks Para un activo que ha salido de la flota: la fecha y las Retirement Remarks, o null. Consulte Retirar un activo.
LinkedTo, LinkedName, LinkedTypeName El activo al que está vinculado este: su identificador, su nombre y su tipo. 0, null y null cuando no está vinculado.
LinkTime Cuándo se vinculó el activo, o null.
SubCount, LinkedAsset Cuántos activos están vinculados a este, y esos activos como tipo y nombre, separados por comas, o null.
HasGPS true cuando los activos de este tipo tienen GPS.
GPSVendorCode, GPSVendorName GPS Vendor: su código y su nombre, o null.
UserLoc, ULocFullName User Position Source: el identificador de usuario y el nombre del usuario, o null.
GetAddr 1 cuando TrakIT busca una dirección para las posiciones de los activos de este tipo; si no, null.
YardMove true cuando los activos de este tipo se pueden usar en movimientos de patio.
Added, AddedBy, AddedByName Cuándo se añadió el activo, y el identificador de usuario y el nombre de quien lo añadió.
Updated, UpdatedBy, UpdatedByName Cuándo se modificaron por última vez los datos del activo, y el identificador de usuario y el nombre de quien los modificó. 0001-01-01T00:00:00, null y null si el activo no se ha modificado desde que se añadió.
CountryName No se usa: siempre null.
AssetData Los campos de activo del activo que tienen un valor, en el orden de los campos. Solo se incluyen los campos activos, y solo los de todas las empresas o los de la empresa principal del activo. Una lista vacía si no hay ninguno.

Cada elemento de AssetData:

Campo Significado
FieldName, Code El nombre y el código del campo de activo.
Value El valor, como texto.
Remarks Las observaciones, o null.
DataType El tipo de dato del campo, como número: 0 Number, 2 Text, 5 Date, 7 Hyperlink, 8 Google Place, 9 Phone, 11 Entity.
Updated Cuándo se guardó el valor por última vez.
UserID El identificador de usuario de quien lo guardó, o null para un campo calculado.