REST DokumentationMitarbeiterGET Interne Stundensätze eines Mitarbeiters auflisten

Interne Stundensätze eines Mitarbeiters auflisten

Liefert die paginierte Liste der für den angegebenen Mitarbeiter erfassten internen Stundensätze (Kostensätze). Die Seitengröße wird mit limit festgelegt.

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
    limit
    Type
    integer, nullable
    Description

    Die Anzahl der Datensätze pro Seite, 1 bis 200. Standardwert ist 15.

  • 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.