Wdrożenie i testy modułu Dozór celny - lista kontrolna wdrożeniowca

Strona zbiera czynności wdrożeniowca po wgraniu skryptów modułu Dozór celny: listę kontrolną wgrania, scenariusze testowe, zapytania diagnostyczne, opis danych demonstracyjnych i granice zakresu. Skrypty modułu zweryfikowano wykonawczo na kopii bazy demonstracyjnej. Na każdym innym środowisku, także na żywym demo, wymagają testów po wgraniu. Opis architektury znajdziesz na stronie architektura i włączenie.

Lista kontrolna wgrania

Poniższe punkty wykonuje się w podanej kolejności na bazie, na którą wgrywasz moduł. Przed pierwszym wgraniem na środowisko inne niż kopia bazy demonstracyjnej wykonaj kopię zapasową bazy.

1. Sprawdź wersję serwera SQL (2016 SP1 albo nowsza) i poziom zgodności bazy (130 albo wyższy); zapytania są na stronie architektury.
2. Wgraj skrypt ss-2026-10-13-1400-wms-dozor-celny-baza. Na bazie nie-demo parametr MODUL_CELNY zostaje równy 0, a menu się nie pojawia.
3. Na bazie demonstracyjnej wgraj skrypt ss-2026-10-13-1410-wms-dozor-celny-demo, a po nim ss-2026-10-17-1000-wms-dozor-celny-ikona-js.
4. Zresetuj pamięć podręczną adresem /DefaultAdministrator.aspx?isdeploy=reset i odśwież przeglądarkę klawiszami Ctrl+F5.
5. Wyloguj się i zaloguj ponownie rolą Magazyn: sekcja DOZÓR CELNY pojawia się w menu dopiero po ponownym zalogowaniu.
6. Sprawdź, czy sekcja ma osiem pozycji, a w sekcji NOWY są Przyjęcie PZC i Wydanie WZC.
7. Uruchom każdy ze skryptów drugi raz: oczekiwane są zero zmian danych, a komunikaty informacyjne o pominięciu.
8. Wykonaj scenariusze z kolejnych sekcji i zapisz wynik każdego kroku.

Przy drugim uruchomieniu skrypt ikony wypisuje liczbę zmienionych wierszy równą 0 i informację, że poprawny adres ma wszystkie 3 transakcje. Skrypt demonstracyjny wypisuje, że dane demo już są, a menu dodaje 0 wierszy. Jedno zachowanie nie jest neutralne: skrypt demonstracyjny na końcu zawsze ustawia MODUL_CELNY na 1 i aktywuje wiersze menu, więc jego ponowne uruchomienie włącza ponownie moduł wyłączony wcześniej przez administratora.

Weryfikacja wykonawcza. Skrypty modułu uruchomiono i sprawdzono na lokalnej kopii bazy demonstracyjnej. Nie sprawdzano ich na żywym demo platformy ST 26 ani na bazach klientów. Po wgraniu na środowisko docelowe wykonaj komplet scenariuszy z tej strony, zanim udostępnisz moduł użytkownikom.

Scenariusz: kokpit

Scenariusz sprawdza liczniki i przejścia do ekranów z gotowym filtrem. Wejście w Kokpit blokuje partie po terminie dozoru, więc liczniki mogą zmienić się zaraz po otwarciu ekranu.

Scenariusz: rejestr, symulacja zgłoszenia i zwolnienia, duplikat pliku

Scenariusz zmienia dane, dlatego wykonuj go na dokumencie testowym. Dodaj dokument typu MRN z numerem zawierającym fragment DEMO, np. 26PLDEMO000000777X, bo takie dokumenty obejmuje opisane niżej czyszczenie. Dokument bez partii można później usunąć przyciskiem Usuń dokument. Kolejka importu zachowa wiersze komunikatów także po usunięciu dokumentu.

Scenariusz: PZC

Dokument demonstracyjny do przyjęcia to zgłoszony dokument T1 z numerem kończącym się na 901H, bez partii, z trzema pozycjami (120, 80, 60 sztuk) i kontenerem z poprawną cyfrą kontrolną. Ponieważ dokument ma już status Zgłoszony, partie przyjęte na PZC dostają od razu status Zgłoszony, a nie Pod dozorem. Termin dozoru to data przyjęcia powiększona o limit dni magazynu.

Scenariusz: WZC, odmowa i zgoda

W danych demonstracyjnych dokument numer 5 w magazynie jest celowo niezwolniony: ma partię z blokadą ręczną i partię po terminie dozoru. Służy do pokazania odmowy. Zatwierdzenie WZC zmienia stan magazynowy, a moduł nie ma polecenia jego cofnięcia, więc wykonuj krok zgody na bazie demonstracyjnej albo kopii. Bufor WZC nie sprawdza statusów, dlatego odmowa pojawia się dopiero przy zatwierdzeniu.

