Get all existing odometer data that have been performed by users of the Customer Portal.

Description

GET /vehicle_settings/get_odometer_history.php?company=RTI_COMPANYKEY&vehicle=VEHICLE_RTIKEY

Parameter

Parameter	Description	Type	Note	Mandatory
company	RTI company key	string		yes
vehicle	RTI vehicle key	string		yes
format	Output format	string	csv or json, default: csv	no

Return

A string will be returned (json or csv). If the request was successful "OK". If the request failed "ERROR:Description".

Possible error values

error	description
MISSING_COMPANY	company key is missing
INVALID_COMPANY	Company not found. Company key or import key might be faulty.
ERROR_MAINTENANCE	Your company is under maintenance, no RTI request are possible at the moment.
MISSING_VEHICLE	vehicle key is missing
INVALID_FORMAT	invalid output format

CSV

Meta informations

Separator	Semicolon ( ; )
Delimiter	Double quote ( " )
Line break	0x0D 0x0A (CarriageReturn LineFeed)
Header	Line 1

Columns

Column	Description
DATE	date of change
NEWODOMETER	Odometer reading after correction
OLDODOMETER	Odometer reading before correction
KMCORRECTIONFACTOR	Corrected value
UPDATEBY	Users of the portal

Example

Return in CSV

"DATE";"NEWODOMETER";"OLDODOMETER";"KMCORRECTIONFACTOR";"UPDATEBY"

"2021-11-23T21:08:13+00:00";"262655";"259434";"1";"Mitarbeiter 1"

"2021-08-19T13:19:08+00:00";"259434";"257319";"1";"Mitarbeiter 1"

"2021-05-26T16:14:54+00:00";"257319";"0";"0";"Mitarbeiter 1"

"2019-08-06T14:18:47+00:00";"241000";"213597";"1.05259";"Mitarbeiter 2"

"2018-01-12T17:00:29+00:00";"213597";"198227";"1.08232";"Mitarbeiter 1"

"2017-02-03T15:34:37+00:00";"198227";"195037";"1.10995";"Mitarbeiter 1"

"2016-10-14T10:50:58+00:00";"195037";"193018";"1";""

"2016-09-07T08:30:51+00:00";"193018";"190600";"1";"Mitarbeiter 2"

"2016-08-11T18:12:12+00:00";"190600";"1";"1.00021";"Mitarbeiter 2"

"2016-06-15T10:35:50+00:00";"1";"0";"1";"Portal"

Return in JSON

[
    {
        "date": "2021-11-23T21:08:13+00:00",
        "newOdometer": "262655",
        "oldOdometer": "259434",
        "kmCorrectionFactor": "1",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2021-08-19T13:19:08+00:00",
        "newOdometer": "259434",
        "oldOdometer": "257319",
        "kmCorrectionFactor": "1",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2021-05-26T16:14:54+00:00",
        "newOdometer": "257319",
        "oldOdometer": "0",
        "kmCorrectionFactor": "0",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2019-08-06T14:18:47+00:00",
        "newOdometer": "241000",
        "oldOdometer": "213597",
        "kmCorrectionFactor": "1.05259",
        "updateBy": "Mitarbeiter 2"
    },
    {
        "date": "2018-01-12T17:00:29+00:00",
        "newOdometer": "213597",
        "oldOdometer": "198227",
        "kmCorrectionFactor": "1.08232",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2017-02-03T15:34:37+00:00",
        "newOdometer": "198227",
        "oldOdometer": "195037",
        "kmCorrectionFactor": "1.10995",
        "updateBy": "Mitarbeiter 1"
    },
    {
        "date": "2016-10-14T10:50:58+00:00",
        "newOdometer": "195037",
        "oldOdometer": "193018",
        "kmCorrectionFactor": "1",
        "updateBy": ""
    },
    {
        "date": "2016-09-07T08:30:51+00:00",
        "newOdometer": "193018",
        "oldOdometer": "190600",
        "kmCorrectionFactor": "1",
        "updateBy": "Mitarbeiter 2"
    },
    {
        "date": "2016-08-11T18:12:12+00:00",
        "newOdometer": "190600",
        "oldOdometer": "1",
        "kmCorrectionFactor": "1.00021",
        "updateBy": "Mitarbeiter 2"
    },
    {
        "date": "2016-06-15T10:35:50+00:00",
        "newOdometer": "1",
        "oldOdometer": "0",
        "kmCorrectionFactor": "1",
        "updateBy": "Portal"
    }
]

Example call

https://map.yellowfox.de/rti/vehicle_settings/get_odometer_history.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

https://map.yellowfox.de/rti/vehicle_settings/get_odometer_history.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&format=csv

https://map.yellowfox.de/rti/vehicle_settings/get_odometer_history.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&format=json

Page tree

vehicle_settings/get_odometer_history.php