TUTORIAL

Extensie DPD Woocommerce

by Zitec

2016/06

Page 1 of 17

Contents

Serviciul de livrare DPD .................................................................................................................................... 3

Integrarea cu Woocommerce ........................................................................................................... 3
Recomandari ............................................................................................................................................... 3
Instalare ......................................................................................................................................................... 4
Configurare .................................................................................................................................................. 4
Setari livrare ................................................................................................................................................. 5
Configurare COD (Cash on delivery - Plata la livrare) ..................................................................... 6
Configurare Tabel de taxare ................................................................................................................... 7
Procesarea comenzilor ......................................................................................................................... 8
Aspecte generale ....................................................................................................................................... 8
Auto-validare cod postal ......................................................................................................................... 8
Creare livrare ............................................................................................................................................... 9
Tiparire documente .................................................................................................................................. 9
Urmarire comanda .................................................................................................................................. 10
Procesarea fara comunicarea cu DPD. ...................................................................................... 12
Folosirea extensiei in frontend ............................................................................................................ 12
Probleme frecvente ............................................................................................................................... 12

2016/06

Page 2 of 17

Serviciul de livrare DPD

Integrarea cu Woocommerce
Extensia DPD permite intr-un mod flexibil procesarea si gestionarea costurilor de livrare prin
integrarea cu sistemele principale ale companiei. Pasii necesari utilizarii acestei extensii sunt detaliati
in paragrafele urmatoare.
Principalele facilitati ale extensiei sunt:

Definirea flexibila a preturilor de livrare cu ajutorul tabelului de taxare

Gestionarea pachetelor trimise
Corectarea automata codului postal
Tiparirea etichetelor de livrare pentru expeditii normale si expeditii cu ramburs
Urmarirea livrarilor
Comunicarea cu serviciul DPD
Generare si tiparire borderou si etichete de livrare
Status livrari

Recomandari

2016/06

Extensia este compatibila cu Wordpress 4.x si Woocommerce 2.5.x

Conform recomandarilor Wordpress recomandam crearea unei copii de siguranta a
bazei de date si a fisierelor, inainte de orice noua instalare
Pentru folosirea extensiei in parametrii optimi este necesara instalarea extensiei PHP
mbstring.
Versiunea PHP minima este 5.2
De asemenea este nevoie ca PHP SOAP sa fie instalat.
Este obligatoriul ca produsele sa aiba definita greutatea deoarece DPD taxeaza in functie de
greutatea livrarii. Daca produsele nu au greutatea speficifata atunci metoda DPD nu va
disponibila in checkout.

Page 3 of 17

Instalare
Cerinte pentru instalare:
Wordpress 4.x
Woocommerce 2.5.x
PHP mbstring
PHP 5.2
PHP SOAP
Greutatea produselor setata in admin
Acesta extensie se instaleaza prin intermediulu sistemului de Plugins specific Wordpress.
Dupa incarcarea extensiei DPD pe server se poate naviga in meniul principal Plugins -> Installed
Plugins. Se va identifica extensia Woocommerce Zitec DPD si se va apasa butonul Install . Atentie:
instalarea extensiei poate dura cateva secunde.
Odata rulat scriptul de instalare se poate trece la configurarea extensiei.

Configurare
Pentru a configura extensia trebuie parcursi urmatorii pasii afisati mai jos (accesibili din meniul DPD,
in cadrul meniului de setari Woocommerce -> Settings)
Setari Livrare
Setari de plata, in cazul in care se doreste si activarea unei metode de plata
Completarea Tabelului de Taxare, pentru a defini modul in care sunt taxati clientii

2016/06

Page 4 of 17

