pobierz instrukcję obsługi

Instrukcja obsługi
Multi DHL 3.0
Opis:
Niniejsza instrukcja opisuje wymogi użytkowania aplikacji oraz zawiera informacje na temat jej
obsługi.
Multi DHL 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
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 1 z 10
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 domyślnej 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.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 2 z 10
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). W polach z nazwą
odbiorcy oraz ulicą można łączyć wartości z dwóch kolumn poprzez odpowiednie
wprowadzenie sekwencji x+x, gdzie x oznacza numer kolumny (np. 2+3)
 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 ustawienia oraz lista wymaganych pól dla opisana jest w dziale nr. 6.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 3 z 10
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.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 4 z 10
3.4. Separator
Rozdzielacz pól w pliku, 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ę „=”.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 5 z 10
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. Konfiguracja Allegro
4.2.1. Pomijaj 3 wiersze
Pliki CSV eksportowane z systemu allegro wymagają pomijanie 3 pierwszych
wierszy, opcja wymagana do zaznaczenia jeżeli użytkownik korzysta z integracji
allegro.
4.2.2. Weryfikacja COD
Aplikacja ma funkcje automatycznego wykrywania przesyłek z pobraniem. Należy
wskazać (poprzez kliknięcie w tą opcję) w jakim polu zawarte są dane „typ
płatności” z ustawień Allegro.
4.3. Konfiguracja Allegro XML
Możliwość ustawienia jakie pola z plików XML Allegro będą przenoszone do pól:
Zawartość, Uwagi oraz MPK
4.4. 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.5. 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.
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.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 6 z 10
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.
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.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 7 z 10
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.
Eksport odbywa się przez wybranie odpowiedniego okresu oraz sekcji.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 8 z 10
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).
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.
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 9 z 10
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: (42) 662 62 62 lub [email protected]
Obowiązuje od: 20.01.2017
Wydane przez: DZKE/MMA
Nr/wersja: eCAS/WI-003/2
Strona 10 z 10