Katalog Modułów

Karty paliwowe

Aplikacja f1400 — karty flotowe LOTOS/ESSO: umowy, karty, transakcje, rozliczenia (ZRT) i saldo przewoźnika.
Opis modułu w toku — do uzupełnienia do poziomu szczegółowości modułów pogłębionych (Wyniki, Obsługa Zlecenia, Faktury).

Aplikacja APEX f1400 „Karty paliwowe” (alias FCARD) — karty flotowe LOTOS/ESSO: umowy, karty z limitami, import transakcji, rozliczenia i saldo przewoźnika.

Co robi

  • Umowy i karty — rejestracja umów flotowych (KARTY_FLOTOWE_UMOWY: NIP, typ L/E, stan AK/ZB, podmiot) i przypisanie kart (KARTY_FLOTOWE_KARTY) z limitami dziennym/miesięcznym i ważnością.
  • Import transakcji LOTOS/ESSOKARTY_FLOTOWE_TRANSAKCJE (typ L/E, PLN/EUR); czarna lista ESSO (KARTY_FLOTOWE_BLACKLIST_ESSO) blokuje dostęp; ceny hurtowe w KARTY_FLOTOWE_CENA_HURT.
  • Rozliczenia (ZRT) i saldo zobowiązań — łączenie transakcji z fakturami w KARTY_FLOTOWE_ZRT; saldo SALDO_KARTY_FLOTOWE_ZOBOWIAZANIA_V = WBRT_PLN − SUMA_ZAPLAT.
  • Saldo przewoźnika i harmonogramy — przeliczanie SALDO_PRZEWOZNIKA (faktury+noty+zlecenia) i wysyłka do MOL przez kolejkę SALDO_PRZEWOZNIKA_QUEUE (REFRESH/SEND_BALANCE_ON_CONTRACT, joby ADD_*_BALANCE_JOB). Ręczna płatność w LOTOS: ADD_MANUAL_SETTLEMENT (dblink @SPX).

Kluczowe obiekty

ObiektRola
KARTY_FLOTOWE_UMOWY / _KARTYumowy i karty (limity, ważność)
KARTY_FLOTOWE_TRANSAKCJEtransakcje paliwowe (L/E)
KARTY_FLOTOWE_FAKTURY / _ZRTfaktury i rozliczenia
KARTY_FLOTOWE_CENA_HURT / _BLACKLIST_ESSOceny referencyjne / blokady
SALDO_PRZEWOZNIKAagregat salda

Powiązania

Integracja z LOTOS przez dblink @SPX; wysyłka sald do MOL asynchronicznie (kolejka). Udostępnianie danych przez REST ORDS_KARTY_FLOTOWE. Saldo przewoźnika wykorzystywane m.in. w CRM (Spedycje/Przewoźnicy) i Wynikach.

Do weryfikacji: obsługa niedostępności @SPX, znaczenie STATUS = NULL w widoku zobowiązań, brak retry w jobach salda. Sekrety dblinków pominięte. Źródło: specs/karty-paliwowe/spec.md.
Copyright © 2026