Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

RodzajOpisFormatUstawianie wartości
klienckazawiera parametry ustawiane indywidualnie dla każdego wdrożeniaparametry akcjiw PWE w parametrach akcji Business Trip
domyślnazawiera pozostałe parametry potrzebne do działania wtyczki, które albo wynikają z przepisów lub założeń
lub najczęściej nie jest potrzebne indywidualne ustawienie podczas wdrożenia
plik json

ładowana automatycznie przy uruchomieniu z zawartego we wtyczce pliku, który zawiera przyjęte domyślne wartości.
Można go znaleźć w projekcie wtyczki w .../resources/config/businessTripDefaultConfig.json

Status
titlev1.2.26+

Podgląd i edycja konfiguracji znajduje się w polu tekstowym w panelu zarządzania konfiguracjami wtyczek (PCM).

Status
titlev4.0.5+

Po wgraniu wtyczki do pola tekstowego ładowana jest automatycznie najnowsza konfiguracja z pliku json znajdującego się w projekcie wtyczki w .../resources/config/businessTripDefaultConfig.json

Jeśli w katalogu domowym w ...\plugins\data\com_suncode_plugin-business-trip\config znajduje się plik businessTripDefaultConfigbusinessTripCustomConfig.json, który zawiera tylko wybrane parametry z innymi wartościami niż w konfiguracji domyślnej pozyskiwanej z projektu wtyczki, wówczas w polu tekstowym konfiguracji wtyczki zostanie wyświetlona domyślna konfiguracja najstarsza wersja konfiguracji (przed zmianami stawek z 2022-07-28) zaktualizowana o te odpowiednie pola. Najnowsza konfiguracja nie doda się automatycznie w PCM, ponieważ konfiguracja z customowymi zmianami różni się od domyślnych ustawień.

 

zmieniona

zawiera parametry jak w konfiguracji domyślnej, ale tylko te które wymagają jednak zmiany w danym wdrożeniu

Status
titlev1.2.26+

w polu tekstowym w panelu zarządzania konfiguracjami wtyczek (wtyczka Plugin Configuration Manager - PCM) w zakładce Business Trip istnieje możliwość zmiany domyślnych parametrów.

 

Status
titlev4.0.5+

Aktualne wersje konfiguracji będą automatycznie dodawane jako kolejne zakładki w PCM pod warunkiem, że ostatnia konfiguracji nie była modyfikowana. Jeżeli najnowsza konfiguracjia w PCM różni się od tej domyślnej z wtyczki (była modyfikowana), to nowe wersje konfiguracji nie będą dodawane.

Można dodawać swoje konfiguracje podając w polu "effective_date" datę, od której nowa konfiguracji ma obowiązywać. Konfiguracja do obliczeń zostaje wybrana na podstawie daty zakończenia delegacji.

plik json

Aby zmienić parametr z konfiguracji domyślnej trzeba utworzyć lokalny poprawny plik json, zawierający tylko te parametry, które chcemy zmienić.

Potem trzeba go wczytać w Administracja->Konfiguracja systemu->Delegacje. Nadpisze to tylko te wybrane parametry, ale wszystkie ich wartości oraz umieści plik z tą konfiguracją na serwerze w '...\plugins\data\com_suncode_plugin-business-trip\config'.

Aby dokonać zmian w tej konfiguracji trzeba ponownie wczytać przygotowany plik z kompletnymi zmianami.

Status
titlev1.2.26+

Aby zmienić parametry z konfiguracji domyślnej trzeba udać się do pola tekstowego w Administracja -> Konfiguracja systemu -> Konfiguracja wtyczek -> Zainstalowane wtyczki -> Business Trip. Ukaże się konfiguracja wtyczki o nazwie config-data (JSON) (wyjątkiem jest najstarsza wersja i ma nazwę "config (JSON)") w postaci pola tekstowego i zmieniamy w nim te parametry, które chcemy zmodyfikować. Po każdej zmianie klikamy w przycisk Zapisz plik.

...

Konfiguracja domyślna zawiera następujące parametry ustawione domyślnie najczęściej wykorzystywanymi wartościami.
ParametrOpis
effective_date
Status
titlev4.0.5+
data wejścia w życie konfiguracji (konfiguracja będzie wybierana na podstawie daty zakończenia delegacji)
Status
titlev4.0.5+
wydatki_walutysymbole walut, w których ma być możliwość zarejestrowania poniesionych wydatków
kilometrowkazawiera kategorie oraz przypisane koszty.
kilometrowka_dlaokreśla dla jakiego typu pojazdu, ma zostać wyliczona kilometrówka.
wymog_ewidencji_pojazduokreśla dla jakiego typu pojazdu ma być wymagane uzupełnienie pól dot ewidencja pojazdu.
srodek_transportuwszystkie środki transportu, dostępne do wyboru dla osoby rozliczającej delegację.
nawa_polskiej_walutynazwa polskiej waluty, używanej w procesie.
before_save_on_map
Status
titlev1.2.25+
zmienna określająca metodę, która ma zostać wywołana tuż przed zapisaniem danych w procesie - metoda przyjmuje dwa parametry: "Map<String, Object>" - mapowane zmienne oraz "BusinessTrip" - obiekt zawierający wszystkie informacje o delegacji i zwraca mapę wartości Map<String, Object> np.

public static Map<String, Object> beforeWriteToProcess(Map<String, Object> zmienna, BusinessTrip delegacja)
{
    return zmienna;
}

