Moduł Wyniki

Moduł Wyniki (aplikacja APEX f2300) to silnik rentowności VanCargo. Agreguje przychody, koszty i marże w układzie sekcja × miesiąc w formie Balanced Scorecard (BSC) i udostępnia je jako pulpit oraz raporty szczegółowe.

Co liczy moduł

Wynik sekcji w danym miesiącu składa się z wielu składowych liczonych w EUR (waluty obce przeliczane kursem BSC):

• R Profits (marża zleceń) — przychód ze sprzedaży minus koszty przewoźnika i usługi dodatkowe.
• R Trailers — wynik rentowności środków floty wg dziennych stawek.
• Credit Buy / Credit Sell — koszt/przychód finansowy wynikający z terminu zapłaty faktur.
• Speculation, Forward Fee, Bonus, Risk Fee — opłaty/wartości doliczane do zleceń (spekulacja, spedycja, bonusy, opłata za ryzyko).
• Notes — wynik z not księgowych (OP/OCP).
• Payment Risk, Vindication, Reserves — ryzyko płatności, windykacja, rezerwy.
• I External / I Internal / C Internal — dochody i koszty wewnętrzne (rozliczenia między sekcjami).
• Tele, Social, Office, Pr, It, Law, Contr, Other — koszty rodzajowe.
• Incomes (obrót), Orders / Invoiced Orders (liczba zleceń / zafakturowanych).
• Insurance (ubezpieczenie, % obrotu), Instant Payment („płać natychmiast”), Extra income/cost (przychód/koszt nieoperacyjny — tylko premia).

Wszystko ląduje w tabeli agregującej WYNIKI_BSC (klucz: SECTION + MONTH).

Jak to działa — przepływ

WYNIKI_PRZELICZENIE_JB  (codziennie, wieczorem)
        │  BEGIN p_calculate_scores_bsc; END;
        ▼
P_CALCULATE_SCORES_BSC(p_sekcja, p_context_user, p_actual_trunc_month)
        │
        ├─ 1) WYNIKI_PKG.p_save_credit_sell_buy()
        │        → przelicza widoki WYNIKI_CREDIT_BUY_V / _SELL_V
        │          i zapisuje do tabel WYNIKI_CREDIT_BUY / WYNIKI_CREDIT_SELL
        │
        └─ 2) MERGE do WYNIKI_BSC (upsert po SEKCJA+MONTH)
                 agregując ~30 widoków WYNIKI_*_V (UNION ALL)
        ▼
WYNIKI_BSC  ──►  Aplikacja f2300 (dashboard + raporty)

• Domyślny miesiąc przeliczenia: bieżący miesiąc z offsetem z parametru WYNIKI_CALC_DATE (VAN_PARAMS_PKG).
• Wywołane bez sekcji → przelicza wszystkie sekcje; z p_sekcja → tylko jedną.

Pakiety i procedury

• WYNIKI_PKG (latest/package/) — logika modułu i obsługa UI:
  • p_calculate_speculation, p_calculate_spedition, p_p301_calculate_scores — naliczanie spekulacji/spedycji,
  • p_save_credit_sell_buy — zrzut credit buy/sell z widoków do tabel,
  • p_p202_load_bonus / p_p202_save_bonus — obsługa bonusów,
  • f_get_score_row, f_scores_exists, f_wyniki_insert — dostęp do tabeli WYNIKI,
  • p_ajax_detailed_amount_view — rozbicie kwoty (stary vs nowy system) dla UI.
• P_CALCULATE_SCORES_BSC (latest/procedure/) — procedura główna przeliczająca BSC (wywoływana przez job).

Widoki

Składowe BSC pochodzą z rodziny widoków WYNIKI_*_V (latest/view/). Najważniejsze:

Wiele widoków ma wariant ..._ACTUAL_MONTH_V (ujęcie na bieżący miesiąc; istnieje też ..._OLD_V dla ryzyka płatności).

Kluczowe tabele

Kolumny WYNIKI_BSC i ich źródła

Klucz tabeli to SECTION + MONTH. Każda kolumna miary jest agregowana z konkretnego widoku (mapowanie wprost z komentarzy w definicji tabeli). Kolumny z osobnym opisem mają link do podstrony:

Składowe BSC (podstrony)

Szczegółowy opis naliczania poszczególnych kolumn ekranu Wyniki:

• Orders — liczba zleceń per sekcja × miesiąc.
• R Profits — marża zleceń (prowizja sekcji, koszty przewoźnika, usługi dodatkowe).
• R Trailers — wynik floty wg dziennych stawek (postojowa vs operacyjna).
• I Internal — przychody wewnętrzne sekcji flotowych (rozkład stawki/rat na FM/FL/S1/S2).
• Credit Buy / Sell — koszt/przychód finansowy z terminu zapłaty faktur.
• Speculation — spekulacja: opłata zależna od parametru finansowego klienta.
• Forward Fee — spedycja: opłata dla podmiotów ze statusem spedycji.
• Bonus — bonusy: wartości premiowe przypisane do sekcji.
• Risk Fee — opłata za akceptację ryzyka kredytowego klienta.
• Notes — wynik z not księgowych (OP/OCP).
• Reserves — rezerwy zaliczkowe i rezerwa łączna narastająco.
• Payment Risk — należności przeterminowane > 30 dni.
• Vindication — windykacja: wynik windykacyjny (odzyski/straty).
• Koszty rodzajowe i pozostałe — koszty rodzajowe, obrót, „płać natychmiast”, koszty/dochody wewnętrzne.
• Insurance — ubezpieczenie jako % obrotu (kolumna wyliczana w widoku ekranu).
• Extra income/cost — przychód/koszt nieoperacyjny; wpływa tylko na premię, nie na wynik.
• Dane historyczne (stary e‑VAN) — OPVTRZYSK66_AGG i mapowanie kolumn ze starego systemu.

Aplikacja f2300

Frontend modułu (apex/f2300/). Wzorzec UI: pulpit BSC (strona 201) z kartami per sekcja, z których przechodzi się do stron drill-down „… - szczegóły” pokazujących pojedyncze faktury/zlecenia składające się na daną kwotę.

Mapa stron

Nawigacja i system

Pulpit, bonusy, spekulacja

Drill-down składowych BSC (… – szczegóły)

Dochody / koszty wewnętrzne (rozbicie)

Listy i raporty pomocnicze

Pojęcia i wzory

Zadanie harmonogramu

WYNIKI_PRZELICZENIE_JB (install/schedulerJobs/) — codziennie wieczorem wywołuje p_calculate_scores_bsc dla wszystkich sekcji i bieżącego miesiąca. Powiązane odświeżanie widoków statusów/płatności: STSFAK_K_MV_JB, TSZAPL_MV_JB (zob. Zadania harmonogramu).