DPD směrovací databáze Specifikace Verze 1.3 2013-12-11
DPD směrovací databáze Verze 1.3 2015-04-14
Obsah 1
Úvod ..................................................................................................................................................5
2
Vývojový diagram dat ........................................................................................................................6
3
Tabulky ..............................................................................................................................................7
3.1 Směrování zásilek .........................................................................................................................7 3.1.1 Popis .......................................................................................................................................7 3.1.2 Pole ........................................................................................................................................7 3.1.2.1 Země (DestinationCountry).................................................................................................7 3.1.2.2 PSČ (BeginPostCode, EndPostCode) ................................................................................7 3.1.2.2.1 PSČ není nutné ............................................................................................................8 3.1.2.2.2 Země bez PSČ .............................................................................................................8 3.1.2.3 Kódy služeb (ServiceCodes) ..............................................................................................8 3.1.2.4 Směrovací místa (Routing Places) .....................................................................................9 3.1.2.5 Datum odeslání (Sending date) ........................................................................................10 3.1.2.6 Vstupní třídění (O-Sort) ....................................................................................................10 3.1.2.7 Cílové depo (D-Depot) ......................................................................................................10 3.1.2.8 Priorita seskupení (Grouping Priority) ..............................................................................11 3.1.2.9 Výstupní třídění (D-Sort) ...................................................................................................11 3.1.2.10 ID čárového kódu (Barcode ID) ........................................................................................11 3.1.3 Pravidla .................................................................................................................................11 3.1.4 Porozumění obsahu tabulky .................................................................................................11 3.1.4.1 Výchozí směrování ...........................................................................................................12 3.1.4.2 Směrování s výjimkou na službu ......................................................................................12 3.1.4.3 Směrování s výjimkou na směrovací místo ......................................................................12 3.1.5 Příklad ..................................................................................................................................13 3.1.6 Vyhledávací algoritmus (Search algorithm) .........................................................................14 3.1.7 Vývojový diagram vyhledávání .............................................................................................15 3.2 Služby ..........................................................................................................................................16 3.2.1 Popis .....................................................................................................................................16 3.2.2 Pole ......................................................................................................................................16 3.2.2.1 Textový kód služby (Service Text) ....................................................................................16 3.2.2.2 Značka služby (Service Mark) ..........................................................................................16 3.2.2.3 Elementy služby (Service Elements) ................................................................................16 3.2.3 Příklad ..................................................................................................................................16 3.3 Země ............................................................................................................................................17 3.3.1 Popis .....................................................................................................................................17 3.3.2 Pole ......................................................................................................................................17 3.3.2.1 ISO kód číselný .................................................................................................................17 3.3.2.2 ISO kód krátký ..................................................................................................................17 3.3.2.3 ISO kód dlouhý .................................................................................................................17 3.3.2.4 Jazyky ...............................................................................................................................17 3.3.2.5 Příznak PSČ .....................................................................................................................17 3.3.3 Příklady .................................................................................................................................17 3.4 Depa ............................................................................................................................................18 3.4.1 Popis .....................................................................................................................................18 3.4.2 Pole ......................................................................................................................................18 3.4.2.1 Kód depa...........................................................................................................................18 3.4.2.2 Pseudo IATA kód ..............................................................................................................18
DPD_smerovaci_databaze
Strana 2 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.4.2.3 ID skupiny dep ..................................................................................................................18 3.4.2.4 Ostatní sloupce .................................................................................................................18 3.4.3 Pravidla .................................................................................................................................19 3.4.4 Vývojový diagram formátování země ...................................................................................19 3.4.5 Příklad ..................................................................................................................................20 3.5 Informační text o službě (Service Field Info) ...............................................................................21 3.5.1 Pole ......................................................................................................................................21 3.5.2 Příklad ..................................................................................................................................21 3.6 Lokace .........................................................................................................................................22 3.6.1 Popis .....................................................................................................................................22 3.6.2 Pole ......................................................................................................................................22 3.6.3 Příklad ..................................................................................................................................22 4
Soubory ...........................................................................................................................................23
4.1 Záhlaví .........................................................................................................................................23 4.1.1 Název souboru .....................................................................................................................23 4.1.2 Verze ....................................................................................................................................23 4.1.3 Konec platnosti .....................................................................................................................23 4.1.4 Hash .....................................................................................................................................23 4.1.5 Reference .............................................................................................................................23 4.1.6 Pole ......................................................................................................................................23 4.1.7 Klíč ........................................................................................................................................24 4.2 5
Data .............................................................................................................................................24 Databáze .........................................................................................................................................25
5.1
Vytvoření ......................................................................................................................................25
5.2
Distribuce .....................................................................................................................................25
DPD_smerovaci_databaze
Strana 3 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
Verze
Verze 1.2
Verze 1.3
Změny Přidán přehled změn Aktualizace příkladů Kapitola 2: Aktualizován diagram Kapitola 3.3.1: Aktualizován popis PSČ Kapitola 3.5: Nové vysvětlení obsahu tabulek Kapitola 3.8: Aktualizován diagram Kapitola 3.11.2.2: Aktualizovány Gateway Depa Kapitola 3.11.3: Aktualizace pravidel Kapitola 3.11.4: Nové: Formátování schéma Kapitola 4.1.3: Smazáno Kapitola 5.3: Smazáno Kapitola 3.3: Aktzalizován popis polí Kapitola 3.3.1: Aktualizováno použití PSČ Kapitola 3.4: Přidána nova pravidla Kapitola 3.8: Aktualizován diagram Kapitola 3.9.2.3: Aktualizace Service Elements Kapitola 3.10.2: Aktualizace popisu pole Kapitola 3.11.2: Aktualizace popisu pole
Reference Dokument
Verze
Vydáno
DPD štítek a čárový kód
Verze 2.1
11.12.2013
ISO 3166, http://www.iso.org
Verze 2
8. 3. 2004
ISO 639, http://www.iso.org
60.60
18. 7. 2002
SHA-1, http://www.ietf.org/rfc/rfc3174.txt
DPD_smerovaci_databaze
září 2001
Strana 4 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
1
Úvod
Tento dokument popisuje rozhraní souborů DPD směrovací databáze. Obsahuje specifikace každé tabulky a jejího využití, možnou spolupráci jednotlivých tabulek, strukturu souborů a popis procesů a distribuce databáze uvnitř systému. Databáze je určena ke společnému užívání společností DPD a jejími partnery a je proto také nazývána „The Common Routing Database“ (Společná směrovací databáze).
DPD_smerovaci_databaze
Strana 5 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
2
Vývojový diagram dat
Diagram znázorňuje procesy a pořadí procesů nutných pro nasměrování zásilky. Dále pak poskytuje přehled požadovaných vstupních parametrů a výstupních parametrů poskytovaných databází.
DPD_smerovaci_databaze
Strana 6 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3
Tabulky
Všechny tabulky budou poskytnuty ve formátu popsaném v kapitole “Soubory”.
3.1
Směrování zásilek
Směrovací tabulka se používá pro určení cílového depa a zároveň poskytuje informace o třídění O-Sort (vstupní třídění, svozová trasa), D-Depot (cílové depo), D-Sort (výstupní třídění, rozvozová trasa) a GroupingPriority (typ řazení). Tato kombinace hodnot, unikátní vůči odesílající zemi, PSČ a typu služby, se nazývá obecně směrování. Používá se během procesu označení štítkem a třídění. Před použitím směrovací tabulky je nutné parametry ověřit použitím tabulek zemí (COUNTRY), dep (DEPOTS) a služeb (SERVICE). 3.1.1
Popis
Název souboru: Typ: 3.1.2
ROUTES Povinný
Pole
Název pole Země Od PSČ Do PSČ Kódy služeb Směrovací místa Datum odeslání Vstupní třídění Cílové depo Priorita seskupení Výstupní třídění ID čárového kódu
ID sloupce v tabulce DestinationCountry BeginPostCode EndPostCode ServiceCodes RoutingPlaces SendingDate O-Sort D-Depot GroupingPriority D-Sort BarcodeID
Formát 2A 9 A/N 9 A/N TEXT TEXT TEXT 4 A/N 4 A/N 1 A/N 4 A/N 3N
Klíč A A A A A A N N N N N
Volitelné . N N A A A A A N A A N
3.1.2.1 Země (DestinationCountry) Pole země (DestinationCountry) obsahuje kód cílové země jako písmennou zkratku o délce 2 znaků. Přehled zemí je uveden v tabulce COUNTRY. 3.1.2.2 PSČ (BeginPostCode, EndPostCode) Pole BeginPostCode a EndPostCode určují rozsah PSČ pro něž je definováno určité směrování. V případě, že je směrování definováno pro jediné PSČ, je uvedeno pouze BeginPostCode a EndPostCode je prázdné. Pokud země určení nemá žádný systém poštovních směrovacích čísel nebo operátoři PSČ dané země či oblasti neznají, je možné PSČ vyhledat v tabulce Lokace. V případě zemí, které systém PSČ nemají je třeba propojit obě tabulky volitelným poštovním směrovacím číslem. Týká se Irska.
DPD_smerovaci_databaze
Strana 7 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.1.2.2.1
PSČ není nutné
Pokud ke směrování balíků není PSČ potřeba, například proto že celá cílová země je obsluhována jediným depem (např. Zimbabwe) nebo jedna služba v cílové zemi je obsluhována jediným depem (jako Express International na Slovensku), obě pole “BeginPostCode” a “EndPostCode” mohou být prázdná. Pokud jsou obě pole prázdná, mechanismus směrování akceptuje jako vstupní parameter jakékoliv PSČ (včetně prázdných hodnot). Mohou se vyskytovat záznamy s PSČ i bez nich. Příklad: V tomto příkladu všechny balíky služby Express International na Slovensko vyhovují prvnímu řádku (S jako ServiceCode, kód 302 vyhovuje rozpětí 302-303) a pro všechny ostatní služby je nutné najít záznam s vyhovujícím PSČ Řádek
3.1.2.2.2
01 02 03 V nn
SK|||S299,S302303|… SK|01000|01299||… SK|01300|01311||… SK|99141|99142||…
Země bez PSČ
Pokud cílová země nemá systém PSČ, směrovací databáze implementuje dva způsoby jak se s tím vypořádat: Skupina GeoPost definuje fiktivní PSČ. Tento způsob je použit, pokud v cílové zemi je více jak jedno doručující depo. GeoPost definuje sadu fiktivních PSČ které musí být zadány uživateli nebo zvolena lokace z tabulky LOCATION pro nalezení správného záznamu z tabulky ROUTES. Fiktivní PSČ bude zadáno do tabulky ROUTES jako skutečné PSČ v případě zemí které systém PSČ mají. PSČ není nutné ke směrování balíku. Postup podle kapitoly 3.3.2.1 3.1.2.3 Kódy služeb (ServiceCodes) Pole kódů služeb definuje pravidlo pro vyjmenované služby, které mohou být zaslány na místo určení (viz příklad níže). Pravidlo se skládá ze seznamu hodnot, vzájemně oddělených čárkou. Použitelné hodnoty jsou: Element ServiceCode
Zápis hodnota rozsah
Syntaxe Saaa Sbbbccc
Popis Příklad S101 a = hodnota S101150 b = počáteční hodnota rozsahu c = koncová hodnota rozsahu Seznam všech použitelných kódů je uveden v tabulce SERVICE. Intervaly obsahující neplatné kódy služeb budou zakázány. V zájmu úspory místa a snížení komplexity je možné pole „Service Codes" nevyplňovat. Je-li pole prázdné, bude záznam použit pro všechny kódy služeb, které se nevyskytují v ostatních záznamech. Prvnímu řádku příkladu níže odpovídají zmíněné běžné zásilky a druhému všechny zásilky s expresní a/nebo garantovanou dobou doručení. Všechny ostatní služby odpovídají přednastavené hodnotě třetího řádku: Řádek
01 02 03
DE|63860|63870|S101154,S289292|… DE|63860|63870|S155288,S299,S302314|… DE|63860|63870||…
DPD_smerovaci_databaze
Strana 8 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.1.2.4 Směrovací místa (Routing Places) Pole Směrovací místa definuje pravidlo pro lokalitu odesílatele, ze které je tato konkrétní služba odesílána, tedy místo ze kterého je o směrování rozhodováno (viz příklad níže). Hodnota pole se skládá ze seznamu hodnot, vzájemně oddělených čárkou. Použitelné hodnoty jsou: Element Depot code
Zápis hodnota rozsah
Syntaxe Daaaa Dbbbbcccc
Country code Depot group *
hodnota hodnota
Caa Gaaaa
Popis a = hodnota kódu depa b = počáteční hodnota rozsahu dep c = koncová hodnota rozsahu dep a = single ISO 2 alpha country code a = single depot group (Freetext)
Příklad D0402 D04010408 CFR GE01A
Seznam všech použitelných kódů (čísel) dep (Depot code), skupin dep (Depot group) a kódů zemí (Country codes) je uveden v tabulce DEPOTS jako GeoPostDepotNumber, GroupID a ISOAlpha2CountryCode. Pro vyhodnocení pravidel směrovacích míst a následné zjištění směrování je nutné znát tyto hodnoty patřících k odesílajícímu depu (domovskému depu zákazníka). Intervaly obsahující nesprávné kódy dep budou zakázány. Hodnota „Depot code“ pracuje se skutečným kódem depa, ne s kódem ve formátu IATA. Elementární kódy zemí či skupiny dep nahrazují dlouhé seznamy jednotlivých čísel dep. Pro test lze rozdělit jednotlivé země do samostatných řádků. Není používána žádné upřednostňování mezi řádky. V zájmu úspory místa a snížení komplexity je možné pole "Routing Places" nevyplňovat. Je-li pole prázdné, bude záznam použit pro všechna směrová místa, která se nevyskytují v ostatních záznamech. Příklad: Balík je odesílán do Německa (DE) na PSČ z rozsahu mezi 63860 až 63870. Hledáme pravidlo, které platí pro lokalitu odesílatele. První řádek příkladu odpovídá všem depům v Německu, Dánsku, hlavnímu překladišti Velké Británie (0550), některému z vyjmenovaných dep ve Francii nebo některému depu skupiny E01A. Druhý řádek odpovídá všem depům skupin DAFR a DSAM, hlavnímu překladišti v Mexiku a dále pak také některým dalším Mexickým depům. Třetí řádek odpovídá všem ostatním depům, která neodpovídají žádnému z ostatních řádků. Tedy například pokud je odesílatel z Aschaffenburgu a tedy spadá pod depo 0163, patřícím do skupiny GPDE a nacházející se v zemi DE, pak pro něj platí první řádek Řádek
01 02 03
DE|63860|63870|S101|CDE,CDK,D0550,D04010408,GE01A|… DE|63860|63870|S101|GDAFR,GDSAM,D0069,D06900693|… DE|63860|63870|S101||…
DPD_smerovaci_databaze
Strana 9 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.1.2.5 Datum odeslání (Sending date) Pole Datum odeslání (Sending Date) může být použito k podmínění záznamu určitým datem (Date), dnem v týdnu (Weekday) či časem (Time). Pole může sestávat z několika z následujících prvků: Element Date
Zápis maska
Syntaxe Dyyyymmdd
Popis y = rok, m = měsíc, d = den maska může obsahovat zástupný znak '?'
Weekday
hodnota
Wa
rozsah
Wbc
maska
Tohhmm
a = číslo dne v týdnu 1 odpovídá pondělí b = počátek rozsahu dnů v týdnu c = konec rozsahu dne v týdnu 1 odpovídá pondělí o = operátor který může být: je rovno = menší < menší nebo rovno <= větší > větší nebo rovno >= h = hodina m = minuta
Time
1
*)
Příklad D????1224 D????06?? D2010???? *1 *2 W1 *3
W15
T<1200 T>1200 T=1200 *4
První příklad odpovídá každému Štědrému dni, druhý příklad odpovídá každému dni v červnu a třetí každému dni v roce 2010. Příklad odpovídá dnu pondělí Příklad odpovídá dnům od pondělí do pátku První příklad odpovídá dopoledni, druhý odpoledni a třetí příklad odpovídá poledni.
2
*) 3 *) 4 *)
K vytvoření logického výrazu je možné použít:
plus (+) jako logické or multiply (*) jako logické and
Výraz podléhá pravidlům logické algebry (and je nadřazené or). V příkladu níže odpovídá první řádek pátečnímu dopoledni, druhý pak pátečnímu odpoledni a třetí řádek pátečnímu poledni. Řádek
01 02 03
DE|63860|63870|S101|D0401|W5*T<1200|… DE|63860|63870|S101|D0401|W5*T>1200|… DE|63860|63870|S101|D0401|W5*T=1200|…
Je-li pole prázdné, zastupuje záznam všechna data a dny, které se nevyskytují v ostatních záznamech. 3.1.2.6 Vstupní třídění (O-Sort) Pole Vstupní třídění (O-Sort) obsahuje DPD číslo trasy, která daný balík sváží. 3.1.2.7 Cílové depo (D-Depot) Pole Cílové depo (D-Depot) obsahuje DPD kód depa, nikoliv kód ve formátu IATA. Na toto depo je směrován balík, jehož adresa v určité zemi a PSČ vyhovuje podmínkám kódů služeb, směrovacích
DPD_smerovaci_databaze
Strana 10 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
míst a datu odeslání. Země příjemce a cílové depo tvoří informaci nazývanou „hlavní směrování“ které je uvedeno na DPD přepravním štítku. Příklad: Cílová adresa je stát CZ, PSČ 11150. Vyhovující záznam je CZ|11150||||||1391||B830|37| Tedy cílové depo je 1391 3.1.2.8 Priorita seskupení (Grouping Priority) Priorita seskupení je typ řazení, který je použit v některých komplikovanějších směrováních, kdy je balík vícekrát překládán v rámci DPD sítě. Pokud je uvedena priorita seskupení, je nutné hlavní směrování doplnit o tzv. přepravní cestu. Informace Přepravní cesta je složena z IATA kódu Cílového depa, které lze vyhledat v tabulce DEPOTS, a priority seskupení vyhovujícího řádku z tabulky ROUTES. Příklad: Cílová adresa je stát FR, PSČ 72460. Vyhovující záznam (pro odesílatele v CZ) je FR|72460|||VCCZV |||1072|X|061|37| Priorita seskupení je přitomná, hodnota X, IATA kód cílového depa 1072 z tabulky DEPOTS je 072, tedy hlavní směrování je FR-1072-072X 3.1.2.9 Výstupní třídění (D-Sort) Pole Výstupní třídění (D-Sort) obsahuje DPD číslo trasy, která na Cílovém depu rozváží balík ke konečnému příjemci. Příklad: Cílová adresa je CZ, PSČ 11150. Vyhovující záznam je CZ|11150||||||1391||B830|37| Tedy Výstupní třídění je B830 3.1.2.10 ID čárového kódu (Barcode ID) ID čárového kódu (Barcode ID) označuje ASCII hodnotu znaku (např.: 37 = %). Takto získaný identifikátor, musí být v čárovém kódu vytištěn na prvním místě. 3.1.3
Pravidla
Kód země se musí vyskytovat v tabulce kódů zemí (COUNTRY). Je-li vyplněno pole Do PSČ (EndPostCode), musí být jeho hodnota větší než Od PSČ (BeginPostCode). Kódy služeb (Service codes) musí být zahrnuty v tabulce kódů služeb (SERVICE). Kód depa ve směrovacích místech se musí vyskytovat v tabulce dep (DEPOTS). Kód cílového depa se musí vyskytovat v tabulce dep (DEPOTS). Každý speciální záznam, výjimka definovaná přítomností jednoho nebo více polí Kódy služeb („Service Codes“), Směrovací místa („Routing Places“) a Datum odeslání („Sending Date“) musí mít přednastavenou hodnotu. Každá kombinace země („Country code“), PSČ („Single postcode“), kódu služby („Single service code“), směrovací místo („Single routing place“) a data odeslání („Sending date“) musí být jedinečná. Tzn. že se po rozložení každé řádky na jednotlivé kombinace země, PSČ, služby, směrového místa a data odeslání nesmí objevit duplicitní záznam.
3.1.4
Porozumění obsahu tabulky
Směrovací tabulka ROUTES je založena na výchozím směrování a směrování výjimek. Následující vysvětlení mají pomoci vysvětlit, jak jsou pole vyplněna:
DPD_smerovaci_databaze
Strana 11 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.1.4.1 Výchozí směrování Výchozí směrování reprezentuje cíl balíku pro většinu služeb a odesílajících dep. Výchozí směrování bude použito pro všechny služby a směrovací místa, pro které není definována výjimka pravidly uvedenými v polích kódů služeb a směrovacích míst. Výchozí směrování je vždy uvedeno s prázdným polem kódů služeb a prázdným polem směrovacích míst. Příklad 1: Všechny balíky z dep skupiny GeoPost / DPD do Uzbekistánu jsou předávány přes jednoho partnera, potřebujeme pouze výchozí směrování do Uzbekistánu Příklad 2: Všechny balíky z dep skupiny GeoPost / DPD na nizozemská PSČ 1000 až 1199 jdou přes cílové depo 0516, potřebujeme pouze výchozí směrování pro tato PSČ. 3.1.4.2 Směrování s výjimkou na službu Směrování s výjimkou na službu definuje první úroveň výjimek ve směrovací tabulce. Tyto výjimky budou použity, pokud některé služby mají jiné směrování. Např. expresní služby mohou být doručovány vyhrazenou rozvozovou linkou. Směrování s výjimkou na službu má vyplněno pole kódů služeb. Příklad: Sobotní doručení v Německu (S228) v Německu zajišťují jiné rozvozové linky, proto mají tyto služby jiné směrování zajištěné uvedením směrování s výjimkou na službu. 3.1.4.3 Směrování s výjimkou na směrovací místo Směrování s výjimkou na směrovací místo definuje druhou úroveň výjimek ve směrovací tabulce. Tato výjimka bude zohledněna, pokud pro stejnou službu a cílové místo existuje více směrování než 1 výchozí směrování. Směrování s výjimkou na směrovací místo má vyplněno pole Směrovací místa. Příklad: Balík směřující z místa ve Francii na jiné místo ve Francii je směrován přímo, používá tedy výchozí směrování. Ale balík směřující z České republiky do Francie prochází na vstupu do Francie přes centrální vstupní překladiště, proto mají tyto služby jiné směrování zajištěné uvedením směrování s výjimkou na směrovací místo.
DPD_smerovaci_databaze
Strana 12 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.1.5
Příklad
#Filename: ROUTES #Version: 20050101 #Update: 20050301 #Expiration: 20050430 #Hash: 7bb39bb530ad0954f8faea585ebea23f40d5a010 #Reference: http://georout.geopost.com/R20050101/common/reference.txt #Fields: DestinationCountry|BeginPostCode|EndPostCode|ServiceCodes|RoutingPlaces|SendingDate| O-Sort|D-Depot|GroupingPriority|D-Sort|BarcodeID| #Key: DestinationCountry|BeginPostCode|EndPostCode|ServiceCodes|RoutingPlaces|SendingDate| FR|05000|05999|S101154,S289292|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|7|11|37| FR|05000|05999|S101154,S289292|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|12|37| FR|05000|05999|S101154,S289292|GDAFR,GDSAM,D0069,D06900693|W15||0446|7|13|37| FR|05000|05999|S101154,S289292|GDAFR,GDSAM,D0069,D06900693|W67||0446|7|14|37| FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|2|15|37| FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|16|37| FR|05000|05999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W15||0446|2|17|37| FR|05000|05999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W67||0446|7|18|37| FR|05000|05999|||||0446|7|10|37| FR|06000|06999|S101154,S289292|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|7|21|37| FR|06000|06999|S101154,S289292|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|22|37| FR|06000|06999|S101154,S289292|GDAFR,GDSAM,D0069,D06900693|W15||0446|7|23|37| FR|06000|06999|S101154,S289292|GDAFR,GDSAM,D0069,D06900693|W67||0446|7|24|37| FR|06000|06999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|2|25|37| FR|06000|06999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|26|37| FR|06000|06999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W15||0446|2|27|37| FR|06000|06999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W67||0446|7|28|37| FR|06000|06999|||||0446|7|20|37| DE|63869|63871||||51|0163||03|37| DE|63872|63875||||52|0163||07|37| GB|B661AA|B661ZZ||||PL08|0550|4|B131|37| GB|B661AA|B661ZZ||||PL09|0550|5|B131|37|
Poznámka: Toto je pouze část tabulky ROUTES. Aktuální verzi naleznete na www.dpd.cz/rdb
DPD_smerovaci_databaze
Strana 13 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.1.6
Vyhledávací algoritmus (Search algorithm)
Před používáním vyhledávacího algoritmu směrovací tabulky je potřeba k místu odesílatele určit odesílající depo, ze kterého je směrování vyhledáváno, a pomocí tabulky dep (DEPOTS) určit jeho zemi („routing depot country“) a skupinu dep („depot group“). Příklad: Z místa v Německu, PSČ 20095, je odesílán balík do Francie, PSČ 05123 Vstupní data pro směrování: Odesílající země: DE Odesílající depo: 0120 Skupina dep: DDEN Cílová země: FR Cílové PSČ: 05123 Kód služby: 191 Den odeslání: 2 (úterý) Vyberte všechny záznamy s cílovou zemí „Francie“, jejichž interval obsahuje cílové PSČ: FR|05000|05999|S101154,S289292|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|7|11|37| FR|05000|05999|S101154,S289292|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|12|37| FR|05000|05999|S101154,S289292|GDAFR,GDSAM,D0069,D06900693|W15||0446|7|13|37| FR|05000|05999|S101154,S289292|GDAFR,GDSAM,D0069,D06900693|W67||0446|7|14|37| FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|2|15|37| FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|16|37| FR|05000|05999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W15||0446|2|17|37| FR|05000|05999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W67||0446|7|18|37| FR|05000|05999|||||0446|7|10|37|
Pokud by existoval pouze jediný záznam s výchozím směrováním, bylo by použito výchozí směrování. Protože je ale záznamů více, je třeba zohlednit výjimky. Vyberte tedy všechny záznamy s odpovídajícím kódem služby. Pokud byl záznam nalezen, pokračujte ve vyhledávání nad daným záznamem nebo skupinou záznamů. Nebyl-li záznam nalezen, vyberte všechny ostatní záznamy. Pro službu 191 byly nalezeny tyto záznamy: FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|2|15|37| FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|16|37| FR|05000|05999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W15||0446|2|17|37| FR|05000|05999|S155288,S299,S302314|GDAFR,GDSAM,D0069,D06900693|W67||0446|7|18|37|
Z nich vyberte všechny záznamy obsahující odesílající zemi, odesílající depo nebo jeho skupinu. Pokud byl záznam nalezen, pokračujte ve vyhledávání nad daným záznamem nebo skupinou záznamů. Nebyl-li záznam nalezen, vyberte všechny ostatní záznamy. Pro odesílající zemi DE byly nalezeny tyto záznamy: FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|2|15|37| FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W67||0446|7|16|37|
Vyberte všechny záznamy s odpovídajícím datem odeslání. Pokud byl záznam nalezen, pokračujte ve vyhledávání nad daným záznamem nebo skupinou záznamů. Nebyl-li záznam nalezen, vyberte všechny ostatní záznamy. Pro den odeslání úterý byl nalezen tento záznam: FR|05000|05999|S155288,S299,S302314|CDE,CDK,D0550,D04010408,GDBNL|W15||0446|2|15|37|
Je-li výsledkem více než jeden záznam, muselo dojít k chybě ve vyhledávání nebo ve směrovací tabulce. Výstupní data směrování použitá na přepravním štítku balíku tedy jsou: Vstupní třídění O-sort prázdné Cílové depo D-Depot 0446 Priorita seskupení GroupingPriority 2 Hlavní směrování Routing text FR-0446-NCE2 Výstupní třídění D-Sort: 15 ID čárového kódu Barcode ID 37 DPD_smerovaci_databaze
Strana 14 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.1.7
Vývojový diagram vyhledávání
Níže zobrazený diagram postupu vyhledávání ve směrovací tabulce (ROUTES), který znázorňuje potřebné vstupní údaje, postup vyhledávání a výstupní údaje poskytnuté databází.
DPD_smerovaci_databaze
Strana 15 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.2
Služby
Tabulka služeb (SERVICE) slouží k ověření existence číselného kódu služby (Service Code), jeho převedení do textového kódu dané služby (Service Text), která bude vytištěna na štítku, zjištění případné značky služby (Service Mark) a k vyhledání elementů ze kterých se služba skládá (Service Elements). 3.2.1
Popis
Název souboru: Typ: 3.2.2
SERVICE Povinný
Pole
Název pole
ID sloupce v tabulce
Formát
Klíč
Číselný kód služby Textový kód služby Značka služby Elementy služby
ServiceCode ServiceText ServiceMark ServiceElements
3N 16 A/N 1A TEXT
A N N N
Volit elné . N N A N
Komentář viz: Textový kód služby viz: Značka služby viz: Elementy služby
3.2.2.1 Textový kód služby (Service Text) Textový kód služby (Service Text) musí být vytištěn na štítku coby čitelná písmenná zkratka, popisující číselný kód služby (Service Code) dané zásilky a tím jeho vlastnosti 3.2.2.2 Značka služby (Service Mark) Je-li pole Značka služby (Service Mark) vyplněné, musí být tento znak vytištěn na štítku. Značka služby (Service Mark) slouží coby nápověda při ručním třídění a označuje speciální a malé zásilky. 3.2.2.3 Elementy služby (Service Elements) Každá služba, reprezentovaná kódem služby, může sestávat z mnoha elementů. (Service elements). Ty definují vlastnosti, ze kterých se daná služba skládá. Pole Elementy služby (Service elements) zobrazuje seznam čárkou oddělených kódů elementů služby (service element codes). Elementy služby poskytují pouze doplňkové informace a nejsou v zásadě při směrování potřebné. Jejich smyslem je popis funkčních vlastností dané služby. Jejich přehled naleznete v samostatném dokumentu. 3.2.3
Příklad
#Filename: SERVICE #Version: 20050501 #Update: #Expiration: 20050831 #Hash: 6bf328d6afe450618888656a2e6b9adf5facc5e9 #Reference: http://georout.geopost.com/R20050101/common/reference.txt #Fields: ServiceCode|ServiceText|ServiceMark|ServiceElements| #Key: ServiceCode| 150|D-COD+|X|002,100,900| 151|D-COD-6+|X|002,100,120,900| 152|D-SWAP+|X|002,110,900| 153|D-SWAP-6+|X|002,110,120,900| 154|PARCELLetter||005| 155|PM2||010|
DPD_smerovaci_databaze
Strana 16 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.3
Země
Tabulka zemí (COUNTRY) slouží k ověření kódů zemí, k převodu kódů zemí na zkratku země, která bude vytištěna na štítku, k vyhledání jazyků používaných v příslušné zemi a také ke zjištění zemí, které nemají systém PSČ. 3.3.1
Popis
Název souboru: Typ: 3.3.2
COUNTRY Povinný
Pole
Název pole
ID sloupce v tabulce
Formát
Klíč
ISO kód číselný ISO kód krátký ISO kód dlouhý Jazyky Příznak PSČ
ISO-NumCountryCode ISO-Alpha2CountryCode ISO-Alpha3CountryCode DestinationLanguages FlagPostCodeNo
3N 2A 3A TEXT 1N
A N N N N
Volitelné . N N N A N
Komentář
Nemá systém PSČ
3.3.2.1 ISO kód číselný Označení země hodnotou číselného kódu podle normy ISO 3166 3.3.2.2 ISO kód krátký Označení země hodnotou písmenného kódu v krátké variantě podle normy ISO 3166 3.3.2.3 ISO kód dlouhý Označení země hodnotou písmenného kódu v dlouhé variantě podle normy ISO 3166 3.3.2.4 Jazyky Zobrazení seznamu čárkou oddělených jazyků používaných v dané zemi. Seznam sestává z hodnot odpovídajících normě ISO 639. 3.3.2.5 Příznak PSČ Zobrazuje hodnotu 1, pokud daná země NEMÁ systém PSČ 3.3.3
Příklady
#Filename: COUNTRY #Version: 20050101 #Update: 20050301 #Expiration: 20050430 #Hash: 8611cb7c40956cfec34efef297129fe3c664834f #Reference: http://georout.geopost.com/R20050101/common/reference.txt #Fields: ISO-NumCountryCode|ISO-Alpha2CountryCode|ISOAlpha3CountryCode|DestinationLanguages|FlagPostCodeNo| #Key: ISO-NumCountryCode| 056|BE|BEL|FR,NL|0| 250|FR|FRA|FR|0| 276|DE|DEU|DE|0| 372|IE|IRL|GA,EN|1|
DPD_smerovaci_databaze
Strana 17 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.4
Depa
Tabulka dep (DEPOTS) se využívá pro ověření kódů dep, k přiřazení kódu depa ke kódu ve formátu IATA, pokud je na štítku hlavní směrování včetně přepravní cesty, zjištění skupiny depa a v případě potřeby také k získání adresy depa. 3.4.1
Popis
Název souboru: Typ: 3.4.2
DEPOTS Povinný
Pole
Název pole
ID sloupce v tabulce
Formát
Klíč
Kód depa Pseudo IATA kód ID skupiny dep Jméno 1 Jméno 2 Adresa 1 Adresa 2 PSČ Město Země
GeoPostDepotNumber IATALikeCode GroupID Name1 Name2 Address1 Address2 PostCode CityName ISOAlpha2CountryCode Phone Fax Mail WEB
4 A/N 3 A/N TEXT 35 A/N 35 A/N 35 A/N 35 A/N 9 A/N 60 A/N 2A
A N N N N N N N N N
Volit elné . N A A N A A A N A N
35 A/N 35 A/N 35 A/N 35 A/N
N N N N
A A A A
Telefon Fax Mail WEB
Komentář bez Priority seskupení viz: ID skupiny dep
3.4.2.1 Kód depa DPD číslo depa, unikátní identifikátor pobočky v přepravní síti. 3.4.2.2 Pseudo IATA kód Textová zkratka napodobující IATA kód pro jedinečnou identifikaci lokality. 3.4.2.3 ID skupiny dep ID skupiny dep poskytuje možnost seskupovat depa se stejnou charakteristikou směrovacího místa, například skupina dep státu, geografické oblasti, nebo dopravce. Pole sestává ze seznamu čárkou oddělených ID skupiny dep. Každé ID skupiny dep se skládá ze čtyř znaků a/nebo čísel. 3.4.2.4 Ostatní sloupce Ostatní sloupce obsahují údaje adresa a kontaktní údaje daného depa. Pokud pro určité přepravní trasy je vstupním depem pro cílovou zemi překladiště, pak se jedná o tzv. gateway depo a PSČ může být fiktivní.
DPD_smerovaci_databaze
Strana 18 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.4.3
Pravidla
IATA kód spravuje cílová země. Není-li pole IATA kód vyplněno, nebude informace přepravní cesta složená z IATA kódu a priority seskupení zobrazena na štítku. V normalizované formě adresy jsou povoleny pouze znaky ze základní ASCII tabulky, bez diakritických znamének či dalších specifických znaků. Pole PSČ bude použito pro směrování balíku, proto musí být vyplněno bez neplatných znaků, tedy bez mezer, pomlček a lomítek. Smí obsahovat pouze čísla a velká písmena.
3.4.4
Vývojový diagram formátování země
V diagramu níže můžete vidět proces vyhledání správné země pro vytištění hlavní směrovací informace (Routing Text) na štítku. Tento dodatečný test je nutný vzhledem k existenci speciálních případů, kdy je některé oblast doručována jinou zemí. Příklad: Malá alpská vesnice Kleinwallsertal patří k Rakousku (země AT, PSČ 6992), ale kvůli přístupnosti údolí pouze z území Německa je doručována německým depem (směrování v ROUTES je na depo 0287), takže hlavní směrovací informace bude DE-0287 (D-Depot pro cíl AT 6992 je 0287, kód země depa 0287 v DEPOTS je DE)
DPD_smerovaci_databaze
Strana 19 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.4.5
Příklad
#Filename: DEPOTS #Version: 20050501 #Update: #Expiration: 20050831 #Hash: 4ab4a8197abd2bb126d8ed4b14a59b3e57875320 #Reference: http://georout.geopost.com/R20050101/common/reference.txt #Fields: GeoPostDepotNumber|IATALikeCode|GroupID|Name1|Name2|Address1|Address2|PostCode|CityName| ISOAlpha2CountryCode|Phone|Fax|Mail|WEB| #Key: GeoPostDepotNumber| 0160|FRA|DDEM,EEUM,EDEM|Depot 0160|DPD Zeitfracht GmbH & Co. KG|Kelsterbacher Str. 64||65479|Raunheim|DE||||| 0408|MSY|DFRM,EEUM|Depot 0408|Chronopost S.A.|21, Rue Du Perou|Zi Du Perou|91300|Massy|FR||||| 0550|BHX|DUK0|Depot 0550|DPD (UK) Ltd. c/o GeoPost UK Ltd.|Roebuck Lane|Smethwick Warley|B66 1BY|West Midlands|GB|||||
DPD_smerovaci_databaze
Strana 20 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.5
Informační text o službě (Service Field Info)
Tabulka SERVICEINFO slouží jako zdroj správných údajů do pole „Service field info“ na štítku. Tato část štítku obsahuje informační text o službě, lidsky čitelný textový název. Tabulky budou poskytnuty ve více jazycích, což umožňuje tisk v lokálním jazyce. Pro češtinu je název tabulky SERVICEINFO.CS Název souboru: Typ: 3.5.1
SERVICEINFO.XX Volitelný
Pole
Název pole Číselný kód služby Informační text o službě
3.5.2
(kde 'XX' představuje kód jazyka dle ISO 639)
ID sloupce v tabulce ServiceCode ServicefFieldInfo
Formát 3N 100 A/N
Klíč A N
Volitelné . N A
Komentář
Příklad
#Filename: SERVICEINFO.CS #Version: 20130902 #Expiration: 20140105 #Hash: 755fd81761d0474d68f00ff70ce4516fa8fef173 #Reference: http://extranet.dpd.de/georoute/references_dpd_20130902.txt #Fields: ServiceCode|ServiceFieldInfo| #Key: ServiceCode| 102|nebezpecne zbozi / hazardous goods| 103|sobota /saturday| 106|ex works nebezpecne zbozi / ex works hazardous goods| 109|dobirka / C.O.D.| 110|dobirka nebezpecne zbozi / C.O.D. hazardous goods| 113|vymena / exchange|
DPD_smerovaci_databaze
Strana 21 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
3.6
Lokace
Tabulka lokací (LOCATION) se používá při směrování v zemích bez systému PSČ. Pomáhá operátorům při vyhledávání správných fiktivních poštovních směrovacích čísel pomocí názvu oblasti nebo města. 3.6.1
Popis
Název souboru: Typ: 3.6.2
LOCATION.XX Volitelný
(kde 'XX' představuje kód jazyka dle ISO 639)
Pole
Název pole
ID sloupce v tabulce
Formát
Klíč
Oblast Město Země Fiktivní PSČ
AreaName CityName ISO-Alpha2CountryCode PostCode
35 A/N 35 A/N 2A 9 A/N
A A N N
3.6.3
Volit elné . A N N N
Komentář
Příklad
#Filename: LOCATION.CS #Version: 20130902 #Expiration: 20140105 #Hash: 6f7eff135d73b9bf60bc6d9c983313d8811fbcb2 #Reference: http://extranet.dpd.de/georoute/references_dpd_20130902.txt #Fields: AreaName|CityName|ISO-Alpha2CountryCode|PostCode| #Key: AreaName|CityName| |Dublin|IE|1| |Irsko mimo Dublin|IE|2|
DPD_smerovaci_databaze
Strana 22 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
4
Soubory
Všechny soubory tabulek jsou poskytovány jako textové soubory v základním ASCII, pole jsou řetězce s variabilní délkou.
4.1
Záhlaví
Každý soubor začíná standardním záhlavím, které poskytuje veškeré informace sloužící k identifikování obsahu tabulky a její validaci. Tyto informace jsou uloženy v řádcích označených dvojicí slov # PARAMETR:HODNOTA. Formát data verze, aktualizace a konce platnosti má hodnotu YYYYMMDD. 4.1.1
Název souboru
Po parametru Filename následuje název souboru tabulky, v některých případech určující i použitý jazyk. 4.1.2
Verze
Po parametru Version následuje datum vydání základní tabulky, které je označením dané verze. Databáze je aktualizována každé čtyři měsíce, nová verze začíná vždy první pracovní pondělí v lednu, květnu a září. 4.1.3
Konec platnosti
Po parametru Expiration následuje datum konce platnosti základní tabulky (poslední den platnosti). 4.1.4
Hash
Po parametru Hash je 160 Bit SHA-1 hodnota reprezentující obsah souboru vyjma záhlaví. Pro vyvarování chyb při výpočtu algoritmu budou vynechány CR znaky (ASCII 0x0D). Tento „Hash“ může být použit pro kontrolu, zda soubor nebyl při přenosu porušen. Obsah 160 Bit bude reprezentován hexadecimálním řetězcem malými písmeny o délce 40 Byte. Obsah „Hash“ bude vytvořen a může být zkontrolován originálním SHA-1 algoritmem který je definován v RFC3174. 4.1.5
Reference
Parametr Reference je následován URL cestou k originálnímu obsahu „Hash“ daného souboru. Tento odkaz umožňuje zkontrolovat, zda se souborem nebylo neoprávněně manipulováno třetí stranou. Zobrazená URL je pouhým příkladem a může být v konečné podobě „Routing Database“ změněna. 4.1.6
Pole
Za parametrem Fields následuje znaky „pipe“ („|“) oddělený seznam názvů sloupců dané tabulky.
DPD_smerovaci_databaze
Strana 23 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
4.1.7
Klíč
Za parametrem Key následuje znaky „pipe“ („|“) oddělený seznam názvů sloupců, které reprezentují primární klíč. Ten je potřeba pro vkládání, aktualizování či odstraňování údajů z tabulky.
4.2
Data
Po řádcích záhlaví následují datové řádky. Jednotlivá pole jsou uvedena jako text s variabilní délkou, pole jsou oddělená znakem „pipe“ („|“), pořadí a obsah polí jsou popsány v řádku Fields.
DPD_smerovaci_databaze
Strana 24 / 25
DPD směrovací databáze Verze 1.3 2015-04-14
5
Databáze
5.1
Vytvoření
Společná směrovací databáze je vytvářena a spravována službou centrální databanky.
5.2
Distribuce
Databáze je poskytována ve formátu ZIP. Archiv s názvem RDB obsahuje všechny soubory databáze. Archiv s názvem ROUTES obsahuje pouze tabulku ROUTES. Název archivu dále obsahuje číslo verze, tedy datum počátku platnosti.: Příklad RDB_20130902.ZIP Archiv obsahuje kompletní směrovací databázi ve verzi platné od 2.9.2013 DŮLEŽITÉ: Za účelem správnosti tištěných štítků, je každý zákazník, který si databázi sám tiskne, povinen stáhnout a nainstalovat nově platné soubory ihned po vypršení platnosti souborů starých.
DPD_smerovaci_databaze
Strana 25 / 25