Soneta Place Def Elementow

Definicje elementów wynagrodzenia — platforma Soneta (enova365, Triva)

Ten skill zawiera kompletną wiedzę o tworzeniu i konfigurowaniu definicji elementów wynagrodzenia na platformie Soneta. Wiedza jest podzielona na pliki referencyjne — czytaj odpowiedni plik w zależności od potrzeby.

Spis treści referencji

Lokalizacja w programie

Folder konfiguracyjny: Ustawienia/Kadry i płace/Płace/Elementy wynagrodzenia

Formularz zawiera:

• Listę definicji (gridID: _New_CfgDefElementowExtender_DefElementow)
• Filtry pod listą:
  • Rodzaj — typ elementu (31 rodzajów)
  • Zakres — Standardowe / Definiowane / Razem (pokaż wszystkie)
  • Stan — Aktywne / Zablokowane / Razem (pokaż wszystkie)

Aby zobaczyć wszystkie definicje, ustaw Zakres=Razem i Stan=Razem.

Rodzaje elementów wynagrodzenia

Zakładki formularza definicji

Ogólne (DefinicjaElementuProPage)

Deklaracje (DefinicjaElementuDeklaracjePage)

Konfiguracja podatków i składek ZUS:

Nieobecności (DefinicjaElementuNieobecnosciProPage)

Konfiguracja wliczania do podstaw urlopów i zasiłków:

Algorytm/Ogólne (DefinicjaElementuAlgorytmPage)

Główna zakładka konfiguracji algorytmu — szczegóły w references/algorytmy-naliczania.md.

Algorytm/Edytor (DefinicjaElementuEdytorPage)

Pole kodu C# (typ code) — edytor algorytmu. Aktywny gdy Algorytm = "Edytor algorytmu".

Algorytm/Podgląd (DefinicjaElementuPodgladPage)

Podgląd wygenerowanego kodu C# (read-only).

Tworzenie nowego elementu — krok po kroku przez MCP

1. navigate_to_folder("Ustawienia/Kadry i płace/Płace/Elementy wynagrodzenia")
2. add_subobject(gridID="_New_CfgDefElementowExtender_DefElementow")
3. update_field_value — wypełnij zakładkę Ogólne (nazwa, skrót, naliczanie, lista płac)
4. switch_form_page("DefinicjaElementuAlgorytmPage") — skonfiguruj algorytm
5. [opcjonalnie] switch_form_page("DefinicjaElementuEdytorPage") — wpisz kod C#
6. switch_form_page("DefinicjaElementuDeklaracjePage") — skonfiguruj PIT/ZUS
7. switch_form_page("DefinicjaElementuNieobecnosciProPage") — skonfiguruj wliczanie do podstaw
8. accept_subform() — zatwierdź podformularz
9. save_form() — zapisz do bazy

Wybór algorytmu

Formatowanie kodu w edytorze (przez MCP)

Znaki nowej linii w kodzie C# przez MCP wstawiamy jako \\n:

update_field_value(["_Tekst=public void Nazwa_Param(...) {\\n    ...\\n}\\n\\npublic Currency Nazwa_Wylicz(...) {\\n    return ...;\\n}"])

Wskazówki przy tworzeniu nowych algorytmów

1. Element to parametr metody — w kodzie algorytmu Element nie jest zmienną globalną ani polem klasy — jest pierwszym parametrem każdej metody (_Param, _Wylicz, _Wartość1h itd.). Metoda musi zawsze zawierać te parametry. Typ tego parametru musi odpowiadać rodzajowi definiowanego elementu:

   • Etat → Soneta.Place.WypElementEtat Element
   • Dodatek → Soneta.Place.WypElementDodatek Element
   • Dodatek automatyczny → Soneta.Place.WypElementDodatekAutomatyczny Element
   • Nieobecność → Soneta.Place.WypElementNieobecnosc Element
   • Nadgodziny → Soneta.Place.WypElementNadgodziny Element
   • Umowa → Soneta.Place.WypElementUmowa Element

   Przykład: jeśli algorytm odwołuje się do Element.DodHistoria.Podstawa, a definicja jest rodzaju Dodatek, to sygnatura metody musi wyglądać:

   public void MojDodatek_Param(WypElementDodatek Element, WypSkladnik Składnik) { ... }
   

2. Wybierz wzorzec — większość nowych elementów pasuje do jednego z istniejących wzorców. Przeczytaj references/wzorce-algorytmiczne.md i zacznij od skopiowania najbliższego wzorca.

3. Źródło kwoty — zdecyduj skąd pochodzi podstawa:

   • Kwota z parametrów pracownika → Element.DodHistoria.Podstawa (Wzorzec A)
   • Kwota z konfiguracji programu → module.Config.Zasiłki.*[Date] (Wzorzec B)
   • Kwota stała z definicji → Element.Definicja.Algorytm.KreatorAlgorytmu.Podstawa (Wzorzec C)
   • Procent od zasadniczego → ZasadniczeNominalne(Date) + Element.DodHistoria.Procent (Wzorzec D)

4. Czas i dni — prawie wszystkie algorytmy ustawiają czas i dni z normy:

   CzasDni cd = Element.Pracownik.Czasy.Norma(Składnik.Okres);
   Składnik.Czas = cd.Czas;
   Składnik.Dni = cd.Dni;
   

5. Pomniejszenie za nieobecności — użyj kreatora algorytmu z konfiguracją korekt lub ręcznie: Element.Pracownik.Czasy.Nieobecnosci(Składnik.Okres).Dni

6. Proporcjonalność do okresu — gdy okres składnika jest krótszy niż pełny okres naliczania, przelicz proporcjonalnie (jak w Premii procentowej — Wzorzec D).

7. Zasiłki — zawsze używaj new PodstawaZasiłku(Element) i WyliczPodstawęZasiłkuZaDzień(...) — nie obliczaj podstawy zasiłku ręcznie.

8. Urlopy okolicznościowe — używaj new NaliczanieOkolicznosciowy(Element, Składnik).NaliczPodstawy() — automatycznie ustawi Podstawa1 (za godziny) i Podstawa2 (za dni).

9. Ekwiwalenty i odprawy — używaj new NaliczanieEkwiwalent(Element, Składnik).NaliczPodstawy().

10. Element.DodHistoria.Podstawa vs Element.DodHistoria.Kwota — w rzeczywistych algorytmach kreatorowych kwota pobierana jest z Element.DodHistoria.Podstawa (nie .Kwota). Pole .Kwota występuje w dokumentacji, ale .Podstawa jest częściej stosowane w generowanym kodzie.

11. Dodatkowe metody — jeśli element ma odbiorców płatności (potrącenia, alimenty), zdefiniuj metody _Odbiorca i _RachunekOdbiorcy. Jeśli okres naliczania wymaga podziału, zdefiniuj _CięcieOkresu. Jeśli element wpływa na podstawy urlopów/zasiłków — przeczytaj references/metody-sterujace-naliczaniem.md.