Info |
---|
| Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar. Kunden mit der bisherigen Zeiterfassung nutzen bitte weiterhin die Funktion get_timerecording.asp |
Gibt alle empfangenen Zeiterfassungsbuchungen des abgefragten Zeitraumes zurück. Der Zeitraum kann dabei entweder nach Eingang der Buchungen oder gebuchter Zeit gewählt werden. 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 standardmäßig das Verarbeitungsdatum verwendet, damit ein chronologischer Datenabruf ohne Lücken oder Dopplungen möglich ist. Beschreibung getget_timerecording.php?output=bookingslist&company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&beginstart=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV&version=1&date_query=insert ParameterParameter | Beschreibung | Typ | Hinweis | Pflicht |
---|
company | RTI Firmenschlüssel | string |
|
| ja | import | RTI Importschlüssel | string |
| beginstart | 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 | format | Ausgabeformat | string | zulässige Ausgabeformate | CSVJSONXML | ja | version | Versionsnummer der Abfrage | integer | aktuell ist Version 1 sollte sich das Ausgabeformat ändern wird jeweils eine neue Versionsnummer vergeben | 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ückgabewerteEs wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung". Gibt einen JSON Formatierten Text zurück mit den angegebenen Details zu jeder Buchung. Beispiel Ausgabe(in Verbindung mit 'with_changes=1', werden geänderte Buchungszeiten mit beachtet) 'update' = NUR in Verbindung mit 'with_changes=1', allgemeine Rückgabe wie 'insert', wurde eine Buchung bearbeitet, zählt aber das Bearbeitungsdatum | nein | group | Bezeichnung der Personalgruppe, auf welche eingegrenzt werden soll | string | Es muss die exakte Bezeichnung einer Personalgruppe angegeben werden | nein | with_changes | Gibt an, ob portalseitige Bearbeitungen von Buchungen mit beachtet werden sollen. Im Portal gelöschte Buchungen werden dann auch nicht ausgegeben | integer | 0 (Standard) - die Buchungen werden immer so ausgegeben, wie ursprünglich erfasst 1 - Die Buchungen werden inklusive der Änderungen ausgegeben (wie im Portal) | nein |
RückgabeEs wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung". Gibt einen JSON Formatierten Text zurück mit den angegebenen Details zu jeder Buchung. Beispiel Ausgabe Code Block |
---|
language | js |
---|
title | JSON Ausgabe |
---|
| [
{
| Code Block |
---|
language | js |
---|
title | JSON Ausgabe |
---|
| [
{
"person": {
"id": "A23",
"key": "DF00000001234",
"nameperson": "Max Mustermann",{
"card_nrid": null
"A23",
},
"datetimekey": "2019-04-01 05:26:00DF00000001234",
"activity": {
"id"name": "1003Max Mustermann",
"namecard_nr": "Arbeitszeit"null
},
"terminaldatetime": "DD2019-04-YF 45601 05:26:00",
"positionactivity": {
"latid": 51.4"1003",
"lonname": 13.1,
"Arbeitszeit"
},
"addressterminal": "Am Wüsteberg 3, 01723 Kesselsdorf"
},{
"id": "M_123",
"name": "DD-YF 456"
}
"areaposition": null,{
"costcenterlat": {51.4,
"idlon": null13.1,
"nameaddress": null
"Am Wüsteberg 3, 01723 Kesselsdorf"
}
},
{ "area": null,
"personcostcenter": {
"id": "A23"null,
"keyname": "DF00000001234",null
}
"name": "Max Mustermann"},
{
"card_nrperson": null{
},
"datetimeid": "2019-04-01 12:35:00A23",
"activitykey": {"DF00000001234",
"idname": "1001Max Mustermann",
"namecard_nr": "Pause"null
},
"terminaldatetime": "Büro2019-04-01 12:35:00",
"positionactivity": {
"latid": 52.0"1001",
"lonname": 11.9,"Pause"
},
"addressterminal": "Am Wüsteberg 3, 01723 Kesselsdorf"
}{
"id": "F_17",
"name": "Büro",
"areaposition": null,{
"costcenterlat": {52.0,
"idlon": "K-47"11.9,
"nameaddress": "allgemeinesAm Wüsteberg 3, 01723 Kesselsdorf"
},
} |
Code Block |
---|
language | xml |
---|
title | XML Ausgabe |
---|
| <?xml version="1.0"?>
<bookings>
<booking>"area": null,
<person>"costcenter": {
<id/>"id": "K-47",
<key>DF00000001234</key> "name": "allgemeines"
}
} |
Code Block |
---|
language | xml |
---|
title | XML Ausgabe |
---|
| <?xml version="1.0"?>
<bookings><name>Max Mustermann</name>
<booking>
<card_nr/>
<person>
<<id/person>>
<datetime>2019-04-01 05:26:00</datetime> <key>DF00000001234</key>
<activity>
<name>Max Mustermann</name>
<id>1003</id>
<name>Arbeitszeit</name><card_nr/>
</activity>person>
<terminal>DD<datetime>2019-04-YF 456</terminal>01 05:26:00</datetime>
<position><activity>
<lat>51.0<<id>1003</lat>id>
<lon>13.1<<name>Arbeitszeit</lon>name>
<address>Am Wüsteberg 3, 01723 Kesselsdorf</address></activity>
</position>
<terminal>
<id>M_123</id>
<name>DD-YF 456</name>
</terminal>
<area/>
<position>
<costcenter> <lat>51.0</lat>
<id<lon>13.1</>lon>
<address>Am Wüsteberg 3, <name01723 Kesselsdorf</>address>
</costcenter>position>
</booking>
<booking><area/>
<person><costcenter>
<id/>
<key>DF00000001234<<name/key>>
</costcenter>
</booking>
<booking>
<person>
<id/>
<key>DF00000001234</key>
<name>Max Mustermann</name>
<card_nr/>
</person>
<datetime>2019-04-01 12:35:00</datetime>
<activity>
<id>1001</id>
<name>Pause</name>
</activity>
<terminal>Büro</terminal>
<terminal>
<id>F_17</id>
<name>Büro</name>
</terminal>
<position>
<lat>52.3</lat>
<lon>11.09</lon>
<address>Am Wüsteberg 3, 01723 Kesselsdorf</address>
</position>
<area/>
<costcenter>
<id>K-47</id>
<name>allgemeines</namename>
</costcenter>
</booking>
</bookings> |
Das CSV Format enthält eine Zeile pro Buchung mit allen jeweils vorhandenen Informationen. Trennzeichen | Semikolon ( ; ) |
---|
Textbegrenzer | Doppeltes Hochkomma ( " ) |
---|
Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Zeile 1 |
---|
Kodierung | Windows-1252 |
---|
CSV SpaltenSpalte | Beschreibung | |
---|
PERSON_ID | Selbstdefinierte Ident der Person. Im Portal Hinterlegbar als | optional selbstdefinierter Identifikator | Einstellbar unter Personalverwaltung - MA-Nr. | PERSON_KEY | Selbstdefinierter Buchungsschlüssel der Person |
| PERSON_NAME | Name der Person |
| PERSON_CARD_NR | Selbstdefinierbarer Buchungsschlüssel, im Portal einstellbar als Card Nroptional Buchungsschlüssel | Einstellbar unter Personalverwaltung - Card-Nr. | DATETIME | Zeitpunkt der Buchung | Format: TT.MM.JJJJ HH:MM:SS | ACTIVITY_ID | Technischer Ident einer Buchung, im Portal zur Tätigkeit hinterlegbar |
| ACTIVITY_NAME | Beschreibungstext, welcher für diese Buchung hinterlegt wurde |
| TERMINAL_ID | Bezeichner optional RTI Ident des Buchungsterminals |
typischerweise das hinterlegte Fahrzeugkennzeichen | LAT | Wenn vorhandenEinzustellen über die RTI Einstellungen | TERMINAL_NAME | Bezeichner des Buchungsterminals | typischerweise das hinterlegte Fahrzeugkennzeichen | LAT | optional | , Latitude zur Positionierung |
| LON | Wenn vorhanden otpional Longitude zur Positionierung |
| ADDRESS | Aufgelöster Positionstext |
|
| AREA | Gebiete, welche für diese Position festgelegt wurden | Trennzeichen: "%|%" | COST_CENTER_ID | optional technischer Ident zur identifikation einer gesetzten Kostenstelle |
|
| COST_CENTER_NAME | optional Name einer gesetzten Kostenstelle |
| Beispiel AusgabeBeispiel Ausgabe Code Block |
---|
| "PERSON_ID";"PERSON_KEY";"PERSON_NAME";"PERSON_CARD_NR";"DATETIME";"ACTIVITY_ID";"ACTIVITY_NAME";"TERMINAL_ID";"TERMINAL_NAME";"LAT";"LON;""ADDRESS";"AREA";"COST_CENTER_ID";"COST_CENTER_NAME" |
"A23";"DF000000000123";"Max Mustermann";"";"01.10. | 2019 082019 08:00:00";"1023";"Arbeit";"M_23";"DD-YF 123";"51.4";"13.1";"Musterstraße 17, 01234 Musterstadt";"Hauptzentrale";"K-47";"allgem. Arbeiten" |
"A23";"DF000000000123";"Max Mustermann";"";"01.10. | 2019 122019 12:00:00";"1024";"Pause";"M_23";"DD-YF 123";"52.0";"11.3";"Testweg 23, 91234 Testhausen";"Müller GmbH";"";"" |
Beispiele mit Geokoordinatenhttp | https://map.yellowfox.de/rti/get_timerecording.php? | output=bookingslist&company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY& | begin201511020000002015110823595920190605235959&format=CSV |
|