Manuál pro systémovou integraci

Transkript

1 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 nebo

2 Obsah Účel dokumentu Přehled změn Seznam obrázků Seznam tabulek v vi vii vii 1 Obecné informace Úprava informačního systému zákazníka Druhy přeprav Číselné řady Kontrolní číslice Směrování zásilek Vnitrostátní směrování Mezinárodní směrování Datové typy Datové typy platné pro balík (parcel) Alfanumerické hodnoty (AN) Celočíselné hodnoty (CC) Číselné hodnoty s desetinnými místy (FP) Kalendářní data (KD) Telefonní čísla (TC) Datové typy platné pro cargo Alfanumerické hodnoty (AN) Celočíselné hodnoty (CC) Celočíselné hodnoty, číslo zarovnané vpravo (CP) Celočíselné hodnoty, číslo zarovnané vlevo (CL) Celočíselné hodnoty, číslo doplněné fixní hodnotou (CS) i

3 1.8.6 Kalendářní data (KD) Časový údaj (KC) Telefonní čísla (TC) Validátor dat Parcel Sloučená (hromadná) zásilka Specifikace formátu EDI Struktura záznamů Konvence pro pojmenování exportních souborů Struktura předávacího protokolu Čárový kód Specifikace pro tisk štítků Doplňkové přepravní služby pro parcel zásilky Avízo o doručené zásilce - ADZ Služba POD Avízo o problémové zásilce - APZ SMS avízo o expedici zásilky - SMS Telefonické avízo - AVI Doručení na dobírku - COD Doručení do 12. hodin - D Doručení fyzické osobě - B2C Ex Works - EXW Garantované doručení - GAR Připojištění - POJ Platba kartou - CDR Výdejní místo - VM Ověření správnosti dat a dokumentů - parcel Ostrý provoz ii

4 3 Cargo Specifikace formátu EDI Struktura záznamů Konvence pro pojmenování exportních souborů Struktura předávacího protokolu Specifikace pro tisk štítků Doplňkové přepravní služby pro cargo zásilky SMS avízo - SMS Telefonické avízo - AVI Dobírka - COD Termínované doručení - DTR B2C (Soukromá adresa) EXW (Platba příjemcem) DL zpět - VDL Smlouvy zpět - VSM B2C Dodání s pomocí - B2P B2C Odvoz spotřebiče - B2S VIP doručení - VIP Ověření správnosti dat a dokumentů - cargo Ostrý provoz Symboly a zkratky 50 Přílohy 51 Předávací protokol pro parcel Předávací protokol pro cargo Předávací protokol pro parcel Předávací protokol pro cargo Náhledy štítků pro balíky Náhledy štítků pro cargo iii

5 Checklist pro podklady - parcel Checklist pro podklady - cargo Tabulka kódů zemí podle ISO Seznam kódů manipulačních jednotek Změna pojmenování souborů se směrovacími tabulkami iv

6 Úč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

7 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/ Změna dostupnosti služeb pro jednotlivé země (CDR) / Doplněna služba Výdejní místa 2.5 Přidání slovenské verze Předávacího protokolu Přílohy 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čí / Ú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

8 Seznam obrázků 1 Zjednodušené schéma EDI formátu pro parcel Náhled exportního souboru pro parcel Ukázka nečitelného (vlevo) a korektního (vpravo) čárového kódu Layout štítku pro parcel Schéma záznamů ve formátu KDDS Popis záznamů ve formátu KDDS Layout štítku pro cargo Náhled štítku pro balík bez doplňkových služeb Náhled štítku pro balík s dobírkou Náhled štítku pro balík více doplňkových služeb Náhled štítku pro balík služba VM Náhled štítku pro cargo zásilka se třemi kusy Náhled štítku pro cargo zásilka se třemi kusy Náhled štítku pro cargo zásilka se třemi kusy Seznam tabulek 1 Přehled změn v dokumentaci vi 2 Struktura záznamů v tabulce pro vnitrostátní směrování Struktura záznamů v tabulce pro mezinárodní směrování Struktura záznamů v exportním souboru pro parcel Označení doplňkových služeb v exportním souboru pro parcel Dostupnost služeb dle druhu přepravy - parcel Označení doplňkových služeb v exportním souboru pro cargo Dostupnost služeb dle druhu přepravy - cargo vii

9 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 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_ftp 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

10 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

