06. Telemetria (KM)
O módulo de Telemetria possibilita a integração com dados de sensores e dispositivos embarcados nos veículos. Com ele, é possível monitorar parâmetros em tempo real e automatizar ações com base em eventos ou condições específicas.
Funcionalidades Principais
Abaixo estão os atalhos para as operações mais utilizadas neste módulo:
Atualizar Quilometragem VIN (número do chassi)
Obtenha o ID do veículo a partir do VIN (número do chassi)
Endpoint: /api/vehicles/filters?page=0&size=0&plateVinBrandModel={ VIN}
Método: GET
Response:
content: [ { "id": 11225, "modelYear": 2023, "chassisNumber": "35715965478964455", "licensePlate": "SMI0604", "initialMileage": 14600, "firstMileage": 0, "vtvExpiration": "", "modelId": 7369, "blockId": 1551, "clientId": 1732, "cityId": 38881, "city": { "id": 38881, "name": "Hamburg", "state": { "id": 119, "name": "Hamburg", "country": { "id": 5, "name": "Germany", "code": "DE", "currency": { "id": 4, "code": "EUR" }, "locale": { "id": 3, "code": "en", "description": "English(United States)" } } } }, "district": "", "registrationDate": "2025-04-15T16:37:43.941+00:00", "brandId": 32, "model": { "id": 7369, "motor": "1.4", "version": "", "initialYear": 2023, "endYear": 2023, "brandId": 32, "brandName": "AUDI", "description": "A3 1.4 TFSI", "countryId": 4, "countryName": "Netherlands", "displayName": "A3 1.4 TFSI 1.4 (2023 - 2023)", "haveMaintenancePlan": null, "havePriceTable": null, "category": "RIDE" }, "block": { "id": 1551, "blockCode": "MVP", "tag": "Test MVP", "parentId": null, "parent": { "id": 1732, "clientCode": "MVPFL", "sapId": "111111111111111", "corporateName": "Test-FleetalityMVP", "tradingName": "Test-FleetalityMVP", "taxIdentifier": "1788", "isParent": true, "clientType": "DEFAULT" }, "address": { "id": 4097, "street": "111", "zipCode": "111111", "number": "111", "district": "", "complement": "", "cityId": null, "city": { "id": 38879, "name": "Stuttgart", "state": { "id": 117, "name": "Baden-Württemberg", "country": { "id": 5, "name": "Germany", "code": "DE", "currency": { "id": 4, "code": "EUR" }, "locale": { "id": 3, "code": "en", "description": "English(United States)" } } } } } }, "client": { "id": 1732, "clientCode": "MVPFL", "sapId": "111111111111111", "corporateName": "Test-FleetalityMVP", "tradingName": "Test-FleetalityMVP", "taxIdentifier": "1788", "isParent": true, "clientType": "DEFAULT" }, "businessArea": null, "businessLine": null, "marketSegment": null, "useClass": null, "expenseGroup": "", "costCenter": "", "version": 40, "telemetryCapable": false, "documentDate": "2023-03-14", "kbaNumber": null, "driversName": null, "notificationDriverIds": null, "notificationClientId": 1732, "notificationCarWorkshopId": null }]A resposta será uma lista de objeto de veículos.
Filtre o primeiro objeto da lista para obter o ID do veículo.
Atualizar Quilometragem com o ID do veículo
Endpoint: api/ vehicles/{id}/update-km
Método: PUT
Request payload:
{ "city": "", "vehicleId": id, "longitude": -49.28226766428372, "latitude": -25.44234940722716, "mileage": 20003}Response:
|
200 |
Update vehicle KM |
{ "message": "string", "payLoad": { "id": 0, "modelYear": 0, "chassisNumber": "string", "licensePlate": "string", "initialMileage": 0.1, "firstMileage": 0.1, "vtvExpiration": "string", "modelId": 0, "blockId": 0, "clientId": 0, "cityId": 0, "city": { "id": 0, "name": "string", "state": { "id": 0, "name": "string", "country": { "id": 0, "name": "string", "code": "string", "currency": { "id": 0, "code": "string" }, "locale": { "id": 0, "code": "string", "description": "string" } } } }, "district": "string", "registrationDate": "2025-08-26T09:29:55.506Z", "brandId": 0, "model": { "id": 0, "motor": "string", "version": "string", "initialYear": 0, "endYear": 0, "brandId": 0, "brandName": "string", "description": "string", "countryId": 0, "countryName": "string", "displayName": "string", "haveMaintenancePlan": true, "havePriceTable": true, "category": "RIDE" }, "block": { "id": 0, "blockCode": "string", "tag": "string", "parentId": 0, "parent": { "id": 0, "clientCode": "string", "sapId": "string", "corporateName": "string", "tradingName": "string", "taxIdentifier": "string", "isParent": true, "clientType": "DEFAULT" }, "address": { "id": 0, "street": "string", "zipCode": "string", "number": "string", "district": "string", "complement": "string", "cityId": 0, "city": { "id": 0, "name": "string", "state": { "id": 0, "name": "string", "country": { "id": 0, "name": "string", "code": "string", "currency": { "id": 0, "code": "string" }, "locale": { "id": 0, "code": "string", "description": "string" } } } } } }, "client": { "id": 0, "clientCode": "string", "sapId": "string", "corporateName": "string", "tradingName": "string", "taxIdentifier": "string", "isParent": true, "clientType": "DEFAULT" }, "businessArea": 0, "businessLine": 0, "marketSegment": 0, "useClass": 0, "expenseGroup": "string", "costCenter": "string", "version": 0, "telemetryCapable": true, "documentDate": "2025-08-26", "kbaNumber": "string", "driversName": [ "string" ], "notificationClientId": 0, "notificationDriverIds": [ 0 ], "notificationCarWorkshopId": 0 }, "warning": true}|
403 |
Unauthorized |
|
500 |
Unknown Server Error |