1 | P a g e

TUTORIAL

Extensie DPD Magento

by Zitec

30-11-2014 Business Development Manager Dragos Buzea

30-11-2014 Support Specialist Alexandru Martin

2 | P a g e

Contents

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

Integrarea cu Magento CE .................................................................................................................... 3

Recomandari ......................................................................................................................................... 3

Instalare ................................................................................................................................................ 4

Configurare ........................................................................................................................................... 4

Setari livrare ...................................................................................................................................... 4

Setari expeditor ................................................................................................................................. 5

Configurare COD (Cash on delivery - Plata la livrare) ....................................................................... 6

Configurare Tabel de taxare ............................................................................................................. 7

Procesarea comenzilor ......................................................................................................................... 9

Aspecte generale ............................................................................................................................... 9

Auto-validare cod postal ................................................................................................................... 9

Creare livrare ................................................................................................................................... 11

Tiparire documente......................................................................................................................... 13

Urmarire comanda .......................................................................................................................... 14

Procesarea fara comunicarea cu DPD. ............................................................................................... 16

Raportul Pret vs Cost .......................................................................................................................... 16

Folosirea extensiei in frontend ........................................................................................................... 16

Probleme frecvente ............................................................................................................................ 17

Actualizarea validatorului pentru codurile postale ....................................................................... 24

3 | P a g e

Serviciul de livrare DPD

Integrarea cu Magento CE

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

● Raport de profitabilitate pe metoda de livrare

● Status livrari

Recomandari

● Extensia este compatibila cu Magento Community Edition 1.5.x, 1.6.x, 1.7.x, 1.8.x, 1.9.x si

Magento Enterprise 1.14.x

● Conform recomandarilor magento 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.3

● 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.

4 | P a g e

Instalare

Extensia poate fi instalata atat folosind sectiunea Magento connect cat si manual folosind arhiva.

1. Dezarhivarea fisierelor modulul in folderul instantei Magento

2. Compilarea Magento trebuie dezactivata din meniul System / Tools / Compilation

3. Structura de fisiere a modulului contine

○ app

○ js

○ lib

○ media

○ skin

○ lib

4. Se va sterge cache-ul Magento: System / Cache manager / Flush Magento Cache

5. Se apasa butonul Log Out si se autentifica din nou folosind utilizatorul de admin

6. Daca instalarea s-a efectuat complet, ar trebui, acum, sa aveti disponibil meniul “Livrare DPD”

si puteti trece la configurarea modulului

Configurare

Pentru a configura extensia trebuie parcursi urmatorii pasii afisati mai jos (accesibili din meniul

Livrare DPD)

● Setari Livrare

● Setari expeditor

● 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

Setari livrare

Setarile metodei de livrare se regasesc in Sectiunea System / Configuration / Shipping methods

5 | P a g e

Urmatoarele campuri vor fi completate in sectiunea DPD GeoPost By Zitec:

● Activ/Enabled: Pentru a activa sau dezactiva metoda de plata

● Corecteaza automat 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).

● Selecteaza Tara/DPD Country Select: Pentru a selecta tara in care este semnat contractul

DPD

● Modul Productie/Production Mode: Pentru a activa extensia pentru testare - selectati

Nu/No.

● Titlul metodei de livrare/Method Title: Titlul extensiei

● Numele metodei de livrare/Method Name: Numele metodei de livrare care va fi vizivil in

checkout.

● Utilizator DPD/Web Service Username: Este numele utilizatorului optinut de la DPD

pentru conectarea la serviciul web

● Parola DPD/Web Service Password

● Web Service Connection Timeout: 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).

Setari expeditor

In acest pas se va seta numele si adresa expeditorului folosite la comunicarea cu serviciul DPD.

Aceste setari se gasesc in sectiune System / Configuration / Sales / Shipment Settings / DPD

GeoPost / Adresa de ridicare a coletelor

Campurile completate in aceasta sectiune sunt:

Nume

6 | P a g e

Nume Aditional

Strada

Oras

Cod Postal

Tara

Telefon

Adresa email

Configurare COD (Cash on delivery - Plata la livrare)

Aceasta componenta permite clientilor magazinului Magento 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 System / Configuration / Payment Method / Plata la

livrare prin DPD - COD 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:

7 | P a g e

● Activ/Enabled: Metoda de plata este activata/dezactivata in orice context pentru website-ul

selectat

● Titlu/Title

● Nume taxa/Method Name: Este numele vizibil in checkout

● Statusul noii comenzi/New oreder status: Statusul unei comenzi noi plasate folosind metoda

de plata DPD