11 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 a Řada tedy vystačí přesně pro balíků. První balík bude mít číslo , druhý balík bude mít číslo atd. Stotisící balík bude mít číslo U přidělené číselné řady se nelze spolehnout na návaznost na předchozí řadu ani na společný prefix. 3

12 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 , číslo KOLLI pro první nákladový kus je 01. Kontrolní číslice se počítá z čísla ) Sečtou se zvlášť číslice na lichých a na sudých pozicích = = 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 Kontrolní číslice se počítá pouze z čísla balíku ) Sečtou se zvlášť číslice na lichých a na sudých pozicích = = 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) = 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) = 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 a Tabulky jsou 2 KOLLI je dvouciferné číslo, které udává pořadí nákladového kusu v zásilce. 4

13 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 Vnitrostátní směrování a 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 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 kontaktní osoby. 5

14 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 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í 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

15 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

16 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) 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 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 gramů v 10 místném poli: Čí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: Příklad: Dobírka 99,- EUR v 10 místném poli:

17 GEIS Group 1.8 Datové typy platné pro cargo Příklad: Dobírka 0,- v 10 místném poli: 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: 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) v mezinárodním tvaru v 15 místném poli: Datové typy platné pro cargo 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 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

18 GEIS Group 1.8 Datové typy platné pro cargo Příklad: Hmotnost balíku 15 kg v 10 místném poli: 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Č v 9 místném poli: 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 v 10 místném poli: 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 , konstanta je 000: 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: Časový údaj (KC) Čas je zaznamenáván do celočíselného pole. Formát času je HHMM. 10

19 GEIS Group 1.8 Datové typy platné pro cargo Příklad: Čas doručení zásilky je 11:30: 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) v mezinárodním tvaru v 15 místném poli:

20 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 nebo 12

21 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 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 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 H H H H H... Obrázek 2: Náhled exportního souboru pro parcel. 13

22 GEIS Group 2.2 Specifikace formátu EDI 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

23 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 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 Kč resp 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

24 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 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 Kč resp 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ď ová adresa nebo telefonní číslo (viz oddíl 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ď ová 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ď ová 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 ová 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

25 GEIS Group 2.2 Specifikace formátu EDI # Název datového bloku Pozice Délka Typ dat Povinný údaj 1 Fixní hodnota CC Ano 2 Číslo zásilky 3 11 CC Ano 3 Číslo balíku 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 AN Ano 13 Jméno kontaktní osoby AN Ne** 14 volné AN 15 Ulice příjemce AN Ano 16 Stát příjemce AN Ano 17 PSČ příjemce AN Ano 18 Město příjemce AN Ano 19 Hmotnost CC Ano 20 Označení doplňkových služeb CC Ano 21 Platba kartou CC Ano 22 volné AN 23 Hodnota dobírky FP Ano* 24 Kód Výdejního místa AN Ano* 25 volné AN 26 Variabilní symbol AN Ano* 27 volné AN 28 Počet balíků v zásilce CC Ano 29 Reference AN Ne 30 volné AN 31 Telefonické avízo/soukromá adresa TC Ano* 32 Připojištění FP Ano* 33 Poznámka pro řidiče AN Ne 34 Poznámka pro příjemce AN Ne 35 volné AN 36 Avízo o problematické zásilce AN/TC Ne 37 Avízo o doručené zásilce AN/TC Ne 38 Avízo o poškozené zásilce AN/TC Ne 39 Služba POD AN Ne 40 SMS avízo o expedici zásilky 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

26 GEIS Group 2.2 Specifikace formátu EDI Název služby Zkratka Pozice Délka Hodnota Uvedení v bloku č. 20 Ex Works EXW / Doručení na dobírku COD / Doručení do 12. hodiny D / Garantované doručení GAR / Připojištění POJ / Soukromá adresa B2C / Výdejní místo VM / 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 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

27 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, 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

28 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 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

29 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í Čá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 a kontrolní číslice 2, bude v čárovém kódu uloženo číslo Č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

30 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 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

31 GEIS Group 2.4 Specifikace pro tisk štítků 154cm f Geis4Parcel4CZ4s.r.o. U4Cementárny41183, Ostrava y Tel.: Fax: mm 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 mm - M 454mm fueoueyofufo fjkgff uu7offy 9 Obrázek 4: Layout štítku pro parcel. 23

32 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 Čá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

33 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ě 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