Versions Compared

Old Version 2

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 3

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

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.

...

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": "1790608029940001",
                "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": "Barej, Marcin Karol",
                "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.

Beispiele

...