Aller au contenu

GetAsset

Renvoie un actif, comme un camion, une remorque ou un équipement, avec ses détails, ses liens vers d’autres actifs et ses champs d’actif. Utilisez-le pour copier un actif dans votre propre système, par exemple chaque actif que GetAssetsUpdated liste comme modifié.

Comment se connecter et lire la réponse : Authentification, Réponses.

GET /api/v1/GetAsset?ID=48211
Token: your-token
Paramètre Obligatoire Signification
ID Oui L’identifiant de l’actif, un nombre entier : la colonne ID de Gestion des actifs.

Sans ID, la requête n’atteint pas le point de terminaison, et TrakIT répond avec le statut HTTP 404 (voir Erreurs).

Règle Info en cas d’échec
L’en-tête Token contient un jeton valide. Token missing in header, Token invalid or expired, ou une autre réponse listée dans Jeton de connexion
L’utilisateur est un administrateur système disposant de l’accès à l’API. API User must be SysAdmin with API Access
Un actif a cet identifiant. No such ID: ..., avec Code -1

En cas de succès, RetInfo est l’actif. Les heures sont en UTC, sans fuseau horaire (voir Dates et heures).

{
"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
}

Les libellés en gras sont ceux des détails de l’actif.

Champ Signification
AssetID L’identifiant de l’actif.
AssetName, AssetSerial Name et Serial.
TypeID, TypeName Le type d’actif : son identifiant et son nom. Utilisez TypeID avec GetAssetsUpdated.
CatID, CatName Category : son identifiant et son nom.
Status Le statut de l’actif, sous forme de nombre : 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 quand le statut est In Service ou In Storage.
OwnerID, EntName Owned By : l’identifiant et le nom de l’entité propriétaire. 0 et null pour un actif qui appartient à votre propre société.
Value Asset Value, ou null.
Remarks Remarks.
Resp, RespName Responsible : l’identifiant utilisateur et le nom de l’utilisateur, ou null.
OfficeID, OfficeName Company, la société principale de l’actif : son identifiant et son nom.
SecOffID Les identifiants des autres sociétés qui partagent l’actif, séparés par des virgules, ou null.
AcqDate, InSvcDate Acquired et In Service, ou null.
RetDate, RetRemarks Pour un actif qui a quitté la flotte : la date et les Retirement Remarks, ou null. Voir Réformer un actif.
LinkedTo, LinkedName, LinkedTypeName L’actif auquel celui-ci est lié : son identifiant, son nom et son type. 0, null et null quand il n’est pas lié.
LinkTime Quand l’actif a été lié, ou null.
SubCount, LinkedAsset Le nombre d’actifs liés à celui-ci, et ces actifs sous la forme type et nom, séparés par des virgules, ou null.
HasGPS true quand les actifs de ce type ont le GPS.
GPSVendorCode, GPSVendorName GPS Vendor : son code et son nom, ou null.
UserLoc, ULocFullName User Position Source : l’identifiant utilisateur et le nom de l’utilisateur, ou null.
GetAddr 1 quand TrakIT recherche une adresse pour les positions des actifs de ce type, sinon null.
YardMove true quand les actifs de ce type peuvent être utilisés dans des mouvements de parc.
Added, AddedBy, AddedByName Quand l’actif a été ajouté, et l’identifiant utilisateur et le nom de l’utilisateur qui l’a ajouté.
Updated, UpdatedBy, UpdatedByName Quand les détails de l’actif ont été modifiés pour la dernière fois, et l’identifiant utilisateur et le nom de l’utilisateur qui les a modifiés. 0001-01-01T00:00:00, null et null si l’actif n’a pas été modifié depuis son ajout.
CountryName Non utilisé : toujours null.
AssetData Les champs d’actif de l’actif qui ont une valeur, dans l’ordre des champs. Seuls les champs actifs sont inclus, et seulement ceux qui s’appliquent à toutes les sociétés ou à la société principale de l’actif. Une liste vide s’il n’y en a aucun.

Chaque élément de AssetData :

Champ Signification
FieldName, Code Le nom et le code du champ d’actif.
Value La valeur, sous forme de texte.
Remarks Les remarques, ou null.
DataType Le type de données du champ, sous forme de nombre : 0 Number, 2 Text, 5 Date, 7 Hyperlink, 8 Google Place, 9 Phone, 11 Entity.
Updated Quand la valeur a été enregistrée pour la dernière fois.
UserID L’identifiant utilisateur de l’utilisateur qui l’a enregistrée, ou null pour un champ calculé.