- Created by YellowFox R&D, last modified on May 24, 2019
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 6 Next »
You have English selected as language but this page has not been translated yet. Translate the page or view the content in the default space language below.
Display defaultKompatibilität
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
get_timerecording.php?output=bookingslist&company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV&version=1&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 |
format | Ausgabeformat | string | zulässige Ausgabeformate
| 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ückgabewerte
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung".
JSON Format
Gibt einen JSON Formatierten Text zurück mit den angegebenen Details zu jeder Buchung.
Beispiel Ausgabe
[ { "person": { "id": "A23", "key": "DF00000001234", "name": "Max Mustermann", "card_nr": null }, "datetime": "2019-04-01 05:26:00", "activity": { "id": "1003", "name": "Arbeitszeit" }, "terminal": "DD-YF 456", "position": { "lat": 51.4, "lon": 13.1, "address": "Am Wüsteberg 3, 01723 Kesselsdorf" }, "area": null, "costcenter": { "id": null, "name": null } }, { "person": { "id": "A23", "key": "DF00000001234", "name": "Max Mustermann", "card_nr": null }, "datetime": "2019-04-01 12:35:00", "activity": { "id": "1001", "name": "Pause" }, "terminal": "Büro", "position": { "lat": 52.0, "lon": 11.9, "address": "Am Wüsteberg 3, 01723 Kesselsdorf" }, "area": null, "costcenter": { "id": "K-47", "name": "allgemeines" } }
XML Format
<?xml version="1.0"?> <bookings> <booking> <person> <id/> <key>DF00000001234</key> <name>Max Mustermann</name> <card_nr/> </person> <datetime>2019-04-01 05:26:00</datetime> <activity> <id>1003</id> <name>Arbeitszeit</name> </activity> <terminal>DD-YF 456</terminal> <position> <lat>51.0</lat> <lon>13.1</lon> <address>Am Wüsteberg 3, 01723 Kesselsdorf</address> </position> <area/> <costcenter> <id/> <name/> </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> <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</name </costcenter> </booking> </bookings>
CSV Format
Das CSV Format enthält eine Zeile pro Buchung mit allen jeweils vorhandenen Informationen.
Metainformationen
Trennzeichen | Semikolon ( ; ) |
---|---|
Textbegrenzer | Doppeltes Hochkomma ( " ) |
Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
Header | Zeile 1 |
Kodierung | Windows-1252 |
CSV Spalten
Spalte | Beschreibung | |
---|---|---|
PERSON_ID | Selbstdefinierte Ident der Person. Im Portal Hinterlegbar als 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 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 | Bezeichner des Buchungsterminals | typischerweise das hinterlegte Fahrzeugkennzeichen |
LAT | Wenn vorhanden, Latitude zur Positionierung | |
LON | Wenn vorhanden Longitude zur Positionierung | |
ADDRESS | Aufgelöster Positionstext | |
AREA | Gebiete, welche für diese Position festgelegt wurden | Trennzeichen: "%|%" |
COST_CENTER_ID | technischer Ident zur identifikation einer gesetzten Kostenstelle | |
COST_CENTER_NAME | Name einer gesetzten Kostenstelle |
Beispiel Ausgabe
|
Beispiele
Abruf der Buchungen mit Geokoordinaten
- No labels