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.

TypNazwa w filtrzeFormat numeruKto zakłada dokumentCo zmienia status dokumentu
T1T1Dokładnie 18 znaków: cyfry i wielkie literyBiuro przyjęć albo kierownik przyciskiem Dodaj dokument; dokument może też powstać z komunikatu agencjiKomunikat o zgłoszeniu daje status Zgłoszony, komunikat o zwolnieniu towaru status Zwolniony
DSKDSKW formularzu litery i cyfry oraz ukośnik i kreska, do 40 znakówTak samo jak dla T1Tak samo jak dla T1
MRNMRN (zgłoszenie)Dokładnie 18 znaków: cyfry i wielkie literyTak samo jak dla T1Tak 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.

Studio WMS.net: rejestr dokumentów celnych z filtrami i listą ze statusem celnym oraz terminem dozoru
Zrzut rejestru w środowisku demonstracyjnym. Nad listą stoją filtry i przyciski, a lista ma dziesięć kolumn, od Typ po Termin dozoru. Kliknij obraz, aby go powiększyć.

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.

PoleWymaganeReguła
Typ dokumentutakT1, DSK albo MRN (zgłoszenie)
Numer (MRN, T1 lub DSK)takT1 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ęciatakDomyślnie dzisiejsza; w formularzu od 10 lat wstecz do 30 dni naprzód. Od niej liczy się termin dozoru
Klient (właściciel towaru)takWybór z wyszukiwarki klientów
Agencja celnanieWybór z kartoteki agencji
Kod procedurytakZ listy kodów; domyślnie 71, a pozostałe kody opisuje słownik w ustawieniach modułu
KontenernieMaska AAAA9999999 i sprawdzenie ISO 6346
UwaginieTekst 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.

Studio WMS.net: karta Pozycje dokumentu bez partii z formularzem dodawania pozycji zgłoszenia
Zrzut dokumentu bez przyjętych partii w środowisku demonstracyjnym. Pod tabelą pozycji stoi formularz Dodaj pozycję zgłoszenia, a przy dokumencie leży przycisk Usuń dokument. Kliknij obraz, aby go powiększyć.

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.

Schemat: pięć statusów celnych partii i przejścia między nimi, od Pod dozorem do Unijny oraz blokada
Schemat pokazuje statusy partii, z których wynika status dokumentu: od Pod dozorem przez Zgłoszony do Zwolniony i Unijny oraz boczną ścieżkę blokady ze zdjęciem blokady. Kliknij obraz, aby go powiększyć.

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ą.

  1. 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.
  2. 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.
  3. Przy zapisie program sprawdza długość numeru oraz maskę i cyfrę kontrolną kontenera. Sprawdza też, czy taki dokument nie istnieje już u tego klienta.
  4. 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.