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 $'{}‘