Setari livrare
Setarile metodei de livrare se regasesc in Sectiunea DPD / Shipping.
Urmatoarele campuri vor fi completate in acesta sectiune:
Activ/Enabled: Pentru a activa sau dezactiva metoda de plata
Corecteaza autom at codul postal in checkout: Da pentru a activa corectia si
generarea automata de cod postal in checkout. Daca sistemul nu reuseste sa identifice
codul postal suficient de precis pe baza adresei intoduse de client (tara, regiune,
strada/adresa) atunci administratorul site-ului va fi nevoit sa valideze manual codul postal
(alegand dintr-o lista de coduri postale posibile) inainte de procesa livrarea comenzii
(apasarea butonului Livreaza/Ship din interfata de vizualizare comanda).
M odul Productie/Production M ode: Pentru a activa extensia pentru testare selectati Nu/No.

Titlul m etodei de livrare/ Shipping m ethod label: Titlul extensiei

Utilizator DPD/W eb Service Usernam e: Este numele utilizatorului optinut de la DPD
pentru conectarea la serviciul web
Parola DPD/W eb Service Passw ord
W eb Service Connection Tim eout: Timpul exprimat in secunde in care aplicatia
asteapta o cerere efectuata la serviciul web DPD
Id-ul adresei de expeditie/Sender Address Id: Obtinut la semnarea contractului
Id-ul platitorului/Payer Id: Obtinut la semnarea contractului
Serviciu/Service: Este tipul serviciului de livrare disponibil in contract.
Puteti vizualiza poza din anexa 1.1

Atentie!!!: Activati doar serviciile de livrare DPD disponibile in contract, pentru a elimina procesarea
inutila de date (apeluri ale API-ului DPD).

2016/06

Page 5 of 17

Configurare COD (Cash on delivery - Plata la livrare)

Aceasta componenta permite clientilor magazinului OpenCart sa plateasca contravaloarea comenzii
la livrare. Metoda de livrare va avea asociata o taxa proprie (care poate fi definita de administratorul
magazinului) si va fi activa in checkout doar daca o metoda de livrare DPD a fost anterior aleasa.
Pentru a realiza aceste setari se va accesa DPD / Paym ent sau puteti vizualiza un print screen in
anexa 1.2
Atentie!!!: Detaliile de taxare setate in aceasta sectiune (Tip plata si Tip valoare plata) vor fi folosite
doar daca nu se defineste o regula in Tabelul de taxare pentru serviciul de livrare.
Setarile disponibile pentru metoda de livrare sunt:

2016/06

Activ/Enabled: Metoda de plata este activata/dezactivata in orice context pentru websiteul selectat
Titlu/ Paym ent m ethod title
Serviciu/ Available for DPD shipping services: Selecteaza serviciul de livrare pentru
care metoda de plata este activa
Tip plata/Paym ent Type: in general va fi aleasa optiunea Cash
Tip valoare plata/Paym ent am ount type: Se va alege aici tipul de taxare aplicat metodei
de plata in cazul in care nu sunt definite intrari in tabela de taxare. Tipul de taxare poate fi
Suma fixa sau Valoare procentuala din valoarea produselor comenzii. Daca exita intrari valide
in tabela de taxare pentru un anumit serviciu de livrare DPD, atunci valoarea setata in
sectiunea System / Configuration nu va fi folosita.
Valoare plata/Paym ent am ount: In functie de valoarea selectata la campul anterior,
valearea campului Valoare plata va fi folosit ca procent sau ca suma fixa.
M etoda de plata activa pentru tarile/Paym ent from Applicable Countries
Paym ent m ethod on delivery se poate opta daca clientul plateste cu numerar sau cu
cardul la livrare

Page 6 of 17

Configurare Tabel de taxare

Tabelul de taxare reprezinta configurari particulare pentru fiecare serviciu de livrare in parte care
permit administratorului de magazin sa controleze mai precis costurile si cheltuielile de livrare.
Astfel cu ajutorul tabelului de livrare se poate defini o gama variata de reguli de taxare, in functie de:

codul postal ar destinatarului

tara de destinatie
regiune de destinatie
magazinul pe care este plasata comanda
raportul greutate / destinatie
raportul pret / destinatie

