Versions Compared

Old Version 8

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 9

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": "1790608029940001123456789",
                "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": "BarejMustermann, Marcin Karol 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.


...