Model danych i znaczniki zapisów modułu Dozór celny - dla wdrożeniowców

Moduł Dozór celny przechowuje dane w dziewięciu tabelach z przedrostkiem x_cel_ i jednym widoku. Strona opisuje kolumny, klucze, indeksy unikalne oraz wartości kodowe, które wdrożeniowiec spotka w zapytaniach diagnostycznych. Ruchy magazynowe nie mają własnych tabel: PZC i WZC zapisują zwykłe wiersze dokumentów magazynowych. Warstwy modułu opisuje strona architektura i włączenie.

Przegląd tabel i relacji

Centralną tabelą jest x_cel_partia: jeden wiersz to jedna partia towaru pod ewidencją celną razem z jej statusem. Partia należy do dokumentu celnego (x_cel_dokument), a ten ma pozycje zgłoszenia (x_cel_dokument_poz). Każda zmiana statusu zostawia ślad w x_cel_status_hist, a komunikaty od agencji trafiają do x_cel_import. Tabela x_cel_pzc wiąże dokument magazynowy PZC z dokumentem celnym i kontenerem. Trzy kartoteki pomocnicze to agencje (x_cel_agencja), kontenery (x_cel_kontener) i magazyny (x_cel_magazyn).

Wszystkie tabele leżą w schemacie dbo, a opisy tabel są zapisane jako właściwość MS_Description. Ich odczyt umożliwia sprawdzenie przeznaczenia tabeli bez zaglądania do dokumentacji.

SELECT o.name AS tabela, CAST(ep.value AS nvarchar(400)) AS opis
FROM sys.objects o
LEFT JOIN sys.extended_properties ep
       ON ep.major_id = o.object_id AND ep.minor_id = 0 AND ep.name = 'MS_Description'
WHERE o.type = 'U' AND o.name LIKE 'x[_]cel[_]%'
ORDER BY o.name;

Tabela x_cel_agencja

Kartoteka agencji celnych, czyli przedstawicieli, którzy składają zgłoszenia za klienta i przysyłają komunikaty. Agencji nie można usunąć na ekranie.

Tabela x_cel_kontener

Kartoteka kontenerów. Numer jest unikalny wśród wierszy aktywnych, więc ten sam kontener nie wystąpi w kartotece dwa razy.

Tabela x_cel_magazyn

Ustawienia magazynu, kluczem jest kod magazynu. Magazyn bez wiersza w tej tabeli jest traktowany jak krajowy z limitem 90 dni.

Tabela x_cel_dokument

Dokument celny jednego z trzech typów (T1, DSK, MRN). Unikalny indeks UQ_x_cel_dokument_TYP_NUMER obejmuje typ i numer dokumentu oraz klienta, tylko dla wierszy aktywnych, więc dokument o tym samym numerze może istnieć u dwóch różnych klientów.

Tabela x_cel_dokument_poz

Pozycje zgłoszenia dokumentu celnego. To na nich opiera się saldo dokumentu i kontrola rozbieżności w raportach.

Tabela x_cel_partia

Partia pod ewidencją celną. Wiersz powstaje przy zatwierdzeniu PZC, a jego pola statusu (STATUS, STATUS_PRZED) oraz powodu blokady zmieniają procedury modułu.

Tabela x_cel_status_hist

Historia zmian statusu partii. Tabela nie ma znacznika ACH, bo wpisy nie są kasowane.

Tabela x_cel_import

Kolejka komunikatów od agencji. Unikalny indeks UQ_x_cel_import_HASH na kolumnie HASH_TRESCI nie dopuszcza dwóch komunikatów o identycznej treści. Szczegóły przetwarzania opisuje strona komunikaty agencji.

Tabela x_cel_pzc

Powiązanie dokumentu magazynowego PZC z dokumentem celnym i kontenerem. Wiersz powstaje już w buforze, a przy zatwierdzeniu procedura zapisu PZC aktualizuje go o dokument celny i kontener podane w zapytaniu.

Widok wms_cel_partie

Widok łączy partie aktywne z bieżącym stanem policzonym z ruchów magazynowych. Zwraca wszystkie kolumny partii oraz trzy kolumny wyliczane (STAN, WYDANO, DNI_DO_KONCA). Stan to suma ilości zatwierdzonych ruchów (ACH równe 1, ROLASYS równe WMS) po kluczu partii (magazyn, klient, indeks, numer partii). Przesunięcia ZL dają zero netto, więc nie zmieniają stanu. Pole WYDANO to ILOSC_PRZYJETA pomniejszona o STAN, ale nie mniej niż zero. Pole DNI_DO_KONCA to liczba dni od dziś do TERMIN_DOZORU i bywa ujemne po terminie.

DECLARE @MAG varchar(20) = 'KOD_MAGAZYNU';
SELECT v.ID, v.NRSERII, v.STATUS, dbo.sf_cel_status(v.STATUS) AS STATUS_OPIS,
       dbo.sf_cel_dok(d.TYP, d.NUMER) AS DOKUMENT, v.NR_KONTENERA,
       v.TERMIN_DOZORU, v.DNI_DO_KONCA, v.ILOSC_PRZYJETA, v.STAN, v.WYDANO
FROM dbo.wms_cel_partie v
JOIN dbo.x_cel_dokument d ON d.ID = v.ID_DOK
WHERE v.MAGAZYN = @MAG
ORDER BY v.STATUS, v.TERMIN_DOZORU, v.NRSERII;

