Instrukcja obsługi DHL KONWERTER 1.6 Opis: Niniejsza instrukcja opisuje wymogi użytkowania aplikacji oraz zawiera informacje na temat jej obsługi. DHL Konwerter powstał w celu ułatwienia oraz usprawnienia procesu wysyłania przesyłek z programu ECAS dzięki plikom XML generowanym na podstawie importowanych danych do konwertera. Spis treści 1. Wymagania 2. Charakterystyka 3. Konfiguracja 3.1. Mapowanie pól 3.2. Katalog XML 3.3. Interwał czasowy 3.4. Separator 4. Dodatkowe opcje 4.1. Plik zawiera nagłówki 4.2. Przesyłki z pobraniem 4.3. Auto ID odbiorcy 5. Korzystanie z aplikacji 6. Lista wymaganych pól XML 7. Przykładowe ustawienia na podstawie MS Allegro 8. Przykładowe ustawienia na podstawie sklepu Shoper Wydane przez: DZKE/MMA Strona 1 z 9
1. Wymagania Do poprawnego działania aplikacji niezbędna jest instalacja oprogramowania JAVA w wersji minimum 8. Do prawidłowego działania aplikacji wymagane jest zachowanie poniższej struktury plików w folderze głównym aplikacji. 2. Charakterystyka Aplikacja nie wymaga dodatkowe oprogramowania, nie instaluje na komputerze użytkownika dodatkowych elementów oraz nie ingeruje w system operacyjny. Aplikacja korzysta z danych pobranych z plików źródłowych importowanych przez użytkownika. Pobrane dane nie są modyfikowane, za poprawność danych odpowiada użytkownik aplikacji. Na podstawie danych z pliku źródłowego automatycznie tworzone są pliki XML w strukturze zgodnej ze specyfikacją DHL na dzień 29.05.2016. Pliki wyjściowe XML pobierane są przez program ECAS w celu wydruku listów przewozowych. 3. Konfiguracja 3.1. Mapowanie pól Przy pierwszym uruchomieniu aplikacji wymagane jest konfiguracja mapowania pól pliku źródłowego. Aby dokonać mapowania należy przejść w menu w Opcje - Definicja importu. Wydane przez: DZKE/MMA Strona 2 z 9
W wyświetlonej tabeli należy ręcznie ustawić wartości zgodnie z poniższych schematem: Kolumna numer kolumny pliku źródłowego z której aplikacja będzie pobierać określony typ danych. Numeracja kolumn zaczyna się od kolumny nr. 0 (przykład: w pierwszej kolumnie pliku CSV znajduje się nazwa odbiorcy, w tabeli aplikacji w pozycji nazwa odbiorcy powinna być wprowadzona wartość 0). Wartość wartość stała która będzie przypisywana do każdego pliku XML. Zazwyczaj wartości które nie znajdują się w pliku źródłowym a są wymagane do prawidłowego przygotowania przesyłki. Przykładowe mapowanie pól oraz lista wymaganych pól dla plików XML opisana jest w dziale nr. 6. Wydane przez: DZKE/MMA Strona 3 z 9
3.2. Katalog XML Domyślną lokalizacją do której będą generowane pliki XML jest: C:\DHL\XML Aby zmienić katalog należy kliknąć w pozycję menu Katalog XML podświetloną na poniższym screenie. Katalog XML wybrany w aplikacji powinien być zgodny z katalog ustawionym w aplikacji ECAS aby pliki XML były pobierane automatycznie bez ingerencji użytkownika. 3.3. Interwał czasowy Opcja służy do ustawienia interwału czasowego pomiędzy generowaniem plików XML. Interwał może być wykorzystywany aby sterować kolejnością pobieranych plików przez program ECAS. Aby ustawić wartość należy wybrać pozycję Interwał czasowy z menu, wartość należy podać w sekundach. Wydane przez: DZKE/MMA Strona 4 z 9
3.4. Separator Separator jest rozdzielaczem pól w pliku źródłowym, domyślnym rozdzielaczem dla pliku CSV jest średnik :. Aby ustawić dowolny rozdzielacz należy wybrać pozycję Separator z menu, separatorem może być dowolny znak z wyłączeniem znaku równa się =. 4. Dodatkowe opcje 4.1. Plik zawiera nagłówki Opcja pozwala na pominięcie pierwszego wiersza przy imporcie danych. Przy zaznaczonej opcji aplikacja pomija tylko pierwszy wiersz i rozpoczyna import danych od drugiego wiersza. 4.2. Przesyłki z pobraniem Po zaznaczeniu tej opcji aplikacja automatycznie będzie dodawała do każdej przesyłki usługę pobrania. Warunkiem dodania tej usługi jest dodanie opcji ubezpieczenia do przesyłki. 4.3. Auto ID odbiorcy Każdy odbiorca powinien posiadać unikatowe ID aby dane były poprawnie wyświetlane w programie ECAS. Jeżeli w pliku źródłowym nie znajduje się unikatowe pole zalecane jest skorzystanie z tej opcji. Wydane przez: DZKE/MMA Strona 5 z 9
5. Korzystanie z aplikacji Po przeprowadzeniu konfiguracji aplikacji można rozpocząć pracę. Aby zaimportować plik źródłowy należy z menu wybrać opcję Start Importuj plik. Po wskazaniu pliku aplikacja automatycznie rozpocznie pobieranie danych o czym użytkownik będzie informowany w polu tekstowym. Nazwy plików XML zawierają liczbę kontrolną datę oraz godzinę wygenerowania pliku. Po zakończonym imporcie danych aplikacji wyświetli również komunikat o liczbie wygenerowanych plików oraz lokalizacji. 6. Lista wymaganych pól XML Poniżej zawarta jest lista wymaganych pól w pliku XML, oraz przykładowe możliwości konfiguracyjne aplikacji. W tym wypadku dane adresowe odbiorców będę pobierane z pliku źródłowego, natomiast produkt, płatnik, płatność itp. będę wartościami stałymi identycznymi dla każdej przesyłki. Pole Dokumenty / Kategoria dotyczy ilości paczek w przesyłce, jedno z pól dokumenty, paczka 5kg, paczka 10kg, paczka 20kg, paczka 31,5kg jest wymagane. Wydane przez: DZKE/MMA Strona 6 z 9
Pozostałe pola w pliku XML są dodatkowe i nie są wymagane. Pola sterujące: BLP określna format wydruku (1- wydruk etykiet, 0- wydruk listu przewozowego) Numer kuriera jeżeli pole jest nieuzupełnione program ECAS przypiszę domyślny numer kurier do każdej przesyłki. Data nadania w przypadku pustego pola aplikacja przypiszę datę dzisiejszą do każdej przesyłki. Utylizacja usługa utylizacji wykorzystywana dla przesyłek międzynarodowych. W przypadku korzystania z opcji pobrania wymagane jest także ubezpieczenie przesyłki na kwotę nie mniejszą niż pobranie. 7. Przykładowe ustawienia na podstawie MS Allegro Menadżer Sprzedaży Allegro daje możliwość eksportu danych w formie plików CSV, aby skorzystać z tej opcji należy z menu wybrać pozycję Eksportuj dane w dziale Dodatkowe opcje. MS daje możliwość stworzenie własnych szablonów plików CSV. Wydane przez: DZKE/MMA Strona 7 z 9
Eksport odbywa się przez wybranie odpowiedniego okresu oraz sekcji. 8. Przykładowe ustawienia na podstawie sklepu Shoper Aby ustawić eksport danych w sklepie opartym na platformie Shoper należy wybrać z zakładki Narzędzia => Centrum Wymiany Danych. Następnym krokiem jest konfiguracja pliku CSV w Zamówieniach, Produktach (ostatnia pozycja na liście). Wydane przez: DZKE/MMA Strona 8 z 9
Podczas edycji ustawień można określić nazwę profilu, separator, oraz listę pól zawartych w pliku CSV. Kolejność pól jest niezmienna, jedyna możliwość konfiguracji to aktywowania pól. Należy pamiętać o rozdzieleniu zamówień na dwa odrębne pliki, przesyłki które będą zawierały pobranie oraz te bez pobrania. Dobrym rozwiązaniem jest skorzystanie ze statusów zamówień w którym można skonfigurować Typy zamówień. Ostatnim krokiem jest eksport danych do pliku CSV w liście zamówień. Pomoc techniczna DHL: (22) 662 62 62 lub cahelp@dhl.com Wydane przez: DZKE/MMA Strona 9 z 9