Główna / Dedykowane / XLS-MagCS – opis funkcjonalny
Jak zainstalować moduł dedykowany XLS_MagCS? | Jak sprawdzić, czy moduł jest poprawnie zainstalowany? | Konfiguracja | Działanie modułu XLS_MagCS | Mapowanie nazw kolumn
Instalacja modułu dedykowanego odbywa się poprzez pobranie aktualizacji z serwera firmy Huzar-Software (analogicznie jak pobierane są poprawki programu MagCS).
Moduł dedykowany jest wczytywany w trakcie uruchamiania programu MagCS.
Uruchamiamy program MagCS. Wybierając Opcje → Konfiguracja modułów zostanie wyświetlone okno Opcje modułów dodatkowych. Na liście Dodatkowe moduły powinien być widoczny moduł o nazwie XLS_MagCS. W obszarze Opis wybranego modułu, powinien być wyświetlony tekst jak na rysunku poniżej (wersja może być inna).
Na rysunku powyżej znajduje się przycisk Konfiguruj, który służy do przygotowania modułu dedykowanego do współpracy z programem. Jego wybór spowoduje wyświetlenie się okna Konfiguracja.
Pole wypełnione – pole używane przez plugin do weryfikacji czy dany wiersz ma być importowany czy nie; jeśli pole jest wypełnione to wiersz jest importowany;
Szablon przesyłki – szablon umożliwia inicjację danych przesyłki wartościami, które dla każdej importowanej przesyłki są takie same;
Bez dostaw – zaznaczenie tej opcji skutkuje ograniczeniem funkcjonalności modułu jedynie do importu przesyłek; nie są importowane dane związane z dostawą;
Użyj nowych ustawień do mapowania kolumn – zaznaczenie tego checkbox’a powoduje import plików z możliwością wczytywania dodatkowych kolumn jako następne dokumenty w przesyłce.
Moduł XLS_MagCS umożliwia import przesyłek z plików w formacie XLS do programu MagCS.
Funkcjonalność pluginu dostępna jest w programie MagCS w oknie głównym poprzez menu: Operacje → Pobierz awizacje, lub w menu kontekstowym na liście dostaw funkcja: Import z pliku (pliki: XLS).
Moduł odczytuje nagłówki kolumn z pierwszego wiersza arkusza. Jeśli pierwszy wiersz nie zawiera prawidłowych nagłówków, odczytywane są także wiersze 2. i 3.
Przed importem program odpytuje użytkownika o skrót zleceniodawcy, który będzie wprowadzony do wszystkich zaimportowanych przesyłek (można go nie podawać).
Wszystkie wymienione poniżej pola są nieobowiązkowe a ich kolejność jest dowolna.
Rozpoznawane są następujące nazwy kolumn:
Nazwa kolumny | Typ danych | Opis |
Data dostawy | Data (program rozpoznaje także notacje tekstowe) | W połączeniu z numerem dostawy stanowi element grupujący przesyłki; numery i daty dostaw nie mogą się powtarzać w bazie danych (choć mogą się powtarzać w pliku). Więcej informacji poniżej. W przypadku braku daty, program przyjmuje jutrzejszą. |
Numer przesyłki | Tekst | Unikatowy numer prezentowany w programie. Gdy autonumeracja jest włączona to numer ten jest ignorowany i nadawany kolejny automatycznie. Jeśli w pliku brak tej kolumny, to należy włączyć autonumerowanie. |
Numer dodatkowy | Tekst | Nie musi być unikatowy, służy do powiązań z innymi systemami. Numer ten można edytować w oknie edycji przesyłki, w trybie fukcji specjalnych. |
Ilość awizowana | Liczba całkowita | |
Skrót dod. odbiorcy | Tekst | Dane odbiorcy w przesyłce uzupełniane automatycznie na podstawie danych bazy firm danymi firmy o zgodnym skrócie dodatkowym. Etap przypisywania firm można pominąć wybierając Ignoruj podczas odpytywania lub blokując tę funkcjonalność w konfiguracji modułu. |
Skrót dod. nadawcy | Tekst | Jw., dotyczy danych nadawcy. |
Skrót odpowiedzialnego | Tekst | Jw., dotyczy odpowiedzialnego. |
Kod oddziału docelowego | Tekst (3 znaki) | |
Kod oddziału nadania | Tekst (3 znaki) | |
Znaki środka transportu | Tekst | Przenoszone do danych środka transportu w dostawie, dodatkowo stanowią one numer dostawy. |
Numer dokumentu | Tekst | Numer dokumentu dodawanego do listy dokumentów przesyłki. Kod i typ dokumentu można zdefiniować w konfiguracji pluginu. |
Waga obj. | Liczba rzeczywista | |
Przeznaczenie | Tekst | Wartości: Przywóz/Wywóz – jeśli puste lub brak kolumny to przyjmowany jest Przywóz. |
Opis przesyłki | Tekst | |
Waga brutto | Liczba rzeczywista | |
GUID | Tekst | Unikatowy numer wewnętrzny, umożliwia ochronę przed wczytaniem ponownym danej przesyłki przy włączonej autonumeracji; jeśli go brak to program wygeneruje go automatycznie. |
Notatka | Tekst | Dopisywana do notatek przesyłki. |
Wartość | Liczba rzeczywista | |
Waluta | Tekst | Gdy wczytano walutę dodatkowo wypełniane jest pole: Data kursu datą aktualną. |
Kod magazynu | Tekst | |
Ilość awiz. dost. | Liczba całkowita | |
Waga awiz. dost. | Liczba rzeczywista | |
Data dost. odb. | Data | |
Odprawa | Tekst (1 znak) | ‘B’ – bez odprawy, ‘Z’ – odprawa zewnętrzna, ‘S’ – samodzielna |
Numer dokumentu 1 | Tekst | Numer dokumentu dodawanego do listy dokumentów przesyłki. Kod i typ dokumentu można zdefiniować w konfiguracji pluginu. |
Numer dokumentu 2 | Tekst | Numer dokumentu dodawanego do listy dokumentów przesyłki. Kod i typ dokumentu można zdefiniować w konfiguracji pluginu. |
Numer dokumentu 3 | Tekst | Numer dokumentu dodawanego do listy dokumentów przesyłki. Kod i typ dokumentu można zdefiniować w konfiguracji pluginu. |
Rodzaj odprawy | Tekst | ‘0’ – obsługa indywidualna, ‘1’ – obsługa zbiorcza H7USZ, ‘5’ – obsługa indywidualna H7, ‘6’ – obsługa indywidualna IOSS |
Kontrola | Tekst | ‘0’ – brak kontroli, ‘1’ – do kontroli, ‘2’ – kontrola pozytywna, ‘3’ – kontrola negatywna |
Nr zamówienia | Tekst (35 znaków) | |
Moment odbioru przes. | Data | |
Data zwrotu | Data | |
Numer dok. zwrotu | Tekst (35 znaków) | |
Numer decyzji zniszcz. | Tekst (35 znaków) | |
Data decyzji zniszcz. | Data | |
Data zniszcz. | Data | |
Protokół zniszczenia | Tekst (35 znaków) | |
Moment decyzji zwrotu | Data | |
Moment pobrania podatku | Data | |
Rodzaj odbiorcy | Tekst | Dopuszczalne wartości: ‘V’,’C’, ‘F’, ‘Z’. |
Imię odbiorcy | Tekst | |
Nazwisko odbiorcy | Tekst | |
Identyfikator odbiorcy | Tekst | |
PESEL odbiorcy | Tekst | |
Kod pocztowy odbiorcy | Tekst | |
Miejscowość odbiorcy | Tekst | |
Ulica i numer domu odbiorcy | Tekst | |
Rodzaj nadawcy | Tekst | Dopuszczalne wartości: ‘V’,’C’, ‘F’, ‘Z’. |
Imię nadawcy | Tekst | |
Nazwisko nadawcy | Tekst | |
Identyfikator nadawcy | Tekst | |
PESEL nadawcy | Tekst | |
Kod pocztowy nadawcy | Tekst | |
Miejscowość nadawcy | Tekst | |
Ulica i numer domu nadawcy | Tekst | |
Numer IOSS FR5 | Tekst (17 znaków) | |
Kod HS towaru | Tekst (6-10 znaków) | |
Opis towaru | Tekst | |
Ilość towaru | Liczba rzeczywista | |
Jednostka towaru | Tekst | |
Wartość towaru | Liczba rzeczywista | |
Waluta towaru | Tekst | |
Koszt transportu | Liczba rzeczywista | |
Kwota obciążenia gwarancji | Liczba rzeczywista | |
Numer ewidencji tranzytowej | Tekst (20 znaków) |
Grupowanie przesyłek:
Podczas wczytywania danych do programu, przesyłki są grupowane wg dostaw. O numerze dostawy decyduje poleZnaki środka transportu i w powiązaniu z polem Data dostawy powinno być unikatowe w obrębie bazy danych. Oznacza to, że para: numer dostawy – data dostawy nie mogą się powtarzać w bazie danych (choć mogą się powtarzać w pliku. Podczas importu tworzona jest nowa dostawa, a wszystkie przesyłki do niej należące są do niej podpinane.
Pomijane rekordy:
W konfiguracji pluginu można zmienić pole, którego wypełnienie będzie decydowało o tym czy rekord ma być importowany czy nie. Jeśli wybrane pole będzie puste, rekord z danymi przesyłki nie będzie importowany.
Przykładowy plik do pobrania: przykład.
Plugin posiada mechanizm pozwalający na mapowanie nazw kolumn, czyli przypisanie domyślnej nazwie kolumny dowolnej innej nazwy.
Mapowanie definuje się w pliku Mapowanie_XLS_MagCS.txt umieszczonym w katalogu, w którym znajduje się plugin. Gdy plik jest pusty, wówczas program wpisuje do niego domyślne nazwy kolumn.
Przypisania dokonuje się za pomocą znaku = podając po nim nową nazwę kolumny, np:
Numer dokumentu=HAWB
Możliwe jest zamapowanie jednej nazwy kolumny do kilku pól przesyłki.
Błędem jest wprowadzenie w jednym arkuszu kilku kolumn o tej samej nazwie.
Moduł obsługuje pliki XLS zawierające więcej niż jeden arkusz. Jeśli wśród istniejących arkuszy program jest w stanie zaimportować dane więcej niż jednego z nich, wówczas użytkownik jest odpytywany o to, który arkusz ma zostać zaimportowany.