get_d8_driver_time.php

Zuletzt geändert von YellowFox_RD am 2025/10/30 10:40

Inhaltsverzeichnis

Gibt aktuelle Informationen bezüglich Lenkzeit, Arbeitszeit, Restlenkzeit, Schichtbeginn vom aktuellen Tag, Woche und Doppelwoche eines Fahrers zurück auf Basis der Digitacho Infoschnittstelle (D8).

Beschreibung

GET get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring ja
importRTI Importschlüsselstring ja
driverFahrerschlüsselstring ja
formatRückgabeformatstringcsv oder json (Standard)nein

Rückgabe

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

CSV Format

Metainformationen

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten

SpalteBeschreibung 
DRIVER_NAMEFahrername 
DRIVER_KEYFahrerschlüssel 
STEER_SECONDSTagesaktuelle Lenkzeit in Sekunden 
STEER_TIMETagesaktuelle LenkzeitFormat 0h 00m
WORK_SECONDSTagesaktuelle Arbeitszeit in Sekunden 
WORK_TIMETagesaktuelle ArbeitszeitFormat 0h 00m
IDLE_SECONDSGebuchte Ruhezeiten innerhalb der aktuellen Schicht in Sekunden 
IDLE_TIMEGebuchte Ruhezeit innerhalb der aktuellen SchichtFormat 0h 00m
REMAINING_SECONDSTagesrestlenkzeit in Sekunden ohne ArbZG 
REMAINING_TIMETagesrestlenkzeit ohne ArbZGFormat 0h 00m
REMAINING_SECONDS_COMBINEDTagesrestlenkzeit in Sekunden mit ArbZG 
REMAINING_TIME_COMBINEDTagesrestlenkzeit mit ArbZGFormat 0h 00m
SHIFT_STARTSchichtbeginnFormat YYYY-MM-DD HH:MM:SS
WEEK_STEER_SECONDSWochenlenkzeit in Sekunden 
WEEK_STEER_TIMEWochenlenkzeitFormat 0h 00m
WEEK_WORK_SECONDSWochenarbeitszeit in Sekunden 
WEEK_WORK_TIMEWochenarbeitszeitFormat 0h 00m
WEEK_REMAINING_SECONDSWochenrestlenkzeit in Sekunden ohne ArbZG 
WEEK_REMAINING_TIMEWochenrestlenkzeit ohne ArbZGFormat 0h 00m
WEEK_REMAINING_SECONDS_COMBINEDWochenrestlenkzeit in Sekunden mit ArbZG 
WEEK_REMAINING_TIME_COMBINEDWochenrestlenkzeit mit ArbZGFormat 0h 00m
WEEK_STARTWochenstartFormat YYYY-MM-DD HH:MM:SS
DBL_WEEK_STEER_SECONDSDoppelwochenlenkzeit in Sekunden 
DBL_WEEK_STEER_TIMEDoppelwochenlenkzeitFormat 0h 00m
DBL_WEEK_WORK_SECONDSDoppelwochenarbeitszeit in Sekunden 
DBL_WEEK_WORK_TIMEDoppelwochenarbeitszeitFormat 0h 00m
DBL_WEEK_REMAINING_SECONDSDoppelwochenrestlenkzeit in Sekunden 
DBL_WEEK_REMAINING_TIMEDoppelwochenrestlenkzeitFormat 0h 00m
DBL_WEEK_STARTStart der DoppelwocheFormat YYYY-MM-DD HH:MM:SS
BLOCK_STEER_TIME_SECONDSLenkzeit seit der letzten Pause in Sekunden 
BLOCK_STEER_TIMELenkzeit seit der letzten PauseFormat 0h 00m
BLOCK_REMAINING_TIME_SECONDSRestlenkzeit bis zur nächsten Pause in Sekunden ohne ArbZG 
BLOCK_REMAINING_TIMERestlenkzeit bis zur nächsten Pause ohne ArbZGFormat 0h 00m
BLOCK_REMAINING_TIME_SECONDS_COMBINEDRestlenkzeit bis zur nächsten Pause in Sekunden mit ArbZG 
BLOCK_REMAINING_TIME_COMBINEDRestlenkzeit bis zur nächsten Pause mit ArbZGFormat 0h 00m
NEXT_BREAK_DURATION_SECONDSDauer der nächsten Pause in Sekunden 
NEXT_BREAK_DURATIONDauer der nächsten PauseFormat 0h 00m
LAST_TACHOGRAPH_STATUSAktivitätsstatus der letzten Tacho-Buchung
0 .. Ruhe
1 .. Bereitschaft
2 .. Arbeit
3 .. Lenken
 
