1. Prozess der Buchung und Zuweisung zu Töpfen:

   1. Zerschneiden der Buchungen:
      Die Buchungen eines Tages werden in einzelne Abschnitte unterteilt, wobei der Beginn und das Ende der Buchung zusammengeführt werden.

   2. Abgleich mit den Regeln für den Tag:
      Diese Abschnitte werden dann mit den festgelegten Regeln für den Tag abgeglichen. Beispiele:

      • Samstag: Über 50 Jahre (Ü50)

      • Vor 06:00 Uhr: Ü50

      • Zwischen 07:00 und 15:12 Uhr: Fahrzeitlohnart

   3. Zuweisung zu den Töpfen:
      Die Buchungen werden in verschiedene Töpfe abgelegt, wobei jeder Topf mehrere Lohnarten beinhalten kann. Zum Beispiel kann der Topf für die Normalarbeitszeit (NAZ) auch Urlaubsbuchungen und Fahrten beinhalten.

Was ist ein "Topf"?

Ein "Topf" ist ein Behälter, der:

• Ein bestimmtes Zeitintervall abdeckt (z.B. Tages-, Wochen-, Monats- oder Jahrestöpfe).

• Eine oder mehrere Lohnarten aufnehmen kann.

• Ein Faktor zur Berechnung von Zuschlägen oder Abschlägen beinhaltet. Beispiel:

  • Ü50-Topf: Faktor = 150

  • ZA15-Topf: Faktor = 115

Optional hat der Topf:

• Eine maximale Füllmenge: z.B.

  • Normalarbeitszeit-Tag: 7,7 Stunden

  • Normalarbeitszeit-Woche: 38,5 Stunden

  • MAZ-Tag: 1,3 Stunden

  • MAZ-Woche: 1,5 Stunden maximal

• Eine minimale Füllmenge: z.B.

  • Normalarbeitszeit-Woche: mindestens 38,5 Stunden

Füllung der Töpfe:

• Maximale Grenze überschritten:
  Wenn ein Topf seine maximale Füllmenge erreicht hat, wird der überschüssige Wert in den nächsten Topf übertragen.

• Mindestfüllmenge nicht erreicht:
  Wenn ein Topf am Ende seines Zeitraums nicht die Mindestfüllmenge erreicht, wird dieser folgendermaßen aufgefüllt:

  1. Der Algorithmus prüft die Töpfe rechts vom aktuellen Topf. Er geht weiter, bis ein Topf mit einem höheren Faktor gefunden wird. Beispiel:

     • Von NAZ geht es weiter zu MAZ, dann zu ZA0, und so weiter.

  2. Sobald ein Topf mit einem höheren Faktor gefunden wurde, wird der benötigte Betrag aus diesem Topf entnommen – z.B. aus ZA0.

  3. Falls nach dieser Entnahme noch immer etwas fehlt, wird der nächste Topf mit dem gleichen oder einem höheren Faktor überprüft – z.B. von ZA0 zu MAZ.

  4. Wenn auch nach dieser Entnahme noch etwas fehlt, beginnt der Prozess erneut mit dem nächsthöheren Faktor.

Beispiel für die Reihenfolge der Töpfe:

• Fahrzeit außerhalb Normalarbeitszeit (FZ außerhalb NAZ)

• Normalarbeitszeit (NAZ)

• Mehrarbeitszeit (MAZ)

• Zuschlagsarten (ZA0)

• Zuschlagsarten (ZA15)

• Zuschlagsarten (ZA20)

• Überstunden über 50 Jahre (Ü50)

• Überstunden über 100% (Ü100)

Mögliche Parameter für die “fillingPatterns”

• Boolean skip

  • auf dieser Ebene (z.B. Woche) wird dieser Topf nicht benötigt; alle Stunden gehen direkt weiter in den darunterliegenden Topf

• String balance: Mit dieser Funktion kann daily oder weekly ein Abgleich gemacht werden, ob der Topf im Minus ist und ggf. in den anderen Töpfen schauen ob er sich Stunden holen kann, damit ein Minus ausgeglichen werden kann.

• Boolean blockWithdraw

  • wenn einem anderen Topf Stunden fehlen (durch minValue oder weil der Topf im Minus ist und balance für den Topf aktiviert wurde), dann werden Stunden aus den benachbarten Töpfen gesammelt; ein Topf mit blockWithdraw = true wird dabei aber ignoriert;
    Ausnahme: wenn bei dem Topf, dem Stunden fehlen eine withdrawOrder angegeben wurde, dann werden (soweit vorhanden) auch Stunden aus einem Topf mit blockWithdraw gezogen.

