Ausgaben
Mit diesem Endpoint können Sie:
- Alle Ausgaben auflisten ohne Filter
- Alle Ausgaben auflisten mit Filter
- Bestimmte Ausgabe abrufen
- Neue Ausgabe anlegen
- Bestehende Ausgabe updaten
- Ausgabe entfernen
Ausgaben-Objekt hat folgende Parameter:
| Feldname | Typ | Beschreibung |
|---|
| ID | Integer | ID |
| user | Text | Benutzername |
| clientName | Text | Kundenname |
| projectName | Text | Projektname |
| name | Text | Ausgabenname |
| price | Number | Preis |
| quantity | Integer | Anzahl / Stück / Menge |
| billable | Boolean | Verrechenbar oder nicht |
| payType | Text | Bezahlart, z.B. Kreditkarte, Bar |
| details | Text | Notizen |
| tags | Text | Hashtags |
| date | Text | Zeitstempel der Erfassung – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
Ausgaben auflisten ohne Filter
curl “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’
Ausgaben auflisten mit Filter
Folgende Filter können verwendet werden:
| Feldname | Typ | Beschreibung |
|---|
| name | Text | Bezeichnung der Ausgabe / Ausgabenname |
| projectName | Text | Projektname |
| clientName | Text | Kundenname |
| user | Text | Benutzername |
| from | Text | Von, Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
| to | Text | Bis, Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
In diesem Beispiel fragen wir nach den Ausgaben des Benutzers “hansm” zwischen 01.10.2020 und 23.10.2020.
curl “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses?username=hansm&from=2020-10-01T00:00:00.000Z&to=2020-10-23T23:59:59.999Z””
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’
Bestimmte Ausgabe abrufen
Pflichtparameter: ID der Ausgabe. Im folgenden Beispiel ist die ID 1.
curl “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/1”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’
Neue Ausgabe anlegen
Beim Anlegen der Ausgabe können Sie alle Parameter des Ausgaben-Objekts verwenden.
Pflichtparameter: clientName, projectName, user, name, quantity, price, date
curl -X “POST” “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“quantity”: 1,
“price”: 25.5,
“clientName”: “Kunde 006”,
“date”: “2020-10-20T10:00:00.000Z”,
“username”: “hansm”,
“projectName”: “Projekt 006_1”,
“name”: “Ticket”
}’
Bestehende Ausgabe updaten
Beim Updaten der Ausgabe können Sie alle Parameter des Ausgaben-Objekts verwenden, mit Ausnahme folgender Parameter: clientName, projectName, user, name.
curl -X “PUT” “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/1”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“price”: 35.5,
“notes”: “Test Ausgabe für das API”
}’
Ausgabe entfernen
curl -X “DELETE” “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/1”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’
