Interne Stundensätze eines Mitarbeiters auflisten

Liefert die paginierte Liste der für den angegebenen Mitarbeiter erfassten internen Stundensätze (Kostensätze).

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

Request

GET /api/v1/employees/{username}/internal-rates

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/{username}/internal-rates' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Pfad-Parameter

Name
username
Type
string
Description
Der Benutzername des Mitarbeiters

Query-Parameter

Name
page
Type
integer, nullable
Description
Die zurückzugebende Ergebnisseite, beginnend bei 1.

Response

{
  "data": [
    {
      "id": 1,
      "employee_id": "max.mustermann",
      "start_date": "2024-01-15T00:00:00.000000Z",
      "internal_rate": 1.5,
      "note": "Familienurlaub",
      "monthly_rate": 1.5,
      "internal_rate_resets": 1.5,
      "rate_type": {
        "id": 1,
        "name": "hourly rate"
      },
      "created": "2024-07-20T11:30:00.000000Z",
      "modified": "2024-07-20T12:30:00.000000Z"
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "string",
        "label": "string",
        "active": true
      }
    ],
    "path": "string",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

Response-Felder

Name
id
Type
integer
Description
Eindeutige Kennung des internen Stundensatzes.
Name
employee_id
Type
string
Description
Benutzername des Mitarbeiters, für den dieser interne Stundensatz gilt.
Name
start_date
Type
string (date-time)
Description
Kalendertag, ab dem dieser interne Stundensatz gilt.
Name
internal_rate
Type
number, nullable
Description
Interner (Kosten-)Satz, der für die Zeit des Mitarbeiters angesetzt wird.
Name
note
Type
string, nullable
Description
Freitextnotiz zum internen Stundensatz.
Name
monthly_rate
Type
number, nullable
Description
Fester Monatssatz, der anstelle des Stundensatzes verwendet wird, sofern zutreffend.
Name
internal_rate_resets
Type
number, nullable
Description
Intervall, in dem der interne Stundensatz zurückgesetzt wird (z. B. monatlich, jährlich).
Name
rate_type
Type
object, nullable
Description
Ob der Satz stündlich oder als fester Monatsbetrag angesetzt wird.
Name
rate_type.id
Type
integer
Description
Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.
Name
rate_type.name
Type
string
Description
Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.
Einer der Werte: "hourly rate", "daily rate"
Name
created
Type
string (date-time), nullable
Description
Zeitstempel der Erstellung des internen Stundensatzes.
Name
modified
Type
string (date-time), nullable
Description
Zeitstempel der letzten Änderung des internen Stundensatzes.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.

PATCH Beschäftigungszeitraum aktualisieren GET Einzelnen internen Stundensatz abrufen