• Beschreibung
• Parameter
• Rückgabe
• Generelles
  • JSON
  • Mögliche Fehlerwerte

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

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:

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.
Beispiel 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