2023/05 Page 1 of 24

TutorialExtensie DPD Magento

30-11-2014 Business Development Manager

Dragos Buzea

30-11-2014 Support Specialist Alexandru Martin15-01-2016 – update Support Specialist Alexandru Martin29-01-2016 – revizuire, font nou

Product Manager Octavian Lipan

21-09-2016 - update Product ManagerSpecialist Suport

Octavian LipanAlin Dorobantu

2023/05 Page 2 of 24

ContentsServiciul de livrare DPD...........................................................................................3

Integrarea cu Magento CE....................................................................................3Recomandari........................................................................................................3Instalare.............................................................................................................4Configurare........................................................................................................4

Setari livrare.....................................................................................................5Serviciul PREDICT..............................................................................................6Setari expeditor...............................................................................................7Configurare COD (Cash on delivery - Plata la livrare).......................................8Configurare Tabel de taxare.............................................................................8

Procesarea comenzilor..................................................................................10Aspecte generale............................................................................................10Auto-validare cod postal.................................................................................11Creare livrare..................................................................................................12Tiparire documente.........................................................................................15Urmarire comanda..........................................................................................16

Procesarea fara comunicarea cu DPD.........................................................17Raportul Pret vs Cost.....................................................................................17Folosirea extensiei in frontend...........................................................................18Probleme frecvente............................................................................................18Actualizarea validatorului pentru codurile postale..................................24

2023/05 Page 3 of 24

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 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● Generare si tiparire borderou si etichete de livrare● Raport de profitabilitate pe metoda de livrare● Status livrari● Serviciul PREDICT● Metoda Debbug

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

2023/05 Page 4 of 24

Instalare

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

1. Dezarhivarea fisierelor modulului in folderul instantei Magento2. 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 admin6. Daca instalarea s-a efectuat complet, ar trebui sa aveti acum disponibil meniul

“Livrare DPD” si puteti trece la configurarea modulului

ConfigurarePentru 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● Completarea Tabelului de Taxare, pentru a defini modul in care sunt taxati clientii

2023/05 Page 5 of 24

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

2023/05 Page 6 of 24

Tool debbugModulul 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

Cod Postal

Tara

Telefon

Adresa email

2023/05 Page 7 of 24

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:

● 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

2023/05 Page 8 of 24

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

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

2023/05 Page 9 of 24

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

2023/05 Page 10 of 24

● 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

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.

2023/05 Page 11 of 24

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.

2023/05 Page 12 of 24

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.

2023/05 Page 13 of 24

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 10 RON (s-a folosit o taxare cu pret fix in checkout), iar pretul real (calculat prin API) este 15.13 RON.

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

2023/05 Page 14 of 24

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

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.

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

2023/05 Page 15 of 24

Un link de urmarire al livrarii este de asemenea prezent.

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

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

2023/05 Page 16 of 24

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.

2023/05 Page 17 of 24

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 server2. Versiunea PHP este mai mica de 5.33. 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

2023/05 Page 18 of 24

Anexa 1.2

2023/05 Page 19 of 24

Anexa 1.3

2023/05 Page 20 of 24

2023/05 Page 21 of 24

2023/05 Page 22 of 24

Anexa 1.4

2023/05 Page 23 of 24

Actualizarea validatorului pentru codurile postalePuteti 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_commerceUltima versiune coduri_postale.csv

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

Se selecteaza 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 adresa de mail: 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 (configurare/instalare) se asigura doar clientilor DPD Romania.

2023/05 Page 24 of 24