Deliveo Website Plugin (DWP)

Pluginul Deliveo pentru site-uri web (DWP) este un modul Deliveo care poate fi integrat într-un site web și care permite vizitatorilor sau clienților site-ului să trimită direct colete, să-și verifice expedierile existente și, în funcție de funcțiile autorizate, să efectueze operațiuni suplimentare.

DWP se conectează la sistem prin intermediul API-ului Deliveo, prin urmare, pentru utilizarea sa este necesar un abonament Deliveo activ și acces la API.

Modulul poate fi integrat în propriul site web, fiind astfel util în special pentru serviciile de curierat care doresc ca clienții lor să poată înregistra sau consulta expedierile fără a fi nevoie de o înregistrare separată sau de utilizarea Portalului pentru clienți Deliveo.

Funcții principale

DWP oferă, printre altele, următoarele funcții:

• crearea unui nou colet;

• selectarea opțiunii de livrare;

• selectarea punctului de ridicare;

• gestionarea plății la livrare;

• utilizarea numărului de referință și a codului de urmărire;

• Gestionarea câmpurilor personalizate OP1–OP3;

• calcularea taxei de expediere;

• calcularea greutății volumetrice;

• plata online prin Barion;

• interogarea expedierii;

• afișarea informațiilor de urmărire;

• descărcarea etichetei;

• descărcarea fișei de semnături;

• modificarea sau anularea expedierii, în cazurile permise;

• inițierea returnării unei expedieri livrate.

O parte din funcțiile disponibile pot fi activate sau dezactivate din setări.

Expedierea trimiterilor

Una dintre funcțiile principale ale DWP este crearea de noi expedieri. În interfața de expediere, vizitatorul poate introduce datele necesare pentru transportul expedierii, iar DWP le transmite apoi către sistemul Deliveo.

Datele expeditorului

În secțiunea dedicată datelor expeditorului se pot introduce datele necesare pentru locul de preluare a expedierii și persoana de contact. Acestea pot include, de exemplu:

• numele;

• denumirea companiei;

• țara;

• cod poștal;

• localitatea;

• adresa;

• număr de telefon;

• adresa de e-mail.

Câmpurile afișate efectiv pot varia în funcție de versiunea și configurația DWP.

Datele destinatarului

În cazul datelor destinatarului, trebuie introduse datele necesare pentru livrare. La fel ca în cazul expeditorului, aici pot fi introduse datele de contact și adresa destinatarului.

Utilizarea punctului de ridicare

DWP poate afișa locațiile active de tip „Punct de colectare” create în Deliveo. Punctul de colectare poate fi selectat separat:

• pe pagina de preluare;

• pe pagina de livrare.

Astfel, expedierea poate pleca de la un punct de colectare, poate ajunge la un punct de colectare sau – în funcție de opțiunile oferite de serviciul de curierat – se poate utiliza un punct de colectare atât la plecare, cât și la destinație. DWP încarcă punctele de colectare direct din sistemul Deliveo, prin urmare gestionarea acestora nu se realizează în DWP, ci în cadrul datelor de bază corespunzătoare din Deliveo.

Gestionarea plătitorului facturii

DWP poate fi utilizat în două moduri, în funcție de faptul dacă toate expedierile online aparțin aceluiași client.

Utilizarea unui client fix

În configurație se poate specifica un ID fix al clientului. În acest caz:

• fiecare expediere creată din DWP este atribuită acestui client;

• vizitatorului nu i se afișează un bloc separat pentru plătitor;

• relația de facturare este determinată de clientul specificat în configurație.

Această opțiune poate fi utilizată în cazul site-urilor web în care DWP-ul este furnizat unui singur client cu contract.

Crearea unui client pe baza datelor furnizate

Dacă nu este configurat un Client fix, vizitatorul poate introduce datele plătitorului facturii. Pe baza acestora, DWP verifică dacă Clientul corespunzător există deja în sistemul Deliveo.

Dacă acesta este găsit, se utilizează clientul existent. Dacă nu se găsește un client corespunzător, DWP îl creează pe baza datelor furnizate, apoi asociază noua expediere cu acest client.

Conținutul expedierii și coletele

O expediere poate consta dintr-unul sau mai multe colete fizice. În DWP se pot adăuga mai multe colete la aceeași expediere. Pentru fiecare colet se pot specifica, printre altele:

