Tworzenie zlecenia

Tworzenie zlecenia odbywa się w oknie Nowe zlecenie (2000:301), obsługiwanym głównie przez NOWE_ZLECENIE_PKG. To samo okno działa w trzech trybach:

Diagram procesu

flowchart TD
  classDef proc fill:#eaf1f9,stroke:#1f5fa6,color:#19222f;
  classDef dec fill:#efeafa,stroke:#6b4fa6,color:#19222f;
  classDef block fill:#fbeced,stroke:#a8252c,color:#7d2329;
  classDef alert fill:#fdf4e3,stroke:#9a6b12,color:#6b521a;
  classDef ok fill:#e7f2ec,stroke:#2c7350,color:#235e41;

  A(["Otwórz okno Nowe zlecenie (2000:301)"]) --> B["Wybór kontrahenta<br/>p_p301_ajax_load_client"]
  B -. "alerty niblokujące" .-> AL["Spekulacja · ryzyko · spedycja<br/>ważność PARAM_FIN · książka instrukcji"]
  B --> C["Adresy: skąd / dokąd + trasy"]
  C --> D["Towar + grupa towarowa<br/>MD accept · wartość · KONTROL_TEMP"]
  D --> E["WWZ: pojazd, zabudowa, ADR"]
  E --> F["Dane ogólne + fakturowanie"]
  F --> G{"Walidacje pól OK?"}
  G -- "NIE: błąd, powrót" --> F
  G -- TAK --> H{"Edycja: status edytowalny?"}
  H -- NIE --> X["ex_order_not_editable (blokada)"]
  H -- "TAK / nowe" --> I["HERE Maps: trasa + km<br/>+ cena sugerowana"]
  I --> J["INSERT: ZLECENIE (status 1) → FAKTUROWANIE →<br/>DANE_ADRESOWE → TOWAR → WWZ → KLIENT_PRZEWOZNIK"]
  J --> K["Stawka VAT (VAT_SOMMELIER_PKG)"]
  K --> L{"Towar wartościowy / podatny?"}
  L -- TAK --> M["E-mail MD · ZLECENIE_OH02 · OH2_NARUSZENIE"]
  L -- NIE --> N["COMMIT"]
  M --> N
  N --> O["E-mail potwierdzenia (jeśli PP_ZLEC)"]
  O --> P(["Status Nowe (1) → przestrzeń Planowanie"])

  class B,C,D,E,F,I,J,K,N,O proc;
  class G,H,L dec;
  class X block;
  class AL alert;
  class A,P ok;

Elementy okna

1. Dane kontrahenta — po wyborze klienta ładowane są dane finansowe: parametr finansowy, specyfikacje i faktury, niezapłacone w terminie, zagrożone (>30 dni), płaci po 12m / 2m, obrót 12m, windykacje/straty; mogą pojawić się alerty kontrahenta.
2. Załadunki/rozładunki, trasy, mapa — zarządzanie adresami; podpowiedzi „trasy najczęstsze / ostatnie” (dwuklik zasila Skąd/Dokąd); po wyborze adresu region tras chowa się, a pokazuje mapa.
3. Grupy towarowe — pozycje towaru (grupa, towar, nr załadunku, wartość EUR, podatność na kradzież, „Więcej”).
4. Informacje dodatkowe — instrukcja kierowcy, notatka dla sekcji, e-mail potwierdzenia.
5. BBS — „Odśwież cenę BBS” wywołuje wyznaczenie proponowanej ceny z HERE Maps (trasa ładowana na mapę).
6. Warunki Wykonania Zlecenia (WWZ) — pojazd/zabudowa, wyposażenie, pozostałe warunki.
7. Parametry zlecenia — typ zlecenia (zob. niżej).
8. Dane fakturowania — waluta, termin, dokument dostawy, poziom fakturowania itd.

Kroki tworzenia (skrót)

1. Wybór kontrahenta (p_p301_ajax_load_client) → załadowanie domyślnych WWZ, tras, zasad fakturowania, alertów.
2. WWZ — domyślne ładuje p_p301_load_default_wwz (z PRODUKT_WWZ + KONTRAHENT_WWZ); edycja w oknie WWZ (p_p305_save_wwz).
3. Towar — siatka zasilająca kolekcję APEX S_TOWARY (p_p301_ajax_add_row_towary_col, edycja/p_p302_save_cargo_col dla wymiarów/ADR/OCP).
4. Adresy — kolekcja adresów (min. 2: załadunek + rozładunek), z datami/godzinami i e-mailem awizacji.
5. Dane ogólne i fakturowania — kwota, waluta, instrukcje, dane FK.
6. Zapis → walidacje → f_save_order.

Walidacje pól (blokujące zapis)

Zapis (Submit) jest blokowany, dopóki nie przejdą walidacje. Pochodzą z dwóch warstw: walidacje APEX na stronie 301 oraz funkcje PL/SQL na kolekcjach.

Walidacje pól nagłówka i fakturowania (APEX)

Walidacje siatki towaru (CARGO / S_TOWARY)

Walidacje adresów i WWZ

Komunikaty przy wyborze kontrahenta (alerty, niblokujące)

Po wyborze kontrahenta p_p301_ajax_load_client + p_p301_ajax_load_notification_for_client ładują dane finansowe i zasilają kolekcję ALERTS (typ „warning”). To ostrzeżenia informacyjne — nie blokują zapisu:

PARAM_FIN przy edycji bierze się z ZLECENIE_FAKTUROWANIE.PRAM_FIN_ORG, a przy nowym — z WNIOSKI (wnioski_pkg.f_get_param_fin).

