W skrócie
Moduł Dozór celny w Studio WMS.net prowadzi w rejestrze trzy typy dokumentów celnych: T1, DSK oraz zgłoszenie z numerem MRN. Typy różnią się formatem numeru, a numer musi być jednoznaczny w obrębie typu i klienta. Moduł Dozór celny jest częścią platformy ST 26 i jest dostępny w środowisku demonstracyjnym; wdrożenie następuje po uzgodnieniu zakresu.
Każda partia pod dozorem jest przypisana do jednego dokumentu celnego. Rejestr modułu Dozór celny w Studio WMS.net zna trzy typy takich dokumentów: T1, DSK oraz zgłoszenie z numerem MRN. Skrót DSK jest w programie nazwą typu dokumentu, więc tak samo używamy go na tej stronie.
Strona porównuje trzy typy pod względem formatu numeru oraz sposobu zakładania dokumentu i zmiany jego statusu.
Rejestr widziany z perspektywy operatora logistycznego opisuje strona o WMS dla operatora 3PL. Ta strona zostaje przy samych typach dokumentów i ich numerach.
Rejestr prowadzi trzy typy dokumentów celnych
Wybór typu stoi w oknie Nowy dokument celny jako pierwsze pole. Od typu zależy format numeru, a pozostałe pola okna są wspólne. W filtrze rejestru typy mają nazwy T1, DSK i MRN (zgłoszenie).
Dokument celny istnieje w rejestrze, zanim towar przyjedzie. Zapis dokumentu nie zmienia stanu magazynu i nie tworzy partii: partie powstają dopiero po zatwierdzeniu dokumentu PZC powiązanego z dokumentem celnym. PZC proponuje do wyboru tylko otwarte dokumenty klienta, czyli takie, które nie są zablokowane ani unijne. Przyjęcie opisuje strona o dokumentach PZC i WZC.
Rejestr pokazuje najwyżej 500 wierszy, a przycisk Eksport do Excela zapisuje bieżący wynik jako plik CSV. Całość modułu przedstawia strona o module Dozór celny, a podział zadań między program i agencję strona o ewidencji składu celnego.
Tabela porównuje trzy typy dokumentów
Tabela zestawia to, co różni typy w rejestrze, i to, co mają wspólne. Skrótu DSK nie rozwijamy, bo wymagałoby to źródła spoza opisu programu.
| Typ | Nazwa w filtrze | Format numeru | Kto zakłada dokument | Co zmienia status dokumentu |
|---|---|---|---|---|
| T1 | T1 | Dokładnie 18 znaków: cyfry i wielkie litery | Biuro przyjęć albo kierownik przyciskiem Dodaj dokument; dokument może też powstać z komunikatu agencji | Komunikat o zgłoszeniu daje status Zgłoszony, komunikat o zwolnieniu towaru status Zwolniony |
| DSK | DSK | W formularzu litery i cyfry oraz ukośnik i kreska, do 40 znaków | Tak samo jak dla T1 | Tak samo jak dla T1 |
| MRN | MRN (zgłoszenie) | Dokładnie 18 znaków: cyfry i wielkie litery | Tak samo jak dla T1 | Tak samo jak dla T1 |
Typy różnią się więc przede wszystkim formatem numeru. Status zmieniają te same dwa rodzaje komunikatów agencji oraz ręczna zmiana statusu partii; w opisie modułu typ dokumentu nie zmienia reguł statusów.