Scenariusz: kontener z błędną cyfrą kontrolną

Kontener DEMU2000015 ma poprawną cyfrę kontrolną, a DEMU2000016 ma zmienioną ostatnią cyfrę. Numer nie jest prawdziwym kontenerem, ale poprawnie przechodzi algorytm. Błędną wersję odrzucają trzy miejsca modułu.

SELECT dbo.sf_cel_iso6346_ok('DEMU2000015') AS poprawny,
       dbo.sf_cel_iso6346_ok('DEMU2000016') AS bledny,
       dbo.sf_cel_iso6346_cyfra('DEMU200001') AS cyfra_kontrolna;

Scenariusz: blokada i zdjęcie blokady

Ten scenariusz da się w pełni wycofać: blokada ręczna zapamiętuje status sprzed blokady, a zdjęcie blokady do niego wraca. Nie stosuj go do partii ze statusem Zwolniony ani Unijny, bo takich partii nie można zablokować.

Zapytania diagnostyczne

Zapytania tylko czytają dane. Pierwsze odtwarza liczniki kokpitu bez blokowania partii po terminie, które robi sam kokpit, więc jego wyniki mogą różnić się od ekranu o partie, które kokpit zablokuje przy najbliższym otwarciu.

DECLARE @MAG varchar(20) = 'KOD_MAGAZYNU';
DECLARE @prog int = ISNULL(TRY_CONVERT(int, (SELECT TOP (1) WARTOSC FROM dbo._parametry WHERE KOD = 'CEL_PROG_DNI')), 14);
SELECT
  (SELECT COUNT(*) FROM dbo.x_cel_partia WHERE ACH = '1' AND MAGAZYN = @MAG AND STATUS = 5) AS ZABLOKOWANE,
  (SELECT COUNT(*) FROM dbo.x_cel_partia WHERE ACH = '1' AND MAGAZYN = @MAG AND STATUS IN (1, 2)) AS BEZ_ZWOLNIENIA,
  (SELECT COUNT(*) FROM dbo.x_cel_partia WHERE ACH = '1' AND MAGAZYN = @MAG AND STATUS IN (1, 2)
     AND TERMIN_DOZORU <= DATEADD(day, @prog, CAST(GETDATE() AS date))) AS TERMIN_PROG,
  (SELECT COUNT(*) FROM dbo.x_cel_import WHERE STATUS_PRZETW = 2 AND (MAGAZYN = @MAG OR MAGAZYN IS NULL)) AS IMPORT_BLEDY,
  (SELECT COUNT(*) FROM dbo.x_cel_import WHERE STATUS_PRZETW = 0 AND (MAGAZYN = @MAG OR MAGAZYN IS NULL)) AS IMPORT_OCZEKUJE;

Drugie zapytanie wymienia partie po terminie dozoru. Partie ze statusem 1 lub 2 zostaną zablokowane automatycznie przy najbliższym wejściu w Kokpit, Zwolnienia i blokady albo Terminy dozoru, bo moduł nie ma zadania cyklicznego.

SELECT v.NRSERII, v.STATUS, dbo.sf_cel_status(v.STATUS) AS STATUS_OPIS,
       v.TERMIN_DOZORU, v.DNI_DO_KONCA, v.STAN
FROM dbo.wms_cel_partie v
WHERE v.MAGAZYN = 'KOD_MAGAZYNU' AND v.STATUS IN (1, 2, 5) AND v.TERMIN_DOZORU < CAST(GETDATE() AS date)
ORDER BY v.TERMIN_DOZORU;

Trzecie zapytanie pokazuje ostatnie wpisy historii statusu ze wszystkich partii magazynu.

SELECT TOP (20) h.KIEDY, p.NRSERII, h.STATUS_PRZED, h.STATUS_PO, h.ZRODLO, h.UZASADNIENIE, h.LOGIN
FROM dbo.x_cel_status_hist h
JOIN dbo.x_cel_partia p ON p.ID = h.ID_PARTII
WHERE p.MAGAZYN = 'KOD_MAGAZYNU'
ORDER BY h.KIEDY DESC, h.ID DESC;

Dane demonstracyjne

Skrypt demonstracyjny tworzy dwie agencje celne (jedną z wymianą API, drugą z FTPS) i ustawienia magazynu: skład celny z limitem 90 dni. Dla każdego magazynu WMS, który ma co najmniej 6 partii na stanie, wstawia 12 dokumentów celnych i 24 partie w różnych statusach. Dokumenty mają numery z fragmentem DEMO i kontenery o prefiksie DEMU z poprawną cyfrą kontrolną. Partie nie są sztuczne: skrypt używa istniejących partii trzech kontrahentów z największą liczbą partii w magazynie i nie wstawia żadnych ruchów magazynowych.

