Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede


Info
titleKompatibilität

Diese Funktion ist nur für Kunden mit aktivierter Zeiterfassung V3 verfügbar.


Gibt alle aktuell verfügbaren Kostenstellen der Zeiterfassung zurück.

Beschreibung

timerecording/get_costcenters.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&format=FORMAT_TYPE

Parameter

Parameter

Beschreibung

Typ

Hinweis

Pflicht

companyRTI Firmenschlüsselstring
ja
importRTI Importschlüsselstring
ja
formatAusgabeformatstring

zulässige Ausgabeformate

  • csv
  • json
  • xml
ja

Rückgabewerte

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

JSON Format

Gibt einen JSON Formatierten Text zurück mit den Eigenschaften jeder Kostenstelle.

Beispiel Ausgabe

Code Block
languagejs
titleJSON Ausgabe
[
	{ 
		ident: 'A100K1001',
		name: 'ArbeitenBaustelle B',
		colorvalid_from: 'CC00002021-01-01',
		isvalid_worktimeto: 1null,
		isplanned_standbytimeduration: 0
	}20000,
	{defined_activities: [
		{ ident: 'A200A100',
		name: 'Fahren' duration: 18000 },
		color{ ident: '00CC00A200',
		is_worktime: 1,
		is_standbytime: 0
	 duration: 2000 },
		{ 
		ident: 'P100A200',
		name: 'Pause',
		color: '0000CC',
		is_worktime duration: null }
	],
	allow_other_activities: 0,
		isdefined_standbytimepersons: 0[
	},
	{ 
		identid: 'B1002093',
		 name: 'Bereitschaft',
		color: '0000CC',
		is_worktime: 0,
		is_standbytime: 1
	}
'Max Mustermann' }
	]
}]


XML Format

Gibt einen XML Formatierten Text zurück mit den Eigenschaften jeder Kostenstelle.

Beispiel Ausgabe

Code Block
languagexml
titleXML Ausgabe
<?xml version="1.0" encoding="UTF-8"?>
<activities><costcenters>
<costcenter>
   <activity><defined_activities>
      <color>CC0000</color><activity>
      <ident>A100</ident>
   <duration>18000</duration>
   <is_standbytime>0</is_standbytime>
      <is_worktime>1</is_worktime><ident>A100</ident>
      <name>Arbeiten<</name>activity>
   </activity>
   <activity>
      <color>00CC00</color>   <duration>2000</duration>
         <ident>A200</ident>
      <is_standbytime>0</is_standbytime></activity>
      <is_worktime>1</is_worktime>
<activity>
       <name>Fahren</name>
   </activity><duration null="true" />
   <activity>
      <color>0000CC<<ident>A200</color>ident>
      <ident>P100<</ident>activity>
   </defined_activities>
   <is<allow_other_standbytime>0<activities>0</isallow_other_standbytime>activities>
   <ident>K1001</ident>
   <is_worktime>0</is_worktime><name>Baustelle B</name>
   <defined_persons>
      <name>Pause</name>
<person>
         <<id>2093</activity>ident>
    <activity>
     <name>Max <color>0000CC<Mustermann</color>name>
      <ident>B100<</ident>person>
   </defined_persons>
   <is<planned_standbytime>1<duration>20000</isplanned_standbytime>duration>
      <is_worktime>0</is_worktime><valid_from>2021-01-01</valid_from>
   <valid_to null="true"  <name>Bereitschaft</name>>
   </activity>costcenter>
</activities><costcenters>


CSV Format

Das CSV Format enthält eine Zeile pro Kostenstelle. Felder die mehrere Datensätze enthalten können, werden als JSON String ausgegeben.

Metainformationen

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1
KodierungUTF-8

CSV Spalten

Spalte

Beschreibung


 
identoptional selbst definierter Identifikator der TätigkeitEinstellbar unter Zeiterfassung > Einstellungen > Tätigkeiten
Die Standard-Tätigkeit "Gehen" hat immer einen "ident" von "0".
nameselbst definierter Name der Tätigkeit
colorselbst definierte Farbe der TätigkeitFormat: Hexadezimal
Die Standard-Tätigkeit "Gehen" hat hat keine Farbe.
is_worktimeOption ob diese Tätigkeit Bestandteil der Arbeitszeit ist oder nicht.Mögliche Werte: 0 oder 1
is_standbytimeOption ob diese Tätigkeit Bestandteil einer Bereitschaftszeit ist oder nicht.Mögliche Werte: 0 oder 1

Beispiel Ausgabe


"ident";"name";"
color
valid_from"";
"is
valid_
worktime
to";"
is_standbytime"
"A100
planned_duration";"
Arbeiten
defined_activities";"
CC0000
allow_other_activities";"
1
defined_persons"
;

"
0
K1001"

"A200"
;"
Fahren
Baustelle B";"
00CC00
2021-01-01";"
1
";"
0
20000"

"P100";"Pause";"0000CC";"0";"0"
"B100";"Bereitschaft";"0000CC";"0";"1
;"[{ ident: 'A100', duration: 18000 },{ ident: 'A200', duration: 2000 },{ ident: 'A200', duration: null }]";"0";"[{id:'2093',name:'Max Mustermann'}]"


 Beispiele


Code Block
titleAbruf der Buchungen im CSV Format
http://map.yellowfox.de/rti/timerecording/get_activities.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&format=csv


...