Agencje i kontenery - kartoteki agencji celnych i kontenerów z kontrolą ISO 6346

Ekran Agencje i kontenery prowadzi dwie kartoteki pomocnicze modułu: agencje celne, od których program odbiera komunikaty, oraz kontenery, w których towar przyjeżdża do składu. Agencję wskazuje się na dokumencie celnym, a numer kontenera jest sprawdzany według normy ISO 6346. Kontener z zatwierdzonego dokumentu PZC trafia do kartoteki sam.

Ekran składa się z dwóch kart pod jednym nagłówkiem. Karta Agencje celne ma przycisk Dodaj agencję i kolumny od Nazwy do liczby Dokumentów. Karta Kontenery ma przycisk Dodaj kontener oraz kolumny Numer, Rozmiar, Armator, Data wjazdu, Zwrot pustego i Partie na stanie. W obu kartach ikona Edytuj otwiera okno z formularzem wybranego wiersza.

Karta Agencje celne

Agencja celna to podmiot, który składa zgłoszenia w imieniu klienta i przesyła ich wynik do magazynu. Program nie składa zgłoszeń celnych, tylko odbiera od agencji komunikaty o zgłoszeniu i zwolnieniu towaru, a kartoteka agencji mówi, skąd komunikat pochodzi i jakim kanałem dociera.

Przycisk Dodaj agencję otwiera okno z pustym formularzem, a ikona Edytuj - z formularzem wypełnionym danymi wiersza.

Okno ma pola Nazwa i NIP oznaczone gwiazdką jako wymagane. Lista Sposób wymiany również jest wymagana i przyjmuje wartości API, FTPS oraz Ręcznie. Pole E-mail dla komunikatów jest opcjonalne. Pole Identyfikator klucza API przyjmuje do 64 znaków i służy tylko do rozpoznania klucza, a nie do jego przechowywania.

Agencja jest rozpoznawana po NIP, więc dwie agencje z tym samym numerem nie istnieją. Próba dodania drugiej agencji z już użytym NIP kończy się komunikatem, że agencja z tym NIP już jest w kartotece. Ta sama zasada działa przy imporcie komunikatu: opcjonalny NIP agencji z treści komunikatu wskazuje agencję w kartotece.

Agencji nie można usunąć. Na karcie nie ma przycisku usuwania. Agencja, którą wskazano na dokumencie celnym w rejestrze, zostaje w kartotece, a zmienia się tylko jej dane. Kolumna Dokumenty pokazuje, ile dokumentów korzysta z danej agencji.

Sposób wymiany opisuje, jak agencja dostarcza komunikaty: przez API, przez FTPS albo ręcznie. W wersji demonstracyjnej nie ma punktu API przyjmującego komunikaty. Program przyjmuje je przez symulację i wczytanie pliku JSON w tej samej strukturze, co opisuje strona Kolejka importu od agencji.

Karta Kontenery

Karta Kontenery zawiera kontenery znane programowi: wpisane ręcznie albo zapisane z zatwierdzonego przyjęcia PZC. Kolumna Partie na stanie pokazuje, ile partii z danego kontenera nadal ma stan w magazynie.

Pole Numer (ISO 6346) jest wymagane i ma maskę wpisu AAAA9999999, czyli cztery litery i siedem cyfr. Rozmiar to wybór między 20' a 40', a domyślnie ustawione jest 40'. Pola Armator, Data wjazdu i Data zwrotu pustego są opcjonalne. Data zwrotu nie może być wcześniejsza niż data wjazdu.

• Rozmiar - wartość 20' albo 40', domyślnie 40'. Inny rozmiar program odrzuca komunikatem, że rozmiar ma wynosić 20 albo 40.
• Daty - zwrot pustego kontenera nie może być wcześniejszy niż wjazd; ta sama data jest dopuszczalna.

Numer kontenera jest unikalny. Próba dodania drugiego kontenera o tym samym numerze kończy się komunikatem, że kontener już jest w kartotece. Aby zmienić dane istniejącego, użyj ikony Edytuj w jego wierszu.

Numer ISO 6346 i cyfra kontrolna

Numer kontenera składa się z jedenastu znaków. Pierwsze trzy litery to kod właściciela, czwarta to kategoria sprzętu i przyjmuje wartość U, J albo Z. Dalej idzie sześć cyfr numeru seryjnego, a jedenasty znak to cyfra kontrolna. Maska AAAA9999999 odpowiada temu podziałowi, a program odrzuca numer, w którym cyfra kontrolna nie zgadza się z pozostałymi znakami.