LAST_TACHOGRAPH_TIMEZeitpunkt der letzten BuchungFormat YYYY-MM-DD HH:MM:SS
LAST_TACHOGRAPH_SLOTTacho-Slot in dem diese Buchung vorgenommen wurde
1 .. Fahrer
2 .. Beifahrer
 
WEEK_SHORT_IDLES_TIMESAnzahl verkürzter Ruhezeiten innerhalb der aktuellen Schichtwoche 
WEEK_EXTENDED_STEER_TIMESAnzahl der Schichttage mit langen Lenkzeiten innerhalb der aktuellen Schichtwoche.
  • reguläre Tageslenkzeit <= 9h, 
  • 9h < lange Tageslenkzeit <= 10h
 

Beispiel
DRIVER_NAME;DRIVER_KEY;STEER_SECONDS;STEER_TIME;WORK_SECONDS;WORK_TIME;IDLE_SECONDS;IDLE_TIME;REMAINING_SECONDS;REMAINING_TIME;REMAINING_SECONDS_COMBINED;REMAINING_TIME_COMBINED;SHIFT_START;WEEK_STEER_SECONDS;WEEK_STEER_TIME;WEEK_WORK_SECONDS;WEEK_WORK_TIME;WEEK_REMAINING_SECONDS;WEEK_REMAINING_TIME;WEEK_REMAINING_SECONDS_COMBINED;WEEK_REMAINING_TIME_COMBINED;WEEK_START;DBL_WEEK_STEER_SECONDS;DBL_WEEK_STEER_TIME;DBL_WEEK_WORK_SECONDS;DBL_WEEK_WORK_TIME;DBL_WEEK_REMAINING_SECONDS;DBL_WEEK_REMAINING_TIME;DBL_WEEK_START;BLOCK_STEER_TIME_SECONDS;BLOCK_STEER_TIME;BLOCK_REMAINING_TIME_SECONDS;BLOCK_REMAINING_TIME;BLOCK_REMAINING_TIME_SECONDS_COMBINED;BLOCK_REMAINING_TIME_COMBINED;NEXT_BREAK_DURATION_SECONDS;NEXT_BREAK_DURATION;LAST_TACHOGRAPH_STATUS;LAST_TACHOGRAPH_TIME;LAST_TACHOGRAPH_SLOT;WEEK_SHORT_IDLES_TIMES;WEEK_EXTENDED_STEER_TIMES
Musternamm, Paul;DF00011424169815;14700;4 h 5 m;16320;4 h 32 m;12123;3 h 22 m;21300;5 h 55 m;19680;5 h 28 m;30.10.2025 00:56;75840;21 h 4 m;81720;22 h 42 m;106920;29 h 42 m;106920;29 h 42 m;27.10.2025 00:00;217080;60 h 18 m;234120;65 h 2 m;106920;29 h 42 m;20.10.2025 00:00;3780;1 h 3 m;12420;3 h 27 m;12420;3 h 27 m;1800;0 h 30 m;0;30.10.2025 08:08;1;1;1

JSON Format

Spalten

SpalteBeschreibung 
driverNameFahrername 
driverKeyFahrerschlüssel 
steerTimeSecondsTagesaktuelle Lenkzeit in Sekunden 
steerTimeTagesaktuelle LenkzeitFormat 0h 00m
workTimeSecondsTagesaktuelle Arbeitszeit in Sekunden 
workTimeTagesaktuelle ArbeitszeitFormat 0h 00m
idleTimeSecondsgebuchte Ruhezeit innerhalb der aktuellen Schicht in Sekunden 
idleTimegebuchte Ruhezeit innerhalb der aktuellen SchichtFormat 0h 00m
remainingTimeSecondsTagesrestlenkzeit in Sekunden ohne ArbZG 
remainingTimeTagesrestlenkzeit ohne ArbZGFormat 0h 00m
remainingTimeSecondsCombinedTagesrestlenkzeit in Sekunden mit ArbZG 
remainingTimeCombinedTagesrestlenkzeit mit ArbZGFormat 0h 00m
blockSteerTimeSecondsLenkzeit seit der letzten Pause in Sekunden 
blockSteerTimeLenkzeit seit der letzten PauseFormat 0h 00m
blockRemainingTimeSecondsRestlenkzeit bis zur nächsten Pause in Sekunden ohne ArbZG 
blockRemainingTimeRestlenkzeit bis zur nächsten Pause ohne ArbZGFormat 0h 00m
blockRemainingTimeSecondsCombinedRestlenkzeit bis zur nächsten Pause in Sekunden mit ArbZG 
blockRemainingTimeCombinedRestlenkzeit bis zur nächsten Pause mit ArbZGFormat 0h 00m
nextBreakDurationSecondsDauer der nächsten Pause in Sekunden 
nextBreakDurationDauer der nächsten PauseFormat 0h 00m
shiftStartSchichtbeginnFormat YYYY-MM-DD HH:MM:SS
steerTimeSecondsSingleWeekWochenlenkzeit in Sekunden 
steerTimeSingleWeekWochenlenkzeitFormat 0h 00m
workTimeSecondsSingleWeekWochenarbeitszeit in Sekunden 
workTimeSingleWeekWochenarbeitszeitFormat 0h 00m
remainingTimeSecondsSingleWeekWochenrestlenkzeit in Sekunden ohne ArbZG 
remainingTimeSecondsSingleWeekCominedWochenrestlenkzeit in Sekunden mit ArbZG 
remainingTimeSingleWeekWochenrestlenkzeit ohne ArbZGFormat 0h 00m
remainingTimeSingleWeekCombinedWochenrestlenkzeit mit ArbZGFormat 0h 00m
startSingleWeekWochenstartFormat YYYY-MM-DD HH:MM:SS
singleWeekShortIdlesAnzahl verkürzter Ruhezeiten innerhalb der aktuellen Schichtwoche 
singleWeekExtendedSteerAnzahl der Schichttage mit langen Lenkzeiten innerhalb der aktuellen Schichtwoche.
  • reguläre Tageslenkzeit <= 9h, 
  • 9h < lange Tageslenkzeit <= 10h
 
