Zákaznická SW řešení Obecný úvod Verze 2015-04-10
Obsah 1 Úvod...3 2 Tisk přepravních štítků z vlastního SW...4 2.1 Přepravní štítek...4 2.2 Datový soubor MPSEXPDATA...4 2.3 Identifikace klienta...5 2.4 DPD směrovácí databáze...5 2.5 Produkty...5 2.6 Číselná řada...5 2.7 Tištěný seznam zásilek...6 3 Webové služby DPD...6 4 Objednávka sběrných služeb...6 4.1 Datový formát CRDATA01...6 4.2 Přenos dat...7 4.3 Zpětná vazba...7 5 Zpracování informací o skenech...8
1 Úvod Tento dokument je obecným úvodem do tvorby vlastních zákaznických řešení pro tisk štítků a datovou komunikaci mezi společností DPD CZ a jejími zákazníky. Tato vlastní řešení zajišťují 3 základní tematické okruhy: Tisk přepravních štítků k zásilkám a poskytnutí dat o těchto zásilkách, pomocí funkcí vlastního software nebo s využitím webových služeb Objednávka sběrných služeb (Sběrný balík a Import) Zpracování informací o skenech STATUSDATA Následující kapitoly popisují základní vlastnosti jednotlivých témat. Zmiňované detailní specifikace a vzory naleznete na webu www.dpd.cz/dokumentace
2 Tisk přepravních štítků z vlastního SW DPD CZ poskytuje svým zákazníkům zdarma software pro tisk přepravních štíků a související datovou komunikaci. Pokud funkcionalita těchto SW není vyhovující, nebo zákazník vyžaduje větší integraci těchto funkcí se svým informačním systémem, může tisk přepravních štítků a související datovou komunikaci zajistit vlastním řešením. V takovém případě musí být vytvořeno takové řešení, které umožní zejména evidovat identifikační údaje klienta (zákaznické číslo, adresy, DelisID) provádět nastavení použitých produktů evidovat přidělenou číselnou řadu, pro tisk štítků z ní přiřazovat unikátní čísla a upozornit uživatele před jejím vyčerpáním vyhledávat DPD směrování ve směrovací databázi tisknout DPD štítky vyhovující specifikaci, včetně požadovaných čárových kódů k zásilkám generovat datový soubor formátu MPSEXPDATA a přenášet jej na vyhrazené FTP 2.1 Přepravní štítek Přepravní štítek obsahuje adresu příjemce, odesílatele a odesílajícího depa. Dále obsahuje číslo balíku, označení DPD produktu, údaje o směrování, případné související doplňkové (např. dobírkové údaje), identifikační (vlastní reference, hmotnost, složení) a servisní údaje (odkaz na VOP, datum čas a způsob tisku). Pro strojové zpracování obsahuje štítek 2 čárové kódy. Náležitosti štítku popisuje dokument DPD štítek a čárový kód. Tisk DPD štítků lze zajistit buď definicí tiskového výstupu odpovídajícího specifikaci, nebo použitím EPL skriptu pro tiskárny Zebra, jehož definice je dostupná v poskytnutých vzorech. 2.2 Datový soubor MPSEXPDATA Datový soubor MPSEXPDATA obsahuje údaje o zásilkách a balících. Formát je popsán v dokumentu Datový formát MPSEXPDATA. Ten je úplným popisem možností. Konkrétní produkty používají vždy pouze některé části formátu, nutné součásti jsou popsány ve vzorech. Vždy je uvedena hlavička a zakončení, údaje o zásilce (HEADER) a balících z nichž se skládá (PARCEL). Podle vlastností služby jsou uvedeny další doplňková data, např. dobírkové údaje (COD), údaje o výměnné zásilce (SWAP), osobním doručení (PERS) nebo avizacích (MSG). Zpracování neumožňuje použití české diakritiky, z textových údajů je nutné znaky s českou diakritikou převést na ekvivalent bez diakritiky (základní ASCII). Při vytváření a přenosu je nutné dodržet tento postup - datový soubor je vytvořen na lokálním disku. Pokud je datový soubor kompletní a úplný, je vytvořen ve stejném umístění tzv. souborový semafor. To je soubor shodného názvu, irelevantního obsahu, s příponou.sem. Na úrovni souborového systému plní funkci příznaku, který umožňuje další zpracování. V následujícím přenosu
na FTP jsou přenášeny všechny datové soubory ke kterým je přítomen semafor. Nejprve je přenesen datový soubor. Pokud je přenos kompletní a správný, což je ověřeno např. kontrolou na shodu velikosti zdroje a cíle, je přenesen semafor. Pokud je přenesen semafor, oba soubory jsou na straně DPD převzaty ke zpracování a z FTP zmizí. Ve zdroji pak může být semafor odstraněn, datový soubor přejmenován na.done a archivován v adresáři /archiv/rok/mesic/den. Adresa FTP je ftp-c.dpd.de, aktuálně 94.125.28.140. Přihlašovacími údaji je DelisID a k němu příslušné heslo. Každé zákaznické číslo / DelisID má tedy vlastní vyhrazení FTP. Soubory jsou nahrávány do kořenového adresáře FTP. 2.3 Identifikace klienta Klient v systému DPD je identifikován unikátním zákaznickým číslem, které je uvedeno v datovém souboru. K němu je přiřazeno tzv. DelisID, sloužící jako identifikátor v elektronických službách. Je uvedeno v datovém souboru, jeho názvu a je také použito jako login pro Zákaznické FTP. Oba údaje obdržíte od obchodního zástupce DPD. 2.4 DPD směrovácí databáze DPD směrovací databáze, routing database, zkráceně RDB, je sada tabulek poskytující informace o depech v DPD síti (DEPOTS), nastavení produktů (SERVICE a SERVICEINFO.CS), zemí (COUNTRY) a zejména směrování (ROUTES). RDB je aktualizována 3x ročně. Její platnost je vždy od prvního pracovního pondělí v lednu, květnu a září, přesné datum je uvedeno v hlavičce tabulek. SW zákazníka musí být schopný aktualizovat načtením souboru alespoň tabulku ROUTES. Ta obsahuje DPD směrování, tedy informace o rozvozovém depu a trase, vůči zemi a PSČ příjemce. Ostatní nastavení může být, zejména v případě že se předpokládá použití pouze malého a neměnného počtu služeb nebo zemí příjemců, řešeno vlastními zjednodušenými číselníky. Jednotlivé tabulky a způsob vyhledávání směrování je popsán v dokumentu DPD směrovací databáze. RDB je poskytována prostřednictvím webu www.dpd.cz/rdb Nová verze je poskytnuta vždy minimálně týden před začátkem platnosti. Předpokládá se stanovení osob odpovědných za aktualizaci RDB a proto proces stažení a aktualizace má probíhat ručně. Směrování vytištěné na štítku má odpovídat verzi platné v den tisku. 2.5 Produkty Produkt v DPD systému, tedy zásilka určitých parametrů, je v DPD systému definována trojicí údajů číselným kódem (ServiceCode), písmennou zkratkou (ServiceText) a plnotextovým názvem (ServiceFieldInfo). Tyto údaje jsou definovány v tabulkách SERVICE a SERVICEINFO.CS a použity na přepravním štítku a v datovém souboru. 2.6 Číselná řada Zásilka je logická jednotka přepravy, shodných parametrů a směřujících k jednomu příjemci. Balík je fyzické balení (krabice, karton). Jeden nebo více balíků tvoří zásilku. Pro unikátní označení balíku je
použito 14ti místné číslo. Zákazník obdrží číselnou řadu definovanou rozsahem dvou 14ti místných čísel. Tento rozsah eviduje ve vlastním systému a přiděluje z tohoto rozsahu pro jednotlivé balíky unikátní čísla. Musí být zajištěno, že nedojde k opakování použití číselné řady nebo přetečení (použití čísla za tímto rozsahem). Vhodné také je, pokud systém upozorní uživatele na fakt, že číselná řada je téměř vyčerpána (např. posledních 15,10 a 5%) a umožní mu včas vyžádat si řadu novou. 2.7 Tištěný seznam zásilek K dennímu objemu zásilek, opatřených štítky, je vytištěn seznam zásilek. Tento dokument obsahuje identifikaci odesílatele, depa, datum a čas vytištění, software, verzi směrovací databáze, počet balíků. Dále obsahuje seznam zásilek / balíků (číslo balíku, DPD produkt, adresu příjemce, případně referenční údaj. DPD kurýr tento dokument podepisuje při převzetí (svozu) zásilek a tím potvrzuje jejich převzetí. 3 Webové služby DPD Tvorbu vlastního řešení může zjednodušit využití webových služeb poskytovaných DPD. Ty nabízejí funkcionalitu pro tisk štítků, správu zásilek, objednávek svozu a seznamu zásilek. To snižuje objem vývoje na straně vlastního software, což je vykoupeno závislostí na aktuálně dostupné funkcionalitě, dostupnosti služeb a rychlosti odezvy. Nabídka webových služeb je popsána v samostatném dokumentu Webové služby DPD. 4 Objednávka sběrných služeb Sběrné služby jsou doplňkovou službou umožňující přepravu z objednaného místa vyzvednutí (mimo standardní místo svozu balíků opatřených štítky tištěnými zákazníkem) na libovolnou adresu. Jsou realizovány pod názvy Sběrný balík (místo svozu v CZ) nebo Import (místo svozu ve vybraných zemích mimo CZ). Zákazník objedná přepravu prostřednictvím datového souboru CRDATA01. DPD vytiskne přepravní štítek, na adrese vyzvednutí převezme zásilku k přepravě a doručí ji na adresu příjemce. Objednávka neobsahuje směrování, to je vyhledáno při zpracování objednávky a přípravě štítku na straně DPD. Lze ale použít pouze platné PSČ, tedy takové které je obsaženo v tabulce ROUTES, což je nutné při vytváření objednávky ověřit. 4.1 Datový formát CRDATA01 Datový formát CRDATA01 obsahuje údaje o adrese vyzvednutí, adrese doručení a doplňující informace, například reference objednávky. Zpracování neumožňuje použití české diakritiky,
z textových údajů je nutné znaky s českou diakritikou převést na ekvivalent bez diakritiky (základní ASCII). Formát je popsán v dokumentu Datový format CRDATA01 a souvisejících vzorech. 4.2 Přenos dat Datový soubor s informacemi o objednávce je odeslán na Zákaznické FTP podle zásad popsaných v bodě 2.2. Kvůli odlišnému procesu zpracování je FTP pro přenos sběrných balíků (svozy v CZ) 195.47.89.194 a FTP pro přenos importů (svozy v zahraničí) 94.125.28.140. 4.3 Zpětná vazba Na základě poskytnutých údajů jsou objednávky realizovány. Na vyžádání lze poskytovat zpětnou vazbu. Pro Sběrné balíky lze poskytovat jednoúčelové reporty o zpracovaných objednávkách, tedy přiřazených číslech balíků, a seznamy o svezených a nesvezených zásilkách, a to e-mailem nebo na jakékoliv FTP. Pro import lze poskytovat informace o stavech zpracování objednávky v datovém souboru CRDATA02, popsaném v dokumentu Datový formát CRDATA02 a souvisejících vzorech, a informace o událostech v životním cyklu balíku jsou poskytovány v datovém souboru STATUSDATA, popsaném v kapitole 4. Oba tyto datové formáty jsou poskytovány pouze na Zákaznické FTP.
5 Zpracování informací o skenech DPD poskytuje zpětnou vazbu o zásilkách dvojím způsobem. Buď jsou poskytována interpretovaná data, tedy jednoúčelové reporty o zásilkách zákazníka, které mají nějaký stav, například svezeno, doručeno, nedoručeno. Takové reporty jsou zasílány e-mailem nebo nahrávány na libovolné FTP. Nebo jsou na Zákaznické FTP poskytovány datové soubory STATUSDATA, které obsahují kompletní surová data o provedených skenech, tedy událostech v životním cyklu balíku. Použitím vyhodnocovací logiky lze data interpretovat a dosáhnout tak vytvoření vlastní kopie webu pro sledování zásilek DELIStrack nebo vlastních reportů. Soubory jsou poskytovány standardně 2x denně, nebo častěji, maximálně ale 1x za hodinu. Obsah souboru je popsán v dokumentu Datový formát STATUSDATA a souvisejících vzorech.