● Serviciu/Service: Selecteaza serviciul de livrare pentru care metoda de plata este activa

● 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

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

8 | P a g e

In aceasta sectiune este posibila folosirea importului dintr-un fisier CSV al mai multor reguli. Puteti

genera un sablon de fisier CSV apasand butonul exporta. Dupa editarea fisierului csv conform nevoilor

se poate face upload fisierului si rula importul. Coloana Shipping price din fisierul CSV respecta

urmatoarea conventie:

● se va adauga caracterul # dupa valoare numerica, pentru a defini un pret fix

● se va adauga caracterul % dupa valoare numerica, pentru a defini un adaos procentual fata de

raspunsul primit de la serviciul DPD

● se va adauga caracterul + dupa valoare numerica, pentru a defini un adaos de pret fix fata de

raspunsul primit de la serviciul DPD

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

● 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 CDO (plata la livrare)/Minimum COD Surcharge

9 | P a g e

Procesarea comenzilor

Aspecte generale

In procesul de livrare al comenzii din interfata magazinului Magento 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 Magento 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.

10 | P a g e

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.

11 | P a g e

Odata editata adresa de livrare a comenzii, toate avertizarile dispar, si codul postal este considerat

valid. Din acest moment se poate continua procesarea comenzii.

Creare livrare

Se poate vizualiza mai jos o noua comanda care are statusul “DPD Pending Cash On Delivery”. Acest

status semnalizeaza faptul ca aceasta comanda a fost plasata folosind metoda de livrare DPD si

metoda de plata DPD.

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 livrarii (apasa butonul Livreaza/Ship) se poate alege numarul de cutii in care se

face livrare dar si daca se va comunica cu DPD pentru obtinerea pretului actualizat.

12 | P a g e

La apasarea butonului Submit Shipment o noua fereastra va aparea, destinata gestionarii cutiilor si a

recalcularii pretului final de livrare

Se poate observa in imaginea de mai sus faptul ca pretul pe care l-a platit clientul pentru livrare este

10RON (s-a folosit o taxare cu pret fix in checkout), iar pretul real (calculat prin API) este 15.13RON

13 | P a g e

Inainte de inregistrarea livrarii in sistemul DPD si obtinerea unui cod de urmariere se pot adauga

comentarii fiecarei cutii in parte (implicit este codul

produsului).

Dupa generarea livrarii in sistemul DPD, administratorul va primi un mesaj similar cu cel ilustrat mai

jos 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

Sales / Shipments

In lista livrarilor se pot identifica butoanele de actiuni care permit Tiparirea etichetelor de livrare,

generarea si tiparirea borderoului pentru mai multe livrari simultan.

14 | P a g e

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 (Sales / Shipments), ulterior apasarea butonului “Select

the visible”, urmat de generarea documentului din sectiunea Actions.

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 care descide o fereastra cu mai multe informatii legate de livrarea

efectiva, dar si un link in sistemul DPD cu localizarea exacta a coletului.

15 | P a g e

Aceasta fereastra este disponibila si clientilor magazinului online in sectiune “Comenzile mele”

16 | P a g e

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.

Raportul Pret vs Cost

Navigand in Livrari DPD / Raport pret vs cost se poate vizualiza si exporta in format CSV un raport

detaliat al preturilor platite de catre clienti si preturilor platite efectiv catre DPD. cu posibilitatea

filtrarii dupa interval temporar.

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.

17 | P a g e

Probleme frecvente

1. PHP SOAP nu este activ pe server

2. Versiunea PHP este mai mica de 5.3

3. Serviciile de livrare DPD activate in Sectiunea System / Configuration / Shipping methods nu

sunt disponibile in contractul cu DPD.

4. Produsele magazinului nu au configurat atributul “weight“ sau acesta este 0.

Anexa 1.1

18 | P a g e

Anexa 1.2

19 | P a g e

Anexa 1.3

20 | P a g e

21 | P a g e

22 | P a g e

Anexa 1.4

23 | P a g e

24 | P a g e

Actualizarea validatorului pentru codurile postale

Puteti actualiza validatorul codurilor postale prin importul fisierului CSV afisat pe site-ul DPD, in extensia instalata DPD_ZITEC. Se descarca de pe site-ul http://www.dpd.com/ro/home/e_commerce Ultima versiune coduri_postale.csv

Se da click pe Postcode update manager pentru a se putea intra in sectiunea de import.

Se selcteaza fisierul pe care l-am descarcat de pe site-ul dpd.ro si se apasa butonul import.

Actualizarea a avut loc cu success.

Pentru informatii va stam la dispozitie pe eshop@dpd.ro