Import zleceń / Integracja klienta K-Ex 1
1 Integracja systemów Klient K-Ex jako sposobem zwiększenia wydajności tworzenia wysyłki 1.1 Import przesyłek na podstawie pliku CSV Wprowadzenie danych na temat przesyłek do systemu K-Ex, może odbywać się z wykorzystaniem mechanizmu importu pliku csv z danymi wysyłkowymi, za pomocą systemu WWW. Opcja ta dostępna jest w zakładce Przesyłki -> Import przesyłek. Przyciskiem Przeglądaj wskazujemy plik z danymi do importu, po czym potwierdzamy rozpoczęcie procesu wprowadzania zleceń (przycisk Importuj). Prawidłowym źródłem importu jest plik CSV, w którym separatorem pól jest znak ';' (średnik). Plik może zawierać nagłówki kolumn, ale wówczas muszą być one zgodne z podanymi w specyfikacji pliku. Dla pliku z nagłówkami kolejność ułożenia kolumn nie jest istotna. W sytuacji kiedy importowany plik nie zawiera nagłówków kolumn, wówczas rozłożenie danych musi występować wg kolejności zdefiniowanej w specyfikacji pliku, która dostępną jest do pobrania na stronie systemu WWW. Pliku do importu musi być kodowany w UTF-8. Rozwiązanie to pozwala na zarządzanie wysyłką, oraz wydrukiem dokumentacji transportowej z poziomu systemu WWW. 2
1.2 Integracja systemów przy wykorzystaniu platformy EDI Platforma EDI służy do wymiany danych pomiędzy systemem klienta a systemem K-Ex. Polega na udostępnieniu przez klienta pliku z danymi wymaganymi do stworzenia zlecenia wysyłki. Klienta1 Klienta2 Serwer e-mail Platforma EDI System K-Ex Platforma EDI obsługuje wymianę danych w formacie XML. Dane przekazywane przez klienta w innym, ustalonym formacie, będą przetwarzane przez platformę EDI i przekazywane do systemu K-Ex. Dostępne formaty plików to: XML, CSV, TEXT. 1.2.1 Sposób komunikacji Wymiana komunikatów EDI obywa się w formie plików. W jednym pliku może być zawarty tylko jeden komunikat EDI. Jednak struktura komunikatu EDI może dopuszczać przekazywanie wielu logicznych jednostek danych (np. wielu zleceń). Każdy plik posiada unikalny identyfikator w ramach wymiany danych z konkretnym klientem. Oznacza to, że w ciągu całego działania systemu wymiany danych nie będzie dwóch rożnych plików (co do zawartości) z takim samym identyfikatorem. Unikalność nazw zapewnia oprogramowanie klienta dla plików generowanych przez klienta. Każdy plik posiada unikalny identyfikator. Identyfikator jest tworzony na podstawie typu komunikatu EDI przekazywanego w pliku oraz numeru sekwencyjnego Nazwa pliku: TT_NNNNNNNNNNNN gdzie: TT dwa znaki określając typ komunikatu, NNNNNNNNNNNN numer sekwencyjny właściwy dla typu komunikatu Na chwilę obecną system posiada następujące typu komunikatów: symbol typu / typ komunikatu EDI 10 zlecenie EXP/LTL 17 trasy Z punktu widzenia transportu, lista typów nie jest istotna. Ważne jest aby zachować format identyfikatora. Przykłady poprawnych identyfikatorów: 10_0000000010000 17_0000002530000 Typ komunikatu informuje system o rodzaju danych przekazywanych na serwer. Najczęściej są to dane na temat zleceń transportowych. Symbolem 10 oznaczone są komunikaty zawierające zlecenia kurierskie oraz paletowe. Numer sekwencyjny może być wartością inkrementowaną, bądź datą wygenerowania (wgrania) komunikatu. Ważne jest aby zachowywał on unikalność. Przykłady poprawnych identyfikatorów: 3
Lub 10_201001121746.exx (10_datagodzina) 10_000000000001.exx (10_wartośćinkrementowana) Wygenerowany przez klienta pliki ze zleceniami, za pomocą FTP, wgrywane są na serwer K-Ex do symbolicznie nazwanego katalogu IN. Pliki są pobierane i przetwarzane na zlecenia umieszczane w systemie K-Ex. Ponieważ transmisja przez FTP nie jest natychmiastowa, konieczne jest zapewnienie, aby pliki nie były dalej przetwarzane przed zakończeniem transferu FTP. Szczegóły procedury opartej na zmianie nazw plików zapisane są poniżej Procedura umieszczania danych w katalogu IN 1. Nazwy plików są tworzone na podstawie identyfikatora pliku i rozszerzenia. 2. Rozszerzenie.exx oznacza plik, który jest aktualnie tworzony przez klienta 3. Rozszerzenie.edx oznacza plik gotowy do odbioru przez FTP. 4. Algorytm dla klientów (ident_pliku = TT_NNNNNNNNNNNN): a. utworzyć plik ident_pliku.exx z treścią komunikatu EDI, b. gdy plik jest już gotowy, należy umieścić go na serwerze i zmienić nazwę ident_pliku.exx na ident_pliku.edx W trakcie wgrywania pliku powinien mieć on rozszerzenie exx. Po prawidłowym jego wyeksportowaniu, zmieniamy rozszerzenie na.edx Oznacza to że plik gotowy jest do przetworzenia. Częstotliwość odczytu plików wynosi od 5min do 24 godzin. System sprawdza poprawność poniższych danych - weryfikacja kodów pocztowych - weryfikacja daty nadania i doręczenia pod względem poprawności następstwa dat - weryfikujemy wprowadzenie nazwy miejscowości, ulicy, nr domu - weryfikujemy wprowadzenie numeru tel. komórkowego: yyyyyyyyy <601111111>) - liczba i waga opakowań W symbolicznym katalogu OUT wystawiany jest przetworzony plik w formie XML zawierający informacje na temat przekazanych zleceo, ewentualnych błędów oraz linków do wydruku. 1.2.2 Dokumentacja transportowa Poniżej znajduje się specyfikacja dotycząca dokumentu transportowego (.pdf) wykorzystywanego przez K-Ex w transporcie przesyłek. Strona Klienta jest odpowiedzialna za tworzenie tego typu dokumentu. Aby uniknąć błędów ludzkich wynikających z rozróżnienia wielu typów dokumentów transportowych klient zobligowany jest do dostosowania wyglądu etykietolistu do standardu wykorzystywanego przez K-Ex. Rozmiar etykiety 100x154 mm (10x15,4 cm). Etykiety mogą być również generowane na podstawie pliku wynikowego, w którym w efekcie przetworzenia przez system K-Ex zostaną umieszczone linki do wydruku dokumentów. 4
Zapis tworzony dynamicznie, podawany jest pierwszy przedział wagowy przesyłek oraz ich ilość, Każdy następny zapis będzie zawierał ilość paczek z kolejnego przedziału wagowy, który wystąpił. np 10kg 30kg 3 2 Sekcja A Nadawca Dane o adresie nadania zapisane pod kątem 90 0 Sekcja B Odbiorca Dane o adresie Doręczenia Sekcja C Data Nadania Sekcja D Typ zlecenia Zapis: EX- zlecenia koperta, 1-30kg, LT zlecenia 31-1000kg EXL- przesyłka lokalna koperta-30kg, LTL- przesyłka lokalna 31-1000kg Sekcja E ilość opakowań Dla zleceń niestandardowych typu LT dodatkowo zapis o wymiarach, oraz wadze przeliczeniowej przesyłki w sekcji J Sekcja F Usługi dodatkowe Wydruk usług dodatkowych które zostały zadeklarowane przez klienta: Dostawa do rąk własnych, Dostawa do 9 00, Dostawa do gidziny xx (xx-pełna godzina), Dostawa 17-22, Awizacja xx (xx- rodzaj {tel., SMS, mail}), Dostawa w sobotę, Dostawa w Niedzilę/Święto, Dokumenty zwrotne xx (xx - ilość), Pobranie xx (xx - kwota), Dedykowany Przewoźnik, Przesyłka niestandardowa [xx dla zleceń EX podana ilość przesyłek niestandardowych] Sekcja G Piktogramy (w załączniku) Sekcja podzielona na 4 wiersze: 1 wiersz zawiera usługi Awizacji (telefon), oraz doręczenie do rąk własnych (dłoń) 2 wiersz zawiera usługi: Pobranie (moneta), dokumenty zwrotne(pod,rod)(dokument) 3 wiersz, doręczenia do wskazanej godziny (budzik), doręczenie Sobota/Niedziela 4 wiersz, ADR (ogień) oraz Rozładunek wniesienie (schody) Sekcja H Opis towaru 1 linijka Sekcja I Uwagi 3 linijki tekstu Sekcja K Trasa (załącznik) Sekcja L numer paczki / sumaryczna ilość paczek na zleceniu Sekcja M kod kreskowy Sekcja N kod opakowania na który składa się: List przewozowy (Negatyw) (9 cyfr), Kod pocztowy Nadawcy (5cyfr), Kod pocztowy odbiorcy (5cyfr), Numer opakowania (2 cyfry), Wartość kontrolna (1 cyfra) 5
Na etykiecie oprócz stałych pojawiają się dwie zmienne, które opis tworzenia opisane są poniżej. 1) Pierwsze z nich to oznaczenie trasy kurierskiej (sekcja K). Wyznaczana jest ona na podstawie kodu pocztowego adresu Doręczenia. Dane te ulegają zmianie w systemie K-Ex i powinny być one aktualizowane w systemie klienta zintegrowanego platformą EDI. Plik z aktualizacją przypisanych tras kurierskich do kodów pocztowych będzie przekazywany automatycznie na serwer, za pośrednictwem platformy EDI. Wtedy to w momencie pojawienia się aktualizacji, w katalogu OUT, będą Państwo z automatu ją pobierać i nanosić zmiany. 2) Tworzenie kodu kreskowego: Numer opakowania kodowany Code 128. Zasada tworzenia numeru opakowania: Numer opakowania składa się z 21 cyfr, z czego a) pierwsze 9 to numer listu przewozowego b) cyfry 10-14 to kod pocztowy nadawcy c) cyfry 15-19 - kod pocztowy odbiorcy d) cyfry 20-21 - numer opakowania w zleceniu ( czyli jeżeli mamy 3 opakowania w zleceniu pierwsze 19 cyfr będzie identyczne, natomiast ostatnie 2 cyfry będą przyjmować wartości 01; 02; 03 dla poszczególnych opakowań) Do kodu opakowania została wprowadzona wartość kontrolna, która znajduje się na końcu (pozycja 22). Zasady tworzenia kodu opakowania opisane są poniżej Wartość kontrolna jest to reszta z dzielenia przez 10 dla sumy iloczynów poszczególnych pozycji numeru i wag. Ewentualne. Wagi stosowane w algorytmie: 1,3,7,9,1,3,7,9,1,3,7,9, itd. Przykład wyznaczania sumy dla etykiety paczki wewnętrznej: Numer: 412345678111112222201 Wagi: 1,3,7,9,1,3,7,9,1,3,7,9,1,3,7,9,1,3,7,9,1 Suma kontrolna = (4*1 + 1*3 + 2*7 + 3*9 + 4*1 + 5*3 +...1*1) mod 10 6