Profil dokumentów jest powtarzalny. Terminy liczone są od dnia wgrania skryptu, więc daty na ekranach zależą od momentu wgrania.

Poza tym skrypt dodaje dla każdego takiego magazynu dokument do przyjęcia: zgłoszony T1 bez partii, z trzema pozycjami (120, 80, 60 sztuk), nowym kontenerem i przetworzonym komunikatem ZGLOSZENIE w kolejce. W kolejce jest też po cztery komunikaty na magazyn, po jednym w każdym statusie (Przetworzony, Częściowy, Oczekuje, Błąd). Nazwy klientów w danych demo pochodzą z bazy demonstracyjnej i nie są tu powtarzane.

Dane do przygotowania pliku komunikatu (identyfikator klienta, indeks, ilość) pobierzesz z dokumentu demonstracyjnego, a identyfikatory pozycji demonstracyjnych rozpoznasz po numerze z fragmentem DEMO.

SELECT d.ID, d.TYP, d.NUMER, d.NRIDODN AS klientId, z.LP, a.INDEKS, z.ILOSC, z.JM
FROM dbo.x_cel_dokument d
JOIN dbo.x_cel_dokument_poz z ON z.ID_DOK = d.ID AND z.ACH = '1'
JOIN dbo.knaso a ON a.NRIDASN = z.NRIDASN
WHERE d.ACH = '1' AND d.NUMER LIKE '%DEMO%'
ORDER BY d.ID, z.LP;

Znane ograniczenia i poza zakresem

Przed testami ustal z kierownikiem projektu, czego moduł nie robi, żeby nie raportować braków jako błędów.

• Blokada tylko dla WZC - dokumenty WZB i RW z partii celnej nie są blokowane; wyzwalacz na tabeli ruchów odrzucono jako zbyt inwazyjny.
• Brak terminala Android - dokumenty PZC i WZC są dostępne tylko w przeglądarce.
• Brak uprawnień CEL_* - dostęp wynika z menu roli, a etykieta Zdejmij blokadę (CEL_BLK) w oknie odmowy jest tylko oznaczeniem.
• Brak punktu API - komunikaty powstają w demo przez symulację i import pliku. Nie ma też rozliczania usług celnych, zrzutu stanów dziennych ani raportów z serwera raportów.

Moduł jest ewidencją magazynową: nie składa zgłoszeń celnych, nie jest certyfikowanym modułem celnym i nie zastępuje systemu celnego. Zgodności z przepisami nie weryfikowano. Blokada po terminie dozoru działa leniwie, przy wejściu w trzy ekrany modułu, a nie według harmonogramu. W polach tekstowych (uzasadnienia, uwagi) nie używaj samodzielnych słów and oraz or: serwer odrzuca takie zapisy.

Cofnięcie i usuwanie danych demonstracyjnych

Pierwszy poziom cofnięcia to parametr MODUL_CELNY równy 0 na ekranie Ustawienia modułu: menu znika po ponownym zalogowaniu, dokumenty PZC oraz WZC przestają być dostępne, a dane zostają.

Drugi poziom to usunięcie danych demonstracyjnych: wierszy tabel x_cel_* z numerem zawierającym fragment DEMO. Skrypty modułu nie zawierają gotowego polecenia usuwającego, więc wykonaj je ręcznie po kopii zapasowej, najpierw sprawdzając zakres zapytaniem poniżej. Wiersze partii, pozycji i powiązań PZC wskazują dokument kolumną ID_DOK, wiersze historii wskazują partię kolumną ID_PARTII, a komunikaty w kolejce da się znaleźć po numerze dokumentu. Kontenery demonstracyjne rozpoznasz po prefiksie DEMU, a agencje po oznaczeniu demo w nazwie. Ruchów magazynowych skrypt demonstracyjny nie wstawia, więc ich nie usuwa się razem z danymi modułu; ruchy dokumentów PZC i WZC z testów zostają w ewidencji magazynowej.

SELECT 'dokumenty' AS obiekt, COUNT(*) AS liczba FROM dbo.x_cel_dokument WHERE NUMER LIKE '%DEMO%'
UNION ALL
SELECT 'partie', COUNT(*) FROM dbo.x_cel_partia p JOIN dbo.x_cel_dokument d ON d.ID = p.ID_DOK WHERE d.NUMER LIKE '%DEMO%'
UNION ALL
SELECT 'komunikaty', COUNT(*) FROM dbo.x_cel_import WHERE NUMER LIKE '%DEMO%'
UNION ALL
SELECT 'kontenery', COUNT(*) FROM dbo.x_cel_kontener WHERE NUMER LIKE 'DEMU%';