Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Gibt alle empfangenen Zeiterfassungsbuchungen des abgefragten Zeitraumes zurück. Standradmäßig wird das Datum der Verarbeitung verwendet, damit auch nachgesendete Buchungen korrekt eingeordnet werden könnenDer 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 kann man chronologisch Daten abrufen und verpasst keinen Wertein 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

...

Gibt einen JSON Formatierten Text zurück mit allen Informationen zur Buchung.

...

den angegebenen Details zu jeder Buchung.

Beispiel Ausgabe

Code Block
languagejs
titleJSON 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"
        }
    }



Analog zum JSON Format werden hier alle Informationen im XML Format ausgegeben.
XML Format

CSV Format

Das CSV Format enthält eine Zeile pro Buchung mit allen jeweils vorhandenen Informationen.

...

Spalte

Beschreibung


 
PERSON_IDSelbstdefinierte Ident der Person. Im Portal Hinterlegbar als MA-Nr
PERSON_KEYSelbstdefinierter Buchungsschlüssel der Person
PERSON_NAMEName der Person
PERSON_CARD_NRSelbstdefinierbarer Buchungsschlüssel, im Portal einstellbar als Card Nr

DATETIME

Zeitpunkt der BuchungFormat: 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


TERMINALBezeichner des Buchungsterminalstypischerweise das hinterlegte Fahrzeugkennzeichen
LATWenn vorhanden, Latitude zur Positionierung
LONWenn vorhanden Longitude zur Positionierung
ADDRESSAufgelöster Positionstext 
AREA

Gebiete, welche für diese Position festgelegt wurden

Trennzeichen: "%|%" 

COST_CENTER_IDtechnischer Ident zur identifikation einer gesetzten Kostenstelle 
COST_CENTER_NAMEName einer gesetzten Kostenstelle 

Beispiel Ausgabe

"PERSON_ID";"PERSON_KEY";"PERSON_NAME";"PERSON_CARD_NR";"DATETIME";"ACTIVITY_ID";"ACTIVITY_NAME";"TERMINAL";"LAT";"LON;""ADDRESS";"AREA";"COST_CENTER_ID";"COST_CENTER_NAME"
"A23";"DF000000000123";"Max Mustermann";"";"01.10.2019 08:00:00";"1023";"Arbeit";"DD-YF 123";"51.4";"13.1";"Musterstraße 17, 01234 Musterstadt";"Hauptzentrale";"K-47";"allgem. Arbeiten"
"A23";"DF000000000123";"Max Mustermann";"";"01.10.2019 12:00:00";"1024";"Pause";"DD-YF 123";"52.0";"11.3";"Testweg 23, 91234 Testhausen";"Müller GmbH";"";""


  

...