Import zleceń / Integracja klienta - PT

K-EX Sp. z o.o.
25-528 Kielce, ul. Zagnańska 61
tel. +4841 367 82 49, faks +4841 367 82 67
e-mail: [email protected]
infolinia: 0 801 702 505
www.k-ex.com.pl
Import zleceń / Integracja klienta
K-Ex
Sąd Rejonowy w Kielcach, X Wydział Gospodarczy Krajowego Rejestru Sądowego pod nr 0000326471
Kapitał zakładowy 1 005 000 ,00 zł - wpłacony w całości
Konto bankowe: Deutsche-Bank 69 1880 0009 0000 0011 0179 5000
NIP: 959-18-56-995, REGON: 260287537
1
K-EX Sp. z o.o.
25-528 Kielce, ul. Zagnańska 61
tel. +4841 367 82 49, faks +4841 367 82 67
e-mail: [email protected]
infolinia: 0 801 702 505
www.k-ex.com.pl
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.
Sąd Rejonowy w Kielcach, X Wydział Gospodarczy Krajowego Rejestru Sądowego pod nr 0000326471
Kapitał zakładowy 1 005 000 ,00 zł - wpłacony w całości
Konto bankowe: Deutsche-Bank 69 1880 0009 0000 0011 0179 5000
NIP: 959-18-56-995, REGON: 260287537
2
K-EX Sp. z o.o.
25-528 Kielce, ul. Zagnańska 61
tel. +4841 367 82 49, faks +4841 367 82 67
e-mail: [email protected]
infolinia: 0 801 702 505
www.k-ex.com.pl
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
Platforma
Klienta2
Serwer
e-mail
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:
Sąd Rejonowy w Kielcach, X Wydział Gospodarczy Krajowego Rejestru Sądowego pod nr 0000326471
Kapitał zakładowy 1 005 000 ,00 zł - wpłacony w całości
Konto bankowe: Deutsche-Bank 69 1880 0009 0000 0011 0179 5000
NIP: 959-18-56-995, REGON: 260287537
3
K-EX Sp. z o.o.
25-528 Kielce, ul. Zagnańska 61
tel. +4841 367 82 49, faks +4841 367 82 67
e-mail: [email protected]
infolinia: 0 801 702 505
www.k-ex.com.pl
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.
Sąd Rejonowy w Kielcach, X Wydział Gospodarczy Krajowego Rejestru Sądowego pod nr 0000326471
Kapitał zakładowy 1 005 000 ,00 zł - wpłacony w całości
Konto bankowe: Deutsche-Bank 69 1880 0009 0000 0011 0179 5000
NIP: 959-18-56-995, REGON: 260287537
4
K-EX Sp. z o.o.
25-528 Kielce, ul. Zagnańska 61
tel. +4841 367 82 49, faks +4841 367 82 67
e-mail: [email protected]
infolinia: 0 801 702 505
www.k-ex.com.pl
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
Sekcja A – Nadawca
Dane o adresie nadania zapisane pod kątem 900
Sekcja B – Odbiorca
Dane o adresie Doręczenia
Sekcja C – Data Nadania
Sekcja D – Typ zlecenia
Zapis: EX- zlecenia koperta, 1-30kg, LT – zlecenia 311000kg
EXL- przesyłka lokalna koperta-30kg, LTL- przesyłka
lokalna 31-1000kg
Sekcja E – ilość opakowań
10kg
30kg
3
2
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 900, 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)
Sąd Rejonowy w Kielcach, X Wydział Gospodarczy Krajowego Rejestru Sądowego pod nr 0000326471
Kapitał zakładowy 1 005 000 ,00 zł - wpłacony w całości
Konto bankowe: Deutsche-Bank 69 1880 0009 0000 0011 0179 5000
NIP: 959-18-56-995, REGON: 260287537
5
K-EX Sp. z o.o.
25-528 Kielce, ul. Zagnańska 61
tel. +4841 367 82 49, faks +4841 367 82 67
e-mail: [email protected]
infolinia: 0 801 702 505
www.k-ex.com.pl
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
Sąd Rejonowy w Kielcach, X Wydział Gospodarczy Krajowego Rejestru Sądowego pod nr 0000326471
Kapitał zakładowy 1 005 000 ,00 zł - wpłacony w całości
Konto bankowe: Deutsche-Bank 69 1880 0009 0000 0011 0179 5000
NIP: 959-18-56-995, REGON: 260287537
6