myAPI_Dokumentace_v2.4.130918.pdf

PPL EDI DOKUMENTACE

Vypracoval:

Jaroslav Fňukal

Schválil:

Podpis Datum:

Ředitel pro správu ICT

Podpis

13.09. 2018

Datum:

ORIGINÁL Tento dokument dokument je duševním vlastnictvím společnosti PPL. Rozmnožování a předávání třetí straně bez souhlasu jejího majitele není dovoleno.

Datum poslední poslední revize: 13.09.2018 Strana 1 (celkem 65)

© PPL CZ s.r.o.

1

Soupis revizí Číslo revize

Datum platnosti

1

13.5.2016

Lokace revize

Popis revize

Revizi provedl / podpis

- Upřesnění na zadávání PS v datech.

4.2.5 CreatePackages

- Upřesnění pro PPL Sprint – routovací – routovací tabulka

Fňukal

- Reálné přík lady lady XML na konci dokumentu 2

- Nové vzory etiket, etiket, váženek - Nové směry / trasování trasování zahraničních zásilek zásilek

12.9.2016

3

26.9.2016

5.2 Číselník produktů

4

25.10.2016

7 Samples

-

Doplněny nové produkty - Změna telefonního čísla na etiketách . z 840 775 77 5 na 225 331 500

5

7.11.2016

6 Chybové hlášení 5.8 Číselník flagů 4.2.1 GetParcelShops 4.2.5 CreatePackages

Doplnění nových error codes + sjednocení Upřesnění flagů a služby SD - Doporučený čas aktualizace u 4.2.1 - Doporučení deklarovat SD nad každou zásilkou – (sekce (sekce

Fňukal Fňukal Fňukal

-

Fňukal

MyApiFlag) - Nové příklady – sobotní – sobotní doručení 6

9.3.2017


zvážených balíků - Nové příklady zvážených Doplněna informace o fixní hodnotě u DepoCode Doplněna informace k CustomerUniqueImportId (nepoužívat) - Upřesnění k vážence, k vážence, čárovému kódu - Možnost dobírky do Polska -

3.2 Routovací štítek 5.2. Číselník produktů

7

21.8.2017 (ver.:1.17.814.1218)

získání číselných řad - Nová metoda na získání - Nové for GetNumberRange

4.2.2 GetCitiesRoutin GetCitiesRouting g

-

– nově nově PSČ pro dopolední balík GetCitiesRouting –


-

Přidána adresa pro dokumenty zpět+číslo zp. zásilky Irsko a Velká Británíe – přídána přídána validace PSČ PSČ Přidán SubjectID Nový VARS (externí (externí číslo) Změna ES, PT, HU na Parcel Connect Rozšíření možnosti filtrování dle stavu + VS C OD Smazání zastaralých informací Nový číselník pro GetPackages Změna IE na Parcel Connect Nové filtry – City, City, ZipCode ED, MD, SD, Post Nové filtry – ED, Pokud je neznámé PSČ přiřadí se nejnižší nejbližší Lepší optimalizace Nová informace BackedDoc (zpětná zásilka) Generování dokumentů zpět, zpětné zásilky Nová možnost možnost deklarace počtu kusů kusů v sadě u balíkové

Fňukal

platformy (PackageInSetNr, (PackageInSetNr, PackageInSet)

Fňukal

-

10.10.2017 (ver.: 1.17.1006.123 1.17.1006.1232) 2)

-

5.9 Číselník externích čísel 5.2 Číselník produktů 4.2.3 GetPackages

-

9

1.11.2017

3.2.1 Vizuální označení 5.12 Čís. stavu zásilek 5.2 Číselník produktů

10

1.02.2018

4.2.1 GetParcelShop

-

4.2.2 GetCitesRouting

-

(ver.: 1.18.125.1350)

-

4.2.3 GetPackages

-

11

8.3.2018

4.2.8 GetNumberRange

-


-

4.2.3 GetPackages

-

(ver.: 1.18.409.1954) 12

© PPL CZ s.r.o.

Fňukal Fňukal

Fňukal

Optimalizace

- Nové služby – AgeCheck AgeCheck 15+ a 18+

13.9.2018

Datum poslední poslední revize: 13.09.2018

Opraven WeightedPackageInfo

6 Chybové hlášení

4.2.8 GetNumberRange

4.1.1 Login 8

Fňukal

Fňukal

Strana 2 (celkem 65)

Obsah

Soupis revizí..................................................................... ........................................................................................................................................... ........................................................................................ .................. 2 ................................................................................................................................... ........................................................................................ ..................5 Termíny, definice .............................................................

1 2 2.1 2.2 2.3

Zkratky ......................................................................................................................................................................................................... 5 Definice ....................................................................................................................................................................................................... 5 Produkty ...................................................................................................................................................................................................... 6

2.3.1 PPL Parcel CZ Business (+ dobírka) .............................................................................................................................................. 6 2.3.2 PPL Parcel CZ Private (+ dobírka) .................................................................................................................................................. 6 2.3.3 PPL Parcel CZ Dopolední balík (+ dobírka) ................................................................................................................................. 6 2.3.4 Dokumenty zpět .................................................................................................................................................................................... 6 2.3.5 PPL Exportní balík ................................................................................................................................................................................ 7 2.3.6 PPL Parcel connect .............................................................................................................................................................................. 7 2.3.7 Firemní paleta ........................................................................................................................................................................................ 8 2.3.8 Soukromá paleta ................................................................................................................................................................................... 8 2.3.9 PPL ParcelShop .................................................................................................................................................................................... 8 2.3.10 Platba kartou................................................................................................................................................................................. 9 Etikety, váženky, routovací kódy ......................................................... 3 ......................................................................................................................... ................................................................10 3.1

Etiketa – balíková platforma ....................................................................................................................................................................... 10

3.1.1 Typ čárového kódu ............................................................................................................................................................................. 10 3.1.2 Rozměry etiket ..................................................................................................................................................................................... 10 3.1.3 Čtení čísla balíku (tabulka po číslech) ......................................................................................................................................... 11 3.2

Routovací štítek (Váženka) - volitelné ........................................................................................................................................................ 11

3.2.1 3.2.2 3.2.3 3.2.4 3.2.5 3.2.6

Routovací štítek - vizuální označení ............................................................................................................................................. 12 Routovací štítek – sobotní doručení ............................................................................................................................................. 12 Routovací štítek - platba kartou ..................................................................................................................................................... 13 Routovací štítek - večerní doručování ......................................................................................................................................... 13 Routovací štítek - zahraničí a Slovensko .................................................................................................................................... 14 Routovací štítek - ostatní země ...................................................................................................................................................... 14

3.3

Etiketa – PPLsprint .................................................................................................................................................................................... 16

3.3.1 Vzhled štítku a popis polí ................................................................................................................................................................. 16 3.3.2 Routovací tabulka ............................................................................................................................................................................... 17 Všeobecný popis myAPI ............................................................ 4 ............................................................................................................................... ........................................................................... ........ 18 4.1

Operační metody ....................................................................................................................................................................................... 18

4.1.1 Metoda „isHealtly“ ............................................................................................................................................................................... 4.1.2 Metoda „Login“ ..................................................................................................................................................................................... 4.1.3 Metoda „Version“ ................................................................................................................................................................................. 4.2

18 19

19 Business metody ....................................................................................................................................................................................... 20

4.2.1 Metoda „GetParcelShops“ ............................................................................................................................................................... 20 4.2.2 Metoda „GetCitiesRouting“ .............................................................................................................................................................. 22 4.2.3 Metoda „GetPackages“ ..................................................................................................................................................................... 24 4.2.4 Metoda „CreateOrders“ ..................................................................................................................................................................... 28 4.2.5 Metoda „CreatePackages“ ............................................................................................................................................................... 30 4.2.6 Metoda „CreatePickupOrders“ ........................................................................................................................................................ 36 4.2.7 Metoda „GetSprintRoutes“ ............................................................................................................................................................... 38 4.2.8 Metoda „GetNumberRange“ ............................................................................................................................................................ 38 5 ................................................................................................................................... .................................................................................................... ..............................40 Číselníky ............................................................. 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 5.11

Číselník návratových hodnot z volání metod .............................................................................................................................................. Číselník produktů ....................................................................................................................................................................................... Číselník zemí ............................................................................................................................................................................................. Číselník měn .............................................................................................................................................................................................. Číselník povolených měn ........................................................................................................................................................................... Číselník dep ............................................................................................................................................................................................... Číselník typu směrů ................................................................................................................................................................................... Číselník flagů ............................................................................................................................................................................................. Číselník typu externích čísel ......................................................................................................................................................................

40 40 41 41 41 41 42 42 42 Pro metodu GetPackages .......................................................................................................................................................................... 42 Číselník statusů ......................................................................................................................................................................................... 42


© PPL CZ s.r.o.


5.12 5.13 5.14 5.15 5.16 5.17 5.18

Číselník stavů zásilek ................................................................................................................................................................................ 43 Číselník obalů - WrapCode (pouze PPLsprint) ........................................................................................................................................... 44 Číselník typů svozu (pouze PPLsprint) ....................................................................................................................................................... 44 Číselník typů manipulace (pouze PPLsprint) .............................................................................................................................................. 44 Číselník služeb .......................................................................................................................................................................................... 44 Číselník bank ............................................................................................................................................................................................. 44 Číselník bank – Česká republika – formát pouze BBAN/Kód banky ........................................................................................................... 44

5.18.1 Číselník bank – Slovensko – formát f ormát pouze BBAN ......................................................................................................... 45 5.18.2 Číselník bank – Polsko – formát pouze IBAN/SWIFT ................................................................................................... 45 Chybové hlášení .............................................................. 6 .................................................................................................................................... ...................................................................................... ................46 6.1 6.2 6.3 6.4

CreatePackages ........................................................................................................................................................................................ CreatePickUpOrders .................................................................................................................................................................................. CreateOrders ............................................................................................................................................................................................. GetNumberRange ......................................................................................................................................................................................

46 47 47 47

Vzory / přílohy .................................................................. ........................................................................................................................................ ...................................................................................... ................48

7 7.1

Etikety ........................................................................................................................................................................................................ 48

7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.1.8 7.1.9

PPL Parcel CZ Business + COD.................................................................................................................................................... 48 PPL Parcel CZ Private + COD ........................................................................................................................................................ 49 Zahraniční balík ................................................................................................................................................................................... 50 PPL Parcel CZ Dopolední balík ...................................................................................................................................................... 51 Etikety – Dokumenty zpět ................................................................................................................................................................ 52 Sdružená etiketa – etiketa společně s váženkou ..................................................................................................................... 52 Etikety – balík na ParcelShop ......................................................................................................................................................... 53 Firemní paleta ...................................................................................................................................................................................... 53 Soukromá paleta ................................................................................................................................................................................. 54

7.2

Předávací protokoly/provozní dokumenty: .................................................................................................................................................. 54

7.2.1 7.2.2 7.2.3 7.2.4

Seznam Všech balíků ........................................................................................................................................................................ 54 Seznam dobírkových balíků ............................................................................................................................................................ 55 Seznam zahraničních zásilek ......................................................................................................................................................... 55 Seznam všech paletových zásilek ................................................................................................................................................. 56 CreatePackages CreatePackages - příklady .................................................................. ....................................................................................................................................... .......................................................................... .....56 ....................................................................................................................................... ...................................................................................... ................ 65 Poznámky k revizím .................................................................


© PPL CZ s.r.o.


Termíny ermín y, definice definic e

2 2.1

Zkratky

PPL – Professional Parcel Logistic. PPL PPL Sprin t – označení produktu přepravy nadrozměrných zásilek a palet. EDI – Electronic Data Interface – rozhraní pro elektronickou výměnu dat. XML - Extensible Markup Language - rozšiřitelný značkovací jazyk. ICT - Information and Communication Technologies WSDL - Web Services Description Language SOAP - Simple Object Access Protocol

2.2

Definice

Jeden balík (Označení na etiketě - 1/1)

1/1

Sada balíků (více kusé zásilky)

1/5 5000 CZK

Pokud je dobírka:

2/5 0 CZK

3/5 0 CZK

4/5 0 CZK

5/5 0 CZK

Sady balíků (více kusé zásilky) -

Sady jsou číslovány X / Y

-

V případě typu balíku s typem „dobírka“ je nosný balík (označený jako 1 / Y) zatížen celkovou částkou. Ostatní jsou

označeny pořadím/celkový počet (2 / Y ; 3 / Y ; atd) a dále hodnotou dobírky „0“

-

Všechny jsou PackProductType = dobírkového typu.

-

V datech se Deklaruje pomocí: Název elementu

Datový typ

Povinný údaj

Validace

Popis

->PackageSet ->PackageInSetNr

int

Ne

->PackagesInSet

int

Ne

Pořadí balíku Není větší > PackageInSet

Počet balíků v sadě

Poznámka: Dobírková částka se uvádí jako celá (zaokrouhlená) částka.


© PPL CZ s.r.o.


Svoz

(návaznost - Metoda „CreatePickupOrders“ ) Vyzvednutí balíku na adrese zasilatele (většinou uvedena ve smlouvě). Balíky jsou již označeny etiketami.

-

Balík z libovolné z libovolné adresy (návaznost - Metoda „CreateOrders“ ) Vyzvednutí balíku jinde, než je smluvně dáno. Balíky nejsou označeny etiketou a plátce je objednavatel.

-

2.3

Produkty K jednotlivám produktům naleznete detailní informace na www.ppl.cz

2.3.1 PPL Parcel CZ Business (+ dobírka) Přeprava balíků do 50 kg v rámci České republiky, kdy příjemce je firma či podnikatel Doručení následující pracovní den v rozmezí 8:00 – 18:00 hod. Možnost volby Sobotního doručení Nejdelší strana zásilky s max. délkou 150 cm a zároveň součet obvodu a délky zásilky nesmí přesáhnout 300 cm Pojištění zásilky do hodnoty 50 000 Kč v ceně přepravného Inkaso dobírky od příjemce pomocí platební karty nebo v hotovosti Možnost kombinace se službou Dokumenty zpě zpětt (veškeré dokumenty, které musí být podepsány příjemcem a následně zaslány zpět • • • • • • •

na adresu zasílatele = vhodné např. pro smlouvy) • • •

Zákaznický software k objednání přepravy, evidenci zásilek, statistických výstupů a individuálních reportů Sledování pohybu zásilek na www.ppl.cz Elektronické potvrzení o doručení

2.3.2 PPL Parcel CZ Private (+ dobírka) Přeprava balíků do 50 kg v rámci České republiky, kdy příjemcem je soukromá osoba Doručení následující den od pondělí do soboty Ve vybraných lokalitách možnost výběru z denního (8:00 – 18:00 hod.) nebo večerního doručení (17:00 - 21:00 hod.) – výčet PSČ s večerním doručením naleznete zde www.pplparcelshop.cz)) Možnost volby doručení do sítě PPL ParcelShop (více informací na nawww.pplparcelshop.cz Nejdelší strana zásilky s max. délkou 150 cm a zároveň součet obvodu a délky zásilky nesmí přesáhnout 300 cm Komunikace s příjemcem, která zahrnuje emailovou a SMS komunikaci s informací o času doručení v rozmezí 2 hodin Možnost změny dispozic doručení on-line nebo prostřednictvím zákaznického servisu Pojištění zásilky do hodnoty 50 000 Kč v ceně přepravného a možnost dalšího připojištění Inkaso dobírky od příjemce pomocí platební karty nebo v hotovosti Možnost kombinace se službou Dokumenty zpět (veškeré dokumenty, které musí být podepsány příjemcem a následně zaslány zpět • • •

• • • • • • •

na adresu zasílatele = vhodné např. pro smlouvy) • • • •

Elektronické potvrzení o doručení Multipartnerský bonusový program iBOD pro příjemce AgeCheck - ověření věku příjemce Direct Addressing - přímé doručení do výdejního místa

2.3.3 PPL Parcel CZ Dopolední balík (+ dobírka) přeprava zásilek s dopoledním doručením nejpozději do 10 hodin dopoledne tato služba je dostupná pouze ve vybraných městech a lokalitách (viz tabulka níže) maximální hmotnost jednotlivých hmotnost jednotlivých balíků 50 kg maximální délka zásilky (nejdelší strana) 150 cm a zároveň součet obvodu a délky zásilky maximálně 300 cm pojištění do hodnoty 50 000 Kč v ceně přepravného a možnost dalšího připojištění (více info zde zde)) možnost zaslat zásilku na dobírku nebo kombinace s produktem Dokumenty zpět (veškeré dokumenty, které musí být podepsány příjemcem, následně zaslané na adresu zasílatele = vhodné např. pro smlouvy) • • • • • •