Parametr usunięty. Teraz jest możliwość dodawania klas i metod klienckich. Szczegóły tutaj.

Status
titlev1.2.25+

krajmapa wartości, zawiera koszty: diety, ryczałtów dla delegacji krajowej.
zagranica :część konfiguracji dotycząca delegacji zagranicznej.
  • rozdziel_ryczalty
wartość true, powoduje rozdzielenie ryczałtów na poszczególne kraje (w walucie tych krajów). Wartość false, powoduje zliczenie wszystkich ryczałtów i przeliczenie ich na PLN.
  • wysokosc_diety_gdy_pracodawca_zapewnil_posilek
procent diety, w przypadku gdy pracodawca zapewnił posiłek w delegacji zagranicznej.
  • kurs_do_obliczen :

ustawienia dotyczące sposobu wybierania daty dla kursów walutowych.
Uwaga, kolejne trzy parametry dot odświeżania kursu można ustawić w konfiguracji klienckiej.

    • odswiezanie_kursu_na_etapie_od_wer_pakietu
      Status
      titlev1.2.24+

wersja mapy, od której odświeżanie będzie funkcjonować.

Parametr usunięty. Kurs walutowy pobierany jest na podstawie daty ustawionej w parametrze akcji "Pobierz kurs z".

Status
titlev1.2.24+

    • odswiezanie_ile_dni_odjac_od_dzisiaj
ile dni ma zostać odjętych od daty dzisiejszej. Domyślną wartością jest -1 (data z wczoraj).
    • czy_czytac_z_pola
      Status
      titlev1.2.24+

wartość true, powoduję, że moduł będzie odczytywał datę dla kursów walutowych, ze wskazanego pola.

Parametr usunięty. Kurs walutowy pobierany jest na podstawie daty ustawionej w parametrze akcji "Pobierz kurs z".

Status
titlev1.2.24+

    • ile_dni_odjac_od_daty_pola
w polu, można wskazać, ile dni ma zostać odjętych od daty wskazanej w polu.
    • czy_obslugiwac_date_zaliczki
      Status
      titlev1.2.24+

wartość true, powoduje, możliwość przekazania daty z poziomu javascriptu (identyfikator data_wydania_zaliczki, w array'u identyfikatorów, przekazywanych w funkcji javascript).

Parametr usunięty. Kurs walutowy pobierany jest na podstawie daty ustawionej w parametrze akcji "Pobierz kurs z".

Status
titlev1.2.24+

    • czy_data_zaliczki_wazniejsza_od_daty_z_rozliczenia
      Status
      titlev1.2.24+

wartość true, powoduje, że data zaliczki, przekazana z poziomu javascript, jest ważniejsza od daty z wcześniejszego rozliczenia wskazanej delegacji.

Parametr usunięty. Kurs walutowy pobierany jest na podstawie daty ustawionej w parametrze akcji "Pobierz kurs z".

Status
titlev1.2.24+

  • waluty
    Status
    titlev1.2.26+

lista dostępnych walut w których może nastąpić rozliczenie

Parametr usunięty. W nowych delegacjach parametr nie jest brany pod uwagę.

Status
titlev1.2.26+

  • dieta
lista stawek diet i walut dla krajów, wg których nastąpi rozliczenie dla poszczególnych krajów
  • kraje
lista dostępnych krajów w rozliczeniu
  • granica_odrazu

typy pojazdów, dla których, rozpoczęcie, zakończenie naliczania diety następuje "od razu", tzn. wylot powoduję naliczanie diety dla kraju przylotu (docelowego) od momentu startu samolotu. Do takich środków lokomocji, należą, samolot oraz statek. Ustawienie to, jest używane tylko i wyłącznie przy kalkulacji diety.

Z powodu ogólnych zasad rozliczania delegacji zagranicznej nie zaleca się modyfikować tej listy. Jeżeli Klient chce takiej zmiany, to musi świadomie podjąć o tym decyzję, ponieważ zmieni się sposób rozliczania delegacji.

...

Po każdorazowym wykonaniu oblicz, aktualizowane są wyniki rozliczenia delegacji, które są zapisywane do procesu wg ustawień w parametrach wyjściowych.
Jednak aktualizowane są tylko te wiersze w tabelach, które w zmiennych ustawionych w konfiguracji w 'Tabela podsumowań'->'Numer delegacji', 'Tabela kosztów'->'Numer delegacji' i 'Tabela wydatków'->'Numer delegacji' mają wartość równą id delegacji (tj. zmienna ustawiona w 'Parametry wejściowe'->'Numer delegacji' ). Zatem jeśli ręcznie dodamy wiersze i nie spełnią one wspomnianego warunku, to te dane nadal pozostaną po ponownym rozliczeniu delegacji.

 

Obliczanie delegacji po zmianach ustawy z dnia 28.07.2022

Sposób obliczania delegacji zależy od ustawionej daty powrotu:

  • Jeżeli data powrotu jest przed 28 lipca 2022, to stawki są brane z pliku konfiguracyjnego wtyczki
  • Jeżeli data powrotu jest 28 lipca 2022 lub późniejsza, to najpierw stawka jest brana z pliku konfiguracyjnego i jeżeli stawka z konfiguracji jest niższa niż minialna stawka z ustawy, to ustawiamy ją na najniższą zgodną z ustawą z dnia 28.07.2022. W przypadku gdy w konfiguracji stawka była wyższa niż z ustawy z dnia 28.07.2022, to liczymy według stawek z pliku konfiguracyjnego.