SaleLight
panel operatora
kanały sprzedaży, rozliczenia, sprzedaż online
FareLight: …
Stack *Light 🎫 SaleLight (panel) ChannelLight — kupujący ChannelLight — flow OSDM FareLight — edytor taryf FareLight — API (docs) Journey Planner (API) SmartLight — PWA kasjera (offline)

Sprzedaż online (odświeżanie co 5 s)

Obszary panelu

Obrót per kanał

KanałTransakcjeObrótProwizja

Ostatnie bookingi

UtworzonyStanOfertaTrasaKwota

Kanały sprzedaży

KodNazwaIdentyfikator (OSDM)KasaJednostkaProwizja %RozliczenieGrupa sprzedażyKasa (słownik)Użytkownik (słownik)Dialekt zniżekKlucz APIStan

Kasa/Jednostka powyżej to pola tekstowe legacy — gdy kanał ma przypiętą Kasę (słownik)/Użytkownika (zakładka „Słowniki organizacyjne"), te wartości MAJĄ PIERWSZEŃSTWO w rekordach FIN.

Nowy kanał

Słowniki organizacyjne

Hierarchia rozliczeniowa: Umowa → Grupa sprzedaży (np. KASY_AVISTA) → Kasa (KASA+JEDN_SL) oraz Użytkownik (UZYT). Kanał wskazuje Grupę + konkretną Kasę/Użytkownika (zakładka „Kanały sprzedaży") — te dane trafiają do rekordów FIN zamiast pól tekstowych/globalnego ustawienia.

Umowy

KodNazwa

Grupy sprzedaży

KodNazwaUmowa

Kasy (KASA + JEDN_SL)

GrupaKASAJEDN_SLNazwa

Użytkownicy (UZYT)

GrupaUZYTNazwa

Bilety i ich statusy

status lokalny z SaleLight · „rejestr” = stan i historia wg ETCD_PL (na żywo)
SprzedanoBiletKanałOfertaTrasaKwotaParagonStatus

Limity miejsc

Limity SaleLighta — działają BEZ SRM (BookLighta). Każdy wymiar jest opcjonalny; pusty znaczy „dowolny". Gdy sprzedaż trafia w kilka limitów, muszą przejść WSZYSTKIE — reguła „wygrywa najszczegółowszy" pozwalałaby obejść limit ogólny dopisaniem szczegółowego.

Licznik jest JAWNY, bo z samych wymiarów nie da się go zgadnąć: limit bez numeru pociągu może znaczyć „10 dziennie łącznie" albo „10 dziennie w każdym pociągu".

NazwaRodzajKodKanałPociąg OkresOdcinekLicznikZajęte / limit

Rozkład jazdy

Kolejność stacji kursu — bez niej limit odcinkowy obowiązuje tylko na DOSŁOWNEJ relacji (geografii nie zgadujemy). Obowiązuje reguła jeden przewoźnik = jedno źródło: ten sam pociąg z dwóch feedów to dwa kursy o tym samym numerze.

Feedy rozkładu (przewoźnik → źródło)

Każdy przewoźnik ma WŁASNY feed i własną częstotliwość: Arriva może jechać z paczki GTFS, a KMŁ z API PLK — jednocześnie. Zmiana źródła wymaga usunięcia feedu razem z rozkładem, żeby nie zostały kursy z poprzedniego.

PrzewoźnikŹródłoKonfiguracja Co ileOstatni pobórKursy

Rozkłady bez feedu (import z pliku)

PrzewoźnikŹródłoKonfiguracjaZaktualizowano

Import z pliku



  


  

    
Braki danych do uzupełnienia

    
Identyfikatory, których zabrakło przy generowaniu rekordów FIN — do uzupełnienia w słownikach (FareLight / Ustawienia). Po uzupełnieniu oznacz jako gotowe.

    

      
      porównuje listę z aktualnymi danymi FareLight: uzupełnione pozycje zamyka same, pozostałe doprecyzowuje
    

    
Typ brakuObiektNazwaWystąpieńOstatnioPrzykład (bilet)

  


  

    
Raport rozliczeniowy (CSV)

    

      

      

      

    

    
    
Raport zawiera wszystkie rekordy w zakresie + podsumowanie obrotu i prowizji per kanał.

  


  

    
Ustawienia integracji

    

      

      

      

    

    

      

      

        
        
Rozkład podaje nazwę z paczki źródłowej — nogi Arrivy są w MERITS podpisane „LKA”.
        Klucz: RICS (np. 3238), RICS|marka
        (marka = UIC service brand kursu, np. 232 = Os) albo nazwa źródłowa (LKA).
        Klucz z marką ma pierwszeństwo. Etykieta nie wpływa na filtrowanie ani na sprzedaż.

      

      

      

      

        
        
IRS 90918-8 wymaga odesłania do pełnych
        warunków przewozu na bilecie — „to, co normalnie znajdujesz na odwrocie biletu
        papierowego”. Bez tego pasażer nie ma z biletu drogi do regulaminu.

      

    

    

      

      
      

        
        
—

      

      
—

    

    

      
      

        
        
—

        
Klucz z zakresem admin,
          używany wyłącznie do przepustki wejścia w panel rejestru. Nieustawiony =
          próba kluczem integracji (zadziała tylko, jeśli ma zakres admin).

      

    

    

      

      

    

    

    
Spółki pracownicze (SP_PRAC)

    
Ulgi UUT — 40 pracownik kolei, 41 emeryt
      kolejowy, 42 rodzina pracownika — przysługują z tytułu zatrudnienia,
      więc rekord rozliczeniowy musi wskazywać pracodawcę w polu SP_PRAC.
      Kanał podaje kod spółki jako drugi człon kodu ulgi (40:317).
      Przy tych ulgach wskazanie spółki jest wymagane, a kod spoza tego
      słownika jest odrzucany — inaczej w polu rozliczeniowym zostawałaby liczba, której
      nikt nie umie przypisać do spółki.

    

      

      

      

    

    
KodNazwaCzynna


    
Kody przewoźników

    
Kanały podają przewoźnika nogi tak, jak umieją: KD kodem liczbowym
      krajowym (14), kasa NKB literowym (IC),
      inni własną numeracją. U nas rozstrzygający jest RICS. Rejestr ERA/UIC
      pokrywa kody literowe i akronimy, ale nie zna kodów krajowych ani numeracji partnerów —
      te wpisuje się tutaj. Kod nierozwiązany nie wywala sprzedaży: noga
      zostaje bez RICS i jest traktowana jak nasz przewoźnik, więc kontrola honorowania
      na niej nie zadziała. Awaria jest cicha — dlatego ten słownik.

    

      

      

      

      

      

    

    
SystemKodRICSNazwaCzynny