Znaczniki i kody

Poniższa tabela zbiera wartości kodowe, które występują w tabelach modułu, a także w ruchach magazynowych i skorowidzach.

Klucz partii i indeksy unikalne

Partię identyfikuje kombinacja czterech pól: magazyn, klient (NRIDODN), indeks asortymentu (NRIDASN) i numer partii (NRSERII, ten sam co w ruchach magazynowych). Unikalny indeks UQ_x_cel_partia_KLUCZ jest filtrowany po ACH równym 1, więc tej samej partii nie da się objąć ewidencją celną dwa razy. Próba przyjęcia na drugim PZC kończy się błędem 50205. Ten sam klucz łączy partię z ruchami magazynowymi, więc wiersz partii bez pasujących ruchów ma STAN równy 0.

Pozostałe indeksy mają charakter pomocniczy. Indeks IX_x_cel_partia_TERMIN obejmuje TERMIN_DOZORU i jest filtrowany po statusie niższym niż 3 albo równym 5 (pod dozorem, zgłoszony, zablokowany), co przyspiesza kokpit oraz raport terminów. Indeks IX_x_cel_partia_DOK i IX_x_cel_dokument_poz_DOK przyspieszają odczyt partii i pozycji dokumentu. Indeks IX_x_cel_import_OCZEKUJE wskazuje komunikaty ze statusem 0.

SELECT i.name, i.is_unique, i.filter_definition
FROM sys.indexes i
WHERE i.object_id IN (OBJECT_ID('dbo.x_cel_partia'), OBJECT_ID('dbo.x_cel_dokument'),
                      OBJECT_ID('dbo.x_cel_kontener'), OBJECT_ID('dbo.x_cel_import'))
  AND i.name LIKE '%x[_]cel%'
ORDER BY i.name;

Numeracja dokumentów i numer palety

Numer dokumentu PZC albo WZC powstaje dopiero przy zatwierdzeniu, z licznika miesięcznego. Procedura dostaje typ rejestru wraz z typem dokumentu oraz maskę #RRRR-#MM-#XXXXX-#TYP z datą dokumentu, a wynik ma postać RRRR-MM-NNNNN-TYP, np. 2026-10-00001-PZC. Licznik liczy osobno dla każdego miesiąca i typu. Dokument w buforze nie ma jeszcze numeru z tego licznika.

Numer palety pochodzi z osobnego licznika ciągłego (parametry PR i PAL, maska #XXXXXXXXXXXXXXXXXX). Przycisk Nowy numer nośnika na ekranie PZC pobiera kolejną wartość z tego licznika.

Kasowanie logiczne

Moduł nie usuwa fizycznie wierszy kartotek i dokumentów. Usunięcie dokumentu celnego lub jego pozycji ustawia ACH równe X; zapytania i indeksy unikalne pomijają takie wiersze. Dzięki filtrowi w indeksie można ponownie dodać dokument o tym samym numerze po usunięciu poprzedniego. Usunięcie jest możliwe tylko wtedy, gdy dokument nie ma przyjętych partii (kody 50021 i 50022). Wpisy historii statusu i kolejki importu nie mają kasowania.

Funkcje

Cztery funkcje skalarne obsługują wyświetlanie i walidację.

• sf_cel_status - zamienia kod statusu 1-5 na nazwę: Pod dozorem, Zgłoszony, Zwolniony, Unijny, Zablokowany.
• sf_cel_dok - składa numer do wyświetlenia z typu i numeru, ale nie dubluje typu, gdy numer już się nim zaczyna (np. DSK/DEMO/0001/26).
• sf_cel_iso6346_cyfra - liczy cyfrę kontrolną ISO 6346 z pierwszych dziesięciu znaków; zwraca -1, gdy format jest zły.
• sf_cel_iso6346_ok - sprawdza cały numer kontenera po przycięciu spacji oraz zamianie na wielkie litery; zwraca 1 dla zgodnego numeru.

Cyfra kontrolna ISO 6346 powstaje tak: litery dostają wartości od A równego 10 z pominięciem wielokrotności 11, wartość każdego z dziesięciu znaków mnoży się przez 2 do potęgi równej pozycji minus jeden, sumę dzieli się z resztą przez 11, a resztę przez 10. Ekran kartoteki kontenerów opisuje strona agencje i kontenery.

Zapytania diagnostyczne

Zapytania poniżej tylko czytają dane. Pierwsze pokazuje historię jednej partii w kolejności zdarzeń, drugie wskazuje wiersze ruchów magazynowych dokumentów PZC i WZC.

DECLARE @MAG varchar(20) = 'KOD_MAGAZYNU', @PARTIA varchar(20) = 'NUMER_PARTII';
SELECT h.KIEDY, h.STATUS_PRZED, h.STATUS_PO, h.ZRODLO, h.UZASADNIENIE, h.LOGIN, h.ID_IMPORT
FROM dbo.x_cel_status_hist h
JOIN dbo.x_cel_partia p ON p.ID = h.ID_PARTII
WHERE p.MAGAZYN = @MAG AND p.NRSERII = @PARTIA
ORDER BY h.KIEDY, h.ID;

SELECT TOP (50) m.ID_DPMAG, m.REFNO, m.PRX, m.TYPDOK, m.ACH, m.NRSERII, m.ILOSC
FROM dbo.dpmag m
WHERE m.TYPDOK IN ('PZC', 'WZC')
ORDER BY m.ID_DPMAG DESC;