Sunteți pe pagina 1din 16

TUTORIAL

Extensie DPD Woocommerce


by Zitec

2016/10 Page 1 of 16
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 .................................................................................. Error! Bookmark not defined.
Procesarea fara comunicarea cu DPD. .................................................................................................. 10
Folosirea extensiei in frontend ............................................................................................................ 10
Probleme frecvente ................................................................................................................................ 10

2016/10 Page 2 of 16
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
● 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.

2016/10 Page 3 of 16
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/10 Page 4 of 16
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 automat codul postal in checkout/Auto-correct the user postcode 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).
● DPD Country select: se lasa Other(enter web service URLs manually)
● Modul Productie/Production Mode: Pentru a activa extensia pentru testare - selectati
Nu/No. Setati Da/Yes ptr a activa extensia
● Debug mode: Yes, daca se doreste crearea fisierului in care se pot verifica erorile. NU, daca
nu se doreste
● Debug file: cum se doreste denumit fisierul in care salveaza erorile
● Production WS URL si test WS URL , se primeste de la DPD
● Utilizator DPD/Web Service Username: Este numele utilizatorului optinut de la DPD pentru
conectarea la serviciul web
● Parola DPD/Web Service Password – se obtine de la DPD
● Web Service Connection Timeout: Timpul exprimat in secunde in care aplicatia asteapta o
cerere efectuata la serviciul web DPD – se recomanda 10 secunde
● 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.
● Service Predict: este tipul de produs disponibil pentru serviciul predict
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).

Setari expeditor

Name:

Additional Name:

Street:

City:

Postcode:
2016/10 Page 5 of 16
Country:

Telephone:

Email Address:

Configurare COD (Cash on delivery - Plata la livrare)

Aceasta componenta permite clientilor magazinului online 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 / Payment sau puteti vizualiza un print screen in
anexa 1.2

Atentie!!!: Detaliile de taxare setate in aceasta sectiune Tip plata/Payment Type si Tip valoare
plata/Payment Ammount Type 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:

● Enabled Yes/No: Metoda de plata este activata/dezactivata in orice context pentru website-
ul selectat
● Titlu/ Payment method title reprezinta titlul modalitatii de plata
● Description: reprezinta descrierea modalitatii de plata, cum se va afisa pe pagina de checkout
cand aceasta se bifeaza
● Surcharge Name: cu se va afisa in tab-ul "plaseaza comanda"
● Tip plata/Payment Type: in general va fi aleasa optiunea Cash
● Tip valoare plata/Payment amount 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/Payment amount: In functie de valoarea selectata la campul anterior, valearea
campului “Valoare plata” va fi folosit ca procent sau ca suma fixa.
● Metoda de plata activa pentru tarile/Payment from Applicable Countries
● Payment method on delivery – se poate opta daca clientul plateste cu numerar sau cu cardul
la livrare

Postcode Update Manager

In acest submeniu aveti posibilitatea de a uploada fisierul cu baza de rutare a codurilor postale.
Upload se face numai cu fisiere in format CSV.

2016/10 Page 6 of 16
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:

● tara de destinatie
● regiune de destinatie
● codul postal al destinatarului
● 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

Campurile completate in Tabelul de taxare sunt:

● 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 mai mare) /Weight (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 mai mare)/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 Metoda Livrare/Enable Shipping Method
● 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
● Adaos valoare procentuala la valoarea DPD/Shipping Percentage
● Adaos valoare fixa la valoare DPD/Add fixed amount to price
2016/10 Page 7 of 16
● 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 minima COD (plata la livrare)/Minimum 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 etichetelor si a 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 actualizata 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/10 Page 8 of 16
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/10 Page 9 of 16
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 poate fi generat din locatia : Woocommerce -> Settings -> DPD -> Shipping List.

Borderoul va genera un fisier PDF care va ingloba livrarile selectate prin bifare.

Se apasa butonul “Check all”, urmat de generarea documentului prin apasarea butonului „Create
manifest“ si apasarea butonului Aplica.

In sectiunea DPD Shipping din comanda se poate alege fiecare livrare in parte pentru a obtine mai
multe informatii.

Un link de urmarire al livrarii este de asemenea prezent tot in sectiunea DPD Shipping din pagina de
comanda.

Exemple ale acestor documente se regasesc in Anexa 1.4

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.

Probleme 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 nu sunt
disponibile in contractul cu DPD.
4. Produsele magazinului nu au configurat atributul “weight“ sau acesta este 0.
2016/10 Page 10 of 16
2016/10 Page 11 of 16
Anexa 1.1

2016/10 Page 12 of 16
Anexa 1.2

2016/10 Page 13 of 16
Anexa 1.3

2016/10 Page 14 of 16
Anexa 1.4

2016/10 Page 15 of 16
2016/10 Page 16 of 16