Versions Compared

Old Version 2

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Ermöglicht das Abrufen der ausgelesenen Daten einer Digitacho Datei. Unterstützt ausschließlich Fahrerdateien.

Beschreibung

GET /get_ddd_details.php?company=RTI_COMPANYKEY&import=RTI_IMPORTKEY&file=UUID


Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
importRTI Importschlüsselstring
ja
fileUUID der angeforderten DateistringDieses Wert erhalten Sie, indem Sie die verfügbaren Dateien über get_file_list.php abrufen.ja

Rückgabe

Es wird ein string im JSON Format zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

Generelles

In einer Digitacho Datei befinden sich verschiedene Datenblöcke. Nicht alle dieser Blöcke sind immer gesetzt. Diese RTI Funktion gibt ausschließlich Blöcke zurück, die auch gesetzt sind. Weiterhin muss zwischen Daten der Tacho Generation 1 und 2 unterschieden werden. Ein vorhandener Block beschreibt sich daher als Array mit den potentiellen Feldern G1 und G2. Diese enthalten zum Teil identische Daten. Generation 2 Daten enthalten aber auch Mehrinformationen und zusätzliche Blöcke. Diese Funktion gibt lediglich die Rohdaten zurück. Das Zusammenführen dieser beiden Generationen muss ggf. nachträglich vorgenommen werden.

Folgende Blöcke werden sofern vorhanden zurückgegeben:

  • Informationen zur Fahreridentifikation (Identification)
  • Aktivitätsaufzeichnungen (DriverActivityData)
  • Führerscheininformationen (DriverLicenceInfo)
  • Länderkennungen (Places)
  • genutzte Fahrzeuge (VehiclesUsed)
  • für Generation 2 Karten: GPS Daten (GNSSPlaces)


Offizielle Informationen zum Aufbau von Digitacho Dateien finden Sie beispielsweise im Datenglossar hier. Die Ausgabe dieser Funktion orientiert sich an dieser Struktur. Einige Daten wurden bereits für Sie vor verarbeitet. So erhalten Sie beispielsweise die Länderkennungen bereits als Länderkürzel, alle Daten wurden als UTF-8 kodiert und Zeitangaben kommen im Format ISO 8601.


JSON

Die genaue Spezifikation finden Sie anhand einer JSON

...

Schema Datei hier.

Code Block
titleBeispiel Ausgabe
{
    "Identification": {
        "G1": {
            "cardIdentification": {
                "cardIssuingMemberState": "PL",
                "cardNumber": "123456789",
                "cardIssuingAuthorityName": "PWPW S.A.",
                "cardIssueDate": "2021-03-24T00:00:00+00:00",
                "cardValidityBegin": "2021-04-11T00:00:00+00:00",
                "cardExpiryDate": "2026-04-10T23:59:59+00:00"
            },
            "driverCardHolderIdentification": {
                "cardHolderName": "Mustermann, Max",
                "cardHolderBirthDate": "08.06.1979",
                "cardHolderPreferredLanguage": "PL"
            },
            "certState": true
        }
    },
    "DriverActivityData": {
        "G1": {
            "cardDriverActivity": {
                "cardActivityDailyRecords": [
                    {
                        "cardActivityDailyRecord": {
                            "activityRecordDate": "2021-03-14T00:00:00+00:00",
                            "activityDayDistance": 0,
                            "activityChangeInfos": [
                                {
                                    "activityChangeInfo": {
                                        "slot": 0,
                                        "drivingStatus": 1,
                                        "cardStatus": 1,
                                        "activity": 0,
                                        "time": 0
                                    }
                                    [...]
                                }
                            ]
                        }
                    }
                    [...]
                ]
            },
            "certState": true
        }
    },
    "DriverLicenceInfo": {
        "G1": {
            "cardDrivingLicenceInformation": {
                "drivingLicenceIssuingAuthority": "Testamt",
                "drivingLicenceIssuingNation": "D",
                "drivingLicenceNumber": "12345789 "
            },
            "certState": true
        }
    },
    "Places": {
        "G1": {
            "cardPlaceDailyWorkPeriod": {
                "placeRecords": [
                    {
                        "placeRecord": {
                            "entryTime": "2021-04-11T04:26:45+00:00",
                            "entryTypeDailyWorkPeriod": 0,
                            "dailyWorkPeriodCountry": "D",
                            "dailyWorkPeriodRegion": 0,
                            "vehicleOdometerValue": 422050
                        }
                    }
                ]
            },
            "certState": true
        }
    },
    "VehiclesUsed": {
        "G1": {
            "cardVehiclesUsed": {
                "cardVehicleRecords": [
                    {
                        "vehicleOdometerBegin": 422050,
                        "vehicleOdometerEnd": 422050,
                        "vehicleFirstUse": "2021-04-11T04:26:45+00:00",
                        "vehicleLastUse": "2021-04-11T23:59:59+00:00",
                        "vehicleRegistration": {
                            "vehicleRegistrationNation": "D",
                            "vehicleRegistrationNumber": "YF 101"
                        }
                    }
                ]
            },
            "certState": true
        }
    }
}


Mögliche Fehlerwerte