Cyfra kontrolna powstaje w czterech krokach. Najpierw każdemu z dziesięciu pierwszych znaków przypisuje się wartość. Cyfra ma wartość równą sobie, a litery liczy się od A=10 z pominięciem wielokrotności 11, więc B=12, K=21, L=23, U=32 i V=34. Potem każdą wartość mnoży się przez 2 podniesione do potęgi równej numerowi pozycji minus 1. Iloczyny się sumuje i dzieli przez 11, a z reszty bierze się ostatnią cyfrę, czyli resztę mod 10.

Przykład obliczenia. Dla pierwszych dziesięciu znaków DEMU100000 wartości to 14, 15, 24, 32, 1, 0, 0, 0, 0, 0. Wagi pięciu pierwszych pozycji to 1, 2, 4, 8 oraz 16, więc iloczyny wynoszą 14, 30, 96, 256 oraz 16, a pozostałe pozycje dają zero. Suma wynosi 412, reszta z dzielenia przez 11 to 5, więc cyfrą kontrolną jest 5, a pełny numer to DEMU1000005. Gdy reszta z dzielenia przez 11 wynosi 10, cyfrą kontrolną jest 0.

Ta sama kontrola działa w trzech miejscach programu: w kartotece kontenerów, w oknie Dodaj dokument celny w rejestrze oraz w polu Kontener (ISO 6346) dokumentu PZC. W dokumencie PZC pole jest sprawdzane po opuszczeniu i pokazuje komunikat Numer zgodny z ISO 6346 albo błąd. Spójność jednej reguły sprawia, że numer przyjęty w jednym miejscu nie zostanie odrzucony w innym.

Automatyczny zapis kontenera z PZC

Kontener wpisany na dokumencie PZC trafia do kartoteki w chwili zatwierdzenia przyjęcia, bez dodatkowej pracy operatora. Jako data wjazdu zapisywana jest data przyjęcia z dokumentu. Zatwierdzenie jest jedną całością: zapis kontenera, partii ze statusem celnym i historii statusu przechodzi w jednej transakcji, więc kontener nie pojawi się w kartotece, jeśli przyjęcie zostanie odrzucone.

Operator nie musi więc dodawać kontenera ręcznie przed przyjęciem. Przycisk Dodaj kontener przydaje się wtedy, gdy kontener trzeba opisać wcześniej, np. dopisać armatora, albo uzupełnić datę zwrotu pustego po rozładunku. Przyjęcie towaru do składu opisuje strona Przyjęcie PZC.

Typowe sytuacje przy pracy z kartotekami

Pierwsza sytuacja to nowa agencja. Zanim klient zacznie korzystać z agencji, której nie ma w kartotece, kierownik dodaje ją przyciskiem Dodaj agencję: podaje nazwę, 10 cyfr NIP i sposób wymiany. Od tej chwili agencję można wskazać w oknie Dodaj dokument celny. Jeśli NIP był już wpisany, program nie utworzy duplikatu, tylko pokaże komunikat, i wtedy trzeba odnaleźć istniejący wiersz.

Druga sytuacja to numer kontenera przepisany z papierowych dokumentów. Pomyłka w jednym znaku, np. zamiana litery O na cyfrę 0, zwykle psuje cyfrę kontrolną, więc program odrzuci numer komunikatem, że nie spełnia ISO 6346. Maska AAAA9999999 pomaga: cztery pierwsze znaki muszą być literami, a siedem kolejnych cyframi. Zanim wpiszesz numer ponownie, porównaj go z dokumentem przewozowym i przelicz cyfrę kontrolną ręcznie.

Co opiera się na kartotekach

Dokument celny w rejestrze ma pole Agencja celna wybierane z kartoteki agencji i pole Kontener sprawdzane według ISO 6346. Dlatego dane tych kartotek trzeba utrzymywać na bieżąco. Błędny NIP agencji utrudni wskazanie jej przy imporcie komunikatu. Błędny numer kontenera zatrzyma zatwierdzenie dokumentu PZC, bo kontrola ISO 6346 należy do kontroli przed zatwierdzeniem.

Ekran jest dostępny po włączeniu modułu. Przy wyłączonym module wszystkie ekrany poza Ustawieniami pokazują komunikat Moduł dozoru celnego jest wyłączony, o czym piszemy na stronie Ustawienia modułu.