2016/09 Page 1 of 24
Tutorial Extensie DPD Magento
30-11-2014 Business Development Manager
Dragos Buzea
30-11-2014 Support Specialist Alexandru Martin
15-01-2016 – update Support Specialist Alexandru Martin
29-01-2016 – revizuire, font nou
Product Manager Octavian Lipan
21-09-2016 - update Product Manager Specialist Suport
Octavian Lipan Alin Dorobantu
2016/09 Page 2 of 24
Contents
Serviciul de livrare DPD............................................................................................................................... 3
Integrarea cu Magento CE .................................................................................................................... 3
Recomandari ............................................................................................................................................... 3
Instalare ......................................................................................................................................................... 4
Configurare .................................................................................................................................................. 4
Setari livrare ............................................................................................................................................ 5
Serviciul PREDICT ................................................................................................................................. 6
Setari expeditor ..................................................................................................................................... 7
Configurare COD (Cash on delivery - Plata la livrare) .......................................................... 8
Configurare Tabel de taxare ............................................................................................................ 8
Procesarea comenzilor ........................................................................................................................ 10
Aspecte generale ................................................................................................................................ 10
Auto-validare cod postal.................................................................................................................. 11
Creare livrare ......................................................................................................................................... 12
Tiparire documente ............................................................................................................................ 15
Urmarire comanda ............................................................................................................................. 16
Procesarea fara comunicarea cu DPD. .......................................................................................... 17
Raportul Pret vs Cost ............................................................................................................................. 17
Folosirea extensiei in frontend ......................................................................................................... 18
Probleme frecvente .............................................................................................................................. 18
Actualizarea validatorului pentru codurile postale ................................................................. 24
2016/09 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.
2016/09 Page 4 of 24
● 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
Extensia poate fi instalata atat folosind sectiunea Magento connect cat si manualul folosind arhiva.
1. Dezarhivarea fisierelor modulului 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 sa aveti acum 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
● Actualizare coduri postale
● Completarea Tabelului de Taxare, pentru a defini modul in care sunt taxati clientii
2016/09 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.
2016/09 Page 6 of 24
● 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).
Serviciul PREDICT
Este serviciul de preavizare a destinatarilor prin intermediul SMS sau Email, referitor la intervalul orar in care urmeaza a se face livrarea catre acestia. Intervalul este cuprins in marja de 3 – 4 ore pentru ziua in care se face livrarea – interval valabil pentru Zona 0 de acoperire.
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.
2016/09 Page 7 of 24
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
2016/09 Page 8 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 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:
2016/09 Page 9 of 24
● 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
● 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
2016/09 Page 10 of 24
● 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 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
2016/09 Page 11 of 24
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.
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.
2016/09 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.
2016/09 Page 13 of 24
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.
La apasarea butonului Submit Shipment o noua fereastra va aparea, destinata gestionarii cutiilor si a recalcularii pretului final de livrare
2016/09 Page 14 of 24
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).
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.
2016/09 Page 15 of 24
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.
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
2016/09 Page 16 of 24
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.
Aceasta fereastra este disponibila si clientilor magazinului online in sectiune “Comenzile mele”.
2016/09 Page 17 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.
2016/09 Page 18 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 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.
2016/09 Page 19 of 24
Anexa 1.1
2016/09 Page 20 of 24
Anexa 1.2
2016/09 Page 21 of 24
Anexa 1.3
2016/09 Page 22 of 24
Anexa 1.4
2016/09 Page 23 of 24
2016/09 Page 24 of 24
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 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: [email protected] 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.
Top Related