2.3.4 Dokumenty zpět využití při potřebě odesílatele nechat si příjemcem potvrdit a zaslat zpět dokumenty, které se vztahují k zásilce (např. úvěrová •

smlouva)


© PPL CZ s.r.o.


• •

možnost doručení na Vámi vybranou adresu cena kalkulována individuálně na základě požadavků zákazníka – pro více informací kontaktujte své regionální depo •

Podmínky přepravy: přepravy:

o o o

zásilka musí být označená speciální etiketou určenou pro Dokumenty zpět, tím je zajištěno, že doručující řidič bude vyžadovat potvrzené dokumenty k zásilce musí být přiložena obálka s etiketou pro doručení zpět (s předepsanou adresou odesílatele jako příjemce). V žádném případě není možné označit zásilku jinou etiketou obálka musí být umístěna tak, aby etiketa pro zpětné doručení nebyla viditelná

2.3.5 PPL Exportní balík Přeprava balíků do 31,5 kg v rámci Evropy, kdy příjemce je firma či podnikatel Přeprava do zahraničí realizována ve spolupráci s Deutsche Post DHL Group Max. rozměry balíku délka 120 cm, šířka 60 cm, výška 60 cm a zároveň součet obvodu a délky balíku nesmí přesáhnout 300 cm Vyzvednutí zásilky na Vámi určeném místě s individuálním přístupem v oblasti času svozu Pojištění zásilky do hodnoty 100 000 Kč v ceně přepravného Zákaznický software k objednání přepravy, evidenci zásilek, statistických výstupů a individuálních reportů • • • • • •

• •

• • • • •

Přepravní podmínky podmínky do do zemí v v rámci EU: EU: etiketa určená pro mezinárodní přepravu vyplnění formuláře pr o mezinárodní zásilky Podmínky přepravy přepravy mimo mimo země EU (tzv. "třetí "třetí země země - Norsko, Švýcar sko"): s ko"): označení zásilky zahraniční etiketou vyplnění Seznamu zahraničních zásilek přiložení faktury za zboží (v případě obálky s dokumenty "proforma faktura" s minimální hodnotou, např. 1, - CHF) vyplnění Exportních dispozic vyplnění Smlouvy o přímém / nepřímém zastoupení (Stačí pouze s první podanou zásilkou. Do smlouvy je nutné uvést registrační identifikační číslo hospodářského subjektu tzv. EORI číslo. Toto číslo obdržíte od celního úřadu na zákl adě zaslání žádosti o přidělení EORI)). EORI

2.3.6 PPL Parcel connect Přeprava balíků do hmotnosti 31,5 kg v rámci Evropy Doručení balíků během 2 - 5 dnů včetně soboty Proaktivní informování příjemců o dni doručení Přeprava realizována v síti DHL Parcel Europe Maximální rozměry balíku délka 120 cm, šířka 60 cm, výška 60 cm a zároveň součet obvodu a délky balíku nesmí přesáhnout 300 • • • • •

cm • • • •

• •

Minimální rozměry balíku délka 11 cm, šířka 15 cm, výška 1 cm Pojištění balíku do hodnoty 100 000 Kč v ceně přepravného Akceptujeme pouze zásilky ve tvaru balíku v kartonové krabici bez strečové fólie, provázků apod. Ideální volba pro e-shopy

Přepravní podmínky podmínky do do zemí v v rámci EU: EU: etiketa určená pro mezinárodní přepravu vyplnění formuláře pr o mezinárodní zásilky

NĚMECKO Pro přepravu balíků v rámci Německa navíc platí:** • •

Minimální rozměry balíku š. 15 cm, v. 1 cm, d. 11 cm Akceptujeme pouze zásilky ve tvaru balíku v kartonové krabici bez strečové fólie, provázků apod.

SLOVENSKO Pro přepravu balíků v rámci Slovenska navíc platí:


© PPL CZ s.r.o.


Hmotnost balíků do 50 kg Doručení balíku v průběhu 1 – 2 dnů Nejdelší strana zásilky s max. délkou 150 cm Proaktivní komunikace s příjemcem – příjemce je o průběhu přepravy informován e-mailem a SMS Inkaso dobírky od příjemce hotově i platební kartou. Deklarace v CZK i EUR*

• • • • •

2.3.7 Firemní paleta přeprava palet, kusových a vícekusových zásilek v rámci ČR, kdy příjemcem je firma či podnikatel s doručením následující pracovní den hmotnost kusu / zásilky do 800 kg / 3 000 kg maximální rozměry zásilky: délka 300 cm, šířka 200 cm, výška 200 cm pojištění zásilky do hodnoty 900 000 Kč v ceně přepravného možnost přiobjednání dalších služeb: Dobírka, Paletové hospodářství, Svoz v pozdních hodinách, Dokumenty zpět, Uložení v naleznete zde) terminálu delší než 3 dny, Třetí pokus o doručení (informace naleznete zde) Podmínky přepravy: přeprava může být realizována na základě zasilatelské smlouvy, nebo jednorázového zasilatelského příkazu bez smlouvy Svoz za hotové zde vyplnění příslušného formuláře v případě faxové nebo e-mailové objednávky očíslování každého jednotlivého kusu zásilky (např.: 1/5 – v případě, že se zásilka skládá z 5 kusů) označení všech kusů zásilky úplnou adresou příjemce (při objednávce i na samotných kusech zásilky) zajištění přiměřené pomoci s nakládkou/vykládkou zásilek v případě, že má zásilka manipulovaná u jednoho odesílatele/příjemce vyšší hmotnost než 500 kg anebo obsahuje-li kus o hmotnosti vyšší než 60 kg •

• • • •

•

• • • •

2.3.8 Soukromá paleta přeprava palet, kusových a vícekusových zásilek v rámci ČR, kdy příjemce je soukromá osoba s doručením následující pracovní den maximální hmotnost kusu 800 kg a zásilky 3 000 kg maximální rozměry zásilky: délka 300 cm, šířka 200 cm, výška 200 cm propracovaná komunikace s příjemcem prostřednictvím emailu emailu a a SMS SMS včetně proaktivního kontaktování příjemců řidičem možnost změny dispozic doručení na www.pplbalik.cz ty 900 900 000 Kč v ceně přepravného pojištění zásilky do hodnoty možnost přiobjednání doplňkových služeb: Dobírka, Výnos zásilky do patra, Zpětný odběr elektrozařízení (informace • • • • • • • •

naleznete zde) naleznete zde) •

• • • •

Podmínky přepravy: přeprava může být realizována na základě zasilatelské smlouvy, jednorázového zasilatelského příkazu bez smlouvy Svoz za hotové zde vyplnění příslušného formuláře v případě faxové nebo e-mailové objednávky očíslování každého jednotlivého kusu zásilky (např.: 1/5 – v případě, že se zásilka skládá z 5 kusů) označení všech kusů zásilky úplnou adresou příjemce (při objednávce i na samotných kusech zásilky) zajištění přiměřené pomoci s nakládkou/vykládkou zásilek v případě, že má zásilka manipulovaná u jednoho odesílatele/příjemce vyšší hmotnost než 500 kg anebo obsahuje-li kus o hmotnosti vyšší než 60 kg

Ostatní služby: 2.3.9

PPL ParcelShop

PPL ParcelShop je nejširší a zároveň nejrychleji se rozšiřující sítí výdejních a podejních míst v České republice. Tato síť j e určena všem, kteří se nechtějí vázat na určitý čas doručení. PPL ParcelShop můžete navštívit kdykoli v otevíracích hodinách včetně víkendů.

Najděte si svůj nejbližší ParcelShop na mapě: http: // //www.pplbalik.cz/M www.pplbalik.cz/Main3. ain3.aspx?cls=KTMMa aspx?cls=KTMMap p

Seznam ParcelShopů, viz Metoda „GetParcelShops“ V PPL ParcelShopech ParcelShopech je možné:


© PPL CZ s.r.o.


•

Vyzvedávat zásilky vyzvedněte si své zásilky objednané na e-shopu, s možností inkasa dobírky v hotovosti Posílat balíky o posílejte balíky po ČR i do zahraničí o posílejte balíky i bez smluvního závazku s PPL CZ ▪

•

• • •

ParcelShopu : Další výhody PPL ParcelShopu široká síť poboček rozšířená rovnoměrně po celé České republice výborná občanská dostupnost jednotlivých poboček stálá pracovní doba včetně víkendového provozu většiny poboček

Platba kartou Platba kartou je realizována na základě požadavku zasílatele. Tato služba je buď zapnuta globálně na všechny balíky zasílatele, nebo vypnuta.

2.3.10

•

Platbu je možná pro tyto vnitrostátní produkty: o PPL Parcel CZ Business o PPL Parcel CZ Private

o •

PPL Parcel CZ Dopolední balík

Platbu kartou nelze kombinovat s platbou v hotovosti

Výhody použití platební karty: o o o o o o

moderní způsob platby bezpečnost pro příjemce i řidiče konkurenceschopnost a konkurenční výhoda eliminace odmítnutých zásilek z důvodu nepřipravené hotovosti lepší kvalita doručení – eliminace zdržení doručení platba platební kartou na místě je nákladově nižší přítěž než platba předem přes internet


© PPL CZ s.r.o.


Etikety, váženky, routovací kódy

3

Etiketa – balíková platforma

3.1

Pole 1 – Příjemce, pole pro zemi, den/večer. Pole 2 – Odesílatel – libovolné informace o zasílateli Pole 3 – Informace o počtech kusů na jednoho příjemce, viz kapitola Termíny, definice Pole 4 – Část určená pro informace k dobírce. Pole MUSÍ obsahovat informaci o měně. Pole 5 – Čárový kód, viz kapitola „Typ čárového kódu“ 1) Pole 6 – Informační část s kontakty na přepravce. Dále název produktu. Příklady etiket naleznete na konci dokumentu v příklady Etikety Etiketní řady přiděluje jednotlivé depo zákazníka nebo na [email protected] o Formou emailu – produkt od: do: o Formou lic souboru (proces je možné automatizovat pomocí souboru, který je zaslán)

• • • • • • • •

Jedno číslo nesmí být použito na více zásilkách! Zákazník si implementuje kontrolu překročení číselných řad!!! (zákazník odpovídá za „přeteční“ své řady)

• •

1)

3.1.1

Poznámka: Číslo zásilky v numerickém tvaru v poli 5 uvádět v rozsahu 11 znaků (čísel ) tj. bez kontrolního čísla.

Typ čárového kódu

Jedná se o typ Interleaved 2 of 5 with module 10 checksum a nikoliv Interleaved 2 of 5. Např. pro 85912345678 je kontrolní součet č. 8, takže čárový kód se vytiskne takto 859123456788 (číslo u čárového kódu tiskneme bez kontrolního součtu).

Problematika kontrolního součtu spočívá v následujícím: Ke kontrolnímu číslu dospějeme tak, že sečteme všechny liché pozice, tzn. v našem případě 8 + 9 + 2 + 4 + 6 + 8 = 37 Součet vynásobíme třemi, tzn. 37 x 3 = 111 K výsledku přičteme sudé pozice, tzn. 111 + 5 + 1 + 3 + 5 + 7 = 132 Kolik zbývá do další desítky tolik je naše hledané číslo neboli kontrolní součet v našem případě je to č. 8, protože tolik právě zbývá do 140. 3.1.2

Rozměry etiket

Standardní rozměry : 101 x 127 mm Etiketa s Váženkou: 101 x 169 mm


© PPL CZ s.r.o.


3.1.3

Čtení čísla balíku (tabulka po číslech)

1

2

3

4

5

6

7

8

9

10

11

8

0

9

1

7

1

2

3

4

5

6

Dobírka / nedobírka

Dokumenty

depa

Pořadové číslo

Typ produkt u

Číslo

(Pokud zpět (Pokud je číslo 9)

Pořadové číslo

Pořadové číslo

Pořadové číslo

Pořadové číslo

Pořadové číslo

12

Kontrolní součet

Číselné rozsahy poskytuje PPL, zákazník sám negeneruje! Ad 1 Typ produktu: -

2 – Exportní produkty 3 – PPL Parcel CZ Dopolední balík (+ dobírka) 4 – PPL Parcel CZ Private (+ dobírka) 5 – Soukromá paleta 8 – PPL Parcel CZ Business (+ dobírka) 9 – Firemní paleta

!!! Číslo zásilky (v jakémkoliv produktu) produktu) se NESMÍ NIKDY opakovat opakovat !!! Ad 2 Čísla dep – balíková balíková platforma: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 14

Ad 3 - Dobírka / Nedobírka 8 a 9 – dobírková zásilka

Ad 4 - Dokumenty zpět: 9 – znamená, že existuje sdružené číslo, pod kterým se vrací dokumenty (např. podepsaná smlouva atp.) (ostatní čísla jsou již pořadová) . Viz produkt – Dokumenty zpět .

U balíkové platformy se vždy tiskne druhá ZPĚTNÁ etiketa (tj. PackProduktType = 1 - 800xxxxxxxx)

Ad 5 - Pořadové číslo Ad 6 - Kontrolní součet Viz předchozí kapitola. Toto číslo se nikde nezobrazuje a neuvádí.

Routovací štítek (Váženka) – volitelné 3.2 Po vytvoření etiket dle specifikací, si dále volí zákazník, zda bude zásilky zároveň i vážit (není důležité, zda f yzicky nebo jen datově). Tyto informace inform ace deklaruje v datech podle zvolených API metod. Dle obchodního a logistického případu je třeba zvolit, co bude zákazník deklarovat. Není možné metody střídat (vážené, nevážené). Pokud udává váhu, MUSÍ zároveň tisknout routovací štítek a deklarovat vstupní a výstupní směr jak v datech, tak i na routovacím štítku. Na konci dokumentu naleznete příklad „sdružených etiket“ (váženka je dohromady s etiketou). Není tedy třeba tisknout zvlášť. Pro získávání tras (rout) se využívá metoda m etoda GetCitiesRouting.

Při používání GetCitiesRouting ve významu vážení, je NUTNÉ updatovat trasy (PSČ) na denní bázi! POZOR! K aktualizaci dochází denně! Aktualizace doporučujeme kolem 4 - 5 hodiny ranní!

V dalších kapitolách jsou poslané jednotlivé metody pro zpracování dat, jejich povinné a nepovinné položky a další

důležité informace pro tvorbu vlastního řešení. Každý balík vložený do systému musí mít štítek „Hub Sort“ (třídící HUB štítek).


© PPL CZ s.r.o.


17ti znakový čárový kód na štítku „Hub Sort“ obsahuje jedinečné číslo balíku, číslo cílového depa a číslo trasy nákladního vozu (Denní rozvoz / Sobotní doručení).

Symbolika Šířka modulu Délka čar Počet znaků Klidová zóna Kvalita Orientace

