Deliveo Website Plugin (DWP) je modul Deliveo, ktorý je možné integrovať do webovej stránky a ktorý umožňuje návštevníkom alebo zákazníkom webovej stránky priamo odoslať zásielku, vyhľadávať svoje existujúce zásielky a v závislosti od povolených funkcií vykonávať ďalšie operácie.
DWP sa pripája k systému prostredníctvom Deliveo API, preto je na jeho používanie potrebné aktívne predplatné Deliveo a prístup k API.
Modul je možné integrovať do vlastnej webovej stránky, preto je užitočný predovšetkým pre kuriérske služby, ktoré chcú, aby ich zákazníci mohli zaznamenávať alebo vyhľadávať zásielky bez nutnosti samostatnej registrácie alebo používania zákazníckeho portálu Deliveo.
Hlavné funkcie
DWP ponúka okrem iného nasledujúce funkcie:
-
vytvorenie novej zásielky;
-
výber možnosti doručenia;
-
výber výdajného miesta;
-
správa platby pri doručení;
-
použitie referenčného čísla a sledovacieho kódu;
-
Správa špecifických polí OP1–OP3;
-
výpočet poštovného;
-
výpočet objemovej hmotnosti;
-
online platba prostredníctvom Barion;
-
vyhľadávanie zásielok;
-
zobrazenie informácií o sledovaní zásielky;
-
stiahnutie štítku;
-
stiahnutie podpisového listu;
-
v prípade povolenia úprava alebo zrušenie zásielky;
-
iniciovanie vrátenia doručenej zásielky.
Niektoré z dostupných funkcií je možné v nastaveniach zapnúť alebo vypnúť.
Odosielanie zásielok
Jednou z hlavných funkcií DWP je vytváranie nových zásielok. Na rozhraní pre odosielanie zásielok môže návštevník zadať údaje potrebné na doručenie zásielky, ktoré DWP následne odošle do systému Deliveo.
Údaje o odosielateľovi
V časti s údajmi odosielateľa je možné zadať údaje potrebné pre miesto vyzdvihnutia zásielky a kontaktnú osobu. Môžu to byť napríklad:
-
meno;
-
názov spoločnosti;
-
krajina;
-
PSČ;
-
obec;
-
adresa;
-
telefónne číslo;
-
e-mailová adresa.
Skutočne zobrazené polia môžu závisieť od verzie a konfigurácie DWP.
Údaje o adresátovi
V údajoch o adresátovi je potrebné uviesť údaje potrebné na doručenie. Podobne ako v prípade odosielateľa je možné tu uviesť kontaktné údaje a adresu adresáta.
Využitie balíkových bodov
Systém DWP dokáže zobraziť aktívne lokality typu „Zberné miesto“, ktoré boli vytvorené v systéme Deliveo. Zberné miesto je možné zvlášť vybrať:
-
na stránke preberania zásielok;
-
na strane doručenia.
Zásielka tak môže odísť z balíkového bodu, doraziť do balíkového bodu alebo – v závislosti od možností poskytovaných kuriérskou službou – môže byť balíkový bod použitý na oboch stranách. DWP načíta balíkové body priamo zo systému Deliveo, preto sa ich správa neuskutočňuje v DWP, ale v príslušných kmeňových údajoch systému Deliveo.
Správa platiteľa faktúry
Systém DWP sa dá používať dvoma spôsobmi v závislosti od toho, či všetky webové zásielky patria k tomu istému zákazníkovi.
Použitie pevne definovaného zákazníka
V konfigurácii je možné zadať ID pevného zákazníka. V tomto prípade:
-
všetky zásielky vytvorené v DWP sa priradia k tomuto zákazníkovi;
-
návštevníkovi sa nezobrazí samostatný blok „Platiteľ faktúry“;
-
fakturačný vzťah určuje zákazník uvedený v konfigurácii.
Toto je možné použiť v prípade webových stránok, kde je DWP poskytované jedinému zmluvnému zákazníkovi.
Vytvorenie zákazníka na základe zadaných údajov
Ak nie je nastavený pevný zákazník, návštevník môže zadať údaje platiteľa faktúry. DWP na základe týchto údajov skontroluje, či príslušný zákazník už existuje v systéme Deliveo.
Ak ho nájde, použije existujúceho zákazníka. Ak sa príslušný zákazník nenájde, DWP ho vytvorí na základe zadaných údajov a následne priradí novú zásielku k tomuto zákazníkovi.
Obsah zásielky a balíky
Zásielka sa môže skladať z jedného alebo viacerých fyzických balíkov, t. j. kolí. V DWP je možné k tej istej zásielke pridať viacero kolí. Pre jednotlivé kolí je možné zadať okrem iného:
-
hmotnosť;
-
dĺžka;
-
šírka;
-
výška;
-
jedinečný identifikátor.
DWP na základe údajov o jednotlivých balíkoch určí súhrnné údaje o zásielke.
Celková hmotnosť a celkový objem
V prípade použitia viacerých balíkov systém zosumarizuje ich hmotnosť a objem. Na základe zadaných rozmerov balíkov DWP automaticky vypočíta aj objemovú hmotnosť.
Vďaka objemovej hmotnosti je možné pri výpočte poplatkov primerane zohľadniť aj veľké, ale relatívne ľahké zásielky.
Možnosti doručenia
Pre zásielku je možné vybrať možnosť doručenia vytvorenú v systéme Deliveo. DWP načíta dostupné možnosti doručenia zo systému Deliveo, preto sa ich vytváranie a správa uskutočňuje na dispečerskom portáli.
Pomocou možnosti doručenia môže kuriérska služba ponúkať rôzne spôsoby poskytovania služieb, napríklad s odlišnými podmienkami doručenia alebo vyzdvihnutia.
Platba pri doručení
DWP podporuje zaznamenávanie zásielok s platbou na dobierku. Ak je k zásielke priradená platba na dobierku, je možné zadať sumu platby na dobierku a súvisiace údaje. Správa platby na dobierku v systéme Deliveo prebieha podľa bežného postupu správy platieb na dobierku.
Referenčné číslo a sledovací kód
K zásielke je možné zadať:
-
Referenčné číslo;
-
Sledovací kód.
Pomocou nich je možné prepojiť vlastné identifikátory externých systémov, internetových obchodov alebo procesov na strane zákazníka so zásielkou v systéme Deliveo.
Jedinečné polia OP1–OP3
DWP podporuje polia Deliveo OP1, OP2 a OP3. Ide o špecifické dátové polia, ktoré je možné využiť na vyžiadanie doplňujúcich informácií potrebných pre vlastnú prevádzku kuriérskej služby. Zobrazený názov polí je možné zmeniť v konfigurácii, takže návštevníkovi sa nemusí zobrazovať technické označenie OP1, OP2 alebo OP3.
Výpočet poplatkov
Systém DWP je schopný na základe údajov o zásielke vyžiadať cenu od systému Deliveo. Pri výpočte ceny sa môžu zohľadniť okrem iného:
-
adresa vyzdvihnutia a doručenia;
-
možnosť doručenia;
-
počet balíkov;
-
hmotnosť;
-
objem;
-
objemová hmotnosť;
-
platba na dobierku;
-
podmienky cenníka nastavené v Deliveo.
Skutočnú výšku poplatku vždy určuje cenník nastavený v systéme Deliveo.
Online platba cez Barion
Službu DWP je možné využívať aj prostredníctvom online platby cez Barion. Ak je integrácia s Barionom povolená a výpočet poplatkov v systéme Deliveo vygeneruje sumu na zaplatenie, návštevník môže poplatok za službu uhradiť online ako súčasť odoslania zásielky.
Postup v tomto prípade je nasledovný:
-
Návštevník vyplní údaje o zásielke.
-
Systém DWP vypočíta cenu za dopravu.
-
Návštevník vykoná platbu prostredníctvom rozhrania Barion.
-
Po úspešnej platbe DWP vytvorí zásielku v systéme Deliveo.
Týmto spôsobom systém zabráni tomu, aby v prípade neúspešnej alebo nedokončenej platby vznikla nezaplatená zásielka.
Vyhľadávanie zásielok
DWP disponuje aj samostatnou funkciou vyhľadávania zásielok. Túto funkciu je možné v konfigurácii samostatne zapnúť alebo vypnúť. Na vyhľadanie zásielky musí návštevník zadať:
-
DeliveoID;
-
PSČ adresáta.
Kombinované použitie týchto dvoch údajov zabraňuje tomu, aby si ktokoľvek mohol prezrieť údaje o zásielke len na základe znalosti DeliveoID.
Údaje zobrazené pri vyhľadávaní
Po úspešnej identifikácii môže DWP zobraziť informácie týkajúce sa zásielky.
Medzi ne môžu patriť:
-
aktuálny stav zásielky;
-
protokol zásielky;
-
obsah zásielky;
-
údaje o odosielateľovi;
-
údaje o príjemcovi;
-
informácie o sledovaní zásielky;
-
štítok zásielky;
-
potvrdenie o prevzatí.
Zobrazenie údajov odosielateľa a príjemcu je možné individuálne nakonfigurovať.
Stiahnutie štítku
Štítok príslušnej zásielky je možné stiahnuť z DWP, ak je táto funkcia k dispozícii. To je užitočné napríklad vtedy, ak si odosielateľ zásielky chce sám vytlačiť a nalepiť štítok na balík.
Potvrdenie o doručení
Zobrazenie alebo stiahnutie potvrdenia o doručení súvisiaceho s doručením je tiež možné povoliť. Ak je táto funkcia aktívna a k zásielke je k dispozícii príslušný dokument, je dostupný z vyhľadávacieho rozhrania DWP.
Úprava a zrušenie zásielky
V DWP je možné povoliť úpravu a vymazanie predtým vytvorenej zásielky. Túto funkciu je možné použiť len vtedy, ak bola povolená v konfigurácii DWP. Okrem toho musí zásielka spĺňať aj nasledujúce podmienky:
-
kuriér ju ešte neprevzal;
-
ešte nebola doručená;
-
nebolo zaplatené.
Ak už došlo k niektorému z týchto prípadov, úprava alebo zrušenie zásielky v systéme DWP nie je povolené.
Vrátenie
Systém DWP podporuje aj iniciovanie vrátenia doručených zásielok. Túto funkciu je možné osobitne povoliť. Ak je vrátenie doručenej zásielky dostupné, systém DWP pripraví nový formulár na odoslanie zásielky na základe údajov pôvodnej zásielky.
Pritom sa pôvodné:
-
údaje odosielateľa sa stanú údajmi adresáta vrátenia;
-
údaje príjemcu sa stanú údajmi odosielateľa vrátenej zásielky
.
Návštevník tak nemusí znovu zadávať kompletné adresné údaje. Vrátenie zásielky technicky znamená vytvorenie novej zásielky.
Prispôsobenie vzhľadu
Vzhľad DWP je čiastočne konfigurovateľný. Okrem iného je možné nastaviť:
-
vlastné logo;
-
farbu motívu;
-
zobrazované funkcie;
-
názvy jednotlivých polí;
-
zobrazené názvy polí OP1–OP3;
-
údaje zobrazené na stránke sledovania zásielok.
Vďaka tomu je možné vzhľad DWP prispôsobiť webovej stránke kuriérskej služby.
Viacjazyčná podpora
DWP je možné používať vo viacerých jazykoch. Pomocou príslušných jazykových súborov je možné tú istú inštaláciu používať na viacerých webových stránkach v rôznych jazykoch alebo pre rôzne skupiny zákazníkov.
Inštalácia
DWP je možné nainštalovať na vlastný webový server. Na inštaláciu je potrebné skopírovať súbory programu do príslušného webového adresára a následne vytvoriť a nakonfigurovať konfiguračný súbor. V konfigurácii je potrebné okrem iného uviesť:
-
pripojovacie údaje k Deliveo API;
-
funkcie, ktoré sa majú používať;
-
prípadné pevné ID zákazníka;
-
nastavenia zobrazenia;
-
údaje potrebné na online platbu;
-
ďalšie prevádzkové parametre.
Konkrétne konfiguračné premenné potrebné na inštaláciu a prevádzku sú uvedené v súbore .env.example .
Stiahnutie: https://gitlab.com/mav-it/deliveo-website-plugin
Ukážka: https://dwp.deliveo.eu/
Požiadavky na server
DWP je aplikácia založená na PHP. Vždy sa odporúča používať verziu PHP, ktorá je ešte oficiálne podporovaná.
Vývoj a opravy chýb v Deliveo prebiehajú pre podporované verzie PHP. Nezodpovedáme za opravy kompatibilných alebo prevádzkových chýb vyplývajúcich z používania už nepodporovaných, zastaraných verzií PHP. Webový server musí disponovať PHP rozšíreniami potrebnými na fungovanie DWP a možnosťou externého HTTPS pripojenia.
Aktualizácia
Po inštalácii novej verzie odporúčame porovnať aktuálny .env.example súbor s predchádzajúcou konfiguráciou, pretože pri zavedení nových funkcií môžu byť pridané aj nové konfiguračné premenné.
Plugin sa dokáže aktualizovať sám z webovej stránky https://gitlab.com/mav-it/deliveo-website-plugin. Na spustenie aktualizácie zadajte za inštalačnú URL adresu: /update
Napr.: dwp.example.com/update
Dôležité informácie
DWP je postavené na API Deliveo, preto údaje vytvorené alebo vyžiadané v DWP pochádzajú priamo zo systému Deliveo. DWP samo o sebe nie je samostatnou databázou kuriérskych služieb, ale webovým doplnkovým rozhraním Deliveo.
Preto je potrebné značnú časť dostupných služieb, možností doručenia, výdajných miest, poplatkov a ďalších obchodných pravidiel nakonfigurovať nie v DWP, ale na dispečerskom portáli Deliveo.