Geis CZ s.r.o. Geis Parcel CZ s.r.o. Geis SK s.r.o. Geis Parcel SK s.r.o. Manuál pro systémovou integraci Verze: 2015/01 Platnost od: 1. září 2015 Poslední revize: 19. srpna 2015 Tato verze nahrazuje všechny předchozí verze v plném rozsahu. Aktuální verze dostupná též na www.baliky.cz/podpora nebo www.baliky.sk/podpora.
Obsah Účel dokumentu Přehled změn Seznam obrázků Seznam tabulek v vi vii vii 1 Obecné informace 1 1.1 Úprava informačního systému zákazníka.................. 2 1.2 Druhy přeprav................................. 2 1.3 Číselné řady.................................. 3 1.4 Kontrolní číslice................................ 4 1.5 Směrování zásilek............................... 4 1.5.1 Vnitrostátní směrování........................ 5 1.5.2 Mezinárodní směrování........................ 6 1.6 Datové typy.................................. 8 1.7 Datové typy platné pro balík (parcel).................... 8 1.7.1 Alfanumerické hodnoty (AN).................... 8 1.7.2 Celočíselné hodnoty (CC)...................... 8 1.7.3 Číselné hodnoty s desetinnými místy (FP)............. 8 1.7.4 Kalendářní data (KD)........................ 9 1.7.5 Telefonní čísla (TC)......................... 9 1.8 Datové typy platné pro cargo........................ 9 1.8.1 Alfanumerické hodnoty (AN).................... 9 1.8.2 Celočíselné hodnoty (CC)...................... 9 1.8.3 Celočíselné hodnoty, číslo zarovnané vpravo (CP)......... 10 1.8.4 Celočíselné hodnoty, číslo zarovnané vlevo (CL).......... 10 1.8.5 Celočíselné hodnoty, číslo doplněné fixní hodnotou (CS)...... 10 i
1.8.6 Kalendářní data (KD)........................ 10 1.8.7 Časový údaj (KC).......................... 10 1.8.8 Telefonní čísla (TC)......................... 11 1.9 Validátor dat................................. 12 2 Parcel 13 2.1 Sloučená (hromadná) zásilka......................... 13 2.2 Specifikace formátu EDI........................... 13 2.2.1 Struktura záznamů.......................... 14 2.2.2 Konvence pro pojmenování exportních souborů........... 18 2.3 Struktura předávacího protokolu....................... 20 2.3.1 Čárový kód.............................. 21 2.4 Specifikace pro tisk štítků.......................... 22 2.5 Doplňkové přepravní služby pro parcel zásilky............... 27 2.5.1 Avízo o doručené zásilce - ADZ................... 27 2.5.2 Služba POD.............................. 28 2.5.3 Avízo o problémové zásilce - APZ.................. 28 2.5.4 SMS avízo o expedici zásilky - SMS................. 28 2.5.5 Telefonické avízo - AVI........................ 28 2.5.6 Doručení na dobírku - COD..................... 29 2.5.7 Doručení do 12. hodin - D12..................... 29 2.5.8 Doručení fyzické osobě - B2C.................... 30 2.5.9 Ex Works - EXW........................... 30 2.5.10 Garantované doručení - GAR.................... 30 2.5.11 Připojištění - POJ.......................... 31 2.5.12 Platba kartou - CDR......................... 31 2.5.13 Výdejní místo - VM.......................... 31 2.6 Ověření správnosti dat a dokumentů - parcel................ 32 2.7 Ostrý provoz................................. 33 ii
3 Cargo 34 3.1 Specifikace formátu EDI........................... 34 3.1.1 Struktura záznamů.......................... 36 3.1.2 Konvence pro pojmenování exportních souborů........... 40 3.2 Struktura předávacího protokolu....................... 41 3.3 Specifikace pro tisk štítků.......................... 42 3.4 Doplňkové přepravní služby pro cargo zásilky............... 46 3.4.1 SMS avízo - SMS........................... 46 3.4.2 Telefonické avízo - AVI........................ 47 3.4.3 Dobírka - COD............................ 47 3.4.4 Termínované doručení - DTR.................... 47 3.4.5 B2C (Soukromá adresa)....................... 47 3.4.6 EXW (Platba příjemcem)...................... 47 3.4.7 DL zpět - VDL............................ 48 3.4.8 Smlouvy zpět - VSM......................... 48 3.4.9 B2C Dodání s pomocí - B2P..................... 48 3.4.10 B2C Odvoz spotřebiče - B2S..................... 48 3.4.11 VIP doručení - VIP.......................... 48 3.5 Ověření správnosti dat a dokumentů - cargo................ 48 3.6 Ostrý provoz................................. 49 Symboly a zkratky 50 Přílohy 51 Předávací protokol pro parcel........................... 51 Předávací protokol pro cargo............................ 52 Předávací protokol pro parcel........................... 53 Předávací protokol pro cargo............................ 54 Náhledy štítků pro balíky............................. 55 Náhledy štítků pro cargo.............................. 57 iii
Checklist pro podklady - parcel.......................... 58 Checklist pro podklady - cargo.......................... 58 Tabulka kódů zemí podle ISO-3166........................ 59 Seznam kódů manipulačních jednotek....................... 59 Změna pojmenování souborů se směrovacími tabulkami............. 59 iv
Účel dokumentu Manuál pro systémovou integraci je určen pro klienty skupiny Geis na území České a Slovenské republiky. Cílem dokumentu je poskytnout klientům klíčové znalosti a informace spojené se systémovou integrací tak, aby byla doba zavedení integrace co nejkratší. Manuál definuje jednak pravidla pro přenos dat do informačního systému společností skupiny Geis, dále určuje jaká data mají být přenášena, jaký je jejich formát a typ a také poskytuje specifikaci pro tisk štítků a předávacích protokolů pro balíkovou (parcel) i paletovou (cargo) přepravu. Zpracovalo IT oddělení Poslední revize: 19. srpna 2015 v
Přehled změn V této sekci je chronologický přehled změn v dokumentaci. Číslo verze Datum vydání Popis změn Oddíl(y) 2015/01 1. 9. 2015 Změna dostupnosti služeb pro jednotlivé země (CDR) 2.5 2014/04 11. 9. 2014 Doplněna služba Výdejní místa 2.5 Přidání slovenské verze Předávacího protokolu Přílohy 2014/03 24. 3. 2014 Doplněna služba Platba kartou 2.5 Rozlišení zásilek z pohledu subjektů přepravy 1.2 Doplněna informace o validátoru dat 1.9 Specifikována velikost čárových kódů 2.4, 3.3 Změna řazení úvodních kapitol v, vi, vii Oprava chyb a překlepů Upravena dostupnost služeb cargo v zahraničí 3.4 2014/02 5. 2. 2014 Úvodní vydání dokumentace Zveřejnění na webu technické podpory Revidována specifikace Parcel Dopracována specifikace Cargo Tabulka 1: Přehled změn v dokumentaci vi
Seznam obrázků 1 Zjednodušené schéma EDI formátu pro parcel................ 13 2 Náhled exportního souboru pro parcel.................... 13 3 Ukázka nečitelného (vlevo) a korektního (vpravo) čárového kódu..... 22 4 Layout štítku pro parcel............................ 23 5 Schéma záznamů ve formátu KDDS128................... 35 6 Popis záznamů ve formátu KDDS128.................... 36 7 Layout štítku pro cargo............................ 42 8 Náhled štítku pro balík bez doplňkových služeb.............. 55 9 Náhled štítku pro balík s dobírkou..................... 55 10 Náhled štítku pro balík více doplňkových služeb.............. 56 11 Náhled štítku pro balík služba VM.................... 56 12 Náhled štítku pro cargo zásilka se třemi kusy............... 57 13 Náhled štítku pro cargo zásilka se třemi kusy............... 57 14 Náhled štítku pro cargo zásilka se třemi kusy............... 58 Seznam tabulek 1 Přehled změn v dokumentaci......................... vi 2 Struktura záznamů v tabulce pro vnitrostátní směrování.......... 6 3 Struktura záznamů v tabulce pro mezinárodní směrování.......... 7 4 Struktura záznamů v exportním souboru pro parcel............. 17 5 Označení doplňkových služeb v exportním souboru pro parcel....... 18 6 Dostupnost služeb dle druhu přepravy - parcel............... 27 7 Označení doplňkových služeb v exportním souboru pro cargo....... 46 8 Dostupnost služeb dle druhu přepravy - cargo............... 46 vii
GEIS Group 1. Obecné informace 1 Obecné informace Součástí manuálu je ZIP archiv obsahující soubory s platnými směrovacími tabulkami, šablony pro tisk štítků, vzor předávacích protokolů, vzorek exportních dat a loga. Aktuální verze tohoto manuálu i ZIP archivu je dostupná ke stažení na webových stránkách www.baliky.cz/podpora, na FTP serveru (přístupové údaje viz oddíl 1.5) nebo u vašeho obchodního manažera Geis. Ujistěte se vždy, že používáte aktuální verzi dokumentace. Nová verze dokumentace nahrazuje předchozí verzi vždy v plném rozsahu. Struktura a obsah ZIP archivu: _loga - Geis_logo_barevne.pdf - Geis_logo_barevne.png - Geis_logo_barevne.svg - Geis_logo_cerne.pdf - Geis_logo_cerne.png - Geis_logo_cerne.svg - Geis_logo_printer.zip \- geis.pcx Cargo - Cargo_Label_EPL.txt - Cargo_Predavaci_Protokol.pdf - Cargo_PSC_CZ_Vnitro.txt - Cargo_PSC_CZ_Export.txt - Cargo_PSC_SK_Vnitro.txt - Cargo_PSC_SK_Export.txt - Cargo_Obaly.csv - Cargo_Zeme.csv \- Cargo_Data_ftp10280869.txt Parcel - Parcel_Label_EPL.txt - Parcel_Predavaci_Protokol.pdf - Parcel_PSC_CZ_Vnitro.txt - Parcel_PSC_CZ_Export.txt - Parcel_PSC_SK_Vnitro.txt - Parcel_PSC_SK_Export.txt - Parcel_Zeme.csv \- Parcel_Data_CTST108c.001 EPL2_Programming_Manual.pdf 1
GEIS Group 1.1 Úprava informačního systému zákazníka 1.1 Úprava informačního systému zákazníka V mnoha případech zavedení integrované datové komunikace se systémy Geis znamená nutnost úprav v informačním systému zákazníka. Při zadávání těchto úprav je třeba si uvědomit, že některé charakteristiky se mohou v čase měnit. Jde zejména o obchodní podmínky, rozsah poskytovaných služeb, číselné řady, doplňkové služby, směrovací tabulky a další číselníky. Proto je vhodné zadat a realizovat úpravy informačního systému tak, aby bylo možné měnit rozsahy dynamicky podle potřeby. 1.2 Druhy přeprav Při přepravě zásilek rozlišujeme základní dva druhy přeprav: Parcel, též balíková přeprava. Tyto přepravy zajišťuje v České republice společnost Geis Parcel CZ, s.r.o. a na Slovensku společnost Geis Parcel SK, s.r.o. Cargo, též paletová přeprava. Tyto přepravy zajišťuje v České republice společnost Geis CZ, s.r.o. a na Slovensku společnost Geis SK, s.r.o. Zákazník si podmínky spolupráce dohodne podle druhu přepravy s příslušnou společností skupiny Geis. Struktura datového napojení (datové soubory, předávací protokoly, štítky, doplňkové služby, směrovací tabulky atd.) se pro oba druhy přeprav liší, jak je detailně popsáno v následujících kapitolách. Základní jednotkou přepravy je zásilka. U balíkové přepravy hovoříme o balíku (1 zásilka = 1 balík). U cargo přepravy hovoříme o cargo zásilce (1 zásilka se může skládat z více nákladových kusů v různých manipulačních jednotkách). Jednotlivé nákladové kusy mají stejné číslo zásilky, pořadí v zásilce je určeno údajem Kolli, viz oodíl 1.3. U balíkové zásilky je manipulační jednotkou (obalem) vždy balík, u cargo zásilky může jít o různé druhy manipulačních jednotek (paleta, sud, kanystr), jejich úplný seznam je v příloze na konci dokumentu. Z pohledu stran, které se účastní přepravy (subjektů) rozlišujeme zásilky na expedice. V tomto případě při přepravě rozlišujeme odesílatele a příjemce zásilky. Přepravu zásilky si objednává odesílatel, tedy zákazník Geis. Tyto zásilky je možné zadávat datovým napojením. V celém dokumentu dále se zásilkou rozumí tento typ přepravy. 2
GEIS Group 1.3 Číselné řady objednávky (též vratky). V tomto případě při přepravě rozlišujeme odesílatele, příjemce a objednatele přepravy. Přepravu zásilky zadává objednatel, tedy zákazník Geis. Příjemce zásilky může, ale nemusí být shodný s objednatelem. Tyto zásilky zatím nelze zadávat datovým napojením. Příklad 1: Zákazník Geis (objednatel) potřebuje přepravit z firmy A (odesílatel) zásilku do firmy B (příjemce). V přepravě jsou tři subjekty - odesílatel, příjemce a objednatel., přepravu zadává objednatel Příklad 2: Zákazník Geis (objednatel) potřebuje přepravit z firmy A (odesílatel) zásilku k sobě. V přepravě jsou 2 subjekty - odesílatel, příjemce = objednatel. Podle země odesílatele a země příjemce zásilky rozlišujeme zásilky na vnitrostátní. V tomto případě se země odesílatele a příjemce neliší (např. přeprava zásilky v rámci České republiky). mezinárodní (též exportní). V tomto případě jsou země odesílatele a země příjemce odlišné (např. přeprava zásilky z ČR do Německa). 1.3 Číselné řady Pojmem číselná řada je označován rozsah čísel, který je klientům přidělován pro číslování zásilek. U obou služeb (Cargo i Parcel) dostane klient číselný interval od, do. V případě služby Cargo je přidělována jedna číselná řada platná jak pro vnitrostátní, tak i pro mezinárodní přepravu. U služby Parcel jsou přidělovány dvě číselné řady jedna pro vnitrostátní a druhá pro mezinárodní přepravu. Z pohledu číslování zásilek je mezinárodní přeprava z CZ do SK, nebo z SK do CZ vnímána jako vnitrostátní, tyto zásilky se tedy číslují z číselné řady pro vnitrostátní přepravu. Číselná řada se přiděluje vždy tak, aby vystačila zhruba na jeden rok, pak je přidělena nová 1. Klient obdrží dvě čísla spodní a horní hranici číselného intervalu (viz příklad). Z intervalu klient vybírá čísla, de facto inkrementováním čísla spodní hranice, dokud přidělený interval nevyčerpá. Obě hraniční hodnoty jsou součástí přidělené řady a tedy mohou být využity pro očíslování zásilek. V systému musí být kontrola konce číselné řady! Pokud se daný číselný rozsah přesáhne, tak data nebudou v našem systému zpracována. Poznámka: Čísla balíkových zásilek jsou 11 místná, čísla cargových zásilek jsou 13 místná. Příklad: Klient obdrží pro službu balíkové přepravy čísla 02045000000 a 02045099999. Řada tedy vystačí přesně pro 100 000 balíků. První balík bude mít číslo 02045000000, druhý balík bude mít číslo 02045000001 atd. Stotisící balík bude mít číslo 02045099999. 1 U přidělené číselné řady se nelze spolehnout na návaznost na předchozí řadu ani na společný prefix. 3
GEIS Group 1.4 Kontrolní číslice 1.4 Kontrolní číslice Z čísel balíků a palet (resp. nákladových kusů) se počítají kontrolní číslice, které klienti uvádějí na předávacích protokolech a štítcích. Způsob výpočtu se pro balíkové a cargové zásilky mírně odlišuje. Cargo Pro cargové zásilky je kontrolní číslice počítána z čísla zásilky a z čísla KOLLI 2. Způsob výpočtu je uveden na příkladu. Příklad: Číslo zásilky je 6130080000005, číslo KOLLI pro první nákladový kus je 01. Kontrolní číslice se počítá z čísla 613008000000501. 1) Sečtou se zvlášť číslice na lichých a na sudých pozicích. 6+3+0+0+0+0+5+1 = 15 1+0+8+0+0+0+0 = 9 2) Součet čísel na lichých pozicích se vynásobí třemi a přičte se součet čísel na sudých pozicích. (15 3) + 9 = 54 3) Kontrolní číslice je doplněk mezivýsledku z předchozího kroku (vyznačen modře) do následující celé desítky. 54 a do následující desítky(60) = 6 Parcel Pro balíkové zásilky je kontrolní číslice počítána pouze z čísla balíku. Postup výpočtu je opět uveden na příkladu. Příklad: Číslo balíku je 22126690500. Kontrolní číslice se počítá pouze z čísla balíku 22126690500. 1) Sečtou se zvlášť číslice na lichých a na sudých pozicích. 2+1+6+9+5+0 = 23 2+2+6+0+0 = 10 2) Součet čísel na lichých pozicích se vynásobí třemi a přičte se součet čísel na sudých pozicích a jednička. (23 3) + 10 + 1 = 80 3) Kontrolní číslice je doplněk mezivýsledku z předchozího kroku (vyznačen modře) do následující celé desítky. 80 a do následující desítky(80) = 0 1.5 Směrování zásilek Pro přepravu zásilek se používá systém směrování a je definováno pomocí směrovacích tabulek. Formát těchto tabulek je popsán dále v oddílech 1.5.1 a 1.5.2. Tabulky jsou 2 KOLLI je dvouciferné číslo, které udává pořadí nákladového kusu v zásilce. 4
GEIS Group 1.5 Směrování zásilek průběžně aktualizovány (nejvýše jednou za měsíc). Aktuální verze tabulek jsou k dispozici ke stažení na FTP serveru GEIS. 3 FTP server: Uživatel: Heslo: Adresář: ftp1.geis.cz ftp_integrace ftp194int integrace Klienti musí umět s těmito tabulkami pracovat, aby byli schopni tisknout na štítcích a odesílat v exportních datech správné hodnoty. Pro směrování přepravy balíkových a cargových zásilek se používají odlišné směrovací tabulky. Pro vnitrostátní a mezinárodní přepravu se používá odlišná struktura směrovacích tabulek, popsaná v oddílech 1.5.1 Vnitrostátní směrování a 1.5.2 Mezinárodní směrování. V přiloženém archivu i na FTP serveru jsou rozřazeny do adresářů Parcel a Cargo. Další informace o pojmenování souborů naleznete v sekci 3.6. 1.5.1 Vnitrostátní směrování V přiloženém archivu naleznete v adresáři Parcel tyto soubory: Parcel_PSC_CZ_Vnitro - směrovací tabulka pro vnitrostátní parcel zásilky zákazníků z České republiky Parcel_PSC_SK_Vnitro - směrovací tabulka pro vnitrostátní parcel zásilky zákazníků ze Slovenska V přiloženém archivu naleznete v adresáři Cargo tyto soubory: Cargo_PSC_CZ_Vnitro - směrovací tabulka pro vnitrostátní cargo zásilky zákazníků z České republiky Cargo_PSC_SK_Vnitro - směrovací tabulka pro vnitrostátní cargo zásilky zákazníků ze Slovenska V souborech jsou směry uloženy na samostatných řádcích. Každý řádek obsahuje různé informace na pozicích uvedených v tabulce 2. Každá informace je popsána v následujícím seznamu. Fixní hodnota: První informace v záznamu je tzv. fixní hodnota. Tento blok má pevně stanovenou hodnotu NT, která je vždy uvedena a není ji třeba nijak zpracovávat. 3 Také jsou odesílány klientům na e-mail kontaktní osoby. 5
GEIS Group 1.5 Směrování zásilek Číslo depa: Toto číslo identifikuje pobočku společnosti Geis, která je přidělena rozsahu PSČ uvedeném na pozicích PSČ od a PSČ do. Uvedená pobočka (depo) v daném rozsahu sváží a nebo doručuje zásilky. Číslo depa v souboru je třímístné, úvodní nula se vždy vypouští. Například pokud je uvedeno číslo depa 088, pak se použije hodnota 88. Kód země: Kód země, pro kterou je uvažován rozsah PSČ uvedený na pozicích PSČ od a PSČ do. Platné kódy viz příloha Tabulka kódů zemí podle ISO-3166. Volné: Takto označená pole jsou ponechána prázdná jsou vyplněna mezerami a nenesou žádnou informaci. Ve formátu jsou pouze z důvodu zvýšení čitelnosti lidmi. PSČ od: V tomto poli je uvedena spodní hranice rozsahu PSČ, se kterým souvisí ostatní informace uvedené v daném řádku. Hodnota je zarovnána zleva. PSČ do: V tomto poli je uvedena horní hranice rozsahu PSČ. Hodnota je zarovnána zleva. 4 Číslo doručovací trasy: Toto číslo identifikuje doručovací trasu přidělenou danému rozsahu PSČ. Interní údaje: Tuto informaci není nutné nijak zpracovávat. Pro přepravy se tato data nevyužívají. V tabulce 2 jsou uvedeny pozice popsaných hodnot v řádku, jejich délka a datový typ (více o datových typech viz oddíl 1.6). # Název bloku Pozice Délka Typ dat 1 Fixní hodnota NT 1 2 AN 2 Číslo depa 3 3 CC 3 Kód země 6 2 AN 4 volné 8 1 AN 5 PSČ od 9 5 AN 6 volné 14 2 AN 7 PSČ do 16 5 AN 8 volné 21 2 AN 9 Číslo doručovací trasy 23 4 CC 10 Interní údaje 27 9 CC Tabulka 2: Struktura záznamů v tabulce pro vnitrostátní směrování. 1.5.2 Mezinárodní směrování V přiloženém archivu v adresáři Parcel tyto soubory: 4 Obě hraniční čísla do intervalu náleží. 6
GEIS Group 1.5 Směrování zásilek Parcel_PSC_CZ_Export - směrovací tabulka pro mezinárodní parcel zásilky zákazníků z České republiky Parcel_PSC_SK_Export - směrovací tabulka pro mezinárodní parcel zásilky zákazníků ze Slovenska V adresáři Cargo naleznete tyto soubory: Cargo_PSC_CZ_Export - směrovací tabulka pro mezinárodní cargo zásilky zákazníků z České republiky Cargo_PSC_SK_Export - směrovací tabulka pro mezinárodní cargo zásilky zákazníků ze Slovenska Směrovací tabulka pro mezinárodní přepravu má informace v řádcích shodné s tabulkou pro vnitrostátní přepravu, liší se jen v pozicích a délkách některých hodnot, jak je zřejmé z tabulky 3. # Název bloku Pozice Délka Typ dat 1 Fixní hodnota NT 1 2 AN 2 Číslo depa 3 3 CC 3 Kód země 6 2 AN 4 volné 8 1 AN 5 PSČ od 9 6 AN 6 volné 15 1 AN 7 PSČ do 16 6 AN 8 volné 22 1 AN 9 Číslo doručovací trasy 23 4 CC 10 Interní údaje 27 9 CC Tabulka 3: Struktura záznamů v tabulce pro mezinárodní směrování. 7
GEIS Group 1.6 Datové typy 1.6 Datové typy V datových souborech a směrovacích tabulkách je třeba vždy formátovat jednotlivé údaje (hodnoty) podle specifikace. Datový typ definuje formát hodnot v datových blocích a záznamech. Mezi nejčastěji používané datové typy patří alfanumerický a celočíselný, často se ale vyskytují i datové typy speciální. Datové typy používané v datových souborech pro cargo a pro parcel se liší a jsou detailně popsány v tomto oddíle. Za názvem každého datového typu je v závorce uvedena zkratka používaná dále v popisu datové strukury. 1.7 Datové typy platné pro balík (parcel) 1.7.1 Alfanumerické hodnoty (AN) Pole s hodnotami tohoto typu mohou obsahovat libovolné znaky abecedy, číslice a speciální symboly(včetně české a slovenské diakritiky). Text musí být zarovnán doleva a všechna prázdná místa musí být vyplněna mezerami do plné délky pole. Příklad: Jméno příjemce Lojza Novák v 20 místném poli: Lojza Novák 1.7.2 Celočíselné hodnoty (CC) Pole s celočíselnými hodnotami mohou obsahovat pouze číslice. Číslo musí být zarovnáno doprava a všechna prázdná místa musí být vyplněna nulami. Příklad: Hmotnost balíku 15000 gramů v 10 místném poli: 0000015000 1.7.3 Číselné hodnoty s desetinnými místy (FP) Pole s hodnotami tohoto typu mohou obsahovat pouze číslice. Desetinná část čísla se neodděluje žádným speciálním symbolem, jsou pro ni vyhrazena dvě místa (viz tučně zvýrazněné číslice v příkladech). Číslo musí být zarovnáno doprava a všechna prázdná místa musí být vyplněna nulami. Příklad: Dobírka 34,50 Kč v 10 místném poli: 0000003450 Příklad: Dobírka 99,- EUR v 10 místném poli: 0000009900 8
GEIS Group 1.8 Datové typy platné pro cargo Příklad: Dobírka 0,- v 10 místném poli: 0000000000 1.7.4 Kalendářní data (KD) Datum je zaznamenáváno do celočíselného pole. Formát data pro balík (parcel) je YYYYMMDD. Příklad: Datum nakládky balíkové zásilky 11. března 2013: 20130311 1.7.5 Telefonní čísla (TC) Telefonní čísla jsou zaznamenávána do alfanumerických polí a mají striktně určený formát. Hodnoty tohoto typu mohou obsahovat pouze znak "+" na svém začátku a dále jen číslice. Telefonní číslo musí být zadáno v mezinárodním formátu (+420xxxxxxxxx). Telefonní číslo musí být zarovnáno doleva a všechna prázdná místa musí být vyplněna mezerami do plné délky pole. Pozor: Číslice nesmí být odděleny mezerami! Celé tel. číslo musí být v jednom souvislém celku. Příklad: Telefonní avízo na číslo (+420) 602 111 222 v mezinárodním tvaru v 15 místném poli: +420602111222 1.8 Datové typy platné pro cargo 1.8.1 Alfanumerické hodnoty (AN) Pole s hodnotami tohoto typu mohou obsahovat libovolné znaky abecedy, číslice a speciální symboly(včetně české a slovenské diakritiky). Text musí být zarovnán doleva. Příklad: Jméno příjemce Lojza Novák v 20 místném poli: Lojza Novák 1.8.2 Celočíselné hodnoty (CC) Pole s celočíselnými hodnotami mohou obsahovat pouze číslice. Číslo musí být zarovnáno doprava a všechna prázdná místa musí být vyplněna nulami. Pokud pole neobsahuje žádná data, zůstává prázdné (např. u doplňkových služeb). 9
GEIS Group 1.8 Datové typy platné pro cargo Příklad: Hmotnost balíku 15 kg v 10 místném poli: 0000000015 1.8.3 Celočíselné hodnoty, číslo zarovnané vpravo (CP) Pole s celočíselnými hodnotami mohou obsahovat pouze číslice. Číslo musí být zarovnáno doprava a prázdná místa (do délky pole) před číslem musí být vyplněna mezerami. Příklad: Odesílatel má PSČ 111 50 v 9 místném poli: 11150 1.8.4 Celočíselné hodnoty, číslo zarovnané vlevo (CL) Pole s celočíselnými hodnotami mohou obsahovat pouze číslice. Číslo musí být zarovnáno doleva a prázdná místa (do délky pole) za číslem musí být vyplněna mezerami. Příklad: Variabilní symbol k zásilce je 20140702 v 10 místném poli: 20140702 1.8.5 Celočíselné hodnoty, číslo doplněné fixní hodnotou (CS) Pole s celočíselnými hodnotami mohou obsahovat pouze číslice. Za číslo se připojí fixní číselná konstanta. Příklad: Číslo zásilky z přiděleného rozsahu je 0701470040014, konstanta je 000: 0701470040014000 1.8.6 Kalendářní data (KD) Datum je zaznamenáváno do celočíselného pole. Formát data pro cargo je DDMMYY. Příklad: Datum nakládky paletové zásilky 11. března 2013: 110313 1.8.7 Časový údaj (KC) Čas je zaznamenáván do celočíselného pole. Formát času je HHMM. 10
GEIS Group 1.8 Datové typy platné pro cargo Příklad: Čas doručení zásilky je 11:30: 1130 1.8.8 Telefonní čísla (TC) Telefonní čísla jsou zaznamenávána do alfanumerických polí a mají striktně určený formát. Hodnoty tohoto typu mohou obsahovat pouze znak "+" na svém začátku a dále jen číslice. Telefonní číslo musí být zadáno v mezinárodním formátu (+420xxxxxxxxx). Telefonní číslo musí být zarovnáno doleva a všechna prázdná místa musí být vyplněna mezerami do plné délky pole. Pozor: Číslice nesmí být odděleny mezerami! Celé tel. číslo musí být v jednom souvislém celku. Příklad: Telefonní avízo na číslo (+420) 602 111 222 v mezinárodním tvaru v 15 místném poli: +420602111222 11
GEIS Group 1.9 Validátor dat 1.9 Validátor dat K ověření správnosti datových souborů je k dispozici validátor dat. Validátor provádí následující kontroly: Kódování datového souboru Struktura datového souboru Formální správnost datových typů Logická správnost datových typů Soulad dat s obchodními podmínkami Směrování Validátor dále umožňuje vypočítat kontrolní číslici pro čárové kódy. Validátor umožňuje kontrolovat datové soubory pro cargo i parcel. Doporučuje se použít tento validátor ještě před prvním odesláním dat ke kontrole do společnosti Geis. Aktuální verze validátoru je zdarma k dispozici na stránkách technické podpory v sekci Ke stažení, kde je i návod pro jeho použití. Stránky technické podpory jsou na adrese www.baliky.cz/podpora nebo www.baliky.sk/podpora. 12
GEIS Group 2. Parcel 2 Parcel V této části manuálu jsou uvedeny všechny informace potřebné pro integraci klientů skupiny Geis využívajících služeb balíkové přepravy Geis Parcel CZ s.r.o. 2.1 Sloučená (hromadná) zásilka O sloučené (hromadné) zásilce hovoříme v případě, kdy je více přepravovaných balíků určeno stejnému příjemci. Každý přepravovaný balík sloučené zásilky má přiděleno vlastní číslo balíku a na štítku je uvedeno číslo balíku z celkového počtu balíků sloučené zásilky, např. 1/2 a 2/2. Související podrobnosti jsou uvedeny níže v této kapitole. 2.2 Specifikace formátu EDI Pro import dat k přepravě balíků do našeho IS je využívána elektronická výměna strukturovaných textových souborů v kódování Windows-1250. Soubor pro přenos dat má strukturu záznamů, uložených na samostatných řádcích. Každý záznam odpovídá jednomu balíku a skládá se z několika datových bloků, jak je naznačeno na obrázku 1. Náhled exportního souboru s vyznačenými datovými bloky ukazuje obrázek 2. Exportní EDI soubor 1 2 3 4 Blok 1 Blok 2 Blok 3 Blok N Blok 1 Blok 2 Blok 3 Blok N Blok 1 Blok 2 Blok 3 Blok N Blok 1 Blok 2 Blok 3 Blok N Záznam pro 1. balík Záznam pro 2. balík Záznam pro 3. balík Záznam pro 4. balík Obrázek 1: Zjednodušené schéma EDI formátu pro parcel. Exportní EDI soubor 1 2 3 4 5 1122162541718221625417180123456782013030120130304015016H... 1122162541718220282913300123456782013030120130304015016H... 1122221759729222217597290123456782013030120130304015017H... 1122221759729222082418560123456782013030120130304015017H... 1122221759729221142825210123456782013030120130304015017H... Obrázek 2: Náhled exportního souboru pro parcel. 13
GEIS Group 2.2 Specifikace formátu EDI 2.2.1 Struktura záznamů Jednotlivé datové bloky mají pevně stanovenou pozici (pořadí), délku a formát dat (viz oddíl 1.7 Datové typy ). Pro některé bloky je také striktně určena hodnota nebo výčet platných hodnot. Všechny tyto informace jsou popsány v seznamu a v tabulce 4 Struktura záznamů v exportním souboru pro parcel dále. Datové bloky v záznamu na sebe těsně navazují, je tedy nutné zajistit, aby zapisované hodnoty nepřekračovaly délku příslušného bloku! Minimální délka záznamu je 317 znaků. Všechny záznamy musejí být stejně dlouhé. V následujícím seznamu datových bloků je uveden význam, přípustné hodnoty a vzájemné závislosti mezi jednotlivými bloky. Za seznamem následuje tabulka, ve které jsou uvedeny především pozice, délky a datové typy bloků. Fixní hodnota: Prvním blokem záznamu je tzv. fixní hodnota. Tento blok má pevně stanovenou hodnotu 11, která musí být vždy uvedena. Číslo zásilky: V případě, že zásilka není sloučená (tzn. obsahuje pouze jeden balík), je tento blok shodný s blokem číslo balíku. Pokud se jedná o sloučenou (hromadnou) zásilku, musí mít záznamy (řádky) pro každý balík patřící do takovéto zásilky shodné číslo zásilky. Toto číslo je určeno prvním (tzv. nadřazeným) balíkem ve sloučené zásilce. Tento záznam se v exportním souboru musí objevit jako první a bude mít shodné hodnoty v blocích číslo zásilky a číslo balíku. Číslo balíku: Vždy musí být uvedeno a musí být z přidělené číselné řady (viz oddíl 1.3). Číslo svozové adresy: Jedinečné identifikační číslo klienta. Po odsouhlasení správnosti exportního souboru bude klientovi přiděleno. Vždy musí být uvedeno. Datum svozu: V tomto bloku musí být uvedeno datum svozu zásilky na naše depo. Datum doručení: Nemusí být uvedeno. Pokud bude uvedeno, jedná se o následující pracovní 5 den od data svozu. Svozové depo: V tomto bloku se uvádí číslo depa, které ze svozové adresy odesílatele sváží zásilky. Zjistí se z poštovního směrovacího čísla svozové adresy odesílatele (viz oddíl 1.5 Směrování ). Vždy musí být uvedeno. Doručovací depo: Zde se uvádí číslo depa, které doručí konkrétní zásilku jejímu příjemci. Zjistí se z poštovního směrovacího čísla příjemce zásilky (viz oddíl 1.5 Směrování ).Vždy musí být uvedeno. Volné: Takto označené datové bloky mají být ponechány prázdné podle svého datového typu mají být vyplněny mezerami nebo nulami. Jedná se o bloky, které v současnosti nenesou žádnou informaci a ve formátu jsou zachovány pouze z důvodu zpětné kompatibility. 5 Je nutné zohlednit víkendy a státní svátky. 14
GEIS Group 2.2 Specifikace formátu EDI Doručovací trasa: Uvádí se číslo doručovací trasy. Vždy musí být uvedeno a zjistí se z poštovního směrovacího čísla příjemce zásilky (viz oddíl 1.5 Směrování ). Jméno firmy/fyzické osoby: V tomto bloku se uvádí jméno příjemce (Firma s.r.o. nebo Lojza Novák v případě režimu B2C viz oddíl 2.5). Vždy musí být uvedeno. Jméno kontaktní osoby: Tento blok je nepovinný. Jméno kontaktní osoby se obvykle uvádí, pokud je v bloku jméno firmy/fyzické osoby uveden název firmy. Ulice, město, stát, PSČ: Adresa příjemce balíku. U všech balíků ve sloučené zásilce musí být shodná. Platné hodnoty pro kód státu u parcel zásilek jsou uvedeny v příloze Tabulka kódů zemí podle ISO-3166. V případě využití služby VM (viz oddíl 2.5) se jedná o adresu Výdejního místa. Hmotnost: Vždy musí být uvedena. Hodnota je uváděna v gramech, minimální hmotnost je 100 gramů. Pokud nebyl balík vážen,tak po schválení obchodním manažerem Geis se může uvádět paušálně 1 kg. Dle obchodních podmínek společnosti Geis Parcel je maximální hmotnost jednoho kusu stanovena na 50 kg. U sloučených zásilek se uvádí hmotnost jednotlivého balíku. Označení doplňkových služeb: V tomto bloku se znakem 1 na příslušných pozicích nastaví požadované doplňkové služby (více viz tabulka 5 dále v tomto oddílu a oddíl 2.5). U sloučených zásilek se vyznačují služby pouze u nadřazeného balíku zásilky. Platba kartou: V tomto bloku se vyznačuje služba Platba kartou (CDR), která umožňuje příjemci zaplatit za dobírkovou zásilku platební kartou. Má smysl pouze ve spojení se službou COD (dobírka) na zásilce. U sloučených zásilek se uvádí pouze u nadřazeného balíku zásilky (tedy balíku, který má shodné číslo zásilky a číslo balíku). Hodnota dobírky: hodnota (částka) dobírky, pokud je balík na dobírku. Hodnota dobírky se vždy udává v měně státu příjemce s přesností na dvě desetinná místa (haléře, centy, apod.). V případě sloučené zásilky s dobírkou, se uvádí celková částka dobírky u nadřazeného balíku zásilky (tedy balíku, který má shodné číslo zásilky a číslo balíku). U ostatních balíků být nesmí, aby odpovídal celkový součet. Dle obchodních podmínek společnosti Geis Parcel je maximální výše dobírky u zásilky stanovena na 200.000 Kč resp. 5.000 EUR. Kód Výdejního místa: V tomto bloku se v závislosti na uvedené službě VM (viz oddíl 2.5) uvádí kód výdejního místa (VM-1234 nebo 1234 ), na které se má zásilka doručit. Zásilka musí obsahovat pouze 1 balík (nesmí být sloučená) a smí mít hmotnost maximálně 15 kg. Variabilní symbol: Pokud je balík na dobírku, je tento údaj povinný. U sloučených zásilek smí být uveden pouze u nadřazeného balíku. Počet balíků v zásilce: Tento blok udává počet balíků v zásilce a je povinný. U sloučených zásilek se uvádí počet balíků ve sloučené zásilce, a to u každého balíku. 15
GEIS Group 2.2 Specifikace formátu EDI Reference: Do tohoto bloku se uvádí zákaznická reference, například číslo objednávky. Toto pole slouží především pro odesílatele, kteří zde mohou uvádět svá evidenční čísla balíků, podle který jsou schopni je dohledat. Tento údaj není povinný. Telefonické avízo/soukromá adresa: V tomto bloku se v závislosti na požadované službě (viz oddíl 2.5) uvádí telefonní číslo v mezinárodním tvaru (viz oddíl 1.8.8). Připojištění: Uvede se hodnota připojištění s přesností na dvě desetinná místa (haléře, centy, apod.), jak je vysvětleno v oddílu 1.7.3. Uvažuje se vždy měna státu odesílatele. Dle obchodních podmínek společnost Geis Parcel ručí za každý balík do hodnoty 50.000 Kč resp. 2.490 EUR. Po dohodě s obchodním manažerem Geis je možné zadávat připojištění zásilek na vyšší hodnoty v tomto bloku. U sloučených zásilek se připojištění uvádí pouze u nadřazeného balíku zásilky. Poznámka pro řidiče: Zde je možné uvést poznámku pro řidiče. Tato poznámka se uvádí také na předávacím protokolu. Poznámka pro příjemce: Zde je možné uvést poznámku pro příjemce. Tato poznámka se uvádí také na štítku pro balík. V případě využití služby VM (viz oddíl 2.5) se zde uvádí skutečná adresa příjmece. Avízo o problematické zásilce: Uvádí se buď e-mailová adresa nebo telefonní číslo (viz oddíl 1.8.8 Telefonní čísla ), kam má být odeslána zpráva v případě problému s doručením zásilky. Avízo o doručené zásilce: Uvádí se buď e-mailová adresa nebo telefonní číslo, kam má být odeslána zpráva při doručení zásilky. Avízo o poškozené zásilce: Uvádí se buď e-mailová adresa nebo telefonní číslo, kam má být odeslána zpráva v případě, že bylo u zásilky zjištěno poškození. Služba POD: Uvádí se e-mailová adresa, na kterou se odešle potvrzený doručovací list. SMS avízo o expedici zásilky: Zde se uvádí telefonní číslo, na které se odešle zpráva o expedici zásilky. 16
GEIS Group 2.2 Specifikace formátu EDI # Název datového bloku Pozice Délka Typ dat Povinný údaj 1 Fixní hodnota 11 1 2 CC Ano 2 Číslo zásilky 3 11 CC Ano 3 Číslo balíku 14 11 CC Ano 4 Číslo svozové adresy 25 9 CC Ano 5 Datum svozu 34 8 KD Ano 6 Datum doručení 42 8 KD Ne 7 Svozové depo 50 3 CC Ano 8 Doručovací depo 53 3 CC Ano 9 volné 56 6 AN 10 Číslo doručovací trasy 62 4 CC Ano 11 volné 66 9 AN 12 Jméno firmy/fyzické osoby 75 30 AN Ano 13 Jméno kontaktní osoby 105 30 AN Ne** 14 volné 135 30 AN 15 Ulice příjemce 165 30 AN Ano 16 Stát příjemce 195 3 AN Ano 17 PSČ příjemce 198 7 AN Ano 18 Město příjemce 205 30 AN Ano 19 Hmotnost 235 10 CC Ano 20 Označení doplňkových služeb 245 10 CC Ano 21 Platba kartou 255 1 CC Ano 22 volné 256 4 AN 23 Hodnota dobírky 260 10 FP Ano* 24 Kód Výdejního místa 270 10 AN Ano* 25 volné 280 12 AN 26 Variabilní symbol 292 10 AN Ano* 27 volné 302 12 AN 28 Počet balíků v zásilce 314 4 CC Ano 29 Reference 318 20 AN Ne 30 volné 338 3 AN 31 Telefonické avízo/soukromá adresa 341 15 TC Ano* 32 Připojištění 356 10 FP Ano* 33 Poznámka pro řidiče 366 57 AN Ne 34 Poznámka pro příjemce 423 57 AN Ne 35 volné 480 20 AN 36 Avízo o problematické zásilce 500 100 AN/TC Ne 37 Avízo o doručené zásilce 600 100 AN/TC Ne 38 Avízo o poškozené zásilce 700 100 AN/TC Ne 39 Služba POD 800 100 AN Ne 40 SMS avízo o expedici zásilky 900 15 TC Ne * Údaj je povinný jen v případě, kdy v bloku označení doplňkových služeb je označena související služba nebo je služba vyžadována. ** POZOR: Tento údaj je povinný v případě, že se jedná o zásilku na výdejní místo. Tabulka 4: Struktura záznamů v exportním souboru pro parcel. 17
GEIS Group 2.2 Specifikace formátu EDI Název služby Zkratka Pozice Délka Hodnota Uvedení v bloku č. 20 Ex Works EXW 246 1 0 / 1 0100000000 Doručení na dobírku COD 247 1 0 / 1 0010000000 Doručení do 12. hodiny D12 249 1 0 / 1 0000100000 Garantované doručení GAR 250 1 0 / 1 0000010000 Připojištění POJ 251 1 0 / 1 0000001000 Soukromá adresa B2C 252 1 0 / 1 0000000100 Výdejní místo VM 254 1 0 / 1 0000000001 Tabulka 5: Označení doplňkových služeb v exportním souboru pro parcel. U služeb typu Avízo a služby POD, které se nezadávají přímo v bloku Označení doplňkových služeb, se uvedením telefonního čísla v příslušném datovém bloku rozumí, že je služba k zásilce vyžadována. Pokud v příslušném bloku není uvedeno nic, služba vyžadována není. U služby Platba kartou (CDR) se uvede hodnota 0 - možnost platby kartou není požadována nebo 1 - možnost platby kartou je požadována. Dostupnost doplňkových služeb v jednotlivých zemích a u různých typů přeprav je uvedena v oddílu 2.5. V přiloženém ZIP archivu v adresáři Parcel je k dispozici příklad exportního souboru Parcel_Data_CTST108c.001, který je v souladu s předávacím protokolem umístěným v příloze Předávací protokol pro parcel. V souboru je uvedeno pět balíků. Dva tvoří sloučenou zásilku a zbylé tři jsou samostatné. Pozor: Využití doplňkových služeb podléhá dohodě mezi zákazníkem a obchodním manažerem firmy Geis Parcel, aktuální podmínky využití služeb jsou uvedeny ve Všeobecných obchodních podmínkách Geis Parcel. 2.2.2 Konvence pro pojmenování exportních souborů Název exportního souboru pro parcel se skládá z několika částí: xxx, dd, m a yyy. Jejich umístění v názvu souboru je následující: Cxxx1ddm.yyy xxx přidělené třímístné ID klienta. Může obsahovat číslice i znaky abecedy. dd den, ve kterém byl soubor exportován (odeslán firmě Geis Parcel CZ s.r.o.). m měsíc, ve kterém byl soubor exportován. Měsíce jsou kódovány na znaky abecedy (leden a, únor b, březen c atd. až prosinec l). yyy přípona exportního souboru. Pokud budou data odesílána jednou za den, nebo s odstupem nejméně 30 minut, je možné odesílat vždy soubor s příponou 001. 18
GEIS Group 2.2 Specifikace formátu EDI V opačném případě je nutné zajistit, aby se číslo v příponě s každým odeslaným souborem během jednoho dne zvyšovalo (tzn. 001, 002... 999 maximálně 999 souborů za den). Příklad: Název exportního souboru pro parcel odeslaného 2. března zákazníkem s ID 565: C565102c.001 Pozor: Název souboru C565102c.001 a C565102c.001.txt není totéž. Pozor: Žádná hromadná zásilka nesmí být rozdělena do více souborů (např. mezi *.001 a *.002). Exportní soubory odeslané později v jednom dni (např. soubor C565102c.002 a popř. také C565102c.003 atd.) mohou, ale nemusí obsahovat záznamy pro balíky, exportované v předcházejících souborech v uvažovaném dni. To znamená, že data exportovaná v souboru C565102c.001 nemusí být obsažena v souborech C565102c.002 ani C565102c.003. Pokud již exportované záznamy jsou v následných souborech znovu obsaženy a údaje zásilek se liší (např. jiný příjemce), tyto záznamy již nebudou importovány ani aktualizovány. 19
GEIS Group 2.3 Struktura předávacího protokolu 2.3 Struktura předávacího protokolu Předávací protokol slouží jako potvrzení o převzetí zásilek k přepravě a má přesně stanovené rozložení jednotlivých částí. Vyhotovuje se ve dvou kopiích jedna pro řidiče a jedna pro odesílatele. V příloze Předávací protokol pro parcel na konci dokumentu je k dispozici náhled podrobně si jej prohlédněte. Protokol má následující povinné části 6. Kontakt na odesílatele: V horní části vlevo musí být úplná adresa klienta. Doporučuje se v tomto místě uvést i telefonní kontakt, ale není povinný. Datum svozu: V horní části uprostřed musí být uveden datum svozu níže sepsaných zásilek a musí být shodný s datem uvedeným v exportním souboru. Kontakt na depo: V horní části vpravo musí být umístěno logo, uvedena adresa a telefonický kontakt na svozové depo. Kontakt na své svozové depo naleznete na webové stránce http://www.geis-group.cz/cz/kontakt po klepnutí na odkaz Balíkové přepravy. Logo naleznete v přiloženém ZIP archivu v adresáři _loga. Počet stran: V protokolu musí být na každé straně uvedeno číslo stránky a celkový počet stran. Soupis balíků: V centrální části je umístěn výčet všech balíků předaných k přepravě. U balíků musí být uvedeny následující údaje: Pozice hodnota udávající pořadí balíku v protokolu. Počáteční hodnota je 1 a postupně pro každý balík roste. Číslo balíku takto označené pole musí obsahovat číslo balíku (viz oddíl 1.3), kontrolní číslici (viz oddíl 1.4) a čárový kód (viz 2.3.1). Adresát adresa příjemce balíku (včetně kódu státu). V případě použití služby VM se jedná o adresu výdejního místa. Připojištění hodnota (částka) připojištění, pokud byl daný balík připojištěn. EXW toto pole obsahuje text Ano, pokud náklady na doručení balíku hradí příjemce. V případě hromadné zásilky, u které hradí náklady příjemce, musí být Ano uvedeno u každého balíku. Sloupec je povinný i když klient službu Ex Works nevyužívá. Dobírka (COD) hodnota (částka) dobírky, pokud je balík na dobírku. Hodnota dobírky se vždy udává v měně státu příjemce s přesností na dvě desetinná místa (haléře, centy, apod.). V případě hromadné zásilky s dobírkou, se uvádí celková částka dobírky u nadřazeného balíku zásilky (tedy balíku, který má shodné číslo zásilky a číslo balíku). U ostatních balíků být nesmí, aby odpovídal celkový součet. 6 Všechny údaje uvedené v náhledu předávacího protokolu v příloze jsou povinné. 20
GEIS Group 2.3 Struktura předávacího protokolu Variabilní symbol identifikátor plateb (obsahuje pouze číslice). V případě dobírky jde o povinný údaj. U sloučených zásilek smí být uveden pouze u nadřazeného balíku. Pokud je uveden u zásilek bez dobírky, údaj se k zásilce nepřenáší. Poznámka uvádí se text poznámky pro řidiče. Stejný text je uveden také v záznamu pro odpovídající balík v exportním souboru (viz blok č. 32 v tabulce 4 Struktura záznamů v exportním souboru pro parcel ). Celkový počet balíků: Pod soupisem balíků je u levého okraje umístěn celkový počet balíků. Celková suma dobírky: Pod tabulkou balíků na pozici sloupce Dobírka (COD) se uvádí celková suma dobírky. Pokud jsou v protokolu uvedeny balíky s dobírkou do více zemí, je součet dobírek pouze číselný (tzn. sčítají se např. eura s korunami bez převodu na společnou měnu). Podpisy: Ve spodní části protokolu musí být umístěny podpisy řidiče a odesílatele společně s textem Výše uvedené zásilky byly předány bez poškození. Patička: Text patičky je uveden v náhledu v příloze Předávací protokol pro parcel. Pozor: Text patičky se v protokolu pro parcel liší od protokolu pro cargo. Sloučené (hromadné) zásilky se v předávacím protokolu nijak nevyznačují. 2.3.1 Čárový kód Na předávacím protokolu je vyžadován čárový kód obsahující číslo balíku včetně kontrolní číslice (viz 1.4 Kontrolní číslice ). Pro čárový kód se používá standard Interleaved 2 of 5 (označovaný také jako I2/5). Je-li například číslo balíku 00121101801 a kontrolní číslice 2, bude v čárovém kódu uloženo číslo 001211018012. Čitelnost čárového kódu Při sestavování protokolu je třeba zajistit, aby čárové kódy byly čitelné. Na obrázku 3 vlevo je příklad nečitelného čárového kódu (kód je příliš úzký). Čárový kód bude čitelný vždy, když jeho šířka bude minimálně 3,5 cm viz příklad vpravo. Také je potřeba dodržet odstup čárového kódu od mřížky tabulky a to minimálně 2mm. 21
GEIS Group 2.4 Specifikace pro tisk štítků Obrázek 3: Ukázka nečitelného (vlevo) a korektního (vpravo) čárového kódu. 2.4 Specifikace pro tisk štítků Každý balík musí být dle všeobecných obchodních podmínek opatřen štítkem (etiketou) náležícím k nabízeným přepravní službám (více o službách viz oddíl 2.5). Pro tisk štítků doporučujeme tiskárnu s podporou jazyka EPL. Štítky je možné tisknout i na laserové tiskárně. Výstup však musí odpovídat dále uvedeným parametrům (velikost, obsah, čitelné čárové kódy, atd.). V ZIP archivu přiloženém k tomuto manuálu je připravena šablona (v adresáři Parcel soubor Parcel_Label_EPL.txt) pro tisk na EPL tiskárnu s rozlišením tiskové hlavy 203dpi. V šabloně stačí nahrazovat výrazy %%VAR_NAME%% skutečnými hodnotami pro dané balíky. K dispozici je také v souboru EPL2_Programming_Manual.pdf 7 manuál pro jazyk EPL2, ve kterém byla šablona vytvořena. Na následujícím obrázku 4 je vyznačeno rozmístění obsahu na štítku a v seznamu za ním jsou uvedeny vysvětlivky. V námi definované šabloně se tisknou texty bez diakritiky, proto je potřeba zadávat textové řetězce bez diakritiky. Při definici vlastní šablony je podpora diakritiky možná viz přiložený EPL manuál. 1. Logo je k dispozici v přiloženém archivu soubor _loga/geis.pcx. V šabloně pro tiskárnu s jazykem EPL je jeho tisk zajištěn nastavením GG630,20, geis na řádku 63. Aby bylo možné logo tisknout, je nutné jej nejprve do tiskárny nahrát. V přiloženém archivu naleznete v adresáři _loga soubor Geis_logo_printer.zip, ve kterém je návod k nahrání loga do tiskárny EPL. 2. Adresa a kontakt na svozové depo. Tyto informace naleznete na webové stránce http://www.geis-group.cz/cz/kontakt po klepnutí na odkaz Balíkové přepravy. V šabloně pro tisk nahraďte následující výrazy odpovídajícími hodnotami. %%SEND_DEPOT_STREET%% na řádku 93 ulice, %%SEND_DEPOT_POSTALCODE%% na řádku 94 PSČ, %%SEND_DEPOT_CITY%% na řádku 94 město, %%SEND_DEPOT_PHONE%% na řádku 95 telefonní číslo, %%SEND_DEPOT_FAX%% na řádku 96 telefonní číslo pro FAX. 7 Manuál není nutné studovat, je přiložen pro ty, kteří chtějí získat hlubší přehled nad tiskovými daty. 22
GEIS Group 2.4 Specifikace pro tisk štítků 154cm f Geis4Parcel4CZ4s.r.o. U4Cementárny41183,47004304Ostrava y Tel.:4+420495142774777 Fax:4+420495142704159 254mm 554mm 6 104cm u Prijemce: FirmajABCjsErEoE JanjNovak fu Lidickaj9u Ejpovice CZjjjjuu7Of f- Pozn:jtextjprojprijemce fm Tel:js-yO9Mffyufyu Odesilatel: f8 NazevjfirmyjsErEoE NejakajulEj9My CZjjjj7u8OyjFrydekdMistek Tel:js-yOuMMOOO7MM f9 f7 KS:fZf f6 VS:jfyffOf798 77O9OOfOOy- M yo yofu 8 7 354mm - M 454mm fueoueyofufo fjkgff uu7offy 9 Obrázek 4: Layout štítku pro parcel. 23
GEIS Group 2.4 Specifikace pro tisk štítků 3. Pruh pro označení služeb. Pokud pro balík nejsou požadovány žádné doplňkové přepravní služby, ponechává se pruh prázdný (viz ukázka štítku na obrázku 8 v příloze manuálu). V opačném případě se v pruhu uvádějí černě podbarvené zkratky služeb oddělené čárkou (viz ukázka štítku na obrázku 10 v příloze manuálu). Vyznačují se jen následující služby: Telefonní avízo ( AVI ), Dobírka ( COD ), Doručení do 12. hodiny ( D12 ), Doručení fyzické osobě ( B2C ), Ex Works ( EXW ), Garantované doručení ( GAR ) a Výdejní místa ( VM-1234 ). Podrobnější popis všech služeb je uveden v oddílu 2.5. V šabloně pro tisk nahraďte výraz %%SERVICES%% na řádku 75 textem, který obsahuje požadované služby (např. pro štítek z obrázku 10 bude na řádku 75 uvedeno B2C,COD,EXW). 4. Číslo balíku. Na této pozici se uvádí jedenáctimístné číslo balíku (viz oddíl 1.3 Číselné řady ). V šabloně pro tisk jím nahraďte na řádku 123 výraz %%TRANSPORT_ID%%. 5. Kontrolní číslice. Na tomto místě se uvádí kontrolní číslice pro číslo balíku (viz oddíl 1.4 Kontrolní číslice ). V šabloně pro tisk jí nahraďte výraz %%TRANSPORT_CHKSUM%% na řádku 124. 6. Čárový kód čísla balíku. Pro čárový kód se používá standard Interleaved 2 of 5 a obsahuje jak číslo balíku, tak i kontrolní číslici (tzn. dvanáctimístné číslo). V šabloně pro tisk nahraďte následující výrazy odpovídajícími hodnotami a čárový kód bude při tisku automaticky vygenerován. %%TRANSPORT_ID%% na řádku 100 číslo balíku, %%TRANSPORT_CHKSUM%% také na řádku 100 kontrolní číslice. 7. Číslo doručovacího depa. Uvádí se číslo depa, které doručí daný balík (zásilku) příjemci. Zjistí se z poštovního směrovacího čísla příjemce (viz oddíl 1.5 Směrování ). V šabloně pro tisk nahraďte výraz %%DEPOT%% na řádku 118 hodnotou získanou ze směrovací tabulky. 8. Číslo doručovací trasy. Číslo doručovací trasy se zjistí z poštovního směrovacího čísla příjemce (viz oddíl 1.5 Směrování ). V šabloně pro tisk nahraďte výraz %%ROUTE%% na řádku 120 hodnotou získanou ze směrovací tabulky. 9. Čárový kód čísla trasy. Pro čárový kód se používá standard Code 39 a obsahuje číslo doručovací trasy. V šabloně pro tisk nahraďte výraz %%ROUTE%% na řádku 120 (viz bod 8 tohoto seznamu) a čárový kód bude při tisku vygenerován automaticky. 10. Datum svozu. Na tomto místě se uvádí datum svozu balíku na naše depo. V šabloně nahraďte výraz %%LOAD%% na řádku 117 odpovídajícím datem ve formátu DD.MM.YYYY. 11. Hmotnost balíku. Pokud balík nebyl vážen, uvádí se hodnota 1 kg. V šabloně nahraďte výraz %%PACKEGE_WEIGHT%% na řádku 122 skutečnou hodnotou. 24
GEIS Group 2.4 Specifikace pro tisk štítků 12. PSČ příjemce. Zde se uvádí poštovní směrovací číslo příjemce, v případě použití služby VM se vyplňuje poštovní směrovací číslo výdejního místa. V šabloně nahraďte výraz %%RECIPIENT_POSTALCODE%% na řádku 121 odpovídajícím PSČ (zadávat bez mezer). 13. Adresa příjemce. V případě použití služby VM je použita adresa výdejního místa, pouze kontaktní osoba je příjemce zásilky. V šabloně pro tisk nahraďte následující výrazy odpovídajícími hodnotami. %%RECIPIENT_NAME%% na řádku 111 jméno firmy / fyzické osoby, %%RECIPIENT_PERSON%% na řádku 112 jméno kontaktní osoby, %%RECIPIENT_STREET%% na řádku 113 ulice příjemce, %%RECIPIENT_CITY%% na řádku 115 město příjemce, %%RECIPIENT_STATE%% na řádku 126 kód státu (všechny platné hodnoty pro parcel zásilky jsou uvedeny v příloze Tabulka kódů zemí podle ISO-3166 ), %%RECIPIENT_POSTALCODE%% na řádku 114 PSČ se stejnou hodnotou jako v bodě 12. 14. Poznámka pro příjemce. Na tomto místě se uvádí poznámka pro příjemce shodná s textem v bloku Poznámka pro příjemce v exportním souboru. V případě použití služby VM se do poznámky vyplňuje adresa příjemce (Ulice, Město a PSČ). V šabloně nahraďte výraz %%NOTE_RCPT%% na řádku 143 odpovídajícím textem. 15. Telefonní číslo příjemce. Tento údaj je nepovinný, nicméně je doporučováno ho uvádět. Při použití služby AVI, B2C, VM je tento údaj naopak povinný. V šabloně nahraďte výraz %%RECIPIENT_PERSON_PHONE%% na řádku 128 odpovídající hodnotou, v případě služby VM se jedná o telefonní číslo skutečného příjemce. 16. Variabilní symbol. Tento údaj je v případě dobírkového balíku povinný. V šabloně nahraďte výraz %%VS%% na řádku 110 odpovídajícím číslem. 17. Pořadí balíku. Uvádí se informace o pořadí daného balíku a celkovém počtu balíků v zásilce. V šabloně pro tisk nahraďte následující výrazy odpovídajícími hodnotami. %%PACKAGE_NR%% na řádku 146 pořadí balíku v zásilce, %%PACKEGE_COUNT%% také na řádku 146 počet balíků v zásilce. Oba údaje se oddělují lomítkem ("/"). U zásilky pouze s jedním balíkem bude výsledná hodnota 1/1. U hromadné zásilky, kde je odesíláno více balíků (např. 3) na jednoho příjemce, pak bude uvedeno postupně na jednotlivých štítcích 1/3, 2/3 a 3/3. 25