Code 128B Min. 0,375 mm Min. 30 mm 17 Min. 10 mm na obou stranách Min. ANSI GRADE B Všesměrový

Se sobotním doručením

Bez sobotního doručení

Příklad čárových kódů obsahuje následující informaci.

20981000019-04021 80981000019-04021 80981000019 je jedinečné číslo balíku, 04021 je číslo trasy – číslo trasy se získává z metody, viz kapitola Metoda „GetCitiesRouting“ - RouteCode 09 – se získává z DepoCode

Routovací štítek, může být součástí etikety. Není nutné tisknou zvlášť, viz. vzor Sdružená etiketa – etiketa společně s váženkou V čárovém kódu se uvádí vždy sobotní směr (nehledě na den vážení), pouze v případě, že není balík „povolen“ na sobotní doručení, je v čárovém kódu směr „klasický.“

3.2.1

Routovací štítek - vizuální označení

Toto označení bude používáno pro třídění balíků do kamionu a případné třídění na výstupním depu. Nejedná se o číselný údaj v čárovém kódu, ale pouze o potřebu správně třídit balíky na překladištích a depech. Na vážence se bude tisknout pouze číslo depa v rámečku. V případě, že bude v ePS zadán příznak „vizuální označení“ rámeček se netiskne (prozatím neplatné). 3.2.2

Routovací štítek – sobotní doručení

Na routovacím štítku se může, ale nemusí tisknout tzv. sobotní směr. Každý balík může být označen nezávisle na ostatních. Sobotní směr se od denního vždy liší a na vážence se tiskne takový směr INVERZNĚ směr INVERZNĚ. Sobotní směry mohou být pro produkty: viz Číselník služeb Číslo trasy se získává z metody, viz kapitola Metoda „GetCitiesRouting“ SAT true


© PPL CZ s.r.o.


Přiklad: Pro PSČ 779 00 – Olomouc

Klasický denní směr:

Sobotní směr:

V CreatePackages se posílá hodnota „OUT_SD“ viz Číselník typu směrů 3.2.3

Routovací štítek - platba kartou

V případě, že není povolena platba kartou je potřeba na vážence tisknout zkratku NK (nelze kartou viz služba Platba kartou)

3.2.4

Routovací štítek - večerní doručování

Při volbě služby večerní doručování je nutné na vážence též tisknout příznak VEČER , viz obr. PSČ, na které je možné tuto službu použít, jsou uvedeny v XML aktualizačním souboru či v XLS formátu na webu PPL CZ.

21:00. Večerní doručení – doručení na nabrané PSČ v časovém okně 17:00 – 21:00. 4.2.2 Metoda „GetCitiesRouting“ Pro seznam psč:

ED


© PPL CZ s.r.o.


3.2.5

Routovací štítek - zahraničí a Slovensko

Při tisku zahraničních zásilek je potřeba u routovacího štítku uvádět kód země. U dobírkových zásilek s příznakem COD

3.2.6

Finsko – PPL – PPL Exportní balík

Finsko – PPL PPL Parcel Connect

– dobírka Slovensko – dobírka

bez dobírky Slovensko – bez

Routovací štítek - ostatní země

Vybrané směry pro výstupní GTW – exportní zásilky Pro exportní zásilky v rámci zemí EU jsou pevně dané směry výstupních bran. Pro Slovensko se uvádí konkrétní výstupní směry (stejně jako pro CZ). Pro ostatní státy závisí zvolený produkt zákazníka. Některé země umožňují zvolit z více produktů. Záleží na domluvě obchodního zástupce a zákazníka. PPL Parcel connect

Stát

Country

ISO-2

Výstupní Depo/depot směr/Output route

Polsko

Poland

PL

25

25001

Estonsko

Estonia

EE

23

23001

Finsko

Finland

FI

23

23001

Litva

Lithuania

LT

23

23001

Lotyšsko

Latvia

LV

23

23001

Rakousko

Austria

AT

23

23001

Slovensko

Slovakia

SK

5X

5XXXX

Německo Švédsko

Germany

DE

23

23001

Sweden

SE

23

23001

Portugalsko

Portugal

PT

21

23001

Španělsko Maďarsko

Spain

ES

21

23001

Hungary

HU

22

26088

Irsko

Ireland

IE

23

23777


© PPL CZ s.r.o.


PPL Exportní balík Stát

Country

ISO-2


Estonsko

Estonia

EE

25

25001

Finsko

Finland

FI

25

25001

Litva

Lithuania

LT

25

25001

Lotyšsko

Latvia

LV

25

25001

PPL Exportní balík - Ostatní státy Stát

Country

ISO-2


Bulharsko

Bulgaria

BG

22

22089

Chorvatsko

Croatia

HR

22

22089

Rakousko

Austria

AT

22

22089

Rumunsko

Romania

RO

22

22089

Řecko

Greece

GR

22

22089

Slovinsko

Slovenia

SI

22

22089

Belgie

Belgium

BE

21

21001

Dánsko

Denmark

DK

21

21001

Francie

France

FR

21

21001

Holandsko

Netherlands

NL

21

21001

Itálie

Italy

IT

21

21001

Lucembursko

Luxembourg

LU

21

21001

Norsko

Norway

NO

21

21001

Švédsko Švýcarsko Velká Británie

Sweden

SE

21

21001

Switzerland

CH

21

21001

Great Britain

GB

21

21001


© PPL CZ s.r.o.


3.3

Etiketa – PPLsprint

3.3.1

Vzhled štítku a popis polí Firemní paleta

Soukromá paleta 1.1 CMR Logo

1.2 PPL Sprint Logo

1.3 Adresa odesílatele 1.4 Adresa příjemce

1.5 Označení produktu

1.6 Datum

1.7 Atributy zásilky 1.8 Kód pro manuální třídění 1.9 Číslo zásilky PPL Sprint 1.10 Číslo zásilky PPL Sprint - čárový kód

1.11 Číslo kusu zásilky

Legenda: 1.1

CMR logo – pevná hodnota

1.2

Logo PPL Sprint • •

1.3

Min výška 10mm Min. šířka 30mm

Adresa odesílatele - písmo Arial 8b. pevná hodnota „From:“ Název Ulice a číslo popisné PSČ Země • • • • •

1.4

Adresa příjemce – pevná hodnota „To“ Název, adresa – Arial 10b. PSČ, město, země – Arial black 11b. • •

1.5

Označení produktu V případě dobírky tisknout na levé straně inverzně DOBÍRKA --- Arial 26b. Datum – Arial 5b Datum vytvoření vytvoření zásilky ve formátu DD-MM-RRRR •

1.6 •

1.7

Atributy zásilky Na levé straně pevná hodnota – „Sender´s reference“ - Arial 8b. Hodnota pole zákaznické reference - Arial black 20b. Na pravé straně pole „Items:“ – Arial 8b. • • •


© PPL CZ s.r.o.


•

Hodnota pole zobrazujíci zobrazujíci počet kusů/ celkový počet např. 5/10 - Arial black 20b.

Kód pro manuální třídění Dle hodnot y PSČ příjemce Písmo Arial black 28b Generuje se na základě tabulky kódu viz. Routovací tabulka Tisk hodnoty DDD – RR – SS DDD – výstupní depo RR – region SS – sortovací kód

1.8

• • • • • •

1.9

Číslo zásilky PPL Unikátní číslo zásilky v systému PPL U více kusých zásilek je stejné pro všechny kusy v zásilce (palety) Numerická hodnota – Arial black 28b Číslo zásilky PPL – čárový kód Typ čárového kódu - Interl eaved 2/5 2/5 s kontrolním součtem (min. výška 15mm, šířka 40mm) Číslo kusu zásilky – čárový kód Unikátní číslo kusu v zásilce v celém systému PPL Typ čárového kódu CODE 128 Tištěná hodnota: JJD00 004 008 YXXXXXXXXXX nebo JJD00 004 004 YXXXXXXXXXX Fixní hodnota : „JJD00 004 008“ nebo „JJD00 004 004“ (sdělí PPL) V datech zasílat pouze JD bez prefixu „J“ Y – poslední číslo v roce např. 2012 = “2” XXXXXXXXXX – 10 znaků – přiděluje depo PPL • • •

1.10

•

1.11

• • • • • • •

3.3.2

Routovací tabulka

Viz metoda Metoda „GetSprintRoutes“ Slouží ke správným vizuálním zobrazením na štítku.

-

Viz metoda 4.2.7 Metoda „GetSprintRoutes“


© PPL CZ s.r.o.


Všeobecný popis myAPI

4

Webová služba myAPI (dále jen myAPI ), je určená pro zákazníky a partnery společnosti PPL CZ s.r.o. (dále jen PPL), kteří prostřednictvím této služby mají potřebu obousměrně přenášet data mezi svým informačním systémem a informačním systémem společnosti PPL. myAPI je implementována na serverech PPL a je přístupná přes internet. Poskytuje sadu metod umožňujících výměnu údajů o zásilkách, stavech zásilek, objednávkách svozu. Dále poskytuje vždy aktualizovaný seznam ParcelShopů, seznam tras, atd.

Projekt myAPI se neustále rozvíjí a soubor metod se průběžně doplňuje o další nové služby, z tohoto důvodu je při provádění nezbytné sledovat nejaktuálnější verzi této dokumentace. Obsah myAPI je zdokumentován a dostupný prostřednictvím služby WSDL URL URL adr esa k WSDL: WSDL: https://myapi.ppl.cz/MyApi.svc?singleWsdl

Popis stylu dokumentu Dokumentace obsahuje podrobný popis každé metody s následujícími detaily: popis jednotlivých atributů popis hodnot atributů jejich omezení vzorová data dotazu SOAP 1.2 návratové hodnoty chybové hodnoty číselníky • • • • • •

Ve vzorových údajích se vyskytují mezi některými elementy otazníky, které označují místa, kde se zadávají hodnoty. Vstupní hodnoty použité jako příklad a návratové hodnoty z volání metod, jsou v tomto tom to dokumentu zvýrazněné červenou barvou. U SOAP 1.1 je třeba do hlavičky zadat i SOAPAction.

Příklad: POST /myApi.asmx HTTP/1.1 Host: www.ppl.cz Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "https://myapi.ppl.cz/v1/IMyApi2/L https://myapi.ppl.cz/v1/IMyApi2/Login ogin""

V uvedeném příkladu myAPI udává, název API, ve které se nacházejí požadované metody a Login je název volané metody.

Metody se rozdělují do dvou základních skupin, jsou to metody operační a business metody. Operační metody jsou v této verzi myAPI tři a zajišťují pro myAPI základní provozní služby. Soubor business metod v této verzi obsahuje šest metod, které zajistí výměnu údajů mezi IS partnera a IS PPL.

Operační metody 4.1 Operační metody zajišťují možnost přihlášení k myAPI, poskytují možnost ověření připojení a identifikaci aktuální verze myAPI ke které je klient připojen. 4.1.1

Metoda „isHealtly“ „isHealtly“

Metoda isHealtly poskytuje klientovi informaci o stavu připojení k myAPI. K ověření stavu připojení se nevyžaduje autentifikace ke službě myAPI. Metoda nemá žádné vstupní argumenty.

XML struktura dotazu pro metodu isHealtly: cz/v1">

Příklad XML struktury odpovědi metody isHealtly: Tabulka 1 - Popis výstupních atributů metody is Healthy

Název elementu

Typ

IsHealtlyResult


string

© PPL CZ s.r.o.

Popis

stav služby


lope/"> "> Healthy Healthy

4.1.2

Metoda „Login“

Metoda Login zajišťuje klientovi možnost přihlásit se k webové službě myAPI. Zadáním vstupních parametrů a zavoláním metody, po úspěšném ověření přihlašovacích údajů, metoda vygeneruje HASH, který klient může použít pro volání dalších metod. HASH je platný 30 minut a proto se musí po uplynutí této doby znovu vygenerovat opětovným zavoláním metody Login. Každá z business metod po svém zavolání také vygeneruje nový HASH s platností 30 minut, který může být také použit při volání dalších business metod až a ž do jeho doby použitelnosti. Tabulka 1 - Popis vstupních atributů metody Login

Název elementu

Datový typ

Datový formát

Povinný údaj

Validace

Auth

Popis Autentifikace

-> AuthToken -> CustId -> Password -> SubjectId -> UserName

Pro přihlášení je třeba zadat buď token nebo Login

Ano int string int string

Autentifikační ticket

ID zákazníka Délka: 32

Heslo ID Subjektu

Délka: 32

Přihlašovací jméno

Pro sledování zásilek z více registrací

XML struktura dotazu pro metodu Login: cz/v1"> MojeID MojeID MojeHeslo MojeHeslo MojePrihlasovaciJmeno MojePrihlasovaciJmeno

Příklad XML struktury odpovědi metody Login: encoding="utf-8"?> elope/"> 1"> MLSchema-instance"> tdI5kXejGU8h tdI5kXejGU8hWkR/Ld8FEfMbB WkR/Ld8FEfMbBAAAugQAAGcDv AAAugQAAGcDv5wKz1ppl2XEi 5wKz1ppl2XEiQp1811ZqY9HdAop Qp1811ZqY9HdAopqyqCRcqZZqO qyqCRcqZZqOkyluJCeHfsshw kyluJCeHfsshw1QIM4N09 1QIM4N09 Pd0UDYIHA== Pd0UDYIHA==

Chybové návratové hodnoty metody Login: Metoda Login při zadání nesprávného přihlašovacího jména nebo hesla vrátí chybovou hodnotu Tabulka 3 - Popis chybových návratových hodnot metody Login

Kód chyby

Popis chyby

s:AS1

4.1.3

Poznámka

Pokus o přihlášení byl neúspěšný, zkontrolujte uživatelské jméno a heslo.

Metoda „Version“

Metoda Version poskytuje klientovi informaci o aktuální verzi myAPI. K ověření stavu připojení se nevyžaduje autentifikace ke službě myAPI. Metoda nemá žádné vstupní argumenty.


© PPL CZ s.r.o.


Tabulka 4 - Popis výstupních atributů metody Version

Název elementu VersionResult

Typ string

Popis

aktuální verze služby myAPI

XML struktura dotazu pro metodu Version cz/v1">

Příklad XML struktury odpovědi metody Version elope/"> xmlns="http://myapi.ppl.cz/v1"> 1.0.5.4 1.0.5.4

Business metody 4.2 Soubor business metod poskytuje skupinu metod, pro výměnu dat mezi IS partnera a IS PPL, jako například generování aktuálního seznamu ParcelShopů, vytvoření zásilky, přepravy, objednávky svozu, atd. V následujícím odstavci budou všechny tyto metody popsané. Metoda „GetParcelShops“ „GetParcelShops“

4.2.1

Metoda GetParcelShops poskytuje klientovi v závislosti na vstupních kritériích aktuální s eznam ParcelShopů (PS). Odpověď metody obsahuje informace o názvu firmy, adrese, poloze (GPS), kontaktních údajích a otevíracích hodinách provozu ParcelShopu. POZOR! K aktualizaci dochází denně! A je možné doručovat i do vybraných zahraničních ParcelShopů. Aktualizace doporučujeme kolem 4 - 5 hodiny ranní! Tvorba etikety:

Na etiketu se přenáší informace o ParcelShopu a jeho adrese. Na etiketě se uvede jen osoba nebo firma, která si má balík převzít. Viz vzor Etikety Etikety – balík na ParcelShop Tabulka 5 - Popis vstupních atributů metody GetParcelShops

Název elementu

Datový typ

Datový formát

Povinný údaj

City

string

Délka: 50

ANO/ne

Code

string

Délka: 50

ANO/ne

CountryCode

string

Délka: 2

ANO/ne

ZipCode

string

Délka: 10

ANO/Ne