Numer dokumentu przepisuje się z papierów agencji
Okno Nowy dokument celny ma osiem pól, z czego pięć jest wymaganych. Tabela podaje ich reguły.
| Pole | Wymagane | Reguła |
|---|---|---|
| Typ dokumentu | tak | T1, DSK albo MRN (zgłoszenie) |
| Numer (MRN, T1 lub DSK) | tak | T1 i MRN: dokładnie 18 znaków, cyfry i wielkie litery. DSK: w formularzu litery i cyfry oraz ukośnik i kreska, do 40 znaków |
| Data przyjęcia | tak | Domyślnie dzisiejsza; w formularzu od 10 lat wstecz do 30 dni naprzód. Od niej liczy się termin dozoru |
| Klient (właściciel towaru) | tak | Wybór z wyszukiwarki klientów |
| Agencja celna | nie | Wybór z kartoteki agencji |
| Kod procedury | tak | Z listy kodów; domyślnie 71, a pozostałe kody opisuje słownik w ustawieniach modułu |
| Kontener | nie | Maska AAAA9999999 i sprawdzenie ISO 6346 |
| Uwagi | nie | Tekst do 500 znaków |
Numer przepisz z papierów agencji dokładnie. Dla T1 i MRN formularz wymaga osiemnastu znaków, a przy innej długości pokazuje komunikat, że MRN ma 18 znaków. Numer z tej strony, 26PLEXAMPLE000001A, jest wymyślony i ma osiemnaście znaków.
Pole kontenera sprawdza ta sama kontrola cyfry kontrolnej, którą opisuje strona o numerze kontenera ISO 6346. Cztery kody procedur (40, 42, 51 i 53) występują w programie wyłącznie jako słownik, bez opisu prawa celnego.
Ten sam numer może wystąpić u dwóch klientów
Dokument jest jednoznaczny przez zestaw trzech wartości: typ dokumentu, numer i klient. Ten sam numer może więc wystąpić u dwóch różnych klientów, ale nie dwa razy u jednego.
Przy próbie powtórzenia program pokazuje komunikat, że dokument o tym typie i numerze jest już w rejestrze tego klienta. Wtedy wyszukaj istniejący dokument zamiast dodawać nowy.
Wyszukiwanie ma cztery filtry: Typ dokumentu, Status celny, Klient oraz fragment numeru dokumentu albo kontenera. Filtr Status celny zna pięć wartości: Pod dozorem, Zgłoszony, Zwolniony, Unijny i Zablokowany. Fragment numeru kontenera pomaga wtedy, gdy pod bramę przyjechał kontener, a nikt nie pamięta numeru zgłoszenia.
Dokument bez partii można uzupełniać, a dokument z partiami jest zamrożony
W dokumencie, który nie ma jeszcze przyjętych partii, karta Pozycje dokumentu pokazuje formularz pozycji zgłoszenia z pięcioma polami: indeks z kartoteki klienta dokumentu, opis towaru, ilość zgłoszona większa od zera, masa brutto w kilogramach i wartość. Pozycje odpowiadają towarowi zgłoszonemu przez agencję i podpowiadają potem listę przy przyjęciu na PZC.