Cu ajutorul conditiilor de mai sus se pot defini preturi speciale pentru livrare si plata:
plata livrari cu o valoare fix
adaos procentual la valoarea livrarii perceputa de DPD
adaos cu valoare fixa peste valoarea livrarii perceputa de DPD
contravaloare plata ramburs - gratuita
contravaloare plata ramburs - suma fixa
contravaloare plata ramburs - suma procentuala din valoarea produselor
Mai multe detalii in Anexa 1.3

Cam purile com pletate in Tabelul de taxare sunt:

2016/06

Tara dest./Country: Tara pentru care se respecta regula de taxare

Regiunea/Statul dest./Dest Region/State: Judetul pentru care se respecta regula de
taxare
Cod postal dest./Destination Zip/Postal Code: Codul postal pentru care se respecta
regula de taxare. se va lasa gol sa se va intorduce *, pentru orice cod postal
Serviciu/Service: Tipul de serviciu de livrare DPD
Conditie/Condition: Reprezinta conditia particulara impusa de regula: respectiv raportul
greutate / destinatie sau raportul pret / destinatie
Greutate (si m ai m are) /W eight (and above): Acest campa apare in cazul in care s-a
selectat conditia de tip greutate. Se va completa cu greutatea in kg incepand de la care se
aplica regula.
Pret (si m ai m are)/Price (and above): Apare in cazul selectarii conditiei de tip pret vs
destinatie. Se ca completa pretul de la care incepe aplicarea regulii de livrare
Activeaza M etoda Livrare/Enable Shipping M ethod
Calcularea pretului de livrare/Shipping Price Calculation: tipul de calul al pretului
metodei de livrare. Poate fi valoare fixa, adaos procentual sau adaos fix
Pret livrare/Shipping Price
Page 7 of 17

Adaos valoare procentuala la valoarea DPD/Shipping Percentage

Adaos valoare fixa la valoare DPD/Add fixed am ount to price
Taxa plata la livrare/Cash On Delivery Surcharge Calculation: reprezinta tipul de
taxare al metode de plata ramburs. Poate fi pret fix, zero sau pret procentual din valoarea
comenzii
Taxa valoare fixa pentru Plata la livrare
Taxa m inim a CDO (plata la livrare)/M inim um COD Surcharge

Procesarea comenzilor
Aspecte generale
In procesul de livrare al comenzii din interfata magazinului Woocommerce vor fi posibile
urmatoarele actiuni:

Verificarea manuala a codului postal sau folosirea unui cod postal identificat automat pentru
adresa utilizatorului
Impartirea produselor in pachete
Adaugarea unei descrieri cutiilor
Obtinerea unui raport de pret de livrare in cazul in care se foloseste adaos sau un pret fix.
Calcularea pretului final dupa impartirea in cutii, sau alte schimbari in partea de administrare
(adresa sau comanada).
Crearea borderoului
Generearea in format PDF a etichetelor si borderoului

Auto-validare cod postal

Nevoia de a procesa livrarile cat mai eficient impune folosirea codurilor postale in sistemul de livrare
DPD.
Extensia Woocommerce vine in sprijinul administratorilor de magazine online prin
implementarea unei validari automate a codului postal aferent adresei completate de client.
Extensia de livrare permite verificarea codului postal din adresa atat automat (in momentul
comunicarii cu serviciul - la plasarea comenzii) dar ofera si anumite alerte in cazul in care codul
postal nu a putut fi stabilit cu exactitate. In cazul in care un cod postal nu a putut fi generat cu o
precizie multumitoare, extensia va avertiza administratorul de site (in interfata de vizualizare
comanda sau vizualizare livrare ) faptul ca un cod postal generat automat a fost folosit pentru
generarea pretului de livrare, insa se recomanda validarea acestuia manual, inainte de expedierea
coletului.
Cautarea codului postal se face prin selectarea uneia dintre sugestiile gasite in baza de date dpd
pentru adresa deja completatat de client sau actializata de administratorul de site.
Odata editata adresa de livrare a comenzii, toate avertizarile dispar, si codul postal este considerat
valid. Din acest moment se poate continua procesarea comenzii.