• greutatea;

• lungime;

• lățime;

• înălțime;

• un identificator unic.

DWP determină datele agregate ale expedierii pe baza datelor fiecărui colet.

Greutatea totală și volumul total

În cazul utilizării mai multor colete, sistemul totalizează greutatea și volumul acestora. Pe baza dimensiunilor coletelor specificate, DWP calculează automat și greutatea volumetrică.

Cu ajutorul greutății volumetrice, chiar și coletele de dimensiuni mari, dar relativ ușoare, pot fi luate în considerare în mod corespunzător la calcularea tarifului.

Opțiuni de livrare

Pentru expediere se poate selecta opțiunea de livrare creată în Deliveo. DWP preia opțiunile de livrare disponibile din sistemul Deliveo, prin urmare crearea și gestionarea acestora se realizează pe Portalul dispeceratului.

Cu ajutorul opțiunii de livrare, serviciul de curierat poate oferi diferite moduri de prestare a serviciilor, de exemplu cu condiții diferite de livrare sau de preluare.

Plata la livrare

DWP acceptă înregistrarea expedierilor cu plată la livrare. Dacă expedierea implică plată la livrare, se pot introduce suma de plată la livrare și datele aferente. Gestionarea plății la livrare în Deliveo se realizează conform procesului standard de gestionare a plății la livrare.

Număr de referință și cod de urmărire

Pentru expediere se pot introduce:

• Număr de referință;

• Cod de urmărire.

Cu ajutorul acestora, identificatorii proprii ai sistemelor externe, magazinelor online sau proceselor din partea clientului pot fi asociați cu expedierea din Deliveo.

Câmpuri unice OP1–OP3

DWP acceptă câmpurile OP1, OP2 și OP3 ale Deliveo. Acestea sunt câmpuri de date unice care pot fi utilizate pentru a solicita informații suplimentare necesare pentru funcționarea propriu-zisă a serviciului de curierat. Denumirea afișată a câmpurilor poate fi modificată din configurație, astfel încât vizitatorul nu trebuie să vadă denumirile tehnice OP1, OP2 sau OP3.

Calculul tarifelor

DWP poate solicita tariful din sistemul Deliveo pe baza datelor expedierii. În cadrul calculului tarifului pot fi luate în considerare, printre altele:

• adresa de preluare și cea de livrare;

• opțiunea de livrare;

• numărul de colete;

• greutatea;

• volumul;

• greutatea volumetrică;

• plata la livrare;

• condițiile de tarifare configurate în Deliveo.

Tariful efectiv este întotdeauna determinat de tariful stabilit în Deliveo.

Plata online prin Barion

DWP poate fi utilizat și cu plata online prin Barion. Dacă integrarea Barion este activată și calculul tarifelor din Deliveo returnează o sumă de plată, vizitatorul poate achita online tariful serviciului ca parte a procesului de expediere a coletului.

În acest caz, procesul este următorul:

1. Vizitatorul completează datele expedierii.

2. DWP calculează tariful de livrare.

3. Vizitatorul efectuează plata pe platforma Barion.

4. După efectuarea cu succes a plății, DWP creează expedierea în Deliveo.

Astfel, sistemul evită crearea unei expedieri neplătite în cazul unei plăți eșuate sau întrerupte.

Consultarea expedierii

DWP dispune și de o funcție separată de interogare a expedierii. Această funcție poate fi activată sau dezactivată separat în configurație. Pentru a interoga expedierea, vizitatorul trebuie să introducă:

• DeliveoID-ul;

• codul poștal al destinatarului.

Utilizarea combinată a celor două date împiedică accesul oricui la datele expedierii doar pe baza unui DeliveoID.

Datele afișate la interogare

După identificarea cu succes, DWP poate afișa informațiile referitoare la colet.

Printre acestea se pot număra:

• starea actuală a expedierii;

• jurnalul expedierii;

• conținutul coletului;

• datele expeditorului;

• datele destinatarului;

• informațiile de urmărire;

• eticheta expedierii;

• fișa de semnătură.

Afișarea datelor expeditorului și ale destinatarului poate fi configurată separat.

Descărcarea etichetei

Eticheta corespunzătoare expedierii căutate poate fi descărcată din DWP, dacă această funcție este disponibilă. Acest lucru este util, de exemplu, în cazul în care expeditorul dorește să imprime și să lipească singur eticheta pe colet.

