2018/03 Page 1 of 20

Tutorial Extensia DPD Magento 2

01-03-2018 Business Development Manager

Valentina Ionescu

01-03-2018 Database Administrator

Alexandru Martin

2018/03 Page 2 of 20

Contents

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

Integrarea cu Magento 2 ................................................................................................................................. 3

Instalare ............................................................................................................................................................. 3

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

Setari livrare ................................................................................................................................................. 5

Setari expeditor .......................................................................................................................................... 6

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

Configurare Tabel de taxare ................................................................................................................... 8

Procesarea comenzilor .............................................................................................................................. 10

Aspecte generale ..................................................................................................................................... 10

Creare livrare ............................................................................................................................................. 10

Creare eticheta Livrare AWB ................................................................................................................ 12

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

Probleme frecvente .................................................................................................................................... 16

2018/03 Page 3 of 20

Serviciul de livrare DPD

Integrarea cu Magento 2

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 a codului postal

● Autocomplet cod postal frontend sectiune inregistrare adrese client site

● Tiparirea etichetelor de livrare pentru expeditii normale si expeditii cu ramburs

● Urmarirea livrarilor

● Comunicarea cu serviciul DPD

● Status livrari

● Metoda Debbug

Recomandari

● Extensia este compatibila cu Magento Community Edition 2.x

● Conform recomandarilor Magento va sfatuim sa creati o copie 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 Romania

taxeaza in functie de greutatea livrarii. Daca produsele nu au greutatea specificata

atunci metoda DPD nu va disponibila in checkout.

Instalare

2018/03 Page 4 of 20

Extensia poate fi instalata atat folosind sectiunea Magento connect cat si manualul folosind arhiva. Dezarhivarea fisierelor modulului in folderul instantei Magento.

Pentru a instala modulul, ar fi ideal sa aveti acces la o consola SSH de pe server-ul respectiv.

In cazul in care nu e disponibila, voi descrie mai jos o modalitate alternativa de instalare.

1 – Se copiaza modulul in [MAGENTO_ROOT_DIR]/app/code/. Structura de directoare

rezultata trebuie sa fie “app/code/Zitec/Dpd/”;

2.

a. In cazul in care aveti acces la consola, se navigheaza pana in folder-ul

[MAGENTO_ROOT_DIR] si se ruleaza urmatoarea comanda:

php bin/magento setup:upgrade

b. Daca nu aveti acces la consola SSH, creati un fisier php

„magento2_enable_module.php“ in care veti scrie urmatorul cod:

<?php

echo passthru('php bin/magento module:enable:Zitec_Dpd');

echo passthru('php bin/magento setup:upgrade');

apoi fisierul se va urca in [MAGENTO_ROOT_DIR], dupa care il accesati in browser:

http://mywebsite.com/magento2_enable_module.php

3. In interfata de administrare a Magento 2 ar trebui sa apara modulul activat in Stores

>>Configuration >>Advanced >> Advanced. Totodata, in meniul de admin ar trebui sa apara o

noua intrare “DPD Carrier”.

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

● Actualizare coduri postale

2018/03 Page 5 of 20

● 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, in partea stanga a ecranului. Urmatoarele campuri vor fi completate in sectiunea DPD GeoPos by Zitec:

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

● Corecteaza/completeaza automat codul postal: 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.

● Debug Mode: YES/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 obtinut de la DPD

pentru conectarea la serviciul web

● Parola DPD/Web Service Password

2018/03 Page 6 of 20

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

● Service PREDICT: Este serviciul aditional si se selcteaza numai daca este activ in

contract impreuna cu produsul. Pentru Romania este activ Produsul DPD B2C +

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

Tool debbug

Modulul DPD Magento ofera prin activarea sa un ajutor in verificarea problemelor aparute in modulul DPD.

Fisierul de debug ar trebui sa fie in folderul default al sistemului (daca este modificat in setari). Totul este raportat la root-ul proiectului: Magento - var/log/zitec_dpd.log.

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/ Shipping Settings/ DPD GeoPost/ Adresa de ridicare a coletelor.

Campurile completate in aceasta sectiune sunt:

Nume

Nume Aditional

Strada

Oras

2018/03 Page 7 of 20

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.

2018/03 Page 8 of 20

Setarile disponibile pentru metoda de livrare sunt:

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

website-ul selectat

● Titlu/Title

● Descriere

● 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

2018/03 Page 9 of 20

● 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

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 camp 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 va 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

2018/03 Page 10 of 20

● 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

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

● Pretul afisat de extensia Mageno in Frontend este fara TVA(extensia magento tine

cont de optiunea din admin-ul magento: System -> Configuration -> Tax ->

Calculation Settings -> Shipping Prices).

● 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

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.

2018/03 Page 11 of 20

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.

In sectiunea shipments veti gestiona expeditia/le in vederea genararii de AWB-uri.

2018/03 Page 12 of 20

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

Creare eticheta Livrare AWB

Tiparirea etichetelor este disponibila din locatia Sales / Shipments;

- Accesand butonul Create Shipping Label

2018/03 Page 13 of 20

Se vor procesa pachetele in vederea generarii AWB-ului;

In exmplul nostru vom avea doua produse in pachet – 1 etichete AWB- de generat:

Apasand butonul SAVE se va trimite request-ul catre serverul DPD de unde se va primi raspuns in format PDF eticheta putand fi salvata

2018/03 Page 14 of 20

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.

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.

2018/03 Page 15 of 20

2018/03 Page 16 of 20

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

2018/03 Page 17 of 20

Anexa 1.1

2018/03 Page 18 of 20

Anexa 1.2

2018/03 Page 19 of 20

Anexa 1.3

Anexa 1.4

2018/03 Page 20 of 20

Pentru informatii va stam la dispozitie pe adresa de mail: eshop@dpd.ro, api.support@dpd.ro Aplicatia este gratuita. Pentru modificari aduse extensiei, DPD Romania nu este responsabila de functionarea acesteia. Extensia DPD functioneaza dupa cerintele standard ale platformei, orice modificare adusa in platforma putand duce la comportament/nefunctionalitate corespunzatoare din partea modulului DPD. Suportul se asigura doar clientilor DPD Romania.