Gdy dokument ma już przyjęte partie, nie można dodawać ani usuwać jego pozycji, a samego dokumentu nie można usunąć. Zgłoszenie jest wtedy podstawą istniejącego stanu magazynowego i musi pozostać niezmienione. Usunięcie dokumentu bez partii jest kasowaniem logicznym: wiersz znika z list, ale nie jest fizycznie usuwany.
Pod tabelą pozycji program pokazuje sumy trzech ilości (zgłoszonej, przyjętej i wydanej) oraz saldo. Saldo to suma aktualnych stanów partii dokumentu, więc maleje wraz z zatwierdzanymi wydaniami, a nie z samym wpisem w rejestrze.
Status dokumentu wynika ze statusów jego partii
Na liście rejestru status dokumentu nie jest polem do wpisania. Jeśli którakolwiek partia dokumentu jest zablokowana, dokument pokazuje status Zablokowany. W przeciwnym razie pokazuje najniższy status spośród swoich partii, a dokument bez partii pokazuje status zapisany na samym dokumencie. Statusy partii porównuje strona o pięciu statusach celnych partii.
Zapisany status zmieniają komunikaty agencji. Komunikat o zgłoszeniu dla nieznanego dokumentu zakłada nowy dokument ze statusem Zgłoszony i uwagą „Utworzony z importu komunikatu agencji.”, a komunikat o zwolnieniu dla nieznanego dokumentu kończy się błędem. Przebieg opisuje strona o komunikatach agencji celnej. W środowisku demonstracyjnym komunikat można zasymulować albo wczytać z pliku JSON, bo moduł nie ma punktu API przyjmującego komunikaty.
W innym wdrożeniu DSK jest numerem w polu numeru serii
Starsze opisy wdrożeń na tej witrynie używają skrótu DSK inaczej. W studium przypadku magazynu celnego agent celny wpisuje numer DSK w oknie dokumentu typu PM, a program zapisuje go w polu numeru serii. W module Dozór celny DSK jest typem dokumentu w rejestrze, z własnymi pozycjami zgłoszenia i statusem. Wariant z agentem opisuje też strona o agencie celnym w WMS.
Zwykłe dokumenty przyjęcia i wydania, bez statusu celnego, opisuje strona o dokumentach magazynowych.
Scenariusz dnia z przepisaniem numeru z papierów agencji
Przykład jest wymyślony: nazwy i numery w kolejnych krokach nie istnieją.
- Biuro przyjęć otwiera rejestr dokumentów celnych, ustawia filtr Typ dokumentu na MRN (zgłoszenie) i wpisuje fragment numeru. Dokumentu nie ma na liście.
- Pracownik klika Dodaj dokument i wybiera typ MRN, a potem wpisuje numer 26PLEXAMPLE000001A. Wskazuje klienta Klient Testowy oraz kod procedury 71, a w polu kontenera wpisuje CSQU3054383.
- Przy zapisie program sprawdza długość numeru oraz maskę i cyfrę kontrolną kontenera. Sprawdza też, czy taki dokument nie istnieje już u tego klienta.
- Dokument czeka na przyjęcie. Zanim towar przyjedzie, biuro dopisuje pozycje zgłoszenia, a operator przyjmuje towar dokumentem PZC.
Czego moduł nie robi na tym etapie
Rejestr dokumentów jest ewidencją, a nie przedłużeniem systemu celnego.
- Zgłoszenia celne: moduł nie składa zgłoszeń, tylko odbiera ich wynik od agencji celnej.
- Integracja: w środowisku demonstracyjnym nie ma punktu API przyjmującego komunikaty, jest symulacja i plik JSON w tym samym kontrakcie, więc nie obiecujemy integracji z konkretną agencją.
Pytania i odpowiedzi o dokumentach T1, DSK i MRN
Czy ten sam MRN może powtórzyć się u dwóch klientów?
Tak. Numer musi być jednoznaczny tylko w obrębie typu dokumentu i klienta, więc ten sam MRN może wystąpić u dwóch klientów, ale nie dwa razy u jednego. Przy próbie powtórzenia program pokazuje komunikat, że taki dokument jest już w rejestrze tego klienta.
Ile znaków ma numer T1 i MRN?
Dokładnie 18 znaków: cyfry i wielkie litery. Przy innej długości numeru MRN formularz pokazuje komunikat, że MRN ma 18 znaków, i nie zapisuje dokumentu. Dla typu DSK obowiązuje inny format numeru.
Jaki format ma numer DSK?
W formularzu numer DSK może zawierać litery i cyfry oraz ukośnik i kreskę, do 40 znaków. Skrót DSK nie jest w programie rozwijany, a numer przepisuje się z papierów agencji.
Czy dokument z przyjętymi partiami można usunąć?
Nie. Gdy dokument ma przyjęte partie, nie można ani usunąć dokumentu, ani dodać lub usunąć jego pozycji, bo zgłoszenie jest podstawą istniejącego stanu magazynowego. Dokument bez partii można usunąć.
Czy WMS sprawdza numer w systemie celnym?
Nie. Program sprawdza format numeru i to, czy dokument się nie powtarza, a nie jego istnienie w systemie celnym. Wynik zgłoszenia przychodzi komunikatem od agencji celnej.
Słownik pojęć o dokumentach celnych
Terminy używane w rejestrze dokumentów celnych modułu Dozór celny.
- Dokument celny
- Wpis w rejestrze modułu, do którego przypisane są partie pod dozorem. Opisuje go osiem pól, z czego pięć jest wymaganych.
- Dokument T1
- Typ dokumentu celnego w rejestrze. Numer ma dokładnie 18 znaków: cyfry i wielkie litery. Definicja w Softwarepedii.
- Dokument DSK
- Typ dokumentu celnego w rejestrze. W formularzu numer ma litery i cyfry oraz ukośnik i kreskę, do 40 znaków. Skrót nie jest rozwijany.
- MRN
- Typ dokumentu w rejestrze zapisany jako zgłoszenie z numerem MRN. Numer ma dokładnie 18 znaków: cyfry i wielkie litery. Definicja w Softwarepedii.
- Pozycja zgłoszenia
- Wiersz dokumentu celnego z pięcioma danymi: indeksem, opisem towaru, ilością zgłoszoną, masą brutto i wartością. Podpowiada listę przy przyjęciu na PZC.
- Kod procedury
- Wartość ze słownika programu przypisana dokumentowi celnemu, domyślnie 71. Program nie opisuje prawa celnego.
Opisz nam swoje dokumenty celne
Podaj, z jakimi typami dokumentów pracuje Twoja firma i jak przyjeżdżają numery od agencji, a przygotujemy propozycję konfiguracji rejestru.
