Sv translation

language	de

Info

title	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

Status

colour	Green
title	GET

getget_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 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ückgabewerte

Rückgabe

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

Rainer SCT

ReinerSCT Format

Es wird eine TXT Datei zurückgegeben. Die Formatierung der Rückgabe Datei entspricht den Anforderungen zum Import in die Rainer SCT ZeiterfassungReinerSCT 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	UTFWindows-81252

Spalten

)"

Spalte	BeschreibungBeschreibungBeschreibung
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 -> Zeiterfassung
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 nur für "mode=CSV" und "version=2"

Beispiel Ausgabe

Code Block

title	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

Code Block

title	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

Code Block

title	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

Sv translation

language	en

Info

title	Compatibility

This function is intended to be used with timerecording V2

If you are using the newer V3 version, please use get_timerecording.php

Returns all timerecording bookings within desired timerange.

Description

Status

colour	Green
title	GET

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	BeschreibungDescription	TypType	HinweisNote	PflichtMandatory
company	RTI Firmenschlüsselcompany key	string		yes	ja
import	RTI Importschlüsselimport key	string			jayes
beginStartzeitpunkt der Ausgabe	output start time	string	der Ausgabezeitraum darf maximal 31 Tage umfassen	ja
end	Endzeitpunkt der Ausgabe	string	der Ausgabezeitraum darf maximal 31 Tage umfassen	ja
the output timerange is limited to 31 days	yes
end	output end time	string	the output timerange is limited to 31 days	yes
mode	output format	string	valid output formats CSV RSCT BOTIME	yes	mode	Ausgabeformat	string	zulässige Ausgabeformate CSV RSCT	ja
version	alternative CSV Ausgabeoutput	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

a value of "2" add geocoordinates for output

no

date_query

which date column is base for date query

string

'insert' (default) : date of proceed

'gps' : date of timerecording message

no

Return

A string will be returned. In case of error "ERROR:Description".

Reiner SCT Format

The returning data matching the specification of Reiner SCT import definition.

Botime Format

The returning data matching the specification of BOTIME. A TXT file will be returned. The requested date is based on timerecording date and not the date of message processing.

CSV Format

On success, the data will be delivered in csv (comma seperated values) format. The first line always is defined as head with column names. The following rows containing the booking data.

Meta informations

Line break
Separator	Semicolon ( ; )
Delimiter	Double quote ( " )
Trennzeichen	Semikolon ( ; )
Textbegrenzer	Doppeltes Hochkomma ( " )
Zeilenende	0x0D 0x0A (CarriageReturn LineFeed)
Header	Zeile Row 1
KodierungEncoding	UTFWindows-81252

Spalten

Columns

JJJJ )Aufbau Kostenstelle Leerzeichen GebietsnameBeispiel101 Baustelle A%|%201 Baustelle Kunde Meiernur für und

SpalteColumn	BeschreibungBeschreibungDescription
DATETIMEZeitpunkt der Buchung (im Format: TT	Date	format DD.MM.	YYYY HH:MM:SS
ACTION	Kürzel, welche Buchung durchgeführt wurdeShort booging type definition	K, G, X, Y, B, E
ACTIONTEXT Beschreibungstext, welcher für diese Buchung hinterlegt wurde Festlegung unter Verwaltung -> Zeiterfassung	Description text for booking as defined	Definition set at Administration -> Timerecording
POSITION	Aufgelöster Positionstext
AREA	KostenstelleCost centers/Gebiete, welche für diese Position festgelegt wurden Trennzeichen areas, as defined for this Position	delimiter: "%\|%"	structure:	cost center +	space +	area name	example: "	101 construction site A%\|%201 construction site B%\|%456	customer smith"
DRIVERKEY	Schlüssel des Fahrers, der die Buchung getätigt hat
DRIVERNAME	Name des Fahrers, der die Buchung getätigt hat
personal key of person who did the booking
DRIVERNAME	name of person who did the booking
CAR	portal Name of object, where the booking was done	CAR	Kurzbezeichnung des Fahrzeugs bei dem die Buchung getätigt wurde
LAT	Latitude Beispiel	example: "51.4"	only for "mode=CSV"	and "version=2"
LON	Longitude	Beispielexample: "13.1" nur für only for "mode=CSV" und and "version=2"

Beispiel Ausgabe

Example

Code Block

title	return in csv

"DATETIME";"ACTION";"ACTIONTEXT";"POSITION";"AREA";"DRIVERKEY";"DRIVERNAME";"CAR";"LAT";"LON";
"01.10.2015 08:00:00";"K";"Arbeitsbeginnwork start";"MusterstraßeExamplestreet 17, 01234 MusterstadtExamplecity";"Hauptzentralehead office";"12345";"MaxSam MustermannSmith";"MU-YF 1";"51.4";"13.1";
"01.10.2015 08:00:00";"X";"Pausenbeginnpause start";"TestwegTestroad 23, 91234 TesthausenTestvillage";"MüllerJohn Doe GmbH";"12345";"MaxSam MustermannSmith";"MU-YF 1";"52";"11.3";

Beispiele

Example calls

Code Block

title	Abruf der Buchungen mit Geokoordinaten	get bookings with geo coordinates

httpshttp://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151102000000&end=20151108235959&mode=CSV&version=2

Code Block

title	Abruf der Buchungen für einen get bookings for Reiner SCT Importimport

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

Page tree

Versions Compared

Old Version 7

New Version Current

Key

Beschreibung

Parameter

Rückgabewerte

Rückgabe

ReinerSCT Format

Botime Format

CSV Format

Metainformationen

Spalten

Beispiel Ausgabe

Beispiele

Description

Beschreibung

Parameter

Rückgabewerte

Rainer SCT Format

CSV Format

Metainformationen

Return

Reiner SCT Format

Botime Format

CSV Format

Meta informations

Columns

Example

Example calls

Page tree

Page History

Versions Compared

Old Version 7

New Version Current

Key

Beschreibung

Parameter

Rückgabewerte

Rückgabe

ReinerSCT Format

Botime Format

CSV Format

Metainformationen

Spalten

Beispiel Ausgabe

Beispiele

Description

Beschreibung

Parameter

Rückgabewerte

Rainer SCT Format

CSV Format

Metainformationen

Return

Reiner SCT Format

Botime Format

CSV Format

Meta informations

Columns

Example

Example calls