Czym to jest
Kasa to ewidencja gotówki firmy z dokładnością co do grosza. Każda kasa fizyczna (recepcja, serwis, kasa główna) ma swoje saldo, a wszystkie wpłaty (KP) i wypłaty (KW) są dokumentowane w cyklu DRAFT → POSTED → (CANCELLED na DRAFT). Saldo aktualizowane atomowo.
Po POST nie ma cofnięcia
Zatwierdzony KP/KW jest immutable — saldo kasy się zmieniło, dokument zostaje. Cofnięcie pomyłki = przeciwny dokument (np. KW wyrównujący po nieprawidłowym KP).
Kod, nazwa, opcjonalny kasjer
Z /finanse/kasa/kasy/new dodajesz nową kasę. Kod unikalny per tenant (np. KASA-1, KASA-CZ). Saldo startuje od 0 — zasilenie przez KP z kind=BANK_WITHDRAWAL albo OWNER_DEPOSIT.
Krok po kroku
Z pulpitu Kasa → Kasy.
Pomarańczowy FAB.
Kasjer Employee ID opcjonalny.
Kasa aktywna od razu, saldo 0 zł.
Efekt: Można już tworzyć KP/KW na tej kasie.
DRAFT → POSTED, saldo += amount
Z /finanse/kasa/kp/new tworzysz dokument wpłaty. Wybierasz kasę, kwotę, rodzaj operacji (kind) — np. CASH_SALE (sprzedaż), OWNER_DEPOSIT (wpłata właściciela), BANK_WITHDRAWAL (z banku). Tytuł obowiązkowy.
Krok po kroku
Z listy /finanse/kasa/kp.
Kind determinuje co to za wpłata. Tytuł — wolny tekst.
EMPLOYEE / PARTY / OWNER / OTHER + Employee ID lub etykieta.
Numer KP/RRRR/NNNN. POST na detail.
Efekt: DRAFT — gotowy do zatwierdzenia.
Saldo kasy się zwiększa atomowo
Z karty KP w DRAFT klik Zatwierdź. Saldo kasy += kwota. Dla kind=ADVANCE_SETTLEMENT pomniejsza balance powiązanej zaliczki. Dla kind=ADVANCE_TOPUP zwiększa amountSettled (pracownik dopłaca z prywatnych).
Krok po kroku
Z listy.
ConfirmDialog — sprawdź kwotę.
POSTED, saldo zaktualizowane, ewentualnie zaliczka rozliczona.
Efekt: Bieżące saldo widać na karcie kasy.
DRAFT, walidacja salda przed POST
Z /finanse/kasa/kw/new tworzysz wypłatę. Kind=ADVANCE_ISSUE wymaga pracownika + celu zaliczki (advancePurpose). Inne kindy: SUPPLIER_PAYMENT (zapłata dostawcy), EMPLOYEE_REIMBURSE (zwrot za prywatny zakup), BANK_DEPOSIT (do banku).
Krok po kroku
Z listy /finanse/kasa/kw.
Kasa musi być ACTIVE, kwota > 0.
EMPLOYEE / PARTY / OWNER / OTHER. Dla ADVANCE_ISSUE — wymagany Employee ID.
Wymagane pole z opisem: na co pracownik bierze gotówkę. Opcjonalna data oczekiwanego zwrotu.
Po POST powstanie zaliczka
System wygeneruje numer ZL/RRRR/NNNN i utworzy KasaCashAdvance powiązaną z tym KW (1:1).
Numer KW/RRRR/NNNN. POST na detail.
Efekt: DRAFT.
Saldo -= kwota; ADVANCE_ISSUE → utworzenie zaliczki
Z karty KW w DRAFT klik Zatwierdź. Walidacja: saldo kasy ≥ amount. Saldo -= kwota. Dla ADVANCE_ISSUE w jednej transakcji powstaje KasaCashAdvance ze statusem OPEN.
Krok po kroku
Z listy.
Walidacja salda.
POSTED. Dla ADVANCE_ISSUE link do utworzonej zaliczki na karcie.
Efekt: Saldo kasy zmniejszone.
Cykl: OPEN → SETTLED
Cały flow: kasjerka tworzy KW z kind=ADVANCE_ISSUE → POST tworzy ZL → pracownik wydaje gotówkę → wraca z paragonami i FV → księgowa robi FVZ w magazyn → linkuje FVZ z zaliczką → ewentualnie KP z kind=ADVANCE_SETTLEMENT na resztę. Gdy balance=0 → status SETTLED.
Krok po kroku
Kasjerka wydaje gotówkę pracownikowi.
System tworzy zaliczkę ZL/RRRR/NNNN ze statusem OPEN i balance=amount.
Zbiera paragony, FV.
Księgowa robi FVZ → wchodzi w detail zaliczki → klik Powiąż FVZ → wpisuje FVZ ID + kwotę pokrycia.
Efekt: Balance zaliczki maleje.
Pracownik zwraca resztę → KP kind=ADVANCE_SETTLEMENT z advanceId. Gdy wydał więcej → KP kind=ADVANCE_TOPUP z dopłatą z prywatnych.
Gdy balance=0, zaliczka zostaje zamknięta.
Efekt: Cykl rozliczony.
Linkowanie FVZ z modułu magazyn
Pracownik dostarcza paragony / FV → księgowa tworzy FVZ w /magazyn/fvz → wchodzi w /finanse/kasa/zaliczki/<id> → klik Powiąż FVZ z zaliczką → wpisuje FVZ ID + kwotę pokrycia + ewentualne uwagi. Walidacja: kwota ≤ saldo zaliczki.
Krok po kroku
Z /finanse/kasa/zaliczki → wybierz zaliczkę.
Modal z FVZ ID + kwotą + uwagami.
FVZ unique per zaliczka, kwota ≤ saldo.
amountSettled += kwota, balance -= kwota. Jeśli balance=0 → SETTLED.
Efekt: FVZ widoczna na karcie zaliczki.
kind=ADVANCE_SETTLEMENT, pomniejsza balance
Po rozliczeniu części przez FVZ pracownik zwraca resztę gotówki → kasjerka tworzy KP z kind=ADVANCE_SETTLEMENT i wskazuje advanceId. POST: saldo kasy += kwota i balance zaliczki -= kwota. Walidacja: kwota ≤ saldo zaliczki.
Krok po kroku
Wybierz UUID zaliczki z detail strony.
Maks. saldo zaliczki.
Saldo kasy +, balance zaliczki -.
Efekt: Gdy balance=0 → SETTLED.
CLOSED_WRITE_OFF — utrata kwoty
Gdy zaliczka jest nieodzyskana (np. pracownik zniknął), klikasz Odpisz zaliczkę na detail → wpisujesz powód. Status → CLOSED_WRITE_OFF, balance pozostaje jako księgowa strata.
Krok po kroku
Modal z powodem.
np. pracownik zniknął bez rozliczenia, brak kontaktu.
Status → CLOSED_WRITE_OFF.
Efekt: Zaliczka zamknięta jako strata.
Dzienny / miesięczny per kasa
Z /finanse/kasa/raporty wybierasz kasę + zakres (dzień / miesiąc). System computed-on-fly: saldo otwarcia (suma KP/KW przed okresem) + suma KP w okresie − suma KW = saldo zamknięcia. Dla raportu dziennego pełna lista dokumentów z linkami.
Krok po kroku
Z pulpitu Kasa → Raport kasowy.
Daty default: dzisiaj / bieżący miesiąc.
Powinno zgadzać się z fizycznym stanem (gdy nie — sprawdź dokumenty).
Efekt: Raport gotowy do druku/pobrania.