Sprawdzenia przy wyborze grupy towarowej

Zapis — f_save_order

Procedura NOWE_ZLECENIE_PKG.f_save_order zapisuje zlecenie i jego elementy. Przy pi_order_id IS NULL (nowe) wykonuje INSERT-y; przy ustawionym ID — UPDATE (po sprawdzeniu f_is_status_editable). Kolejność:

1. ZLECENIE — nagłówek: kontrahent, numer klienta, wartość/ilość/kwota/waluta, typ zlecenia, sekcja, instrukcja/notatka, spedytor, sugerowane km i cena z HERE Maps, ID_STATUS = 1 (Nowe).
2. ZLECENIE_FAKTUROWANIE — dane FK: Skąd/Dokąd, dokument dostawy, typ faktury, termin płatności, waluta i kurs (ID_KURS_DZIEN), poziom fakturowania (M/S), uwagi FV, filia, PRAM_FIN_ORG/SPEC_FAK_ORG.
3. ZLECENIE_DANE_ADRESOWE — adresy (typ S/D, data podstawienia, e-mail awizacji); powiązane instrukcje w ZLECENIE_KSIAZKA_INSTRUKCJI.
4. ZLECENIE_TOWAR — towary (grupa, opis, wymiary, ilość, waga, flagi palet/monitoring, ADR, OCP); kody w ZLECENIE_TOWAR_ADR / ZLECENIE_TOWAR_EXT_OCP.
5. ZLECENIE_WWZ — warunki: kody z kolekcji mapowane na S_WWZ (f_get_wwz_id_by_code).
6. ZLECENIE_KLIENT_PRZEWOZNIK — trasy (kombinacje adresów skąd–dokąd).

Po zapisie zlecenie ma status Nowe (1) i pojawia się w przestrzeni Planowanie.

Weryfikacje i automaty w tle (przy zapisie)

Oprócz INSERT-ów f_save_order wykonuje szereg czynności „w tle”:

• Edytowalność statusu — przy edycji istniejącego zlecenia f_is_status_editable sprawdza S_ZLECENIE_STATUS.EDYCJA; jeśli 0 → wyjątek ex_order_not_editable (zapis zablokowany).
• Trasa i kilometraż (HERE Maps) — z adresów budowana jest trasa przez van_pricing.here_maps_pkg.f_get_route (z uwzględnieniem kontroli temperatury i kodu sekcji XX/VV); wynik zasila ZLECENIE.KM_SUGEROWANE, HERE_VIA_LAT/LNG, HERE_ROUTE_JSON. Błąd liczenia trasy nie blokuje zapisu.
• Sugerowana cena — gdy są km, a użytkownik nie podał ceny (f_p301_get_price_new_order), cena jest wyliczana i zaokrąglana.
• Stawka VAT — wyznaczana przez VAT_SOMMELIER_PKG (na podstawie kierunku/krajów).
• Procedura OH02 (towar wartościowy / podatny) — jeśli którykolwiek towar ma wartość C004 ∈ ('200','201') lub podatność C005 = 'TAK', ustawiana jest flaga i wysyłany e-mail do MD (p_send_md_email), zapis do ZLECENIE_OH02, a ZLECENIE.OH2_NARUSZENIE = 1 (e-mail wysłany) lub 2 (jest akceptacja ryzyka, e-mail pominięty).
• E-mail potwierdzenia — gdy WWZ wymaga potwierdzenia (PP_ZLEC), po commit wysyłany jest PDF zlecenia (p_send_confirmation_email) na adres z formularza + kopia do pracownika. Commit przed wysyłką, bo e-maila nie da się wycofać.
• Historia zmian — przy edycji każda zmiana pól ZLECENIE / ZLECENIE_FAKTUROWANIE / adresów jest logowana do ZLECENIE_HISTORIA_ZMIAN (stara → nowa wartość).

Wyjątki / kody błędów (przykładowe)

Inne wyjątki domenowe: gc_no_podmiot_found (kontrahent bez podmiotu), gc_not_valid_section (nieprawidłowa sekcja).

Typ zlecenia i uprawnienia

ZLECENIE.TYP_ZLECENIA: D Drogowe (domyślny) / M Morskie-Lotnicze / P Promowe. Dostępność typów:

• admin → wszystkie,
• sekcja z produktu 2 (5. znak kodu sekcji) → Morskie/Lotnicze,
• sekcja XXGAS1 → Promowe,
• w innym wypadku → wg dodatkowych uprawnień PRACOWNIK_SEKCJA_UPRAWNIENIA (typ TYP_ZLECENIA).

Zmiana typu czyści pole „Poziom fakturowania”.

WWZ — domyślne źródła

p_p301_load_default_wwz łączy PRODUKT_WWZ (warunki produktu/sekcji) + KONTRAHENT_WWZ (warunki kontrahenta), filtrując po statusie. Automatyka: gdy towar ma OCP „kontrola temperatury”, do WWZ dopisywany jest odpowiedni warunek (p_p301_ajax_check_temperature_control).

Kolekcje APEX (stan formularza przed zapisem)

Dane formularza przed zapisem żyją w kolekcjach APEX (kolumny Cxxx/Nxxx):

Parametry VAN_PARAMS używane przy tworzeniu

OPLATA_SPEK_KRAJ / OPLATA_SPEK_MIEDZYNARODOWA (+ _WALUTA), PROCENT_WARTOSCI_FRACHTU, PARAM_FIN_INFO_KONIEC — wykorzystywane w komunikatach finansowych (spekulacja, ważność parametru). Zob. też Spekulacja.