Gibt alle empfangenen Zeiterfassungsbuchungen des abgefragten Zeitraumes zurück.

Beschreibung

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

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	ja
version	alternative CSV Ausgabe	integer	ein Wert von "2" bei der CSV Ausgabe fügt die Geokoordinaten hinzu	nein

Rückgabewerte

Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

Rainer SCT Format

Die Formatierung der Rückgabe entspricht den Anforderungen zum Import in die Rainer SCT Zeiterfassung.

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	UTF-8

Spalten

Spalte	BeschreibungBeschreibung
DATETIME	Zeitpunkt der Buchung (im 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

"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

http://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

http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT

Page tree

get_timerecording.asp