postPZEClockIn method

Future<RestApiResponse> postPZEClockIn({ String? employeeoid, String? key, })

Startet die Zeiterfassung (Einstempeln) für einen Mitarbeiter

Registriert den Arbeitsbeginn für die Personalzeiterfassung (PZE). Kann mit optionalem Schlüssel für verschiedene Tätigkeitsarten verwendet werden.

employeeoid - OID des Mitarbeiters (optional, Standard: aktueller Benutzer) key - Tätigkeitsschlüssel für verschiedene Arbeitsarten (optional)

Returns: RestApiResponse mit dem Status der Zeiterfassung

Beispiel:

RestApiResponse response = await api.v1.timeRecording.postPZEClockIn(
  employeeoid: "emp-12345",
  key: "PROJEKT_A"
);
if (response.isOk) {
  print("Zeiterfassung gestartet");
}

Hinweis zur neuen API: Stempelt einen Mitarbeiter ein (POST v1/pze/clockIn).

employeeoid/key landen nur bei Nicht-null im Body; der Body wird - wie im Legacy - IMMER gesendet (leer als {}).

Implementation

Future<RestApiResponse> postPZEClockIn({String? employeeoid, String? key}) {
  final Map<String, dynamic> body = <String, dynamic>{};
  if (employeeoid != null) body['employeeoid'] = employeeoid;
  if (key != null) body['key'] = key;

  return _runtime.execute(
    ApiRequest<RestApiResponse>(
      method: ApiHttpMethod.post,
      version: ApiVersion.v1,
      path: '/pze/clockIn',
      body: jsonEncode(body),
      authentication: AuthenticationPolicy.session,
      responsePolicy: _responsePolicy,
      operationId: 'v1.timeRecording.postPZEClockIn',
    ),
  );
}