# Trzy typy dokumentów celnych w magazynie: T1, DSK i MRN w module Dozór celny

> Trzy typy dokumentów celnych w Studio WMS.net: T1, DSK i MRN. Czym różnią się formatem numeru i tym, kto je zakłada w rejestrze modułu Dozór celny w WMS.

Adres strony: https://magazyn.softwarestudio.com.pl/dokumenty-celne-t1-dsk-mrn-w-magazynie/

---

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](/wms-dla-operatora-logistycznego-z-dozorem-celnym/). 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](/przyjecie-pzc-i-wydanie-wzc-w-skladzie-celnym/).

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](https://system.wms.net.pl/modul-dozoru-celnego-w-wms/), a podział zadań między program i agencję strona o [ewidencji składu celnego](/ewidencja-skladu-celnego-w-systemie-wms/).

## 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](/numer-kontenera-iso-6346-cyfra-kontrolna/). 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](https://system.wms.net.pl/statusy-celne-partii-w-wms/).

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](https://system.wms.net.pl/import-komunikatow-od-agencji-celnej-do-wms/). 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](/wms-dla-skladu-celnego-studium-przypadku/) 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](https://system.wms.net.pl/agent-celny-w-wms-numer-dsk-i-zatwierdzenie/).

Zwykłe dokumenty przyjęcia i wydania, bez statusu celnego, opisuje strona o [dokumentach magazynowych](/dokumenty-magazynowe/).

## 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

## Słownik pojęć o dokumentach celnych

Terminy używane w rejestrze dokumentów celnych modułu Dozór celny.