2016/06

Page 8 of 17

Creare livrare
In interfata de vizualizare a comenzii se pot observa detaliile de livrare si plata. Se poate remarca, de
asemenea, faptul ca metoda de plata impune o taxa specifica platii ramburs, care de asemenea
afecteaza totalul comenzii, total care se va factura.

In interfata prelucrarii de comanda va aparea sectiunea DPD Shipping, in partea de jos a comenzii.
Aici se poate alege numarul de cutii in care se face livrare dar si daca se va comunica cu DPD pentru
obtinerea pretului actualizat.
La modificarea impartirii produselor in cutii se va actualiza pretul livrarii si diferenta dintre acesta si
suma platita de client pentru livrare.

Dupa generarea livrarii in sistemul DPD, administratorul va primi un mesaj de succes si poate vizualiza
starea livrarii in timp real prin apasarea link-ului Urmareste comanda

Tiparire documente
Tiparirea etichetelor este disponibila atat din interfata de vizualizare a comenzii dar si din locatia
Woocommerce -> Settings -> DPD -> Shipping List

2016/06

Page 9 of 17

Tiparirea Etichetelor de livrare reprezinta generarea unui fisier PDF care va contine cate o pagina
pentru fiecare livrare bifata in lista. Fiecare pagina va contine desigur cate o eticheta pentru fiecare
cutie.
Borderoul este un document obligatoriu care va fi solicitat de catre agentul DPD la ridicarea
coletelor. Borderoul trebuie sa contina livrarile pentru intreaga zi, si trebuie tiparit in doua
exemplare.
Borderoul va genera un fisier PDF care va ingloba livrarile selectate prin bifare.
Se recomanda filtrarea pe zile in lista livrarilor (DPD Carrier / Shipments), ulterior apasarea butonului
Check all, urmat de generarea documentului prin apasarea butonului Create manifest
Tot in aceasa sectiune se poate alege fiecare livrare in parte pentru a obtine mai multe informatii.
Exemple ale acestor documente se regasesc in Anexa 1.4
Un link de urmarire al livrarii este de asemenea prezent.

Urmarire comanda
Din momentul plasarii livrarii, in interfata de vizualizare a comenzii si a livrarii sau in contul clientului
este disponibil link-ul de urmarire.

2016/06

Page 10 of 17

2016/06

Page 11 of 17

Procesarea fara comunicarea cu DPD.

Asa cum an prezentat mai sus, in sectiune de administrare este posibila procesarea comenzilor fara
comunicarea cu serviciul DPD care returneaza pretul exact al livrarii. Este posibil sa aveti nevoie de
aceasta optiune in anumite situatii. Exemplu: sistemul DPD este indisponibil.

Folosirea extensiei in frontend

Odata instalata si configurata extensia conform detaliilor anterioare, metoda de plata DPD va fi
disponibila in checkout similar oricarei alte metode de livrare.
In cazul unor adrese invalide (exemplu adrese pentru care DPD nu efectueaza livrari) metoda de
livrare va fi indisponibila.
In plus metoda de livrare DPD, poate activa o metoda de plata la livrare, care spre deosebire de alte
metode de plata poate taxa suplimentar clientul conform setarilor efectuate de administratorul
magazinului.
Problem e frecvente
1. PHP SOAP nu este activ pe server
2. Versiunea PHP este mai mica de 5.2
3. Serviciile de livrare DPD activate in Sectiunea DPD Carrier / Shipping settings
disponibile in contractul cu DPD.
4. Produsele magazinului nu au configurat atributul w eight sau acesta este 0.

2016/06

Page 12 of 17

nu sunt

Anexa 1.1

2016/06

Page 13 of 17

Anexa 1.2

2016/06

Page 14 of 17

Anexa 1.3

2016/06

Page 15 of 17

Anexa 1.4

2016/06

Page 16 of 17

2016/06

Page 17 of 17