Gibt die Liste aller öffentlich verfügbaren Berichte einer Firma inklusive des Downloadlinks zurück. Von Yellowfox berechnet Berichte liegen für den Abruf 7 Tage ab Generierung bereit.
| Info |
|---|
| Wir empfehlen die Reporte im CSV-Format zu generieren, um sie standardisiert weiterzuverarbeiten. Die CSV Struktur der Reporte kann man unter diesem Link einsehen |
Beschreibung get_report_list.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY ParameterParameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|
| company | RTI Firmenschlüssel | string |
| ja | | import | RTI Importschlüssel | string |
| ja | | format | Rückgabeformat | string | 'csv' oder 'json'. Standard bei Nichtangabe ist 'csv'. | nein |
RückgabeEs wird eine Zeichenkette zurückgegeben. Bei einem Fehler wird der "403 - Verboten: Zugriff verweigert." HTTP-Header gesendet.. Bei einer korrekten Anfrage werden die Berichtsdaten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste
Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Danach folgen die Daten. | Trennzeichen | Semikolon ( ; ) |
|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
|---|
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
|---|
| Header | Zeile 1 |
|---|
| Kodierung | UTF-8 |
|---|
SpaltenSpalte | Beschreibung |
|---|
| REPORTNAME | Name der Berichtsvorlage | | REPORTRANGE_FROM | Auswertungszeitraum Beginn | | REPORTRANGE_TO | Auswertungszeitraum Ende | | CREATE_DATE | Erstellungsdatum | | REPORT_TYPE | Numerische Repräsentation des Berichtstyps: - 1... Tagesfahrtenreport
- 2... Tagessummenreport
- 3... Tagesroutenreport
- 4... Betriebsstundenreport
- 5... Stillstandsreport
- 6... Temperaturschreiber
- 8... FMS/CAN - Fahrzeugvergleich
- 9... Zeiterfassung (alt)
- 10... Geschwindigkeitsreport
- 11... Tankreport
- 15... FMS/CAN - Fahrzeuganalyse
- 21... FMS/CAN - Fahrervergleich
- 22... Fahrerbewertung / Fahrstilanalyse
- 23... Gebiets-/KST-Auswertung
- 26... POI-Bericht
- 27... Tacho - Arbeitszeiten (alt)
- 29... Fahrer - Übergeschwindigkeiten
- 30... Spesenabrechnung
- 31... Telemetriereport
- 32... Zeiterfassung (neu)
- 34... Führerscheinkontrolle
- 35... Fahrzeugnutzung
- 36... Tacho - Arbeitszeiten (neu)
- 37... Tätigkeitsreport
- 38... Trailerreport
- 40... Tacho - Verstoßanalyse
- 43... Zeiterfassung - Monatsbericht
| | FORMAT | Dateiformat, z.B. html, pdf, xls... | | DOWNLOADLINK | Link zu der generierten Datei Achtung: Besonders große Excel-Berichte sind möglicherweise in mehrere Dateien geteilt und werden als ZIP Archiv zurückgegeben! |
| Code Block |
|---|
| [
{
"reportname":"Zeiterfassung Werkstatt",
"reportrange_from":"2020-12-01 00:00:00",
"reportrange_to":"2020-12-31 23:59:59",
"create_date":"2021-01-01 07:04:53",
"report_type":26,
"format":"html",
"downloadlink":"map.yellowfox.de/rc.php?i=REPORT_IDENT"
}
] |
Beispielaufrufe| Code Block |
|---|
| title | Beispielaufruf im CSV Format |
|---|
| https://map.yellowfox.de/rti/get_report_list.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&format=csv |
Beispielantwort| Code Block |
|---|
| title | Beispielantwort in CSV Format |
|---|
| "REPORTNAME";"REPORTRANGE_FROM";"REPORTRANGE_TO";"CREATE_DATE";"REPORT_TYPE";"FORMAT";"DOWNLOADLINK"
"Zeiterfassung Werkstatt";"2020-12-01 00:00:00";"2020-12-31 23:59:59";"2021-01-01 07:04:53";"32";"html";"map.yellowfox.de/rc.php?i=REPORT_IDENT"
"tägliche Serie POI-Bericht";"2020-12-25 00:00:00";"2020-12-31 23:59:59";"2021-01-01 07:09:20";"26";"pdf";"map.yellowfox.de/rc.php?i=REPORT_IDENT" |
|