• Boolean blockSpillover

• Boolean leftWithdraw: Wenn ein Topf aufgefüllt werden muss, dann bedient er sich als ersten von dem Topf links daneben und erst dann, falls noch was fehlt, in der gewohnten Reihenfolge.

• Lohnarten-Liste: withdrawOrder ,gibt die Reihenfolge der Töpfe zurück aus denen etwaige Fehlbeträge genommen werden können; sollte der Fehlbetrag aus den angegebenen Töpfen nicht bedient werden können, dann wird in standard-Reihenfolge weiter eingezogen. Bsp.: <withdrawOrder>120,130,400</withdrawOrder>

  • wird bei der withdrawOrder ein Topf referenziert bei dem blockWithdraw = true hinterlegt ist, so wird das blockWithdraw zugunsten der withdrawOrder ignoriert

• Lohnarten-Liste: withdrawOrderLimited ,gibt die Reihenfolge der Töpfe zurück aus denen etwaige Fehlbeträge genommen werden können; sollte der Fehlbetrag aus den angegebenen Töpfen nicht bedient werden können, dann wird abgebrochen. Bsp.: <withdrawOrderLimited>120,130,400</withdrawOrderLimited>

• Boolean forcePrimaryWagetype

• BigDecimal minValueOffset

• BigDecimal maxValueOffset

• BigDecimal minValueAzmFactor

• BigDecimal maxValueAzmFactor

• BigDecimal maxValuePPeriodOffset

• BigDecimal maxValuePPeriodAzmFactor

Mögliche Parameter auf “potMatrix” Ebene

Folgende Parameter können über dem <model> -Tag angegeben werden. Die Reihenfolge spielt keine Rolle.

• enable75Rule

  • ab der 3. täglichen Überstunde (auch Mehrstunde) werden 75% (vor 19 Uhr) / 100% (nach 19 Uhr) Zulagen ausgelöst

  • dabei werden die Stunden, die an diesem Tag angesammelt wurden und einen Faktor <=150 haben aufsummiert; davon wir die Sollarbeitszeit abgezogen; die ersten beiden Stunden die übrig bleiben werden nicht verändert;

  • alles >2h wird auf 75% bzw. 100% umgebucht

  • die alten Buchungen bleiben bestehen um den Vorgang nachvollziehen zu können

  • Erforderlich:

    • zumindest ein Topf mit Ü75 (wird anhand des Faktors = 175 identifiziert) sowie

    • ein Topf mit Ü100 (Faktor = 200).

  • Beispiel:

  • 

• adjustEndTimes

  • Wird dieser Parameter angegeben:

  • <adjustEndTimes>true</adjustEndTimes>

  • dann werden die BIS -Zeiten der einzelnen Lohnbuchungen dem Buchungswert angepasst;

  • Bsp.:

    • es wurde eine Arbeit von 13 bis 17 Uhr gebucht

    • ab 16 Uhr ist der Normalarbeitszeittopf (NAZ) gefüllt und läuft in den Mehrarbeitszeittopf (MAZ) über

    • Ohne adjustEndTimes wird einen Lohnbuchung mit

      • 13 bis 17 Uhr im Wert von 3h auf NAZ und eine

      • 16 bis 17 Uhr im Wert von 1h auf MAZ geschrieben; es wird also immer für die NAZ die gesamte Zeitspanne angedruckt; das kann für einzelne Anwendungen und Auswertungen erforderlich sein.

    • Mit adjustEndTimes werden die Zeiten ohne Überlappungen erzeugt

      • 13 bis 16 NAZ

      • 16 bis 17 MAZ

  • Wichtig: um auch die Aktiv-Zeiten entsprechend anzupassen ist zusätzlich die Mandanteneinstellung WAGEBOOKINGS_SPLIT_ADJUST_ACTIVE_TIMES auf true zu setzten

• manualBookingsSentToPotMatrix

  • Standard = false (=NEIN)

  • Der Parameter bestimmt, ob manuelle Lohnbuchungen (bspw. vom Monteur am Mobile-App oder im Büro über die Korrektur-Maske eingetragen) für Überstunden (Topf-Logik) und Zulagenberechnung herangezogen werden sollen.

  • Ist dieser Parameter auf “true” gestellt:

    • erlaubt es z.B. manuelle Zusatzstunden für Entfzl. und die ZA Berechnung zu berücksichtigen

    • muss vorweg für alle potentiell manuell gebuchten Stunden geprüft werden ob sich auch tatsächlich für Zulagen und Überstunden herangezogen werden sollen!