Validace

Popis

Město Kód parcel shopu. Pokud se hodnota ponechá prázdná, metoda vrátí seznam všech PS z CZ Kód země. Minimálně jeden z elementů CountryCode a Code Číselník zemí musí být vyplněn. PSČ

XML struktura dotazu pro metodu GetParcelShops: cz/v1"> KM10128401 KM10128401

Odpověď metody GetParcelShops: G etParcelShops:


© PPL CZ s.r.o.


Tabulka 6 - Popis výstupních atributů metody GetParcelShops

Název elementu

Typ

Popis

Email

string

Město Země (zatím se používá) Kontaktní email

Fax

variant

Fax na provoz

City

string

Country

string

GPSLocation -> GPSLocation -> GPS_E_D

float

-> GPSLocation -> GPS_E_M

float

-> GPSLocation -> GPS_E_S

float

-> GPSLocation -> GPS_N_D

float

-> GPSLocation -> GPS_N_M

float

-> GPSLocation -> GPS_N_S

float

Name

string

Name2

string

OrgId

string

OrgVatId

string

ParcelShopCode

string

Phone

variant

GPS souřadnice

Název firmy provozující Parcelshop Název firmy provozující Parcelshop IČO firmy DIČ firmy Kód Parcelshopu Kontaktní telefon

Position

string

Pozice

QrCode

string

Street

string

QR kód Ulice a číslo popisné

WorkHours

Informace o otevíracích hodinách

-> MyApiKTMWorkHour MyApiKTMWorkHour

-> Day

int

-> From

time

-> To

time

-> ZipCode

string

1 - Neděle 2 - Pondělí 3 - Úterý 4 - Středa 5 - Čtvrtek 6 - Pátek 7 - Sobota

začátek intervalu otevření provozu konec intervalu otevření provozu PSČ

Příklad XML struktury odpovědi metody GetParcelShops: elope/"> > 01/XMLSchema-instance">

Kroměříž CZ [email protected] [email protected] 17 23 42.9480 49 17 46.9140

FRČÍME s.r.o. PPL Parcelshop 101 26307642 CZ26307642 KM10176701< KM10176701 /ParcelShopCode> 776372463

1. máje 281


© PPL CZ s.r.o.


3 12:00 12:00 3 05:00 05:00 4 12:00 12:00 4 05:00 05:00 76701

4.2.2

Metoda „GetCitiesRouting“

Metoda GetCitiesRouting poskytuje klientovi seznam směrů pro účely tisku váženek. Tisk váženek přímo u klienta, který

je zároveň odesílatelem, umožňuje přímou přím ou expedici zásilek na cílové depo. Tisk váženek využívají někteří velcí klienti, kteří si chtějí přímou expedicí na cílové depo prodloužit čas kdy je možné zásilky expedovat a zároveň urychlit proces přepravy. Při deklaraci váhy je tato metoda nutnou podmínkou! Metoda zároveň vrací informace o možnostech doručení, produktů a typ trasy – dopolední balík, večerní doručení, sobotní doručení.

Při používání GetCitiesRouting ve významu vážení, je NUTNÉ updatovat trasy (PSČ) na denní bázi! POZOR! K aktualizaci dochází denně! Aktualizace doporučujeme kolem 4 - 5 hodiny ranní!

ATTENTION! A TTENTION! The list list is updated daily daily. Updating recommend recommend about 4-5 hours hours in the morning! morning! Tabulka 7 - Popis vstupních atributů metody GetCitiesRouting

Název elementu

Datový formát

Datový typ

Povinný údaj

Validace

Auth

Popis Autentifikace

-> AuthToken

Ano

-> CustId

int

-> Password

string

-> UserName

string

Délka: 32 Délka: 32

-> CountryCode

string

Délka: 2

Ano

-> DateFrom

DateTime

YYYYMM-DD

Ne

Pro přihlášení je třeba zadat, buď token nebo Login

Autentifikační ticket ticket ID zákazníka Heslo


->Filter

V případě, že se nedá, preddef. hodnota je CZ. Minimálně jeden ze dvou elementů CountryCode a ZipCode musí být vyplněn. Pokud se nezadá datum, XML nesmí obsahovat element

Kód státu podle číselníku Číselník zemí Datum OD

-> EveningDelivery EveningDelivery Bool

Ne

1/0

-> MorningDelivery MorningDelivery Bool

Ne

1/0

-> Post

Ne

Město

-> SaturdayDelivery SaturdayDelivery Bool

Ne

1/0

-> ZipCode

string

Délka: 10

Ne

Pokud se nezadá žádná hodnota, m etoda vrátí všechny směry. Minimálně jeden ze dvou elementů CountryCode a ZipCode musí být vyplněn. Pokud je vyplněno neznámé PSČ, vrátí se nejbližší nižší PSČ.

PSČ

XML struktura dotazu pro metodu GetCitiesRouting


© PPL CZ s.r.o.


y) *** *** PŘÍKLAD 1 (dotaz na všechny směr y) cz/v1"> e3mmlo7o+RAyrD2 e3mmlo7o+RAyrD2STiL5Nv.....AAugQ STiL5Nv.....AAugQAAGcAAAAa1 AAGcAAAAa1ksyyjQ= ksyyjQ= CZ CZ

XML struktura dotazu pro metodu GetCitiesRouting *** PŘÍKLAD 2 (dotaz na směry podle filtru PSČ) ***

e3mmlo7o+RAyrD2STiL5Nv.....AAugQAAGcAAAAa1ksyyjQ= e3mmlo7o+RAyrD2STiL5Nv.....AAugQAAGcAAAAa1ksyyjQ=

CZ CZ 77900 77900

Odpověď metody GetCitiesRouting: Tabulka 8 - Popis výstupních atributů metody Get Cities Routing

Název elementu

Typ

Popis

MyApiCityRouting -> Changed

string

-> City

string

-> CountryCode

string

-> Created

datetime

-> DepoCode

Varchar (2)

-> Highlighted

boolean

-> Post

string

-> Region

string

-> Reject

boolean

-> RouteCode

string

-> Services

variant

-> ZipCode

string

Datum změny směru - formát: {YYYY-MM-DD} T {hh: MM: SS} Město Kód země podle číselníku Číselník zemí Datum vytvoření směru - formát: {YYYY-MM-DD} T {hh: MM: SS} Kód přiřazeného depa podle číselníku Číselník dep Vizuální označení depa (číslo depa v rámečku nebo bez) Pošta Region

Vyřazení směru Směr Služby (sobotní směr, večerní doručení, dopolední balík) PSČ

Příklad XML struktury odpovědi metody GetCitiesRouting: elope/"> /v1"> LSchema-instance"> fSikniJGuWm8/SkknW/S7uAFkAwBe1 …………..k0j6lTx5rc /zwvsxNrG5nspVLP/uFc8WgQ= /zwvsxNrG5nspVLP/uFc8WgQ== = 0001-01-01T00:00:00 Olomouc Olomouc 9 CZ 2015-03-30T06:59:44 09 false Olomouc 9 false 09001


© PPL CZ s.r.o.


SAT false ED true MD true 77900

Metoda „GetPackages“ „GetPackages“

4.2.3

Metoda GetPackages je určena klientovi pro vyhledávání zásilek a detailních údajů, jako například číslo balíku, stav

doručení, váha, datum vážení, doručení, atd. Zákazník se dotazuje například rozsahem datumu, konkrétním číslem balíku. Tabulka 9 - Popis vstupních atributů metody GetPackages

Název elementu

Datový typ

Datový formát

Povinný údaj

Auth -> AuthToken -> CustId

Ano

int

Validace

Pro přihlášení je třeba zadat buď token, nebo Login

Délka: 32

Popis Autentifikace

Autentifikační ticket ticket ID zákazníka

-> Password

string

Heslo

->SubjectId

int

-> UserName

string

Délka: 32

-> CustRefs

string

Délka: 40

Ne

Zákaznická reference

-> DateFrom

DateTime

YYYY-MM-DD

Ne

Datum OD

-> DateTo

DateTime

YYYY-MM-DD

Ne

Datum DO

Ne

Číslo zásilky Dle číselníku Číselník stavů zásilek Dle VS dobírky

Subject ID

Pro sledování zásilek z více registrací Přihlašovací jméno

->Filter

Délka: 11

-> PackNumbers

string

-> PackageStates

string

Ne

->VariableSymbolsCOD ->VariableSymbolsCOD

long

Ne

Pouze čísla

XML struktura dotazu pro metodu GetPackages

*** PŘÍKLAD 1 (dotaz na všechny zásilky zákazníka v určitém časovém úseku podle filtru OD ... DO) *** zation/Arrays"> xP5xKnD9TT xP5xKnD9TT4cIS9jfPcGBfM 4cIS9jfPcGBfMbBAAAugQAA. bBAAAugQAA.......uhNyeHSfPY= ......uhNyeHSfPY= 2016-10-01 2016-10-01 2016-11-26 2016-11-26

XML struktura dotazu pro metodu GetPackages

*** PŘÍKLAD 2 (dotaz na konkrétní zásilku zákazníka podle čísla zásilky) *** zation/Arrays">


© PPL CZ s.r.o.


xP5xKnD9TT xP5xKnD9TT4cIS9jfPcGBfMb 4cIS9jfPcGBfMbBAAAugQAA.... BAAAugQAA.......uhNyeHSfPY= ...uhNyeHSfPY= 80912345678 80912345678

Odpověď metody GetPackages: Tabulka 10 - Popis výstupních atributů metody GetPackages

Název elementu

Typ

Popis

BackedDoc

string

BankAccount

string

BankCode

string

Datum odeslání zásilky zpět Číslo zpětné zásilky Číslo účtu klienta, na který bude dobírka odeslána Kód banky pro platbu dobírky klientovi

CanPayByCard

string

Povolena platba kartou

City

string

BackDate

DateTime

DeliveryToKtm

bool

DelivPerson

string

DelivPerson

string

DepInCode

string

DepInName

string

DepoCode

string

DepOutCode

string

DepOutName

string

Město Datum odeslání příkazu do banky měna dobírky Kód typu čísla zásilky Datum platby dobírky Datum odeslání peněz z PPL CZ do banky klienta částka dobírky Variabilní symbol dobírky číslo kusu Kontaktní osoba Stát Číselník zemí Datum doručení Doručení na ParcelShop Příjemce zásilky Příjemce zásilky Kód vstupního depa podle číselníku Číselník dep Název vstupního depa Kód vstupního depa podle číselníku Číselník dep Kód výstupního depa podle číselníku Číselník dep Název výstupního depa

Email

string

E-mail

ExtNumber

string

Externí číslo zásilky výška Datum přijetí na centrálu

CodBankStatementDate

DateTime

CodCurrency

string

Code

string

CodPaidDate

DateTime

CodPaymentAccDate

DateTime

CodPrice

decimal

CodVarSym

long

ColliNumber

string

Contact

string

Country

string

DelivDate

DateTime

Hight

int

HubDate

DateTime

IBAN

string

InvDate

DateTime

InvNumber

string

Length

int

LoadDate

DateTime

ManipulationType ManipulationType

int

IBAN

Datum vystavení faktury číslo faktury Délka Datum nakládky typ manipulace

MyApiPackageOutColli MyApiPackageOutService MyApiPackagesOutStatus Name

string

Name 2


string

© PPL CZ s.r.o.

Informace o službách zásilky Informace o statusu vztahujících se k zásilce Jméno Jméno 2


NotDelivDate

DateTime

Note

String

Note2

string

OutDepDate

DateTime

PackageServices PackagesExtNums PackageStatuses PackageStatuses PackDesc

string

PackNumber

string

PackProductType

int

PalletInfoOut ParcelShopCode

string

PaidByCard

bool

PaymentInfoOut PEURCount

int

Datum nedoručení Poznámka Poznámka 2 Datum odjezdu z výstupního depa Informace o službách zásilky Informace o externích číslech zásilky podle číselníku Číselník typu externích čísel Informace o statusech vztahujících se k zásilce podle číselníku Číselník statusů Popis zásilky Číslo balíku Typ produktu podle číselníku Číselník produktů Informace o paletách Kód ParcelShopu Placené kartou Informace o platbách Počet palet k vrácení

Phone

string

Telefon

PickupCargoTypeCode

string

Kód typu Svozu Částka za službu Měna částky za službu podle číselníku Číselník měn Informace o příjemci Informace o odesílateli Datum dodání zásilky Specifické údaje o dodání Čas dodání OD Čas dodání DO Specifický symbol pro platbu dobírky klientovi Datum vyzvednutí zásilky Čas vyzvednutí OD Čas vyzvednutí DO Kód služby přiřazené k zásilce podle číselníku Číselník služeb

Price

decimal

PriceCurrency

string

Recipient Sender SpecDelivDate

DateTime

SpecDelivery SpecDelivTimeFrom SpecDelivTimeTo

DateTime DateTime

SpecSymbol

string

SpecTakeDate

DateTime

SpecTakeTimeFrom

DateTime

SpecTakeTimeTo

DateTime

SrvCode StaID

string int

ID statusu

StatusDate

DateTime

StatusName

string

Datum vytvoření statusu

Název statusu

Street

string

Ulice

Swift

string

SWIFT podle číselníku Číselník bank – Polsko – formát pouze IBAN/SWIFT Datum vyzvednutí zásilky Sobotní doručení objem zásilky váha Datum vážení Volumetrická váha šířka Typ obalu zásilky PSČ

TakeDate

DateTime

MyApiFlag

decimal

Volume

decimal

Weight

Decimal

WeightedDate WeightVol Width

DateTime decimal int

WrapCode

string

ZipCode

string

Příklad XML struktury odpovědi metody GetPackages: elope/"> "> LSchema-instance"> B+WwnLWF7YD B+WwnLWF7YDLdnYLkpD9TvMb LdnYLkpD9TvMbBA....ld5mO6q6 BA....ld5mO6q6tb45bbq3JFvQ= tb45bbq3JFvQ= "/> "/>


© PPL CZ s.r.o.


"/> false false 09 09 Olomouc Olomouc 07 Ostrava Ostrava "/> "/> "/> "/> TEST TEST NEREAGOVAT NEREAGOVAT "/> 80912345678 80912345678 1 1 B2CO B2CO 12345432100 12345432100 "/> "/> B2OC B2OC "/> "/> TOLL TOLL "/> "/> FUEL FUEL "/> "/> "/> "/> "/> "/> "/> "/> "/> "/> "/> "/> "/> "/> "/> "/> false false "/> "/> Krnov Krnov CZ CZ Jméno Přijmení Ulice Ulice 18 18 79401 79401


© PPL CZ s.r.o.


Olomouc Olomouc CZ CZ název firmy Ulice Ulice 20 20 77900 77900 "/> "/> "/> "/> "/> "/> "/> "/> 33.00 33.00 "/> "/> SD SD false false

Hodnoty atributů, které nejsou v databázi zadané, jsou nahrazeny v odpovědi na dotaz hodnotou "true" (v příkladu jsou zvýrazněny zelenou barvou). 4.2.4

Metoda „CreateOrders“

Metoda CreateOrders je určena k vytvoření objednávky pro přepravu zásilky (pouze balíková platforma) z místa "A" do místa "B" kde není předem definováno číslo zásilky z číselné řady. Zásilka bude vyzvednuta kurýrem v místě "A" na základě vyplněných údajů objednávky. Tabulka 11 - Popis vstupních atributů metody CreateOrders

Název elementu

Datový typ

Datový formát

Povin

ný údaj

Validace Autentifikace

Auth -> AuthToken -> CustId -> Password -> UserName

Popis

Ano

int string string

Pro přihlášení je třeba zadat buď token nebo Login


Autentifikační ticket ID zákazníka Heslo


