Numeracja dokumentów w Studio WMS.net - format RRRR-MM-NNNNN-TYP i liczniki miesięczne

Studio WMS.net nadaje dokumentowi magazynowemu numer dopiero przy zatwierdzeniu, według stałego wzorca RRRR-MM-NNNNN-TYP: rok i miesiąc z daty dokumentu, pięciocyfrowy licznik miesięczny i typ dokumentu. Ekran Numeracja dokumentów w panelu administratora nie służy do projektowania formatu - pokazuje liczniki, z których program pobiera kolejne numery. Strona wyjaśnia, skąd bierze się każda część numeru i kiedy w numeracji może powstać luka, a na końcu pokazuje nadawanie numeru od strony bazy danych.

Lista pokazuje liczniki w siedmiu kolumnach: Aktywne, Opis, Przed, Numer, Po, Rok i Termin do. W bazie demonstracyjnej pierwszy wiersz, Dokument PAL, jest licznikiem numerów palet z rokiem 2099 i terminem 2100-01-01, a kolejne wiersze to liczniki dokumentów, np. przyjęć cross-docking CDP z rejestrem PZ i wydań CDW z rejestrem WZ. Kilka wierszy o tym samym opisie i roku odpowiada licznikom kolejnych miesięcy - kolumny miesiąca ekran nie wyświetla. Stopka podaje w bazie demonstracyjnej 3041 liczników przy 100 rekordach na stronie.

Budowa numeru dokumentu magazynowego

Cały numer przykładowego przyjęcia ma postać 2026-07-00012-PZ. Ten sam wzorzec mają zlecenia, np. RRRR-MM-NNNNN-ZPZ i RRRR-MM-NNNNN-ZWZ. Program nie ma ustawienia, które dodałoby do numeru oddział albo magazyn: wzorzec jest zapisany w transakcjach programu i administrator nie zmienia go na ekranie Numeracja.

Rejestr posortowany malejąco po kolumnie Nr dokumentu pokazuje w bazie demonstracyjnej dokument 2026-08-00001-PZ z datą 1 sierpnia, a pod nim 2026-07-00051-PZ z datą 31 lipca. Pierwszy dokument sierpnia zaczyna nową serię od 00001, a lipcowa seria kończy się na 00051. W kolumnie Nr zlecenia numery zleceń ZPZ mają ten sam wzorzec z końcówką ZPZ, np. 2026-07-00065-ZPZ. Kolumny rejestru opisuje strona rejestr zatwierdzonych przyjęć PZ.

Kiedy dokument dostaje numer

Dokument zapisany przyciskiem Bufor nie pobiera numeru. W polu numeru przechowuje numer referencyjny - identyfikator unikalny, ale niebędący kolejnym numerem porządkowym. Numer z licznika program pobiera dopiero przy zatwierdzeniu przyciskiem Zapisz, po komunikacie: "Po zatwierdzeniu dokument otrzyma numer i nie będzie podlegał edycji".

W buforze przyjęć PZ kolumna Nr dokumentu zawiera długie ciągi cyfr - numery referencyjne dokumentów roboczych - a kolumna Nr zlecenia numery zleceń ZPZ w pełnym formacie, bo przyjęcie PZ realizuje wyłącznie zatwierdzone zlecenia. W bazie demonstracyjnej bufor ma sześć dokumentów z datami od 7 do 30 lipca 2026. Pola numeru dokumentu dostawcy, awizo, dowodu i faktury są jeszcze puste - kreska oznacza brak danych. Pracę z tym rejestrem opisuje strona przyjęcia PZ w buforze.

Po zatwierdzeniu okno potwierdzenia pokazuje numer, który faktycznie zapisał się w bazie. Obowiązuje właśnie ten numer - może różnić się od oczekiwanego, gdy kontrola unikalności poprawi numer zajęty. Usunięcie dokumentu z bufora nie zużywa numeru, bo dokument roboczy go nie pobrał.

Rok i miesiąc z daty dokumentu

Reguła daty w numerze. Rok i miesiąc numeru pochodzą z daty dokumentu wybranej w formularzu przy zatwierdzeniu, a nie z daty systemowej serwera. Dokument z datą 31 lipca zatwierdzony 1 sierpnia dostanie numer z serii lipcowej, np. 2026-07-00052-PZ.

Przy zatwierdzeniu program zapisuje też chwilę zatwierdzenia: data dokumentu w bazie zostaje ustawiona na datę bieżącą, a data wybrana w formularzu trafia do osobnego pola. Na przełomie miesięcy numer może więc należeć do poprzedniego miesiąca, choć dokument zatwierdzono już w nowym. Przy zamykaniu miesiąca warto sprawdzić, czy w buforze nie zostały dokumenty z datami poprzedniego miesiąca - ich zatwierdzenie dopisze kolejne numery do serii, którą uznano już za zamkniętą.

Ekran numeracji dokumentów - kolumny i liczniki

Licznika nie zakłada się ręcznie. Gdy w nowym miesiącu zostanie zatwierdzony pierwszy dokument danego typu, program sam dopisuje licznik dla tego miesiąca, dlatego lista rośnie z każdym miesiącem pracy magazynu. Liczniki nie mają kolumny magazynu ani oddziału: dokumenty jednego typu ze wszystkich magazynów w bazie dzielą w danym miesiącu jedną serię numerów. W instalacji demonstracyjnej lista służy do podglądu i nie ma edycji w wierszu.

Format numeru nie jest ustawieniem. Wzorzec RRRR-MM-NNNNN-TYP jest zapisany w transakcjach programu, a licznik przechowuje rok, rejestr, typ, miesiąc, ostatni numer i termin ważności - bez magazynu i oddziału. Numeru z symbolem oddziału ani osobnych serii dla magazynów nie ustawia się w panelu administratora.

Unikalność numeru i luki w numeracji

Przed zapisem numer przechodzi kontrolę unikalności. Program porównuje go z numerami wszystkich dokumentów magazynowych i zleceń, także oznaczonych jako usunięte. Gdy numer jest zajęty, dokument dostaje numer o jeden większy od najwyższego użytego w tym samym miesiącu dla tego samego typu.

Luka w numeracji nie musi więc oznaczać zaginionego dokumentu. Numer, który raz trafił do dokumentu albo zlecenia, nie zostanie nadany drugi raz - nawet jeśli pierwszy rekord oznaczono później jako usunięty. Rekordy usunięte zostają w bazie, a samo usunięcie zapisuje się w dzienniku zdarzeń.

Co dzieje się w bazie przy nadawaniu numeru

Przy zatwierdzeniu baza wykonuje jedno polecenie UPDATE, które zmienia status pozycji z bufora na zatwierdzony i wpisuje do nich numer; razem z nim powstaje wpis w dzienniku zdarzeń. Numer dokumentu magazynowego pochodzi z licznika miesięcznego, który prowadzi usługa serwera aplikacji, a przed zapisem przechodzi opisaną wyżej kontrolę unikalności.

Transakcja i blokady przy zatwierdzeniu. Zmiana statusu z numerem i wpis do dziennika wykonują się w jednej transakcji - zapisują się oba albo żaden. Aplikacja nie ustawia własnego poziomu izolacji, więc obowiązuje poziom domyślny bazy, opisany w dokumentacji poziomów izolacji transakcji w Microsoft Learn. Polecenie UPDATE trzyma blokady wyłączne na zmienianych wierszach do końca transakcji, a warunek "tylko pozycje w buforze" sprawia, że drugie zatwierdzenie tego samego dokumentu, np. z innego stanowiska, nie znajdzie już nic do zmiany. Mechanizm blokad przedstawia przewodnik po blokadach i wersjonowaniu wierszy w SQL Server.

Procedury serwerowe, które same nadają numery - zamknięcie inwentaryzacji z dokumentami PI i RI oraz zatwierdzenie rozliczenia kosztów - pobierają je z liczników w bazie poleceniem UPDATE zwiększającym numer o jeden, wewnątrz transakcji procedury. Blokada wyłączna na wierszu licznika sprawia, że dwa równoczesne wywołania dostają kolejne numery, a błąd w procedurze wycofuje całą transakcję razem z pobranym numerem.

Numer palety a numer SSCC

Numer palety nadaje osobny licznik ciągły - na liście liczników wiersz Dokument PAL z rejestrem PR. Numer ma 18 cyfr i nie zaczyna się od nowa z nowym rokiem ani miesiącem. Długością przypomina numer SSCC, ale nim nie jest: nie ma prefiksu firmy GS1 ani cyfry kontrolnej. Numery SSCC zgodne ze standardem tworzy moduł jednostek logistycznych SSCC, a budowę numeru opisuje standard SSCC w serwisie GS1.

Typowe sytuacje przy numeracji

Rolę dokumentów przychodowych i rozchodowych w ewidencji opisuje opracowanie dokumenty magazynowe PZ, WZ, PW, RW i MM.