Fișa de semnătură

Afișarea sau descărcarea fișei de semnătură aferentă livrării poate fi, de asemenea, activată. Dacă funcția este activă și există un document corespunzător pentru expediere, acesta este disponibil din interfața de interogare a DWP.

Modificarea și ștergerea expedierii

În DWP se poate activa modificarea și ștergerea unui trimis creat anterior. Funcția poate fi utilizată numai dacă a fost activată în configurația DWP. În plus, trimisul trebuie să îndeplinească următoarele condiții:

• curierul nu l-a preluat încă;

• nu a fost încă livrat;

• nu a fost plătită.

Dacă s-a îndeplinit deja una dintre aceste condiții, modificarea sau ștergerea expedierii din DWP nu este permisă.

Retur

DWP acceptă și inițierea returnării expedierilor livrate. Această funcție poate fi activată separat. Dacă opțiunea de returnare este disponibilă pentru o expediere livrată, DWP pregătește noul formular de expediere pe baza datelor expedierii inițiale.

În acest proces, datele inițiale:

• datele expeditorului devin cele ale destinatarului returului;

• datele destinatarului devin cele ale expeditorului returului

.

Astfel, vizitatorul nu trebuie să introducă din nou toate datele de adresă. Returul înseamnă, din punct de vedere tehnic, crearea unui nou colet.

Personalizarea aspectului

Aspectul DWP este parțial configurabil. Printre altele, se pot seta:

• logo-ul propriu;

• culoarea temei;

• funcțiile afișate;

• denumirea anumitor câmpuri;

• denumirea afișată a câmpurilor OP1–OP3;

• datele afișate pe pagina de urmărire.

Cu ajutorul acestor opțiuni, aspectul DWP poate fi adaptat la site-ul web al serviciului de curierat.

Funcționare multilingvă

DWP poate fi utilizat în mai multe limbi. Cu ajutorul fișierelor de limbă corespunzătoare, aceeași instalare poate fi utilizată pe mai multe site-uri web în limbi diferite sau pentru mai multe segmente de clienți.

Instalare

DWP poate fi instalat pe un server web propriu. Pentru instalare, fișierele programului trebuie copiate în directorul web corespunzător, apoi trebuie creat și configurat fișierul de configurare. În configurație trebuie specificate, printre altele:

• datele de conectare la API-ul Deliveo;

• funcțiile pe care doriți să le utilizați;

• eventualul ID fix al clientului;

• setările de afișare;

• datele necesare pentru plata online;

• alți parametri de funcționare.

Variabilele de configurare specifice necesare pentru instalare și funcționare sunt incluse în fișierul .env.example .

Descărcare: https://gitlab.com/mav-it/deliveo-website-plugin

Demo: https://dwp.deliveo.eu/

Cerințe de server

DWP este o aplicație bazată pe PHP. Se recomandă utilizarea unei versiuni de PHP care este încă susținută oficial.

Dezvoltarea și remedierea erorilor Deliveo se realizează pentru versiunile PHP suportate. Nu ne asumăm responsabilitatea pentru remedierea erorilor de compatibilitate sau de funcționare rezultate din utilizarea unei versiuni PHP care nu mai este suportată sau care este depășită. Serverul web trebuie să dispună de extensiile PHP necesare pentru funcționarea DWP, precum și de posibilitatea unei conexiuni HTTPS externe.

Actualizare

După instalarea unei noi versiuni, este recomandat să comparați fișierul .env.example cu configurația anterioară, deoarece odată cu apariția unor funcții noi pot fi introduse și variabile de configurare noi.

Pluginul se poate actualiza automat de pe site-ul https://gitlab.com/mav-it/deliveo-website-plugin. Pentru a rula actualizarea, adăugați la adresa URL de instalare: /update

De exemplu: dwp.example.com/update

Informații importante

DWP se bazează pe API-ul Deliveo, prin urmare datele create sau interogate în DWP provin direct din sistemul Deliveo. DWP nu este în sine o bază de date separată a serviciului de curierat, ci o interfață web complementară a Deliveo.

Prin urmare, o mare parte din serviciile disponibile, opțiunile de livrare, punctele de ridicare, tarifele și alte reguli comerciale nu trebuie configurate în DWP, ci pe Portalul de dispecerat Deliveo.