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ęśćZnaczeniePrzykład
Rokcztery cyfry2026
Miesiącdwie cyfry10
Numer w miesiącupięć cyfr z licznika miesięcznego00012
Typ dokumentuskrót dokumentu, na przykład PZ albo WZPZ
KońcówkaPM albo KMPM
Schemat: rok, miesiąc, numer w miesiącu, typ dokumentu i końcówka PM albo KM w numerze dokumentu magazynowego
Schemat rozkłada numer na pięć części i opisuje, kiedy dokument ma końcówkę PM, kiedy KM, a kiedy nie ma końcówki wcale.

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.

DokumentKto i kiedy nadaje numerKońcówka
ZPZ i ZWZSystem, przy zatwierdzeniu nowego zlecenia. Klient zapisuje zlecenie do bufora.PM lub KM, zależnie od rodzaju dostawy albo wydania
PZ typu KMSystem, przy zatwierdzeniu przyjęciaKM
PZ typu PMAgent celny, po nadaniu numeru DSKPM
WZ typu KMSystem, przy zatwierdzeniu wydaniaKM
WZ typu PMAgent celny, po wpisaniu numerów odprawy. Terminal numeru nie nadaje.PM
PZB, PW, WZB i RWSystem, przy zatwierdzeniu dokumentubrak
ZLA, ZLP, ZLC i ZLBSystem, przy zatwierdzeniu dokumentu przesunięciabrak
PRKSystem, przy zatwierdzeniu przepakowaniabrak

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.