steerTimeSecondsDoubleWeekDoppelwochenlenkzeit in Sekunden 
steerTimeDoubleWeekDoppelwochenlenkzeitFormat 0h 00m
workTimeSecondsDoubleWeekDoppelwochenarbeitszeit in Sekunden 
workTimeDoubleWeekDoppelwochenarbeitszeitFormat 0h 00m
remainingTimeSecondsDoubleWeekDoppelwochenrestlenkzeit in Sekunden 
remainingTimeDoubleWeekDoppelwochenrestlenkzeitFormat 0h 00m
startDoubleWeekStart der DoppelwocheFormat YYYY-MM-DD HH:MM:SS
lastTachographStatusAktivitätsstatus der letzten Tacho-Buchung
0 .. Ruhe
1 .. Bereitschaft
2 .. Arbeit
3 .. Lenken
 
lastTachographTimeZeitpunkt der letzten BuchungFormat YYYY-MM-DD HH:MM:SS
lastTachographSlotTacho-Slot in dem diese Buchung vorgenommen wurde
1 .. Fahrer
2 .. Beifahrer
 

Beispiel
{"driverName":"Mustermann, Paul","driverKey":"DF0123456789815","steerTimeSeconds":14700,"steerTime":"4 h 5 m","workTimeSeconds":16320,"workTime":"4 h 32 m","idleTimeSeconds":12775,"idleTime":"3 h 33 m","remainingTimeSeconds":21300,"remainingTime":"5 h 55 m","remainingTimeSecondsCombined":19680,"remainingTimeCombined":"5 h 28 m","blockSteerTimeSeconds":3780,"blockSteerTime":"1 h 3 m","blockRemainingTimeSeconds":12420,"blockRemainingTime":"3 h 27 m","blockRemainingTimeSecondsCombined":12420,"blockRemainingTimeCombined":"3 h 27 m","nextBreakDurationSeconds":1800,"nextBreakDuration":"0 h 30 m","shiftStart":"2025-10-30 00:56:00","steerTimeSecondsSingleWeek":75840,"steerTimeSingleWeek":"21 h 4 m","workTimeSecondsSingleWeek":81720,"workTimeSingleWeek":"22 h 42 m","remainingTimeSecondsSingleWeek":106920,"remainingTimeSingleWeek":"29 h 42 m","remainingTimeSecondsSingleWeekCombined":106920,"remainingTimeSingleWeekCombined":"29 h 42 m","startSingleWeek":"2025-10-27 00:00:00","singleWeekShortIdles":1,"singleWeekExtendedSteer":1,"steerTimeSecondsDoubleWeek":217080,"steerTimeDoubleWeek":"60 h 18 m","workTimeSecondsDoubleWeek":234120,"workTimeDoubleWeek":"65 h 2 m","remainingTimeSecondsDoubleWeek":106920,"remainingTimeDoubleWeek":"29 h 42 m","startDoubleWeek":"2025-10-20 00:00:00","lastTachographStatus":0,"lastTachographTime":"2025-10-30 08:08:00","lastTachographSlot":1}

Beispielaufrufe

Abfrage im JSON Format
https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000

Abfrage im CSV Format
https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv