W skrócie
W opisywanym wdrożeniu numer dokumentu niesie informację o statusie celnym: składa się z roku, miesiąca, numeru w miesiącu, typu dokumentu i końcówki PM albo KM. Numer powstaje dopiero przy zatwierdzeniu, bufor nosi numer referencyjny, a numer DSK leży w polu numeru serii, poza maską. Przykłady numerów są wymyślone.
Numer dokumentu zwykle służy tylko do identyfikacji. W opisywanym wdrożeniu magazynu z towarem pod dozorem celnym niesie dodatkową informację: końcówka PM albo KM mówi, czy towar był pod dozorem. Opisujemy maskę numeru i moment jego nadania, a na końcu to, co dział IT powinien uzgodnić przed integracją.
Kontekst projektu opisuje studium przypadku magazynu z dozorem celnym. Tutaj zajmujemy się wyłącznie numerami.
Maska z pięciu części
Numer dokumentu składa się z pięciu części oddzielonych myślnikami. Przykład wymyślony: 2026-10-00012-PZ-PM. Format zapisuje się jednym ciągiem znaków z symbolami roku, miesiąca, numeru i typu, a zasady takiego zapisu opisuje strona o funkcji LICZNIK.
| Część | Znaczenie | Przykład |
|---|---|---|
| Rok | cztery cyfry | 2026 |
| Miesiąc | dwie cyfry | 10 |
| Numer w miesiącu | pięć cyfr z licznika miesięcznego | 00012 |
| Typ dokumentu | skrót dokumentu, na przykład PZ albo WZ | PZ |
| Końcówka | PM albo KM | PM |
Nowy miesiąc oznacza nowy licznik, więc numer w miesiącu wraca do początku. Formularz PZ przekazuje do licznika datę dokumentu, a formularz WZ datę wydania, więc miesiąc w numerze wynika z tych pól.
Przykład wymyślony pokazuje, jak numer zmienia się z miesiąca na miesiąc. Dwunasty dokument PZ typu PM z października 2026 ma numer 2026-10-00012-PZ-PM. W listopadzie numer w miesiącu wraca do początku, więc pierwszy dokument tego typu może mieć numer 2026-11-00001-PZ-PM. Rok i miesiąc są częścią numeru, a nie osobnym polem, które ktoś musiałby uzupełniać.
Kiedy numer powstaje
Numer z licznika dokument dostaje dopiero przy zatwierdzeniu. Wcześniej, w buforze, nosi numer referencyjny. Tabela podaje osiem przypadków: kto i kiedy nadaje numer oraz jaką końcówkę ma dokument.
| Dokument | Kto i kiedy nadaje numer | Końcówka |
|---|---|---|
| ZPZ i ZWZ | System, przy zatwierdzeniu nowego zlecenia. Klient zapisuje zlecenie do bufora. | PM lub KM, zależnie od rodzaju dostawy albo wydania |
| PZ typu KM | System, przy zatwierdzeniu przyjęcia | KM |
| PZ typu PM | Agent celny, po nadaniu numeru DSK | PM |
| WZ typu KM | System, przy zatwierdzeniu wydania | KM |
| WZ typu PM | Agent celny, po wpisaniu numerów odprawy. Terminal numeru nie nadaje. | PM |
| PZB, PW, WZB i RW | System, przy zatwierdzeniu dokumentu | brak |
| ZLA, ZLP, ZLC i ZLB | System, przy zatwierdzeniu dokumentu przesunięcia | brak |
| PRK | System, przy zatwierdzeniu przepakowania | brak |
Przy zatwierdzaniu PZ błąd licznika kończy się komunikatem o błędzie licznika i prośbą o ponowny zapis dokumentu.
Numer powstaje po zatwierdzeniu. Bufor ma numer referencyjny, więc nie zużywa numerów z licznika.
Kolejność kroków na wymyślonym przykładzie jednej dostawy typu PM wygląda następująco. Pracownik na terminalu przyjmuje pozycje do PZ. Dokument czeka na agenta i do tej pory nosi numer referencyjny, bo nie został zatwierdzony. Agent wpisuje numer DSK, na przykład DSK-2026-0001, i zatwierdza dokument. Dopiero wtedy dokument dostaje numer z licznika, na przykład 2026-10-00012-PZ-PM.
Przy wydaniu typu PM kolejność jest podobna. Terminal zapisuje WZ do bufora i kończy pracę komunikatem „Przekazano do Agencji Celnej”. Agent wpisuje numer kolejnego dokumentu celnego i numer odprawy celnej, a dokument dostaje numer z końcówką PM. Do tej chwili magazyn nie edytuje takiego wydania.
Numer DSK w polu numeru serii
Numer DSK nie jest częścią numeru dokumentu. Leży w polu numeru serii, które platforma ma dla towarów z numerem serii, a wpisuje go agent celny. Przy przyjęciu typu PM program sprawdza, czy pozycje mają numer o długości co najmniej dwóch znaków. Bez niego dokumentu nie da się zapisać, a formularz odpowiada „Brak nadanego numeru DSK!”.
Przy przepakowaniu nowy nośnik dziedziczy ten numer, bo wszystkie nośniki rozchodu muszą mieć ten sam numer serii. Okno agenta opisuje artykuł o agencie celnym w WMS. Numer nośnika, czyli palety, pochodzi z osobnego licznika ciągłego: nie zawiera daty, roku ani końcówki, więc nie zmienia się z miesiąca na miesiąc.
- Numer DSK: od 2 do 20 znaków, zapisany w polu numeru serii.
- Numer nośnika: licznik ciągły o 18 znakach. Wpisanie 0 na terminalu nadaje nowy numer.
- Pola numerów w nagłówku: do 20 znaków, na przykład numer awizo.
- Uwagi: do 200 znaków.
Numer palety z etykiety jest inny: ma 13 znaków i niesie kod kraju, o czym pisze artykuł o numerze palety z kodem kraju.
Co to znaczy dla integracji i raportów
Numer z trzyliterowym typem, na przykład ZPZ, i końcówką ma 20 znaków, a numer PZ z przykładu 19. Pole numeru w zewnętrznym systemie powinno pomieścić 20 znaków.
Końcówka PM jest ostatnią częścią numeru, więc raport lub eksport może wyodrębnić dokumenty pod dozorem bez dodatkowego pola. Numer dokumentu w buforze jest innym numerem niż numer po zatwierdzeniu, dlatego system zewnętrzny powinien czytać dokumenty zatwierdzone. Zestawienia ilości i lokalizacji opisuje strona o raporcie stanów magazynowych, a wczytywanie danych z plików strona o imporcie Excel do WMS.
Przed integracją trzeba uzgodnić dwie rzeczy: długość pola numeru po stronie systemu zewnętrznego i to, czy końcówka ma być częścią klucza dokumentu. Typy dokumentów zebrano na stronie o dokumentach magazynowych, a etapy wdrożenia na stronie o wdrożeniu systemu WMS.
Format numeru jest zapisany w formularzach, które nadają numer: w przyjęciach, wydaniach, zleceniach i w oknie agenta. Zmiana maski, na przykład dodanie symbolu oddziału, oznacza więc zmianę w każdym z tych miejsc i wymaga sprawdzenia na wszystkich typach dokumentów. Dokumenty już zatwierdzone zachowują numery nadane starą maską, dlatego system zewnętrzny powinien czytać numer jako tekst, a nie rozkładać go na części według jednej, stałej reguły.
Pytania do postawienia przy analizie przedwdrożeniowej
Reguły numeracji wynikają z formularzy i z konfiguracji bazy, więc część odpowiedzi trzeba uzyskać od wdrożeniowca przed startem. W analizie przedwdrożeniowej zadajemy cztery pytania.
- Licznik wspólny czy osobny: czy dokumenty z końcówką PM i KM oraz różne typy dokumentów mają jeden licznik miesięczny, czy każdy rodzaj liczy osobno. Odpowiedź zależy od konfiguracji po stronie bazy, a nie od formularzy.
- Długość pola: ile znaków przyjmuje pole numeru dokumentu w systemie zewnętrznym i w raportach, przy numerze do 20 znaków.
- Dokumenty bez końcówki: czy przesunięcia, przepakowania i przyjęcia bez zlecenia mają trafiać do tych samych zestawień co dokumenty z końcówką.
- Numer referencyjny bufora: czy system zewnętrzny ma widzieć dokumenty w buforze, a jeśli tak, jak odróżni numer referencyjny od numeru z licznika.
Czego opis nie obejmuje
Opis dotyczy maski i momentu nadania numeru w opisywanym wdrożeniu. Nie podajemy liczby dokumentów w miesiącu, czasu nadania numeru ani zachowania licznika przy jednoczesnym zatwierdzeniu dwóch dokumentów, bo źródła tego nie opisują.
Numer dokumentu WMS i numery wpisywane przez agenta to dwa osobne zestawy. Pierwszy nadaje system, drugie wpisuje człowiek po obsłudze celnej, a program ich nie rozlicza. Kontekst całego wdrożenia opisuje studium przypadku, a wydruk, na którym numer dokumentu się pojawia, artykuł o wydruku PZ z wagą brutto.
Pytania i odpowiedzi o numeracji dokumentów KM i PM
Kiedy dokument dostaje numer?
Przy zatwierdzeniu. Do tego czasu dokument w buforze nosi numer referencyjny. Przy typie PM numer powstaje dopiero po nadaniu numeru DSK przez agenta celnego.
Skąd końcówka PM?
Z rodzaju dostawy albo wydania wybranego w zleceniu. Rodzaj PM oznacza towar pod dozorem celnym i daje końcówkę PM, a pozostałe rodzaje dają końcówkę KM.
Czy bufor zużywa numer z licznika?
Nie. Bufor nosi numer referencyjny dokumentu, a numer z licznika miesięcznego powstaje dopiero przy zatwierdzeniu.
Gdzie jest zapisany numer DSK?
W polu numeru serii, a nie w numerze dokumentu. Ma od 2 do 20 znaków, a nowy nośnik po przepakowaniu dziedziczy ten numer.
Które dokumenty nie mają końcówki?
Nie mają jej dokumenty PZB, PW, WZB i RW. Bez końcówki są też przesunięcia ZLA, ZLP, ZLC i ZLB, a tak samo numeruje się przepakowanie PRK. Numer takiego dokumentu ma cztery części: rok, miesiąc, numer w miesiącu i typ.
Słownik pojęć o numeracji dokumentów
Terminy używane przez dział IT i kierownika projektu, gdy numer dokumentu WMS niesie informację o statusie celnym.
- Maska numeru
- Zapis, który określa części numeru dokumentu: rok, miesiąc, numer w miesiącu, typ dokumentu i końcówkę. W opisywanym wdrożeniu ma pięć części.
- Licznik miesięczny
- Licznik, który w nowym miesiącu zaczyna numerację od początku. Daje trzecią część numeru dokumentu, pięć cyfr.
- Numer referencyjny
- Numer, który nosi dokument w buforze. Numer z licznika dokument dostaje dopiero przy zatwierdzeniu.
- Końcówka PM i KM
- Ostatnia część numeru. PM oznacza towar pod dozorem celnym, KM towar krajowy albo dopuszczony do obrotu. Niektóre dokumenty nie mają końcówki.
- Bufor
- Stan dokumentu zapisanego, ale niezatwierdzonego. Bufor nie pobiera numeru z licznika.
Opisz nam numery w swoich dokumentach
Podaj, jakie informacje numer dokumentu ma nieść i z jakim systemem zewnętrznym będzie wymieniany, a zaproponujemy maskę i moment nadania numeru.