Orders -> MyApiOrderIn -> CountPack

int

-> CustRef

string

-> Email

string

-> Note

string

-> OrdRefID -> PackProductType PackProductType

string

Ano

Délka: 40 Délka: 100 Délka: 300 Délka: 100

int

Počet zásilek, musí být> 0.

Ne Ne Ne Ano

Počet zásilek k vyzvednutí vyzvednutí (počet etiket k tisku) Zákaznicka reference E-mail Objednavatele (pro potvrzení) Popis

Pro každé volání musí být unikátní!

Unikátní označení objednávky Typ produktu - 1,9,11

Ano

-> SendDate

DateTime DateTime

Ano

YYYY-MM-DDThh:MM:SS YYYY-MM-DDThh:MM:SS

-> SendTimeFrom SendTimeFrom

DateTime DateTime

Ne

YYYY-MM-DDThh:MM:SS

-> SendTimeTo

DateTime DateTime

Ne

YYYY-MM-DDThh:MM:SS YYYY-MM-DDThh:MM:SS

Datum přepravy. Datum se rovná aktuálnímu datu nebo datu v budoucnosti.

Preferovaný čas přepravy OD Preferovaný čas přepravy DO

-> Sender


© PPL CZ s.r.o.


Ano

string


-> Country

string

Délka: 2

Ne

-> Email

string

Ne

E-mail

-> Name

string

Ano

-> Name2

string

Jméno Jméno 2

-> Phone

string

-> Street

string

-> ZipCode

string

Délka: 100 Délka: 250 Délka: 250 Délka: 30 Délka: 30 Délka: 10

-> City

string

-> Contact

Ne

Ne

Město Kontaktní osoba Kód státu podle číselníku íselník zemí - Pokud se jedná o mezinárodní zásilku (PackProductType =9, 11), pak country příjemce se nesmí rovnat country odesílatele a zároveň zároveň je pak toto pole pole je povinné. - Pokud se jedná o tuzemskou zásilku (PackProductType (PackProductType = 1), pak country příjemce se musí rovnat country odesílatele.

Ne

Telefon

Ano

Ulice

Ano

PSČ Město Kontaktní osoba Kód státu podle číselníku Číselník zemí - Pokud se jedná o mezinárodní zásilku (PackProductType =9, 11), pak country příjemce se nesmí rovnat country odesílatele a zároveň je pak toto pole je povinné. - Pokud se jedná o tuzemskou zásilku (PackProductType = 1), pak country příjemce se musí rovnat country odesílatele.

-> Recipient -> City

string string


Ano

-> Contact

-> Country

string

Délka: 2

Ne

-> Email

string

Ne

E-mail

-> Name

string

Délka: 50 Délka: 50 Délka: 50 Délka: 30 Délka: 50 Délka: 10

Ano

-> Name2

string

-> Phone

string

-> Street

string

-> ZipCode

string

Ne

Ne

Jméno Jméno 2

Ne

Telefon

Ano

Ulice

Ano

PSČ

XML struktura dotazu pro metodu CreateOrders

*** PŘÍKLAD 1 (dotaz s vybranými minimálními atrib uty) ***  g="UTF-8"?>  api.ppl.cz/v1">     e3mmlo7o+RAyr e3 mmlo7o+RAyrD2STiL5N D2STiL5Nv.....AAugQAAG v.....AAugQAAGcAAAAa1ksy cAAAAa1ksyyjQ= oken>    CO2015112707  CO2015112707  1 1  1 TEST TEST  2016-05-26 2016-05-26   Olomouc Olomouc  TomášFuk  TomášFuk  Uličná30  Uličná30  77900 77900    Olomouc Olomouc  PetrPříjemce  PetrPříjemce  Nahraně33  Nahraně33  77300 77300        

Odpověď metody CreateOrder CreateOrders: s: Datum poslední poslední revize: 13.09.2018

© PPL CZ s.r.o.


Po odeslání dotazu na metodu CreateOrders, zpracování dat trvá určitou dobu, což může v některých případech trvat až 5 minut. Proto je třeba při zpětném ověření zapsaných dat metodou GetPackages počkat na zpracování. Tabulka 12 - Popis výstupních atributů metody CreateOrders

Název elementu Code Message

Typ Int String

Popis

Návratová hodnota (hodnota není nula = chyba) Popis návratové hodnoty (popis chyby)

Příklad XML struktury odpovědi metody CreateOrders CreateOrders:: *** PŘÍKLAD 1 (odpověď v případě úspěšného zápisu) *** elope/"> /v1"> LSchema-instance"> e3mmlo7o+RAyrD2 e3mmlo7o+RAyrD2STiL.....GneuBmT STiL.....GneuBmTA5JTXZ0OK A5JTXZ0OKPx9qyyjQ= Px9qyyjQ= 0 0 Příklad XML struktury odpovědi metody CreateOrders: *** PŘÍKLAD 2 (odpověď v případě chyby při zápisu) *** elope/"> 1"> MLSchema-instance"> e3mmlo7o+RAy e3mmlo7o+RAyrD2STiL.....GneuB rD2STiL.....GneuBmTA5JTXZ mTA5JTXZ0OKPx9qyy 0OKPx9qyyjQ= jQ= 1040 1040 Unknown Unknown Package flag flag 4.2.5 Metoda „CreatePackages“ „CreatePackages“ Metoda CreatePackages je určena k odeslání údajů zásilek pro které má klient přidělenou číselnou řadu a tiskne etikety. Metoda je omezena na 1000 zásilek na request. Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 30 (celkem 65) Tabulka 13 - Popis vstupních atributů metody CreatePackages Název elementu Datový typ Datový Povinný údaj formát Validace Auth Popis Autentifikace -> AuthToken -> CustId -> Password string -> UserName string CustomerUniqueImportId Ano int string Pro přihlášení je třeba zadat buď token, nebo ID / UserName / Password Délka: 32 Délka: 32 Délka: Heslo Přihlašovací jméno Unikátní identifikátor zadaný klientem ( VŽDY musí být jedinečný, nesmí se nikdy opakovat) – opakovat) – Doporučujeme Nepoužívat Ne 100 Autentifikační ticket ticket ID zákazníka Packages -> MyApiPackageIn MyApiPackageIn -> PackNumber -> PackProductType PackProductType string Délka: 11 int -> Note string -> DepoCode string Ano Ano Délka: Nesmí být vyplněno existující číslo (v minulosti). Dle číselníku produktů Poznámka Ne 300 Délka: 2 Ne íslo balíku, číslo vygenerované z číselné řady zásilek zákazníka . Typ produktu podle číselníku Číselník produktů Validace podle Číselníku dep Kód vstupního depa. Fixní hodnota, přiřazuje depo zákazníka (pozn.: nemá NIC společného s hodnotou z GetCitiesRou GetCitiesRouting). ting). -> Sender Ano Odesílatel zásilky (převážně se používá pro Firemní a Soukromou paletu. Pro balíkovou platformu není potřeba). Město Ne Kontaktní osoba. Ne -> City string -> Contact string Délka: 50 Délka: 300 Povinný pro paletové zásilky, jinak nepovinný. 1. Validace podle íselník zemí 2. Pokud se jedná o mezinárodní zásilku (PackProductType (PackProductType = 9, 10,11,36,37,38), -> Country string Délka: 2 ANO pak se země odesílatele nesmí rovnat země příjemce a zároveň je pak toto pole povinné. 3. Pokud se jedná o tuzemskou zásilku Kód země podle číselníku Číselník zemí (PackProductType (PackProductType = 1,2,7,8,13,14,15,16,19 nebo 20), pak se země odesílatele musí rovnat země příjemce. 4. CZ paletový produkt: Country sendera = country recipienta -> Email string Délka: 50 Ne -> Name string Ano -> Name2 string Délka: 50 Délka: 50 -> Phone string Délka: 30 Ne Datum poslední poslední revize: 13.09.2018 Ne © PPL CZ s.r.o. Vyplněný kontaktní údaj výrazně zvyšuje úspěšnost doručení Jméno Jméno 2 Vyplněný kontaktní údaj výrazně zvyšuje úspěšnost doručení Strana 31 (celkem 65) -> Street string Délka: 50 Ano Ulice -> ZipCode string Délka: 10 Ano PSČ -> City string Délka: 50 Ano -> Contact string Město Kontaktní osoba V případe zásilky na ParcelShop, zde uvádět kontakt -> Recipient Délka: Ne 300 příjemce (jméno nebo firma) nebo duplikovat 1. Validace podle íselník zemí 2. Pokud se jedná o mezinárodní zásilku (PackProductType (PackProductType = 9, 10,11,36,37,38), -> Country string Délka: 2 ANO pak se země odesílatele nesmí rovnat země příjemce a zároveň je pak toto pole povinné. 3. Pokud se jedná o tuzemskou zásilku Kód země podle číselníku Číselník zemí (PackProductType (PackProductType = 1,2,7,8,13,14,15,16,19 nebo 20), pak se země odesílatele musí rovnat země příjemce. 4. CZ paletový produkt: Country sendera = country recipienta -> Email string Délka: 50 Ne -> Name string Ano -> Name2 string Délka: 50 Délka: 50 -> Phone string Délka: 30 Ne -> Street string Délka: 50 Ano -> ZipCode string Délka: 10 Ne Ano Telefon Vyplněný kontaktní údaj výrazně zvyšuje úspěšnost doručení Jméno Jméno 2 Vyplněný kontaktní údaj výrazně zvyšuje úspěšnost doručení Ulice Irsko – Město Město kopírujt kopírujte e do PS ; GB dle vzoru: A9 9AA A99 9AA A9A 9AA AA9 9AA AA99 9AA AA9A 9AA PSČ -> SpecDelivery -> ParcelShopCode string Délka: 50 Ne 1. Pouze pro balíkové zásilky 2. PackProductType pouze 13,14, 36, 37 (SK) !! 2. Validace proti seznamu, který vrací Kód ParcelShopu metoda GetParcelShops GetParcelShops -> SpecDelivTimeFrom SpecDelivTimeFrom YYYYMM-DD DateTime hh:mm:ss -> SpecDelivTimeTo SpecDelivTimeTo DateTime hh:mm:ss -> SpecDelivDat e -> SpecTakeDate DateTime DateTime YYYYMM-DD -> SpecTakeTimeFrom SpecTakeTimeFrom DateTime hh:mm:ss -> SpecTakeTimeTo SpecTakeTim eTo DateTime hh:mm:ss Ne (nepoužívá se) Čas dodání OD Čas dodání DO Ne Ne ANO Datum musí být stejné nebo větší, než aktuální datum! (Povinné, pokud je paletová přeprava – PPT = 15,16,19,20) string Délka: 10 Ne Ne Datum vyzvednutí zásilky Čas dodání OD Čas dodání DO Platební informace, relevantní pouze pro dobírkové produkty. Ne -> PaymentInfo -> BankAccount Datum doručení zásilky 1. BankAccount pokud je vyplněno, pak musí být vyplněno i pole BankCode. 2. Pokud je vyplněno BankAccount BankAccount a Číslo bankovního účtu BankCode, pak nemůže být vyplněn IBAN a SWIFT. -> BankCode string Délka: 4 Ne 1. BankCode pokud je vyplněn, pak musí být vyplněno i pole BankAccount. 2. Pokud je vyplněno BankAccount BankAccount a BankCode, pak nemůže být vyplneén Kód banky podle číselníku Číselník y bank IBAN a SWIFT. -> CodCurrency string Datum poslední poslední revize: 13.09.2018 Délka: 3 Ne 3. Validace podle Číselník bankovních kódů 1. Pokud je vyplněno CodCurrency, pak musí být vyplněno i CodPrice. 2. Validace podle Číselník měn © PPL CZ s.r.o. Měna dobírky podle číselníku číselníku Číselník měn Strana 32 (celkem 65) 1. Pokud je CodPrice vyplněné, pak musí být vyplněno i CodCurrency. 2. Částka nesmí být záporná. 3. Částka může být m aximálně -> CodPrice decimal 3.1 Domestic - 200.000, - CZK Délka: Ne 12.4 -> CodVarSym long Délka: 30 Ne -> IBAN string Délka: 50 Ne 3.2. Zahraničí: 3.2.1 - Dobírka na Slovensko V měně CZK – max 80.000 Kč V měně EUR – 3.000 EUR 3.2.2 - Dobírka Polsko V měně PLN – max 6.400 PLN Omezení na 0-10 čísel. Pokud jsou vyplněny elementy CodCurrency nebo CodPrice, pak CodVarSym musí být vyplněn. 1. IBAN pokud je vyplněn, pak musí být vyplněno i pole SWIFT. 2. Pokud je vyplněno IBAN a SWIFT, pak nemůže být vyplněny BankAccount a Částka dobírky. Částka je oddělena tečkou. Pouze kladné číslo. Pokud je v CZK a země CZ, pak zaokr ouhlená ouhlená na celé částky. Variabilní symbol dobírky. POUZE čísla IBAN BankCode. -> InsurCurrency string Délka: 3 Ne 1. Pokud je InsurCurrency vyplněné, vyplněné, pak musí být vyplněno i I nsurPrice. 2. Validace pouze CZK -> InsurPrice decimal Délka: Ne 12,4 1. Pokud je InsurPrice vyplněné, pak musí být vyplněno i I nsurCurrency. 2. Částka nesmí být záporná ani nulová 3. Částka může být maximálně 1 000 000, - CZK. -> SpecSymbol string Délka: 6 Ne -> Swift string Délka: 50 Ne Připojištění může být pouze v rámci naší národní měny – CZK Částka připojištění. Zadává se jen připojištění, standardní pojištění zásilky se zde neuvádí (automaticky do hodnoty 50.000 u balíku, 900.000 PPLSprint, 100.000 Balíky do zahraničí. Omezení na 0-10 čísel Specifický symbol 1. SWIFT pokud je vyplněno, pak musí být vyplněno i pole IBAN. SWIFT podle číselníku Číselník bank – Polsko – 2. Pokud je vyplněno IBAN a SWIFT, pak formát pouze IBAN/SWIFT (platí jen pro nemůže být vyplněny Ba nkAccount a zahraničí – akt. PL) BankCode. 3. Validace podle Číselník SWIFT -> PackagesExtNums PackagesExtNums -> MyApiPackageExtNum MyApiPackageExtNum -> Code string Délka: 4 Ano -> ExtNumber string Délka: 50 Ano ->PackageServices Musí být vyplněno Code i ExtNumber zároveň, nelze vyplnit pouze jedno z těchto polí. Buď obě, nebo žádné. Validace podle íselník typ externích čísel Ne Kód typu externího čísla podle číselníku íselník typu externích čísel Externí číslo zásilky Služby k zásilce -> MyApiPackageInServices - Služby vázány na daný produkt viz -> SvcCode string Délka: 4 Ano Číselník služeb - Pokud vyplněná služba EB a PackProductType PackProductType = 15,16,19,20, pak Kód služby. Validace podle Číselník služeb musí být PEURCount > 0 -> Flags -> MyApiFlag -> Code string Délka: 3 Ano Flag SD nesmí být použit pro paletové Validace podle lagů (deklarovat, u íselník f la každého balíku [pouze CZ, SK], službu SD zásilky (PackProductType (PackProductType = 15,16,19,20) DOPORUČENO! ) – pouze balíková platforma bool Ano Příznak flag 1 / 0 ->PackageInSetNr ->PackageInSetNr int Ne ->PackagesInSet ->PackagesInSet int Ne Pořadí balíku Počet balíků v sadě -> Value ->PackageSet -> PalletInfo Ne -> Collies Ano Validace - Není větší > PackageInSet Pole je určeno POUZE pro produkty PPLsprint POUZE pro paletové zásilky Celková váha se počítá jako součet Weight pro každý kus. Celková váha je Informace se používá, pouze v případě, že se jedná o paletovou zásilku. zásilku. Kusy paletové zásilky max 3000 kg Informace o kusech paletové zásilky -> MyApiPackageInColli MyApiPackageInColli -> ColliNumber -> Height string int Datum poslední poslední revize: 13.09.2018 Délka: 50 Ano Ne Musí být v rámci Collies unikátní. Počet kusů 1-999 1. Číslo musí být kladné © PPL CZ s.r.o. Číslo kusu (přiřazuje depo v rámci číselných řad) Výška – Výška – pouze celé číslo Strana 33 (celkem 65) Pokud je vyplněno, pak musí být vyplněno i Length a Widtgh. 2. -> Length int Ne 3. Max 300 cm pokud Length <= 200 ; Width <= 200. Pokud jedno z Length nebo Width > 200, pak Height max 200 cm. 1. Číslo musí být kladné Délka – Délka – pouze celé číslo 2. Pokud je vyplněno, pak musí bát vyplněno i Height a Widtgh. 3. Max 300 cm pokud Height <= 200 ; Width <= 200. Pokud jedno z Height nebo Width > 200, pak Length max 200 cm. -> Weight decimal -> Width int -> WrapCode -> ManipulationType ManipulationType -> PEURCount String Délka: Ano 9,2 Ne Délka: 2 int Ano Ano int Ne Váha musí >= 0. Povinné pouze pokud je Hmotnost palety sekce Collies vyplňována (pouze pro palety). Váha maximálně 800 kg. 1. Číslo musí být kladné Šířka – Šířka – pouze celé číslo 2. Pokud je vyplněno, pak musí bát vyplněno i Height a Length. 3. Max 300 cm pokud Length <= 200 ; Height <= 200. Pokud jedno z Length nebo Height > 200, pak Width max 200 cm. Validace podle íselník obalů WrapCode pouze (pouze PPLsprint) Pole je určeno POUZE pro produkty PPLsprint PEURCount > 0, pokud ve službách SvcCode = EB !! A zároveň pokud PEURCount PEURCount > 0, pak aspoň jeden kus musí mít obal PEUR: WrapCode = 40 Pole je určeno POUZE pro produkty ID obalů ID typu Číselník typů manipulace (pouze PPLsprint).. PPLsprint) Počet europalet, které se mají vrátit. Platí pouze pro paletové zásilky a vyplňuje se zde počet europalet, které se posílají s paletovými zásilkami a zákazník požaduje jejich vrácení. Zákazník MUSÍ mít smluvně zajištěno paletové konto! PPLsprint -> PackDesc string -> PickUpCargoTypeCode string -> Volume decimal Délka: Ne 512 Délka: 2 Délka: Ano Ne 9,2 decimal Délka: 9,2 Popis zásilky (poznámka) Pole je určeno POUZE pro produkty Kód typu svozu. Validace podle Číselník typů PPLsprint svozu (pouze PPLsprint) Pole je určeno POUZE pro produkty PPLsprint Pouze pro balíkové produkty -> WeightedPackageInfo WeightedPackageInfo -> Weight Pole je určeno POUZE pro produkty PPLsprint Ano Váha musí >= 0 -> Routes -> Route Celkový objem zásilky v m3. Počítá se objem jednotlivých kusů kusů (z délky, šířky a výšky) výšky) a součet objemů kusů dá celkový objem zásilky. Pouze PackProductType PackProductType 1,2,7,8,9,10,13,14,36,37,38 Váha zásilky, které zvážil klient. Pouze pro balíkovou platformu! Informace o směrech k vážené zásilce – návaznost na GetCitiesRouting GetCitiesRouting Směr Validace podle íselník typu směrů (RouteType „IN“ dodá PPL) Kód směru podle číselníku směrů -> RouteType string Délka: 6 Ano Pouze u vážených zásilek -> RouteCode string Délka: 50 Ano Omezení na 5 čísel -> City string Ano Město -> Contact string Délka: 50 Délka: Ne Kontaktní osoba DocumentsBack -> Recipient -> Country string -> Email string -> Name string -> Name2 string -> Phone string -> Street -> ZipCode string string 300 Délka: 2 Délka: 50 Délka: 50 Délka: 50 Délka: 30 Délka: 50 Délka: 10 ANO Pouze CZ Ne E-mail Ano Jméno Jméno 2 Ne Ne Telefon Ano Ano Ulice PackNumber PS Číslo dokumentu vrácených dokumentů (Vždy číslo 800xxxxxxxx / PPT = 1) XML struktura dotazu pro metodu CreatePackages *** PŘÍKLAD 1 (dotaz s minimálním počtem atributů) *** Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 34 (celkem 65) cz/v1"> e3mmlo7o+RAyrD2 e3mmlo7o+RAyrD2STiL5Nv.....AAugQ STiL5Nv.....AAugQAAGcAAAAa1 AAGcAAAAa1ksyyjQ= ksyyjQ= CUID15110 CUID1511001 queImportId> 80912345678 80912345678 1 Olomouc Olomouc nazev nazev odesilatele odesilatele ulice ulice 77300 77300 Praha Praha CZ nazev nazev prijemce prijemce ulice ulice 26 26 15500 15500 B2CO B2CO 20151127001 20151127001 Odpověď metody CreateP CreatePackages: ackages: Po odeslání dotazu na metodu CreatePackages, může zpracování dat, trvat určitou dobu, což může být v některých případech až 5 minut. Proto je třeba při zpětném ověření zapsaných dat metodou GetPackages, počkat na zpracování. Tabulka 14 - Popis výstupních atributů metody CreatePackages Název elementu Code Message Typ Int String Popis Návratová hodnota (hodnota není nula = chyba) Popis návratové hodnoty (popis chyby) Příklad XML struktury odpovědi metody CreatePackages CreatePackages:: *** PŘÍKLAD 1 (odpověď v případě úspěšného zápisu) *** encoding="UTF-8"?> lope/"> 1"> LSchema-instance"> e3mmlo7o+RAyrD2ST e3mmlo7o+RAyrD2STiL.....GneuBmT iL.....GneuBmTA5JTXZ0OKPx A5JTXZ0OKPx9qyyjQ= oken> 0 0 80912345678 80912345678 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 35 (celkem 65) Příklad XML struktury odpovědi metody CreatePackages: CreatePackages: elope/"> /v1"> ma-instance"> e3mmlo7o+RAyrD2S e3mmlo7o+RAyrD2STiL.....GneuBmT TiL.....GneuBmTA5JTXZ0OKPx A5JTXZ0OKPx9qyyjQ= Token> 1040 1040 80912345678 80912345678 Unknown Unknown Package flag flag 4.2.6 Metoda „CreatePickupOrders“ „CreatePickupOrders“ objed návek svozu zásilek (vyzvednutí označených etiket na svozové Metoda CreatePickupOrder s je určena k zaslání objednávek adrese zákazníka). Tabulka 15 - Popis vstupních atributů metody CreatePickupOrders Název elementu Datový typ Datový formát Povinný údaj Validace Auth Popis Autentifikace -> AuthToken Ano -> CustId int -> Password string -> UserName string Délka: 32 Délka: 32 -> OrdRefId string Délka: 100 Ano -> CustRef string Délka: 40 Ne -> CountPack int -> Note string -> Email string ticket Pro přihlášení je třeba zadat, Autentifikační ticket buď token nebo Login ID zákazníka Heslo Přihlašovací jméno Orders -> MyApiPickUpOrderIn MyApiPickUpOrderIn Ano Délka: 300 Délka: 100 -> SendTimeFrom SendTimeFrom YYYY-MMDateTime DD DateTime -> SendTimeTo DateTime -> SendDate Počet zásilek musí bý t > 0 Ne Ne Unikátní označení objednávky (nemůže být použito 2x jedno a to stejné) Zákaznická reference Počet zásilek Poznámka E-mail Ano Ne YYYY-MM-DDThh:mm:ss YYYY-MM-DDThh:mm: ss Ne YYYY-MM-DDThh:mm:ss YYYY-MM-DDThh:mm: ss Datum přepravy. Datum se rovná aktuálnímu datu nebo datu v budoucnosti. Preferovaný čas přepravy OD Preferovaný čas přepravy DO -> Sender -> City string -> Contact string -> Country string -> Email string -> Name string -> Name2 string -> Phone string -> Street string -> ZipCode string Délka: 50 Délka: 30 Délka: 2 Délka: 100 Délka: 250 Délka: 250 Délka: 30 Délka: 30 Délka: 10 Ano Ne Ne Město Kontaktní osoba Validace podle Číselník státu Kód země podle číselníku Číselník zemí Ne E-mail Ano Ne Jméno Jméno 2 Ne Telefon Ano Ulice Ano PSČ XML struktura dotazu pro metodu CreatePickupOrders *** PŘÍKLAD 1 (dotaz s minimálním počtem atributů) *** "> Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 36 (celkem 65) 123456 XY12324654 XY12324654 a1 ref 1 [email protected] [email protected] z 2017-12-06 2017-12-06 Ostrava Ostrava CZ CZ jmeno jmeno Ulice Ulice 70999 70999 Odpověď metody CreateP CreatePickupOrders: ickupOrders: Po odeslání dotazu na metodu CreatePickupOrders, zpracování dat trvá určitou dobu, což může v některých případech trvat až 5 minut. Proto je třeba při zpětném ověření zapsaných dat metodou GetPackages, počkat na zpracování. Tabulka 16 - Popis výstupních atributů metody CreatePickupOrders Název elementu Code Message Typ Int String Popis Návratová hodnota (hodnota nerovná nule = chyba) Popis návratové hodnoty (popis chyby) Příklad XML struktury odpovědi metody CreatePickupOrders: CreatePickupOrders: *** PŘÍKLAD 1 (odpověď v případě úspěšného zápisu) *** elope/"> xmlns="http://myapi.ppl.cz/v1"> LSchema-instance"> e3mmlo7o+RAyrD2S e3mmlo7o+RAyrD2STiL.....GneuBmT TiL.....GneuBmTA5JTXZ0OKPx A5JTXZ0OKPx9qyyjQ= Token> 0 0 Příklad XML struktury odpovědi metody CreatePickupOrders: CreatePickupOrders: *** PŘÍKLAD 2 (odpověď v případě chyby při zápisu) *** encoding="UTF-8"?> lope/"> xmlns="http://myapi.ppl.cz/v1"> LSchema-instance"> e3mmlo7o+RAyrD2ST e3mmlo7o+RAyrD2STiL.....GneuBmT iL.....GneuBmTA5JTXZ0OKPx A5JTXZ0OKPx9qyyjQ= oken> 1040 1040 Unknown Unknown Package flag flag Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 37 (celkem 65) 4.2.7 Metoda „GetSprintRoutes“ „GetSprintRoutes“ Metoda vrací směry svozu a rozvozu Sprintových zásilek. Metoda neobsahuje žádné filtry a není nutná autentifikace. Metoda bude vždy vracet plný seznam podle dotazu níže. Tabulka 17 - Popis výstupních atributů metody GetSprintRoutes Název elementu Typ Sprint routes data ->result Popis kolekce informací o routování Sprint zásilek ->MyApiSprintRoutes PS od PS do Depo doručení Region doručení Sortovací kód -> ZipFrom -> ZipTo -> DeliveryDepot -> DeliveryRegion -> SortCode Příklad XML struktury odpovědi metody GetSprintRoutes: lope/"> 1"> /XMLSchema-instance"> 10000 10000 10999 10999 PRG PRG AB AB P10 P10 4.2.8 Metoda „GetNumberRange“ „GetNumberRange“ Metoda vrací číselné řady pro jednotlivé produkty. Základem metody je automatizovat a dodávat všechny typy číselných řad. Zákazník, tak bude moci, v případě, že mu číselná řada bude docházet, požádat o nový rozsah daného typu. Odbourá se tak chyba lidského faktoru a možnosti dodání špatné číselné řady. Rychlejší odbavení takových požadavků. Table 18 - Popis vstupních atributů metody GetNumberRange Název elementu Datový typ Datový Povinný formát údaj Validace Auth Popis Autentifikace -> AuthToken -> CustId int -> Password string -> UserName string Délka: 32 Délka: 32 Ano ticket Pro přihlášení je třeba Autentifikační ticket ID zákazníka zadat buď token, nebo ID / Username / Password Heslo Přihlašovací jméno -> NumberRanges -> NumberRangeRequest NumberRangeRequest -> PackProductType -> Quantity ->DokumentBack ->DokumentBack int Ano int Ano bool ne Počet musí být > 99 Typ produktu podle číselníku Číselník produktů Počet žádaných číse l 100 – 50.000 max 0 / 1 (pouze pro PackProductType PackProductType = 1,2,7,8,13,14,15,16,19,20) XML struktura dotazu pro metodu GetNumberRange *** PŘÍKLAD 1 (dotaz s vybranými minimálními atributy – atributy – požadavek, na jeden typ) *** - Kus y Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 38 (celkem 65) cz/v1"> 123456 AA112233 AA112233 CLCL pe> 199 00 mentBack> XML struktura dotazu pro metodu GetNumberRange *** PŘÍKLAD 1 (dotaz s vybranými minimálními atributy – atributy – požadavek, na více typů) *** cz/v1"> 123456 AA112233 AA112233 13< 13 ype> 100 1414 pe> 100 Odpověď metody GetNumberRang GetNumberRangee Tabulka 19 - Popis výstupních atributů metody GetNumberRange Název elementu Datový Popis typ int Typ produktu podle číselníku Číselník produktů Název daného produktu – viz Číselník produktů Počet žádaných čísel 1 – 50.000 -> From From int Vrací hodnotu od (11 čísel – balíková platforma; 21 čísel – paletová platforma - kusy) -> To To int Vrací hodnotu do (11 čísel – balíková platforma; 21 čísel – paletová platforma - kusy) -> PackProductType PackProductType int -> Name -> Quantity Quantity Příklad XML struktury odpovědi metody GetNumberRange GetNumberRange:: elope/"> < GetNumberRangeResp GetNumberRangeResponse onse xmlns="http://myapi.ppl.cz/v1 xmlns="http://myapi.ppl.cz/v1"> "> < GetNumberRangResult GetNumberRangResult xmlns:i="http://www.w3.org/2001/X xmlns:i="http://www.w3.org/2001/XMLSchema-instance" MLSchema-instance"> > B+WdnYLkpD9T B+WdnYLkpD9TvMbBA....ld5m vMbBA....ld5mO6q6tb45bbq3JFv O6q6tb45bbq3JFvQ= Q= 11 PPL Parcel CZ Business 10001000 8001000000180010000001 8001000100080010001000 0 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 39 (celkem 65) 1313 PPL Parcel CZ Private 500500 4001000000140010000001 4001000100040010001000 0 1414 PPL Parcel CZ Private - Dobírka 500 4009000000140090000001 4009000100040090001000 Číselníky 5 Číselník návratových hodnot z volání metod 5.1 Kód 0 Kód Popis Loaded successfully Popis 1025 Insurance price and currency must be filled both 1000 Invalid or missing Package Number 1026 Insurance negative price 1001 Unknown Product Type 1027 Unknown COD currency 1002 Bad sender address 1028 Unknown insurance currency 1003 Bad recipient address 1029 Unknown package service 1004 Invalid COD variable symbol 1030 Unknown external number 1005 Invalid special symbol 1031 Invalid country in sender address 1006 COD price and COD currency not filled both 1032 Invalid country in recipient address 1007 COD negative price 1033 Invalid informations about weighted packages 1008 Invalid bank informations - filled bank account/code and also IBAN/SWIFT 1034 Unknown routes 1009 Bank account and bank code must be filled both 1035 Invalid package weight 1010 IBAN and SWIFT must be filled both 1036 Saturday delivery filled and saturday route not or vice versa 1011 Unknown bank code 1037 Missing input destination 1012 Unknown SWIFT code 1038 Missing output destination 1013 Filled COD informations for nonCOD product 1039 1014 Invalid count of collies 1040 Unknown Package flag 1015 Pallets - Colli number must be specified 2001 Bad sender address 1016 Pallets - Colli number must be unique 2002 Bad count of packages 1017 Pallets - invalid size 2005 Invalid country in sender address 1018 Pallets - unknown wrap code 3001 Bad recipient address 1019 Pallets - unknown manipulation type 3002 Bad sender address Filled route type in and not route type out or vice versa. Two times filled route type out or route type in. 1020 Pallets - unknown pickup cargo type 3003 Bad count of packages 1021 Pallets - parcel shop cannot be filled for pallet shipment 3004 Unknown product type for package 1022 Pallets - pallet information for nonpallet shipment 3005 Invalid country in sender address 1023 Unknown parcel shop code 3006 Invalid country in recipient address 1024 Invalid package weight Číselník produktů 5.2 Pack Product Type ID Code 1 1 Name COD PPL Parcel CZ Business Datum poslední poslední revize: 13.09.2018 Poznámka 0 © PPL CZ s.r.o. Strana 40 (celkem 65) 2 2 PPL Parcel CZ Business - dobírka 1 7 7 0 8 8 PPL Parcel CZ Dopolední balík PPL Parcel CZ Dopolední balík - dobírka Exportní balík 0 10 Exportní balík - dobírka 1 Pro země: GB, CH, SI, BE, DK, FR, IT, NL, NO, RO, BG, GR, LU, HR AT, FI, LV, EE, LT, LT, SE (je možnost možnost vybrat buď PPT 9 nebo PPT 36 – použít se domlouvá s obchodním MŮŽE SE MĚNIT! - jaký produkt použít zástupcem PPL !!! Zatím nelze 11 11 PPL Parcel Import 0 Pouze u CreatOrders 13 13 PPL Parcel CZ Private 0 14 14 PPL Parcel CZ Private - dobírka 1 15 15 0 16 16 19 19 20 20 Firemní paleta Firemní paleta - dobírka Soukromá paleta Soukromá paleta - dobírka 36 36 PPL Parcel Connect 0 Možnost večerního doručení Možnost večerního doručení Pouze v rámci CZ Pouze v rámci CZ Pouze v rámci CZ Pouze v rámci CZ Zatím pouze DE, SK, PL, HU, ES, PT, IE (bez volby). AT, FI, LV, EE, EE, LT, SE (je možnost možnost vybrat buď PPT 36 nebo PPT 9 – použít se domlouvá s obchodním MŮŽE SE MĚNIT! - jaký produkt použít zástupcem PPL !!! 37 37 PPL Parcel Connect - Dobírka 1 SK, PL 38 38 PPL Parcel International 0 CL Colli Zatím se nepoužívá Pouze pro GetNumberRange (náleží k PPT – 15,16,19,20) Zpětná zásilka 9 9 10 1 0 1 DBZ Číselník zemí 5.3 Kód Země Kód Země CZ Česká republika ES Španělsko DE FR Francie GB Německo Velká Británíe IE Irsko SK Slovensko IT Itálie AT Rakousko NL Holandsko PL Polsko NO Norsko CH Švýcarsko PT Portugalsko FI Finsko SE Švédsko HU Maďarsko RO Rumunsko SI Slovinsko BG Bulharsko LV Lotyšsko GR Řecko EE Estonsko HR Chorvatsko LT Litva TR Turecko BE Belgie LU Lucembursko DK Dánsko Číselník měn 5.4 Code Name CZK EUR PLN Euro 5.5 Česká koruna Polský zlozy Číselník povolených měn Country ID Country Code Currency ID Code 1 2 3 CZ SK PL 1 4 16 CZK EUR PLN 5.6 1 GetCitiesRouting Pouze do vybraných měst, viz. GetCitiesRouting GetCitiesRouting Pouze do vybraných měst , viz. GetCitiesRouting Číselník dep Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 41 (celkem 65) Fiktivní Čechy / depo Morava 01 17,18,19 Č Praha východ 31 Praha Jažlovice PRG 02 T2 Č České Budějovice 32 České Budě jovice CKP 03 13 Č Plzeň 33 Plzeň PLZ 04 44, 84 Č Teplice 34 Teplice TEP Č Hradec Králové 35 Hradec Králové DCB Kód 05 Kód Depo Routovací kód Depo (Sprint) 06 86, 66 M Brno 36 Brno BRQ 07 77, A7 M Ostrava 37 Ostrava OSR 08 X8 M Zlín - Malenovice 38 Zlín - Malenovice ZLN M Olomouc 39 Olomouc OLO Č Praha západ 11 Č Liberec 41 Liberec LBR 12 Č Humpolec Č Praha sever 09 1W 10 1R 14 Číselník typu směrů 5.7 Typ Popis Vstupní směr (RouteType „IN“ dodá PPL) Výstupní směr Výstupní směr sobotního doručení IN OUT OUT_SD Číselník flagů 5.8 Kód Popis Sobotní doručení Balík / Paleta / Vše Popis Podmínka Balík 1, 2, 7, 8, 13, 14, 36, 37 U zahraničí pouze Slovensko! Deklarujte prosím SD na úrovni každé zásilky! SD nebo SAT Číselník typu externích čísel 5.9 Name Code Externí B2CO Zákaznické CUST Variabilní symbol pro nonCOD VARS 5.10 Pro metodu GetPackages Name Code Name Code Externí Zákaznické Partnerské B2CO Vrácení vratných obalů VROB CUST Poplatek za TCP TCPF PRTN JJD CJJD Objednávková přeprava Atyp Balík ATPB AWB CAWB ADR LQ Žabka Žabka číslo balíku TOAD TDID TP-DKod DKOD PL číslo PLCE JJD parcel connect PJJD Variabilní symbol pro nonCOD VARS 5.11 OBJP ADRL Sobotní svoz Zdravotní prostředky SOSV ZDRP Číselník statusů Kód Kód Popis Popis 150 Převzetí od zákazníka 463 Nedoručeno - neobjednáno 151 Převzetí s výhradou 464 Nedoručeno - odmítnuto vyexpedováno pozdě 281 Příjem zahraničí 465 Nedoručeno - odmítnuto zásilka nekompletní 300 Příjem na rozvozové depo 466 Nedoručeno - odmítnuto jiný důvod 336 Nevyzvednutý osobní odběr 467 Nedoručeno - adresa neúplná/nenalezena neúplná/nenalezena Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 42 (celkem 65) 343 Doručení na KTM 468 Nedoručeno - nepřipravená hotovost 400 Evidence na PL 469 Nedoručeno - dovolená 450 Doručeno 470 Nedoručeno - zdržení na celnici 451 Doručeno nekompletní 471 Nedoručeno - chybné nebo chybějící doklady 453 472 454 Doručeno s výhradou Nedoručeno - Nestihl 500 Nedoručeno - zásilka poškozena Příjem na centrálu 455 Nedoručeno - pozdní dojezd zásilek na depo 605 Dobírka - příkaz na zákazníka 456 Nedoručeno - porucha vozu 606 Dobírka - zaplaceno zákazníkovi 457 Nedoručeno - špatné počasí 613 Dobírka - příkaz partnerovi 458 614 459 Nedoručeno - příjemce nezastižen / oznámení Nedoručeno - příjemce nezastižen / bez oznámení Dobírka - zaplaceno partnerovi Převážení/vážení 460 Nedoručeno - dohoda jiný termín 718 Zpět odesílateli 461 Nedoručeno - dohoda osobní odběr 720 Výdej partnerovi 462 Nedoručeno - dohoda jiná adresa 927 Výmaz 463 Nedoručeno - neobjednáno 929 Příjem na jiné depo - závlek 5.12 710 Číselník stavů zásilek Name Status ID 900 150 151 170 450 451 453 336 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 478 718 993 Popis DataShipment PickedUpFromSender Datová zásilky Převzato od zákazníka Delivered Doručeno NotDelivered Nedoručeno BackToSender OutForDelivery Vráceno odesílateli Doručováno příjemci Datum poslední poslední revize: 13.09.2018 281 282 300 343 400 500 720 733 734 929 © PPL CZ s.r.o. Popis Import dat Převzetí od zákazníka Převzetí s výhradou Příjem od zákazníka - zahraničí Doručeno Doručeno nekompletní Doručeno s výhradou Nevyzvednutý osobní odběr Nedoručeno - Nestihl Nedoručeno - pozdní dojezd zásilek na depo Nedoručeno - porucha vozu Nedoručeno - špatné počasí Nedoručeno - příjemce nezastižen / oznámení Nedoručeno - příjemce nezastižen / bez oznámení Nedoručeno - dohoda jiný termín Nedoručeno - dohoda osobní odběr Nedoručeno - dohoda jiná adresa Nedoručeno - neobjednáno Nedoručeno - odmítnuto vyexpedováno pozdě Nedoručeno - odmítnuto zásilka nekompletní Nedoručeno - odmítnuto jiný důvod Nedoručeno - adresa neúplná/nenalezena neúplná/nenalezena Nedoručeno - nepřipravená hotovost Nedoručeno - dovolená Nedoručeno - zdržení na na celnici Nedoručeno - chybné nebo chybějící doklady Nedoručeno - zásilka poškozena Nedoručeno - Zavřeno Zpět odesílateli Nedoručeno. Není možné kontaktovat odesílatele Je vyplněno „BackDate“ Příjem zahraničí Příjem zásilky v zahraničí Příjem na rozvozové depo Doručení na KTM Evidence na PL Příjem na centrálu Výdej partnerovi Příjem na výstupním depu - zahraničí Výdej z výstupního depa - zahraničí Příjem na jiné depo - závlek Strana 43 (celkem 65) Dobírka zaplacena zákazníkovi CodPaidDate 5.13 Popis Typ Popis 32 Balík 41 Pytel 33 Bedna 42 Sud 34 Buben 43 Volně 35 Kartón 44 Colli 36 Kontejner 45 Svazek 37 Kotouč 46 Tyč 38 Krabice 47 Role 39 Paleta 50 Box 40 P-EUR 54 Obálka u PL Číselník typů svozu (pouze PPLsprint) Kód Popis PT Podej na depu PPL Sprint SV Standardní svoz 5.15 Dobírka - příkaz na zákazníka Dobírka - zaplaceno zákazníkovi Dobírka - příkaz partnerovi Dobírka - zaplaceno partnerovi Číselník obalů - WrapCode WrapCode (pouze PPLsprint) Typ 5.14 605 606 613 614 Číselník typů manipulace (pouze PPLsprint) Kód Popis Vozík Hydraulické čelo 1 2 5.16 Číselník služeb Popis Dobírka Večerní doručení Platba v hotovosti příjemcem COD Balík / Popis Paleta / Vše 2, 8, 10, 14, 16, 20 vše Ve službách se neuvádí. Je deklarována pomocí PaymentInfo. ED Balík 13,14 - Paleta 15, 16, 19, 20 - 15, 16, 19, 20 Pokud je ADR, pak se do PackDesc specifikuje, o jakou ADR se Kód Code CreatePackg COD ED EXW EXW EXW ADR ADR ADR ADR Paleta Připojištění INSR INSR vše EB EB EB Paleta P-EUR zpět (pokud je domluveno paletové konto) Paleta 19, 20 - MD Balík 7, 8 Ve službách se neuvádí. Jedná se o produkt. A15 Balík 13, 14 Kontrola věku příjemce – 15+ A18 Balík 13, 14 Kontrola věku příjemce – 18+ DB DB vše Výnos na poschodí FH FH FH Odvoz starého spotřebiče OGB Dopolední balík MD 5.17 5.18 PPT = 1 Max weight zásilky = 80 kg (max 1ks na zásilku!) Číselníky bank Číselník bank – Česká republika – formát f ormát pouze BBAN/Kód banky Code 0100 Pokud není dohodnuto s OZ, nelze tento produkt využít! OGB OGB Dokumenty zpět A18 - Paleta vše AgeCheck – 18+ 1, 2, 7, 8, 9, 10, 11, 13, 14, 15, 16, 19, 20 15, 16, 19, 20 Zásilka k příjemci označena touto službou. Zpětný dokument PPCK PPCK A15 jedná (název, (název, třída, obal. skupinu, UN číslo). číslo). Pokud je zásilka zásilka mix (ADR i ne- ADR zboží), musí být uveden počet a hmotnost pouze ADR zboží. 1, 2, 7, 8, 9, 10,11, 13, 14, 15, 16, 19, 20 1, 2, 7, 8, 13, 14, 15, 16, 19, 20 19, 20 Osobní odběr AgeCheck – 15+ Podmínka Name Code Komerční banka, a.s. Datum poslední poslední revize: 13.09.2018 8030 © PPL CZ s.r.o. Name Raiffeisenbank im Stiftland eG pobočka Cheb, odštěpný závod Strana 44 (celkem 65) Československá obchodní banka, a.s. 0300 0600 0710 0800 2010 2250 2600 2700 3500 4000 4300 5000 5400 5500 5800 6000 6100 6200 6300 6700 6800 7910 7940 7950 7960 7970 GE Money Bank, a.s. Česká národní banka Česká spořitelna, a.s. Fio banka, a.s. Creditas Citibank a.s. UniCredit Bank Czech Republic a.s. ING Bank N.V. LBBW Bank CZ Českomoravská záruční a rozvojová banka, a.s. Crédit Agricole Royal Bank of Scotland Raiffeisenbank a.s. J & T Banka, a.s. PPF banka a.s. Equa bank COMMERZBANK AG, pobočka Praha Fortis Bank SA/NV, pobočka ČR Všeobecná úverová banka a.s., pobočka Praha Volksbank CZ, a.s. Deutsche Bank A.G. Filiale Prag Waldviertler Sparkasse von 1842 Raiffeisen stavební spořitelna a.s. Českomoravská stavební spořitelna, a.s. Wüstenrot-stavební spořitelna a.s. Wüstenrot hypoteční banka, a.s. se sídlem v Praze Modrá pyramida stavební spořitelna, a.s. 7980 7990 5.18.1 8040 8060 8090 8150 2020 6210 2030 2070 2050 2100 2200 2230 2040 2310 2060 3030 4500 3800 6400 4400 2000 4100 3400 1800 7920 1900 Oberbank AG pobočka Česká republika Stavební spořitelna České spořitelny, a.s. Česká exportní banka, a.s. HSBC Bank plc - pobočka Praha Bank of Tokyo-Mitsubishi UFJ (Holland) N.V., Prague Branch mBank AKCENTA, spořitelní a úvěrní družstvo Moravský peněžní ústav WPB Capital, spořitelní družstvo Hypoteční banka Peněžní dům AXA Bank Europe UNIBON – spořitelní a úvěrní družstvo Zuno CITFIN, spořitelní družstvo Air Bank Moravia Banka, a.s. HYPO Vereinsbank CZ a.s Universal banka, a.s. Erste (CR) a.s. Kreditní banka Plzeň, a.s. Česká banka, a.s. Praha Union banka, a.s. Ekoagrobanka, a.s. Fores, a.s. SOCIETE GENERALE, pobočka Praha 2210 Evropsko-ruská banka, a.s. 2220 Artesa, spotřební družstvo Číselník bank – Slovensko – formát pouze BBAN Code Name Code Name 0200 Všeobecná úverová banka, a.s. 8020 Crédit Agricole SK 0900 Slovenská sporiteľňa, a.s. Národná banka Slovenska 8050 COMMERZBANK Aktiengesellschaft, tiengesellschaft, pobočka zahraničnej banky, Bratislava 8100 KOMERČNÍ BANKA Bratislava, a.s. Tatra banka, a.s. 8120 8130 1111 8330 8370 8300 8410 8350 1111 Privatbanka, a.s. Citibank (Slovakia), a.s. Bratislava UniCredit Bank Slovakia a.s. 0720 1100 3000 3100 4900 5200 5600 6500 7300 8020 8050 5.18.2 Slovenská záručná a rozvojová banka, a.s. ĽUDOVÁ BANKA, a.s. Bratislava ISTROBANKA, a.s. OTP Banka Slovensko, a.s. Dexia banka Slovensko, a.s. Poštová banka, a.s. ING Bank N.V., pobočka Bratislava Crédit Agricole SK COMMERZBANK Aktiengesellschaft, pobočka zahraničnej ban ky, Bratislava Fio banka, a.s., pobočka zahraničnej banky Oberbank HSBC BANK PLC pobočka Slo vensko ZUNO BANK AG, pobočka zahraničnej banky RBS Slovakia UniCredit Bank Slovakia a.s. Číselník bank – Polsko – formát pouze IBAN/SWIFT Code Name Code Name WBKPPLPP Bank Zachodni WBK SA HSBCPLPW HSBC Bank Polska SA PKOPPLPW Bank Polska Kasa Opieki SA IEEAPLPA Idea Bank SA Industrial and Commercial Bank of China (Europe) S.A. (Spółka Akcyjna) BWEUPLPW Alior Bank SA ICBKPLPW BIGBPLPW Banco Mais S.A. (SA) Oddział w Polsce Bank BGŻ BNP Paribas SA INGBPLPW BCITPLPW Oddział w Polsce ING Bank Śląski SA Intesa Sanpaolo S.p.A. Spółka Akcyjna Oddział w Polsce PPABPLPK BPHKPLPK Bank BPH SA RHBHPLPW mBank Hipoteczny SA GOSKPLPW Bank Gospodarstwa Krajowego BREXPLPW mBank SA CITIPLPX Bank Handlowy w Warszawie SA CITIPLPX Mercedes-Benz Bank Polska SA BIGBPLPW Bank Millennium SA NBPLPLPW Narodowy Bank Polski Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 45 (celkem 65) EBOSPLPW Bank Ochrony Środowiska SA DABAPLPW Nykredit Realkredit A/S SA - Oddział w Polsce BOTKPLPW Bank of Tokyo-Mitsubishi UFJ (Polska) SA HYVEPLP2 Pekao Bank Hipoteczny SA POCZPLP4 Bank Pocztowy SA BPKHPLPG PKO Bank Hipoteczny SA POLUPLPR IVSEPLPP PLUS BANK SA BPKOPLPW Powszechna Kasa Oszczędności Bank Polski SA CAIXPLPW BANK POLSKIEJ SPÓŁDZIELCZOŚCI SA Banque PSA Finance SA Oddział w Polsce BNP PARIBAS SA Oddział w Polsce BNP Paribas Securities Services SKA Oddział w Polsce CAIXABANK, S.A. (SPÓŁKA AKCYJNA)ODDZIAŁ W POLSCE AGRIPLPR Credit Agricole Bank Polska SA SOGEPLPW BNPAPLPX PARBPLPX RCBWPLPW Raiffeisen Bank Polska SA ABNAPLPW RBS Bank (Polska) SA SOGEPLPW RCI Banque Spółka Akcyjna Oddział w Polsce SATNPLP1 Santander Consumer Bank SA DABAPLPW Danske Bank A/S SA Od dział w Polsce SAXODKKK Saxo Bank A/S Spółka Akcyjna Oddział w Polsce DEUTPLPX Deutsche Bank Polska SA GBWCPLPP SGB-Bank SA MHBFPLPW ESSEPLPW Skandinaviska Enskilda Banken AB (SA) - Oddział w Polsce DEUTPLPX DNB Bank Polska SA Elavon Financial Services Limited (Spółka z ograniczoną odpowiedzialnością) odpowiedzialnością) Oddział w Polsce SOGEPLPW SOGEPLPW Euro Bank SA HANDPLPW Societe Generale SA Oddział w Polsce Svenska Handelsbanken Handelsbanken AB SA Oddział w Polsce FBPLPLPW FCA-Group Bank Polska SA INGBPLPW Sygma Bank Polska SA ABNAPLPW FCE Bank Polska SA TOBAPLPW Toyota Bank Polska SA PBPBPLPW FM Bank PBP SA UBSWGB24 UBS Limited (spółka z ograniczoną odpowiedzialnością) Oddział w Polsce Vanquis Bank Limited (spółka z ograniczoną odpowiedzialnością) odpowiedzialnością) Oddział w GBGCPLPK Getin Noble Bank SA VANQPLP1 Polsce (w likwidacji 02.11.15) ESSIPLPX HAITONG BANK, S.A. Spółka Akcyjna Oddział w Polsce VOWAPLP1 VOLKSWAGEN BANK POLSKA SA Chybové hlášení 6 CreatePackages 6.1 Kód Kód Popis Popis 0 Loaded successfully 1032 Invalid country in recipient address 1 Create packages failed 1033 SpecTakeDate must be equal or greater than the current date 1000 Invalid or missing Package Number 1034 Unknown routes 1001 Unknown Package product type 1035 Service is not relevant for product type 1002 Bad sender address 1036 Saturday delivery filled and saturday route not or vice versa 1003 Bad recipient address 1037 Missing input destination 1004 Invalid COD variable symbol 1038 1005 Invalid specific symbol 1039 Missing output destination Filled route type in and not route type out or vice versa. Two times filled route type out or route type in 1006 COD price and COD currency must be filled 1040 Unknown package flag 1007 COD negative price 1041 Invalid colli weight (min: 0 kg, max: 800 kg) 1008 Invalid bank informations - filled bank account/code and also IBAN/SWIFT 1042 Invalid weight (max: 80 kg) 1009 Bank account and bank code must be filled both 1043 SD flag can't be specified for this Product type 1010 IBAN and SWIFT must be filled both 1044 Parameter mismatch: Package service EB and PEURCount 1011 Unknown bank code 1045 Parameter mismatch: Colli WrapCode and PEURCount 1012 1046 „Recipient coutry“ ZipCode wrong, check the format 1013 Unknown SWIFT code CodPrice, CodeCurrency, VS, SS, BankCode, BankAccount, IBAN a SWIFT can't be specified for non COD product 1047 - Bad sender ZipCode format 1014 Invalid count of collies 1048 Parameter SpecTakeDate must be specified 1015 Pallets - Colli number must be specified 1049 1050 COD price is greater than the maximum allowable limit for the country 1016 Pallets - Colli number must be unique Maximum number of packages „limit max počet zásilek“ exceeded (1000) 1051 - Value of key with name MaxInsurance is not decimal (Hodnota připojištění není číslo) - Value of key with name MaxCODPrice is not decimal (Hodnota - dobírky není číslo) Value of key with name MaxPackagesInCount is not int (Počet zásilek není číslo) 1017 Pallets - invalid size 1018 Pallets - unknown wrap code 1052 The PackNumber is required field (PackNumber je povinné pole) 1019 Pallets - unknown manipulation type 1053 Duplicit PackNumber: „PackNumber“ „PackNumber“ 1020 Pallets - unknown pickup cargo type 1054 Unknown COD currency Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 46 (celkem 65) 1054 Insurance price must be lower or equal to „limit max částka připojištění“ Maximum number of packages „limit max počet zásilek“ exceeded 1021 Pallets - parcel shop cannot be filled for pallet shipment 1022 Pallets - pallet information for nonpallet shipment 1055 1023 Unknown parcel shop code 1057 The PackNumber is required field 1024 - 1058 Duplicit PackNumber: „PackNumber“ „PackNumber“ 1025 Insurance price and currency must be filled both 1059 Package „PackNumber“ is not authorized to create back documents 1026 Insurance negative price 1060 Package: „PackNumber“ , DocumentsBack PackNumber is missing 1027 Currency for the COD is not acceptable 1061 Package: „PackNumber“ , service with code DB is missing. 1028 Unknown insurance currency 1062 Invalid recipient address for back documents 1029 Unknown Package service 1063 Recipient ZIP code doesn't support morning delivery 1030 Unknown External number 1065 PackageInSetNr is higher then PackageInSet 1031 Invalid country in sender address Invalid package weight CreatePickUpOrders 6.2 Kód Popis 0 Loaded successfully 1 Create order failed 2001 Bad sender address 2002 Bad count of packages 2005 Invalid country in sender address 2006 SendDate must be equal or greater than the current date 2008 Parameter SendDate must be filled CreateOrders 6.3 Kód Popis 0 Loaded successfully 1 Create order failed 3001 Bad recipient address 3002 Bad sender address 3003 Bad count of packages 3004 Unknown product type for package 3005 Invalid country in sender address 3006 Invalid country in recipient address 3007 3008 SendDate must be equal or greater than the current date. Parameter SendDate must be filled 3010 Duplicit OrdRefId: „OrdRefID“ (Duplicitní OrdRefID) Count of orders is greater than „max limit pro počet objednávek“ (současné nastavení: 500) 3011 GetNumberRange 6.4 Kód 0 Popis Loaded successfully 4000 You have have already already unsused numbers of requested range, contact contact sales or technician technician or IT 4001 PackProductType does not exist 4002 Quantity is above maximum 4003 Quantity is bellow minimum AS36 Při zpracování došlo k chybě. Chyba byla zaznamenána **.**.**** **:**:** (Zkontrolujte zadanou hodnotu v položce „PackProductType“) Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 47 (celkem 65) 7 Vzory / přílohy 7.1 Etikety 7.1.1 PPL Parcel CZ Business + COD Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 48 (celkem 65) 7.1.2 PPL Parcel CZ Private + COD 7.1.3 PPL Parcel CZ Private – AgeCheck 15+ a 18+ Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 49 (celkem 65) 7.1.4 Zahraniční balík Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 50 (celkem 65) 7.1.5 PPL Parcel CZ Dopolední balík Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 51 (celkem 65) 7.1.6 Etikety – Dokumenty zpět 7.1.7 Sdružená etiketa – etiketa společně s váženkou Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 52 (celkem 65) 7.1.8 Etikety – balík na ParcelShop 7.1.9 Firemní paleta Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 53 (celkem 65) 7.1.10 Soukromá paleta 7.2 Předávací protokoly/provozní dokumenty: 7.2.1 Seznam Všech balíků Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 54 (celkem 65) 7.2.2 Seznam dobírkových balíků 7.2.3 Seznam zahraničních zásilek Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 55 (celkem 65) 7.2.4 Seznam všech paletových zásilek CreatePackages - příklady PPL Parcel Business – bez COD, naprosté minimum ?> xmlns:v1= xmlns:v1 ="http://myapi.ppl.cz/v1" > QTxAh9Cwt ILN3……….z253H6XyGHLf16kXFPWNuTDvgHA== 80950589410 1 Olomouc Olomouc jmeno jmeno ulice ulice 77200 77200 SD 0 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 56 (celkem 65) PPL Parcel Private – bez COD, ko mpletní kontakty mpletní ?> xmlns:v1= xmlns:v1 ="http://myapi.ppl.cz/v1" > D0D79ZWtnJ/………….iKYj+awy2fZXp9ybw0O1dI4TFyw== 40950121995 13 13 Olomouc Olomouc kontaktni osoba [email protected] kontaktni osoba 777111222 ulice ulice 77200 77200 SD 0 ?> PPL Parcel Private – balík poslaný na ParcelShop s původní adresou příjemce adresou příjemce xmlns:v1= xmlns:v1 ="http://myapi.ppl.cz/v1" > Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 57 (celkem 65) D0D79ZWtnJ/6K8QjWAQQ9OAFB…………..SGNJOStn+ == 40950121995 13 13 Olomouc Olomouc kontaktni osoba [email protected] Name - Nazev Firmy 777111222 ulice ulice 77200 77200 KM10128401 SD 1 Pozn.: Balík je pak zobrazován v systému PPL, viz obrázek. Dochází ke změně adresy na adresu ParcelShopu. PPL Parcel Private – balík poslaný na ParcelShop s adresou PS z GetParcelShops ?> > Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 58 (celkem 65) D0D79ZWtnJJ+v…………….jSSGNJOStn+awybw0O1d I4TFyw== I4TFyw== 40950121995 40950121995 13 13 Olomouc Olomouc Kontakt, který si převezme balík [email protected] [email protected] BuBuSport BuBuSport PPL PPL Parcelshop 101 101 777123456 777123456 ulice ulice 77200 77200 KM10128401 KM10128401 SD 0 PPL Parcel Private – Sobotní doručení vypnuto ?> > D0D79ZWtnJJ+v…………….jSSGNJOStn+awybw0O1dI4TFyw== 40950262579 40950262579 13 13 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 59 (celkem 65) Olomouc Olomouc Contakt Contakt [email protected] [email protected] Name Name 721827252 721827252 street street 77200 77200 SD SD 0 0 PPL Parcel Private – COD, Připojištěný, Večerní doručení s Externím číslem ?> xmlns:v1= xmlns:v1 ="http://myapi.ppl.cz/v1" > hwVotO0TOL1UOhf6wZNoh……………gYACBsyuj84ds7fILakTw== 40990422619 14 14 note note 09 09 Olomouc Olomouc kontakt kontakt CZ CZ [email protected] jmeno jmeno jmeno2 jmeno2 721827252 ulice ulice 77200 77200 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 60 (celkem 65) CZK CZK 100 100 12345 12345 CZK CZK 51000 51000 ED ED B2CO B2CO 12345678EE SD 0 Soukromá paleta – Externí číslo, výnos do patra, odvoz starého spotřebiče ?> > YACgAAAN9DSiMACERBMDk…………0MjI2AAAAgBEkeRsyAyMyhH7w== 50950009523 50950009523 19 19 note note Krnov Krnov kontakt kontakt CZ CZ [email protected] [email protected] Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 61 (celkem 65) Podej Podej na depu depu jmeno2 jmeno2 7779712345 7779712345 ulice ulice 79401 79401 Olomouc Olomouc kontakt kontakt CZ CZ [email protected] [email protected] jmeno jmeno jmeno2 jmeno2 721827252 721827252 ulice ulice 77200 77200 2016-05-14 2016-05-14 B2CO B2CO 12345678EE 12345678EE OGB OGB FH FH JD0000400460000083935 JD0000400460000083935 60 60 60 60 90 90 110 110 38 38 JD0000400460000083936 JD0000400460000083936 10 10 22 22 90 90 110 110 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 62 (celkem 65) 51 51 1 1 SV SV PPL Parcel Private – Zvážený, Sobotní doručení povoleno ?> > D0D79ZWtnJJ+v…………….jSSGNJOStn+awybw0O1dI4TFyw== 40950262579 40950262579 13 13 Olomouc Olomouc Contakt Contakt [email protected] [email protected] Name Name 721827252 721827252 street street 77200 77200 SD SD 1 1 12.22 12.22 IN 09999 09999 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 63 (celkem 65) OUT OUT 09001 09001 OUT_SD OUT_SD 09901 09901 PPL Parcel Private – Zvážený, Sobotní doručení zakázáno ?> > D0D79ZWtnJJ+v…………….jSSGNJOStn+awybw0O1dI4TFyw== 40950262579 40950262579 13 13 Olomouc Olomouc Contakt Contakt [email protected] [email protected] Name Name 721827252 721827252 street street 77200 77200 SD SD 0 0 Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 64 (celkem 65) 12.22 12.22 IN 09999 09999 OUT OUT 09001 09001 Poznámky k revizím k revizím Datum poslední poslední revize: 13.09.2018 © PPL CZ s.r.o. Strana 65 (celkem 65)

myAPI_Dokumentace_v2.4.130918.pdf

Recommend Documents