Magazyn

Krok po kroku

1. 1

   Otwórz `/magazyn/pz`

   Z pulpitu Magazyn → Przyjęcia (PZ).

2. 2

   FAB *Nowe PZ*

   FAB w prawym dolnym rogu.

3. 3

   Wybierz magazyn docelowy

   Lista aktywnych magazynów.

4. 4

   Numer FV dostawcy + data przyjęcia

   Numer FV opcjonalny (zostanie powiązany w Fazie 2). Data domyślnie teraz.

5. 5

   Dodaj pozycje

   + Dodaj pozycję tworzy nową linię. Wybierasz produkt z kartoteki, wpisujesz ilość i koszt jednostkowy. Możesz dodać wiele pozycji.

   Pozycje serializowane

   Dla produktu z flagą Serializowany wymagane qty=1 i numer seryjny per linia.

6. 6

   Zapisz DRAFT

   PZ otrzymuje numer PZ/RRRR/NNNN. Możesz zatwierdzić od razu albo wrócić później.

   Efekt: Dokument w statusie DRAFT — zatwierdzasz na stronie szczegółów.

Krok po kroku

1. 1

   Otwórz PZ w statusie DRAFT

   Z listy /magazyn/pz.

2. 2

   Sprawdź pozycje

   Magazyn, produkty, ilości, koszty — po POST nie cofniesz.

3. 3

   Kliknij *Zatwierdź (POST)*

   Niebieski przycisk z ikoną CheckCircle.

   Nieodwracalne

   Po POST dokument jest immutable. Jeśli pomyłka, trzeba zrobić korektę KPZ (Faza 3 modułu).

4. 4

   Potwierdź w ConfirmDialog

   System pyta Zatwierdzić PZ?.

5. 5

   Sprawdź stan

   W zakładce Stany widzisz nowe partie z qtyRemaining = qtyReceived.

   Efekt: Towar dostępny do wydania.

Krok po kroku

1. 1

   Otwórz `/magazyn/wz/new`

   Z pulpitu Magazyn → Wydania (WZ) → FAB.

2. 2

   Magazyn + odbiorca + data

   Odbiorca jako wolny tekst (np. Klient — Jan Kowalski). W Fazie 2 pojawi się link do ticketów/szkód.

3. 3

   Dodaj pozycje

   Produkt + ilość. Bez kosztu — FIFO weźmie najstarsze partie.

4. 4

   Zapisz DRAFT

   WZ otrzymuje numer WZ/RRRR/NNNN.

   Efekt: Dokument do zatwierdzenia.

Krok po kroku

1. 1

   Otwórz WZ w statusie DRAFT

   Z listy /magazyn/wz.

2. 2

   Sprawdź pozycje + magazyn

   Po POST nie cofniesz.

3. 3

   Kliknij *Zatwierdź (POST)*

   System sprawdza dostępność stanu (suma qtyRemaining ≥ qty wydane). Jeśli brak — błąd, trzeba uzupełnić stan.

   FIFO transparentnie

   Po POST każda linia pokazuje Pobrane partie (FIFO) — z którego PZ/MM, kiedy przyjęto, ile sztuk i po jakiej cenie.

4. 4

   Potwierdź w dialogu

   ConfirmDialog Zatwierdzić WZ?.

5. 5

   Sprawdź alokacje

   Na karcie WZ pod każdą linią lista partii z których pobrano towar.

   Efekt: Towar wydany, stan zaktualizowany.

Krok po kroku

1. 1

   Otwórz `/magazyn/stock`

   Z pulpitu Magazyn → Stany.

2. 2

   Zakładka *Stan zagregowany*

   Tabela: produkt + magazyn + suma qtyRemaining. Najszybszy widok ile mamy.

3. 3

   Zakładka *Partie*

   Każda partia z osobna. Partie z ikoną alarmu mają cenę PROVISIONAL — czekają na FV od dostawcy (do potwierdzenia).

4. 4

   Zakładka *Dziennik ruchów*

   Każdy ruch (RECEIPT/ISSUE) z dokumentem (PZ/WZ), datą, ilością i kosztem.

Krok po kroku

1. 1

   Otwórz `/magazyn/ipo`

   Z kafla Zlecenia zakupów w Finansach (zaczyna się od IPO).

2. 2

   FAB *Nowe IPO*

   FAB w prawym dolnym rogu.

3. 3

   Umowa ramowa (opcjonalnie)

   Wybierz, gdy zapotrzebowanie zna już dostawcę i chcesz wycenić z cennika. Bez umowy = formularz przełącza się w tryb free-text (nazwa + jednostka).

4. 4

   Pozycje

   Z umową: SKU + ilość + (opcjonalnie) cena lub Pozycja cennika. Bez umowy: wpisz nazwę, kwotę i wybierz VAT (domyślnie Podstawowa 23%) — pojazd i przeznaczenie opcjonalnie.

5. 5

   Zapisz DRAFT

   IPO otrzymuje numer IPO/RRRR/NNNN.

   Efekt: DRAFT — można edytować linie. Wysłanie na stronie szczegółów.

Krok po kroku

1. 1

   Otwórz IPO w DRAFT

   Z listy /magazyn/ipo.

2. 2

   Kliknij *Wyślij do zakupów*

   Niebieski przycisk z ikoną Send.

3. 3

   Potwierdź

   ConfirmDialog Wysłać IPO?.

   Efekt: Status SUBMITTED, czeka na konwersję do PO.

Krok po kroku

1. 1

   Otwórz IPO w SUBMITTED

   Z listy /magazyn/ipo (filtr Wysłane).

2. 2

   Kliknij *Konwertuj do PO*

   Przycisk z ikoną ShoppingCart — tylko gdy masz mag_po_ADD.

3. 3

   Potwierdź

   ConfirmDialog Utworzyć PO z IPO?.

4. 4

   Edytuj PO

   Po konwersji landujesz na /magazyn/po/[id]/edytuj — przejdź do procesu Przydzielanie grup księgowych.

   Efekt: PO/RRRR/NNNN w statusie DRAFT, IPO przechodzi do CONVERTED_TO_PO.

Krok po kroku

1. 1

   Otwórz PO w DRAFT

   Po konwersji IPO→PO redirect leci tu od razu, lub klik Edytuj na karcie podglądu.

2. 2

   Uzupełnij nagłówek

   Dostawca, tryb płatności, oczekiwana dostawa, notatki. Zapisz nagłówek.

3. 3

   Przydziel każdą linię do grupy

   W banerze Bez przydziału dropdown Przydziel do grupy → linia trafia do odpowiedniej sekcji.

4. 4

   Uzupełnij wymagane pola per grupa

   PZ: magazyn docelowy. ŚT: kod KŚT (stawka się sama uzupełni), checkbox używany gdy istotny, centrum kosztu. Koszt: konto kosztowe + centrum.

5. 5

   (Opcjonalnie) split N:M

   Klik Rozdziel koszt na kilka centrów → mini-edytor z % udziału, suma musi być 100%.

6. 6

   Wyślij do dostawcy

   Przycisk Wyślij — odblokowany dopiero po przydziale wszystkich linii i wybraniu dostawcy.

   Efekt: DRAFT → SENT, czekamy na dostawę + FVZ.

Krok po kroku

1. 1

   Otwórz PO w DRAFT

   Z listy /magazyn/po lub po edycji bezpośrednio.

2. 2

   Sprawdź pozycje + grupy

   Po SEND nie cofniesz.

3. 3

   Kliknij *Wyślij do dostawcy*

   Niebieski przycisk z ikoną Send.

4. 4

   Potwierdź

   ConfirmDialog Wysłać PO?.

   Efekt: Status SENT — czeka na dostawę i fakturę.

Krok po kroku

1. 1

   Otwórz `/magazyn/fvz/new`

   Z FAB.

2. 2

   Dostawca + numer FV od dostawcy

   Numer wpisz dokładnie tak jak na FV (np. FA/2026/05/123 ABC sp. z o.o.).

3. 3

   Powiązanie z PO (opcjonalne na DRAFT)

   FV bez PO ląduje w RE — wymaga utworzenia PO przed POST.

4. 4

   Pozycje + dyspozycje

   Każda linia: produkt, ilość, koszt jedn., dyspozycja księgowa.

5. 5

   Zapisz DRAFT

   FVZ otrzymuje numer FVZ/RRRR/NNNN.

   Efekt: DRAFT — POST na stronie szczegółów.

Krok po kroku

1. 1

   Otwórz FVZ w DRAFT

   Każda linia musi mieć link do linii PO (3-way match). FV bez PO → utwórz PO najpierw.

2. 2

   Kliknij *Zatwierdź (POST)*

   Walidacja + transakcja: KKS jeśli delta poza tolerancją, IN_TRANSIT flow gdy brak PZ.

   Auto-KKS

   Jeśli FVZ.unitCost różni się od provisional cost lota i delta wykracza poza tolerancję trybu linii PO — system tworzy KKS proporcjonalny dla wszystkich już skonsumowanych alokacji partii. Magia.

3. 3

   Potwierdź w dialogu

   ConfirmDialog Zatwierdzić FVZ?.

4. 4

   Wynik

   Status POSTED, partie z costStatus=CONFIRMED, ewentualny KKS w bazie.

   Efekt: Cena potwierdzona, wartość zapasu zaktualizowana.

Krok po kroku

1. 1

   Otwórz `/magazyn/mm/new`

   Z FAB.

2. 2

   Magazyn źródłowy + docelowy

   Muszą być różne. Częste case: MAG-IN-TRANSIT → MAG-AN po dostarczeniu auta.

3. 3

   Pozycje

   Bez sourceLotId — auto-FIFO ze źródłowego. Z sourceLotId — konkretny lot.

4. 4

   Zapisz DRAFT

   MM otrzymuje numer MM/RRRR/NNNN.

   Efekt: DRAFT — POST na stronie szczegółów.

Krok po kroku

1. 1

   Otwórz MM w DRAFT

   Z listy /magazyn/mm.

2. 2

   Kliknij *Zatwierdź (POST)*

   Walidacja + transakcja.

3. 3

   Potwierdź

   ConfirmDialog Zatwierdzić MM?.

4. 4

   Wynik

   Status POSTED, oryginał ma decrement, nowy lot w docelu.

   Efekt: Stany zaktualizowane na obu magazynach.

Krok po kroku

1. 1

   Otwórz `/magazyn/pw/new`

   Z pulpitu Magazyn → Przyjęcia wewnętrzne (PW).

2. 2

   Magazyn docelowy + data

   Wybierz magazyn aktywny.

3. 3

   Pozycje + szacowany koszt

   Wpisz produkt, ilość i koszt. Cena pojawi się jako provisional do skorygowania.

4. 4

   Zapisz DRAFT

   PW otrzymuje numer PW/RRRR/NNNN.

   Efekt: DRAFT — POST na stronie szczegółów.

Krok po kroku

1. 1

   Otwórz PW w DRAFT

   Z listy /magazyn/pw.

2. 2

   Kliknij *Zatwierdź (POST)*

   Tworzy partie i wpisy.

3. 3

   Potwierdź

   ConfirmDialog.

   Efekt: Stan zwiększony, partie z costStatus=PROVISIONAL.

Krok po kroku

1. 1

   Otwórz `/magazyn/rw/new`

   Z pulpitu Magazyn → Rozchody wewnętrzne (RW).

2. 2

   Magazyn źródłowy + domyślny powód

   Powód można nadpisać per linia (np. mix CONSUMPTION + SCRAP).

3. 3

   Pozycje

   Tylko produkt + ilość — koszt brany z partii FIFO przy POST.

4. 4

   Zapisz DRAFT

   RW otrzymuje numer RW/RRRR/NNNN.

   Efekt: DRAFT — POST na stronie szczegółów.

Krok po kroku

1. 1

   Otwórz RW w DRAFT

   Z listy.

2. 2

   Kliknij *Zatwierdź (POST)*

   Walidacja stanu + transakcja.

3. 3

   Sprawdź alokacje

   Pod każdą linią lista pobranych partii (FIFO trail).

   Efekt: Stan obniżony, koszty zaalokowane.

Krok po kroku

1. 1

   Otwórz `/magazyn/stocktake/new`

   Z pulpitu Magazyn → Inwentaryzacja.

2. 2

   Magazyn + dzień referencyjny

   Domyślnie dzisiaj.

3. 3

   Zapisz DRAFT

   Numer IN/RRRR/NNNN. Otwórz na stronie szczegółów.

   Efekt: DRAFT — gotowe do otwarcia.

Krok po kroku

1. 1

   Otwórz inwentaryzację w DRAFT

   Z listy.

2. 2

   Kliknij *Otwórz (snapshot lotów)*

   Tworzy linie ze stanem systemowym.

3. 3

   Wynik

   Status IN_PROGRESS, każda linia ma systemQty + countedQty=null.

   Efekt: Możesz wpisywać policzone ilości.

Krok po kroku

1. 1

   Wpisz wszystkie countedQty

   Bez wpisanej wartości linia jest traktowana jako counted=system (zero różnicy).

2. 2

   Kliknij *Zamknij i wygeneruj PW/RW*

   Transakcja generuje oba dokumenty.

3. 3

   Potwierdź

   ConfirmDialog ostrzega o nieodwracalności.

   Efekt: Status CLOSED, link do PW/RW na karcie.

Krok po kroku

1. 1

   Otwórz `/magazyn/kks`

   Z pulpitu Magazyn → Korekty kosztu.

2. 2

   FAB *Ręczne KKS*

   Pomarańczowy FAB.

3. 3

   Wpisz lotId + delta + powód

   Delta dodatnia = wartość rośnie, ujemna = spada.

4. 4

   Utwórz

   System tworzy KKS proporcjonalnie + aktualizuje lot.unitCost.

   Efekt: Status POSTED, łańcuch korekt na karcie.

Krok po kroku

1. 1

   Otwórz `/magazyn/kpz/new`

   Z pulpitu Magazyn → Korekty PZ.

2. 2

   Wybierz POSTED PZ

   Lista zatwierdzonych PZ. Wybór determinuje magazyn i loty.

3. 3

   Rodzaj + powód

   PARTIAL_RETURN (część) / CANCEL_FULL (całość) / SHORTAGE_AT_RECEIPT (korekta zapisu).

4. 4

   Zapisz DRAFT

   Numer KPZ/RRRR/NNNN. Linie dodajesz na detail.

   Efekt: DRAFT — gotowe do dodania pozycji.

Krok po kroku

1. 1

   Otwórz KPZ w DRAFT

   Z listy /magazyn/kpz.

2. 2

   Sprawdź pozycje

   Każda linia: oryginalna pozycja + lot + qty.

3. 3

   Kliknij *Zatwierdź*

   Walidacja stanu lota + transakcja.

4. 4

   Wynik

   POSTED, qtyRemaining lota zmniejszone, ruch widoczny w dzienniku.

   Efekt: Towar formalnie zwrócony do dostawcy.

Krok po kroku

1. 1

   Otwórz `/magazyn/kwz/new`

   Z pulpitu Magazyn → Korekty WZ.

2. 2

   Wybierz POSTED WZ + magazyn docelowy

   Magazyn auto-fill na warehouseId oryginału.

3. 3

   Rodzaj + powód

   CUSTOMER_RETURN / DELIVERY_ERROR / CANCEL_FULL.

4. 4

   Zapisz DRAFT

   Numer KWZ/RRRR/NNNN. Linie z wyborem alokacji dodajesz na detail.

   Efekt: DRAFT — gotowe.

Krok po kroku

1. 1

   Otwórz KWZ w DRAFT

   Z listy.

2. 2

   Kliknij *Zatwierdź*

   Walidacja qty ≤ alokacja − wcześniejsze KWZ.

3. 3

   Wynik

   POSTED, nowe loty na docelowym magazynie z snapshot ceny.

   Efekt: Stan zwiększony, FIFO przy następnej WZ uwzględni nowe loty.

Krok po kroku

1. 1

   Otwórz `/magazyn/kfvz/new`

   Z pulpitu Magazyn → Korekty FVZ.

2. 2

   Wybierz POSTED FVZ

   Lista zatwierdzonych FVZ.

3. 3

   Rodzaj + numer korekty + powód

   PRICE wymaga unitCostDelta ≠ 0 i qtyDelta = 0. QTY wymaga osobnego KPZ.

4. 4

   Zapisz DRAFT

   Numer KFVZ/RRRR/NNNN.

   Efekt: DRAFT — gotowe do dodania linii z deltami.

Krok po kroku

1. 1

   Otwórz KFVZ w DRAFT

   Z listy.

2. 2

   Kliknij *Zatwierdź*

   Walidacja delt vs. kind + transakcja.

   Auto-KKS magia

   PRICE_CORRECTION generuje pojedynczy KKS dokument z liniami per dotknięta alokacja + remaining — wszystkie zaktualizowane w jednej transakcji.

3. 3

   Wynik

   POSTED, wygenerowane KKS widoczne na karcie KFVZ.

   Efekt: Wartość zapasu i koszty COGS zaktualizowane proporcjonalnie.

Krok po kroku

1. 1

   Wyszukaj pojazd

   Po numerze rejestracyjnym lub VIN — wyniki z kartoteki Vehicle.

2. 2

   Sprawdź czy auto jest już w warsztacie

   Modal pokazuje aktywne pobyty — możesz dopiąć bieżące zgłoszenie albo dodać nowy pobyt.

   Reguła raz przyjęty

   Jeden fizyczny pobyt może obsługiwać wiele zgłoszeń SRV/LSK. Klient X, auto Y, kategoria mechanika → jeden pobyt.

3. 3

   Wybierz kategorię

   MECHANICAL / BODYSHOP / OTHER — determinuje pulę magazynów.

4. 4

   Wybierz magazyn

   Z mapowania kategorii. Auto-select gdy 1 magazyn.

5. 5

   Przebieg + notatki

   Stan pojazdu, uwagi, zdjęcia.

6. 6

   Zapisz

   Pobyt OPEN. Auto-resolved task lsk:intake_done / srv:intake_done jeśli był zaplanowany. Po zapisie wracasz do źródłowego zgłoszenia (SRV/LSK), z którego otworzyłeś formularz — przyjęcia „wolne” (bez ticketu) lądują na liście pobytów.

   Efekt: Pojazd na stanie magazynu klienckiego do czasu wydania, użytkownik na karcie zgłoszenia.

Krok po kroku

1. 1

   Z ticketu SRV/LSK

   Kliknij Przyjmij pojazd w sekcji Pobyt w warsztacie.

2. 2

   System wykrywa aktywny pobyt

   Modal: lista pobytów OPEN dla tego pojazdu.

3. 3

   Dopnij to zgłoszenie

   Tworzy CustomerCarVisitTicket (junction).

   Efekt: Pobyt obsługuje teraz oba zgłoszenia. Wydanie pojazdu zamyka pobyt — nie zamyka ticketów.

Krok po kroku

1. 1

   Otwórz pobyt

   Z /magazyn/kartoteki/pojazdy lub z sekcji Pobyt w warsztacie ticketu.

2. 2

   Kliknij *Wydaj pojazd*

   Tylko gdy status OPEN.

3. 3

   Wpisz dane wydania

   Data + przebieg + notatki + zdjęcia.

4. 4

   Backend sprawdza otwarte zgłoszenia

   Jeśli są — modal pokazuje listę i prosi o notatkę.

   Wydanie z otwartymi

   Field releasedWithOpenTickets=true zostaje zapisany w pobycie — audit trail.

5. 5

   Zatwierdź wydanie

   Pobyt → status RELEASED. Auto-resolved task lsk:release_done.

   Efekt: Pojazd wydany klientowi. Karta pobytu pokazuje sekcję Wydanie z timestampem i przebiegiem.