get_timerecording.asp

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37

Inhaltsverzeichnis

Beschreibung
Parameter
Rückgabe
Beispiele

Kompatibilität
Diese Funktion ist für Nutzer der Zeiterfassung V2 gedacht.
Sollten Sie bereits die Zeiterfassung V3 verwenden, nutzen Sie bitte de Funktion get_timerecording.php

Gibt alle empfangenen Zeiterfassungsbuchungen des abgefragten Zeitraumes zurück. Es wird das Verarbeitungsdatum verwendet. D.h. wann bei uns die Meldungen verarbeitet wurden.
Falls die Zeiterfassungsbuchungen aus den Digitacho Dateien erstellt werden ist zu beachten, das es zu Verzögerungen kommt. Es muss erst die jeweilige Datei vom Fahrzeug heruntergeladen werden und danach noch exportiert werden. Dies kann zu mehreren Stunden, eventuell sogar Tagen, Verzögerung führen. Deshalb wird auch das Verarbeitungsdatum verwendet, damit kann man chronologisch Daten abrufen und verpasst keinen Wert.

Beschreibung

GET get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2&date_query=insert

Parameter

Parameter	Beschreibung	Typ	Hinweis	Pflicht
company	RTI Firmenschlüssel	string		ja
import	RTI Importschlüssel	string		ja
begin	Startzeitpunkt der Ausgabe	string	der Ausgabezeitraum darf maximal 31 Tage umfassen	ja
end	Endzeitpunkt der Ausgabe	string	der Ausgabezeitraum darf maximal 31 Tage umfassen	ja
mode	Ausgabeformat	string	zulässige Ausgabeformate CSV RSCT BOTIME	ja
version	alternative CSV Ausgabe	integer	ein Wert von "2" bei der CSV Ausgabe fügt die Geokoordinaten hinzu	nein
date_query	Welches Datum bildet die Grundlage für die Zeitraumeingrenzung	string	'insert' (Standard) = Verarbeitungsdatum 'gps' = Datum an dem die Zeitbuchung stattgefunden hat	nein

Rückgabe

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

ReinerSCT Format

Es wird eine TXT Datei zurückgegeben. Die Formatierung der Datei entspricht den Anforderungen zum Import in ReinerSCT timeCard.

Botime Format

Es wird eine TXT Datei zurückgegeben. Die Formatierung entspricht der für das Zeiterfassungsprogramm BOTIME. Es werden lediglich Kommen und Gehen Buchungen übertragen. Datumsquelle ist das Datum, wann die Meldung entstanden ist, nicht wann es verarbeitet wurde.

CSV Format

Bei einer korrekten Anfrage werden die Daten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Dannach folgen dann die Daten

Metainformationen

Trennzeichen	Semikolon ( ; )
Textbegrenzer	Doppeltes Hochkomma ( " )
Zeilenende	0x0D 0x0A (CarriageReturn LineFeed)
Header	Zeile 1
Kodierung	Windows-1252

Spalten

Spalte	Beschreibung
DATETIME	Zeitpunkt der Buchung	Format: TT.MM.JJJJ HH:MM:SS
ACTION	Kürzel, welche Buchung durchgeführt wurde	K, G, X, Y, B, E
ACTIONTEXT	Beschreibungstext, welcher für diese Buchung hinterlegt wurde	Festlegung unter Verwaltung -> Timerecording
POSITION	Aufgelöster Positionstext
AREA	Kostenstelle/Gebiete, welche für diese Position festgelegt wurden	Trennzeichen: "%\|%" Aufbau: Kostenstelle + Leerzeichen + Gebietsname Beispiel: "101 Baustelle A%\|%201 Baustelle B%\|%456 Kunde Meier"
DRIVERKEY	Schlüssel des Fahrers, der die Buchung getätigt hat
DRIVERNAME	Name des Fahrers, der die Buchung getätigt hat
CAR	Kurzbezeichnung des Fahrzeugs bei dem die Buchung getätigt wurde
LAT	Latitude	Beispiel: "51.4" nur für "mode=CSV" und "version=2
LON	Longitude	Beispiel: "13.1" nur für "mode=CSV" und "version=2

Beispiel Ausgabe

Ausgabe als CSV
"DATETIME";"ACTION";"ACTIONTEXT";"POSITION";"AREA";"DRIVERKEY";"DRIVERNAME";"CAR";"LAT";"LON";
"01.10.2015 08:00:00";"K";"Arbeitsbeginn";"Musterstraße 17, 01234 Musterstadt";"Hauptzentrale";"12345";"Max Mustermann";"MU-YF 1";"51.4";"13.1";
"01.10.2015 08:00:00";"X";"Pausenbeginn";"Testweg 23, 91234 Testhausen";"Müller GmbH";"12345";"Max Mustermann";"MU-YF 1";"52";"11.3";

Beispiele

Abruf der Buchungen mit Geokoordinaten
https://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151102000000&end=20151108235959&mode=CSV&version=2

Abruf der Buchungen für einen Reiner SCT Import
https://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT