Deliveo Website Plugin (DWP)

Deliveo Website Plugin (DWP) je modul Deliveo, který lze integrovat do webových stránek a který umožňuje návštěvníkům nebo zákazníkům těchto stránek přímo odesílat zásilky, vyhledávat své stávající zásilky a v závislosti na povolených funkcích provádět další operace.

DWP se k systému připojuje prostřednictvím API Deliveo, proto je k jeho používání nutné aktivní předplatné Deliveo a přístup k API.

Modul lze integrovat do vlastních webových stránek, proto je užitečný především pro kurýrní služby, které chtějí, aby jejich zákazníci mohli zadávat nebo vyhledávat zásilky i bez samostatné registrace nebo použití zákaznického portálu Deliveo.

Hlavní funkce

DWP mimo jiné nabízí následující funkce:

• vytvoření nové zásilky;

• výběr možnosti doručení;

• výběr výdejního místa;

• správa platby na dobírku;

• použití referenčního čísla a sledovacího kódu;

• správa individuálních polí OP1–OP3;

• výpočet poštovného;

• výpočet objemové hmotnosti;

• online platba přes Barion;

• vyhledávání zásilky;

• zobrazení informací o sledování zásilky;

• stažení štítku;

• stažení podpisového listu;

• v povolených případech změna nebo zrušení zásilky;

• zahájení procesu vrácení doručené zásilky.

Některé z dostupných funkcí lze v nastavení zapnout nebo vypnout.

Odeslání zásilky

Jednou z hlavních funkcí DWP je vytváření nových zásilek. Na rozhraní pro odeslání zásilky může návštěvník zadat údaje potřebné k přepravě zásilky, které DWP následně předá do systému Deliveo.

Údaje o odesílateli

V části s údaji o odesílateli lze zadat údaje potřebné pro místo vyzvednutí zásilky a kontaktní osobu. Může se jednat například o:

• jméno;

• název společnosti;

• země;

• PSČ;

• obec;

• adresa;

• telefonní číslo;

• e-mailová adresa.

Skutečně zobrazená pole se mohou lišit v závislosti na verzi a konfiguraci DWP.

Údaje o příjemci

V údajích o příjemci je třeba uvést údaje nezbytné pro doručení. Stejně jako u odesílatele lze i zde zadat kontaktní a adresní údaje příjemce.

Využití balíkových bodů

DWP dokáže zobrazit aktivní lokality typu „Zásilkový bod“ vytvořené v systému Deliveo. Zásilkový bod lze samostatně vybrat:

• na stránce pro vyzvednutí zásilky;

• na straně doručení.

Zásilka tak může být odeslána z balíkového bodu, doručena do balíkového bodu nebo – v závislosti na možnostech poskytovaných kurýrní službou – lze balíkový bod využít na obou stranách. DWP načítá balíkové body přímo ze systému Deliveo, proto se jejich správa neprovádí v DWP, ale v příslušných kmenových datech systému Deliveo.

Správa plátce faktury

DWP lze používat dvěma způsoby v závislosti na tom, zda všechny webové zásilky patří ke stejnému zákazníkovi.

Použití pevně přiřazeného zákazníka

V konfiguraci lze zadat pevné ID zákazníka. V tomto případě:

• všechny zásilky vytvořené v DWP budou přiřazeny tomuto zákazníkovi;

• návštěvníkovi se nezobrazí samostatný blok „Plátce faktury“;

• fakturační vztah určuje zákazník zadaný v konfiguraci.

Tuto funkci lze použít u webových stránek, kde je DWP poskytováno pouze jednomu smluvnímu zákazníkovi.

Vytvoření zákazníka na základě zadaných údajů

Pokud není nastaven žádný pevný zákazník, může návštěvník zadat údaje plátce faktury. DWP na základě těchto údajů ověří, zda již v systému Deliveo existuje odpovídající zákazník.

Pokud je nalezen, použije stávajícího zákazníka. Pokud není nalezen odpovídající zákazník, DWP jej vytvoří na základě zadaných údajů a následně k tomuto zákazníkovi přiřadí novou zásilku.

Obsah zásilky a balíky

Zásilka se může skládat z jednoho nebo více fyzických balíků, tj. ColliBalicí jednotka. Ukazuje, kolik kusů je součástí dané zásilky.. V DWP lze ke stejné zásilce přidat i více ColliBalicí jednotka. Ukazuje, kolik kusů je součástí dané zásilky.. U jednotlivých ColliBalicí jednotka. Ukazuje, kolik kusů je součástí dané zásilky. lze mimo jiné zadat:

• hmotnost;

• délka;

• šířka;

• výška;

• jedinečný identifikátor.

DWP určí souhrnné údaje o zásilce na základě údajů o jednotlivých balících.

Celková hmotnost a celkový objem

V případě použití více balíků systém sečte jejich hmotnost a objem. Na základě zadaných rozměrů balíků DWP automaticky vypočítá také objemovou hmotnost.

Díky objemové hmotnosti lze při výpočtu poplatků náležitě zohlednit i velké, ale relativně lehké zásilky.

Možnosti dopravy

Pro zásilku lze vybrat možnost dopravy vytvořenou v systému Deliveo. DWP načítá dostupné možnosti dopravy ze systému Deliveo, proto se jejich vytváření a správa provádí na dispečerském portálu.

Pomocí možnosti dopravy může kurýrní služba nabízet různé způsoby poskytování služeb, například s odlišnými podmínkami doručení nebo vyzvednutí.

Platba na dobírku

DWP podporuje zadávání zásilek s platbou na dobírku. Pokud je k zásilce připojena platba na dobírku, lze zadat částku dobírky a související údaje. Správa dobírky v systému Deliveo probíhá podle standardního procesu správy dobírky.

Referenční číslo a sledovací kód

K zásilce lze zadat:

• Referenční číslo;

• sledovací kód.

Pomocí těchto údajů lze k zásilce v systému Deliveo přiřadit vlastní identifikátory externích systémů, internetových obchodů nebo procesů na straně zákazníka.

Jedinečná pole OP1–OP3

DWP podporuje pole Deliveo OP1, OP2 a OP3. Jedná se o vlastní datová pole, která lze využít k vyžádání doplňujících informací nezbytných pro vlastní provoz kurýrní služby. Zobrazený název polí lze změnit v konfiguraci, takže návštěvníkovi se nemusí zobrazovat technické označení OP1, OP2 nebo OP3.

Výpočet poplatku

Systém DWP je schopen na základě údajů o zásilce vyžádat poplatek ze systému Deliveo. Při výpočtu poplatku lze zohlednit mimo jiné:

• adresa vyzvednutí a doručení;

• možnost dopravy;

• počet balíků;

• hmotnost;

• objem;

• objemová hmotnost;

• platba na dobírku;

• podmínky tarifů nastavené v Deliveo.

Skutečnou cenu vždy určuje ceník nastavený v systému Deliveo.

Online platba přes Barion

Službu DWP lze využít i s online platbou přes Barion. Pokud je integrace s Barionem povolena a výpočet poplatku v systému Deliveo vykáže částku k úhradě, může návštěvník v rámci odeslání zásilky uhradit poplatek za službu online.

Postup v tomto případě je následující:

1. Návštěvník vyplní údaje o zásilce.

2. Systém DWP vypočítá cenu přepravy.

3. Návštěvník provede platbu v rozhraní Barion.

4. Po úspěšné platbě DWP vytvoří zásilku v systému Deliveo.

Systém tak zabrání tomu, aby v případě neúspěšné nebo nedokončené platby vznikla neuhrazená zásilka.

Vyhledávání zásilky

DWP disponuje také samostatnou funkcí pro vyhledávání zásilek. Tuto funkci lze v konfiguraci samostatně povolit nebo zakázat. Pro vyhledání zásilky musí návštěvník zadat:

• DeliveoID;

• PSČ příjemce.

Kombinace těchto dvou údajů zabraňuje tomu, aby si kdokoli mohl prohlédnout údaje o zásilce pouze na základě znalosti DeliveoID.

Údaje zobrazené při vyhledávání

Po úspěšné identifikaci může DWP zobrazit informace týkající se zásilky.

Mezi ně mohou patřit:

• aktuální stav zásilky;

• protokol zásilky;

• obsah zásilky;

• údaje o odesílateli;

• údaje o příjemci;

• informace o sledování zásilky;

• štítek zásilky;

• potvrzení o převzetí.

Zobrazení údajů o odesílateli a příjemci lze nastavit samostatně.

Stažení štítku

Štítek patřící k vyhledané zásilce lze stáhnout z DWP, pokud je tato funkce k dispozici. To je užitečné například v případě, že si odesílatel zásilky chce sám vytisknout a nalepit štítek na balík.

Potvrzení o převzetí

Zobrazení nebo stažení potvrzení o doručení lze rovněž povolit. Je-li tato funkce aktivní a je-li k zásilce k dispozici příslušný dokument, je tento dostupný z vyhledávacího rozhraní DWP.

Úprava a smazání zásilky

V systému DWP lze povolit úpravu a smazání dříve vytvořené zásilky. Tuto funkci lze použít pouze v případě, že byla povolena v konfiguraci systému DWP. Kromě toho musí zásilka splňovat následující podmínky:

• kurýr zásilku ještě nepřevzal;

• ještě nebyla doručena;

• nebyla zaplacena.

Pokud již došlo k některé z těchto situací, není v DWP povoleno zásilku upravovat ani mazat.

Vrácení zásilky

DWP podporuje také iniciování vrácení doručených zásilek. Tuto funkci lze samostatně povolit. Pokud je u doručené zásilky k dispozici možnost vrácení, DWP připraví nový formulář pro odeslání zásilky na základě údajů původní zásilky.

Přitom se původní:

• údaje o odesílateli se stanou údaji o příjemci vrácené zásilky;

• údaje o příjemci se stanou údaji o odesílateli vrácené zásilky

.

Návštěvník tak nemusí znovu zadávat kompletní adresní údaje. Vrácení zásilky technicky znamená vytvoření nové zásilky.

Přizpůsobení vzhledu

Vzhled DWP je částečně konfigurovatelný. Lze mimo jiné nastavit:

• vlastní logo;

• barvu motivu;

• zobrazované funkce;

• názvy jednotlivých polí;

• zobrazené názvy polí OP1–OP3;

• údaje zobrazené na stránce pro sledování zásilek.

Díky tomu lze vzhled DWP přizpůsobit webovým stránkám kurýrní služby.

Vícejazyčná podpora

DWP lze používat ve více jazycích. Pomocí příslušných jazykových souborů lze stejnou instalaci použít i na webových stránkách v několika různých jazycích nebo pro různé skupiny zákazníků.

Instalace

DWP lze nainstalovat na vlastní webový server. Pro instalaci je třeba zkopírovat soubory programu do příslušného webového adresáře a poté vytvořit a nastavit konfigurační soubor. V konfiguraci je třeba mimo jiné zadat:

• připojovací údaje k API Deliveo;

• funkce, které chcete používat;

• případné pevné ID zákazníka;

• nastavení zobrazení;

• údaje potřebné pro online platby;

• další provozní parametry.

Konkrétní konfigurační proměnné potřebné pro instalaci a provoz jsou obsaženy v souboru .env.example .

Stažení: https://gitlab.com/mav-it/deliveo-website-plugin

Ukázka: https://dwp.deliveo.eu/

Požadavky na server

DWP je aplikace založená na PHP. Vždy se doporučuje používat verzi PHP, která je stále oficiálně podporována.

Vývoj a opravy chyb v Deliveo se provádějí pro podporované verze PHP. Nepřijímáme odpovědnost za opravy kompatibilních nebo provozních chyb vyplývajících z použití již nepodporované, zastaralé verze PHP. Webový server musí disponovat PHP moduly nezbytnými pro fungování DWP a možností externího HTTPS připojení.

Aktualizace

Po instalaci nové verze je vhodné porovnat aktuální .env.example soubor s předchozí konfigurací, protože s příchodem nových funkcí mohou být přidány i nové konfigurační proměnné.

Plugin je schopen se sám aktualizovat z webu https://gitlab.com/mav-it/deliveo-website-plugin. Pro spuštění aktualizace zadejte za instalační URL: /update

Např.: dwp.example.com/update

Důležité informace

DWP je založeno na API Deliveo, proto data vytvořená nebo načtená v DWP pocházejí přímo ze systému Deliveo. DWP samo o sobě není samostatnou databází kurýrních služeb, ale webovým doplňkovým rozhraním Deliveo.

Významnou část dostupných služeb, možností doručení, výdejních míst, poplatků a dalších obchodních pravidel je proto třeba konfigurovat nikoli v DWP, ale na dispečerském portálu Deliveo.