FehlerBeschreibung
MISSING_COMPANYFirmenschlüssel fehlt
INVALID_COMPANYFirma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen. 
ERROR_MAINTENANCEIhre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich.
MISSING_IMPORTImport-Schlüssel fehlt.
MISSING_FILEEs wurde keine UUID angegeben.
NO_FILE_FOUNDEs wurde keine Digitacho Datei mit dieser UUID gefunden.
FILE_PARSING_FAILEDBeim Verarbeiten der vom Server abgerufenen Datei ist ein Fehler aufgetreten.
FILE_TYPE_NOT_SUPPORTEDDer Typ dieser Datei wird nicht unterstützt. Es ist ausschließlich das Abrufen von Fahrerdateien möglich.


Sv translation
languageen

Offers access to parsed data of a digitacho file. Only supports driver files.

Description

GET /get_ddd_details.php?company=RTI_COMPANYKEY&import=RTI_IMPORTKEY&file=UUID


Parameter

ParameterDescriptionTypeNoteMandatory
companyRTI company keystring
yes
importRTI import keystring
yes
fileUUID of requested filestringYou can get this value via get_file_list.php yes


Return

A string in Json format is returned. Returns "ERROR:description" on error.


General

A digitacho file consists of different data blocks. Not all blocks are always set. This RTI function will only return blocks that are available. Additionally you have to ditinct between data block of generation 1 data and generation 2 data. A potential block is therefore described as an object with the possible attributes G1 and G2. These might contain similar data. Generation 2 data can also hold additional information. This function only returns the raw data. You need to merge this data by yourself if needed.

The following block are returned if available:

  • information for driver identification (Identification)
  • activity records(DriverActivityData)
  • driver licence information (DriverLicenceInfo)
  • country codes(Places)
  • used vehicles (VehiclesUsed)
  • only for generation 2 cards: GPS data (GNSSPlaces)


You can find official information about the structure of digitacho files here. The return value of this function is based on this. Some data is already processed. For example you will receive countries as country codes, all data is encoded as UTF-8 and time values are formatted according to ISO 8601.

...


JSON

You can access the specification as a JSON Schema file here.

Code Block
titleexample of return value
{
    "Identification": {
        "G1": {
            "cardIdentification": {
                "cardIssuingMemberState": "PL",
                "cardNumber": "123456789",
                "cardIssuingAuthorityName": "PWPW S.A.",
                "cardIssueDate": "2021-03-24T00:00:00+00:00",
                "cardValidityBegin": "2021-04-11T00:00:00+00:00",
                "cardExpiryDate": "2026-04-10T23:59:59+00:00"
            },
            "driverCardHolderIdentification": {
                "cardHolderName": "Mustermann, Max",
                "cardHolderBirthDate": "08.06.1979",
                "cardHolderPreferredLanguage": "PL"
            },
            "certState": true
        }
    },
    "DriverActivityData": {
        "G1": {
            "cardDriverActivity": {
                "cardActivityDailyRecords": [
                    {
                        "cardActivityDailyRecord": {
                            "activityRecordDate": "2021-03-14T00:00:00+00:00",
                            "activityDayDistance": 0,
                            "activityChangeInfos": [
                                {
                                    "activityChangeInfo": {
                                        "slot": 0,
                                        "drivingStatus": 1,
                                        "cardStatus": 1,
                                        "activity": 0,
                                        "time": 0
                                    }
                                    [...]
                                }
                            ]
                        }
                    }
                    [...]
                ]
            },
            "certState": true
        }
    },
    "DriverLicenceInfo": {
        "G1": {
            "cardDrivingLicenceInformation": {
                "drivingLicenceIssuingAuthority": "Testamt",
                "drivingLicenceIssuingNation": "D",
                "drivingLicenceNumber": "12345789 "
            },
            "certState": true
        }
    },
    "Places": {
        "G1": {
            "cardPlaceDailyWorkPeriod": {
                "placeRecords": [
                    {
                        "placeRecord": {
                            "entryTime": "2021-04-11T04:26:45+00:00",
                            "entryTypeDailyWorkPeriod": 0,
                            "dailyWorkPeriodCountry": "D",
                            "dailyWorkPeriodRegion": 0,
                            "vehicleOdometerValue": 422050
                        }
                    }
                ]
            },
            "certState": true
        }
    },
    "VehiclesUsed": {
        "G1": {
            "cardVehiclesUsed": {
                "cardVehicleRecords": [
                    {
                        "vehicleOdometerBegin": 422050,
                        "vehicleOdometerEnd": 422050,
                        "vehicleFirstUse": "2021-04-11T04:26:45+00:00",
                        "vehicleLastUse": "2021-04-11T23:59:59+00:00",
                        "vehicleRegistration": {
                            "vehicleRegistrationNation": "D",
                            "vehicleRegistrationNumber": "YF 101"
                        }
                    }
                ]
            },
            "certState": true
        }
    }
}


Possible error values

ErrorDescription
MISSING_COMPANYcompany key is missing
INVALID_COMPANYCompany not found. Company key or import key might be faulty.
ERROR_MAINTENANCEYour company is under maintenance, no RTI request are possible at the moment.
MISSING_IMPORTimport key is missing
MISSING_FILENo UUID was given.
NO_FILE_FOUNDCould not find any digitacho file with this UUID.
FILE_PARSING_FAILEDAn error occured while trying to parse this file.
FILE_TYPE_NOT_SUPPORTEDFile type not supported. Only access for driver files.

Beispiele

...