Ghid de instalare modul

DPD OpenCart

27-08-2015 Versiunea 1.2 Bussiness Dragos Buzea

Development Manager
27-08-2015 Versiunea 1.2 Support Specialist Alexandru Martin
18-01-2016 Update Support Specialist Alexandru Martin
27-09-2016 Update Support Specialist Alin Dorobantu
Manager Produs Octavian Lipan

2016/09 Page 1 of 21
Contents
Serviciul de livrare DPD............................................................................................................................... 3
Integrarea cu OpenCart 2.0 ................................................................................................................ 3
Recomandari ............................................................................................................................................... 3
Instalare ......................................................................................................................................................... 4
Configurare .................................................................................................................................................. 5
Setari livrare ................................................................................................................................................. 6
Serviciul PREDICT .................................................................................................................................. 7
Tool debbug ............................................................................................................................................. 7
Configurare COD (Cash on delivery - Plata la livrare) .......................................................... 8
Configurare Tabel de taxare ............................................................................................................ 9
Procesarea comenzilor ........................................................................................................................ 10
Aspecte generale ................................................................................................................................ 10
Auto-validare cod postal................................................................................................................. 10
Creare livrare ......................................................................................................................................... 12
Tiparire documente ............................................................................................................................ 12
Urmarire comanda ............................................................................................................................. 14
Procesarea fara comunicarea cu DPD. ......................................................................................... 14
Folosirea extensiei in frontend .....................................................................................................15
Probleme frecvente ...........................................................................................................................15
Actualizarea validatorului pentru codurile postale .................................................................. 21

2016/09 Page 2 of 21
Serviciul de livrare DPD
Aplicatia este gratuita.

Pentru modificari aduse extensiei, DPD Romania nu este responsabil de functionarea

acesteia. Extensia DPD functioneaza dupa cerintele standard ale platformei, orice
modificare adusa in platforma putand duce la comportament/functionalitate
necorespunzatoare din partea modulului DPD.

Suportul (configurare/instalare) se asigura doar clientilor DPD Romania.

Integrarea cu OpenCart 2.0

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 checkout
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
Status livrari
Serviciul PREDICT
Metoda Debbug

Recomandari

Extensia este compatibila cu OpenCart 2.0

Conform recomandarilor OpenCart 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.

2016/09 Page 3 of 21
 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.

Instalare

Cerinte pentru instalare:

OpenCart 2.x
PHP mbstring
PHP 5.2
PHP SOAP
Greutatea produselor setata in admin

1. Dezarhivare fisiere din arhiva zitec_dpd_opencart2_v0.1.0.zip si urcare pe server in

fisierele corespunzatoare, fara cel de vqmod. Se recomanda salvarea fisierului
zitec_dpd.ocmod.xml local. (Vezi pasul 4)
Versiunea de modul pentru opencart 2 nu mai foloseste Extensia Vqmod.
2. Dupa incarcarea extensiei DPD pe server se poate naviga in meniul principal
Extensions -> Shipping. Se va identifica extensia DPD, DPD Shipping Carrier si se va
apasa butonul install. Atentie: instalarea extensiei poate dura cateva secunde.
3. Dupa instalarea modulului se va naviga in meniul principal la Extensions -> Extension
Installer.

2016/09 Page 4 of 21
 4. Din pagina nou aparuta, se apasa butonul de upload. In fereastra aparuta se va selecta
fisierul zitec_dpd.ocmod.xml. (Fisierul se afla in arhiva zitec_dpd_opencart2_v0.1.0.zip
-> vqmod -> xml).
Atentie: uploadara modulului poate dura cateva secunde.

5. Se va naviga la Extensions->Modifications, unde se va apasa butonul de refresh.

6. Dupa efectuarea cu success a modificarilor, va aparea un mesaj de success, iar in

meniul principal din partea stanga, va aparea un link pentru modulul DPD Carrier.

7. Se poate incepe configurarea modulului.

Configurare
Pentru a configura extensia trebuie parcursi urmatorii pasii afisati mai jos (accesibili din
meniul DPD Carrier)
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/09 Page 5 of 21
Setari livrare

Setarile metodei de livrare se regasesc in Sectiunea DPD Carrier / Shipping settings.

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

Store switcher: Your store default values

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).
Modul Productie/Production Mode: Pentru a activa extensia pentru testare -
selectati Nu/No.
Debug File: YES/NO
Numele metodei de livrare/Method Name: Numele metodei de livrare care va fi
vizivil in checkout.
Production Mode: https://nou.dpdonline.ro/IT4EMWebServices/eshop/
Test URL: https://nou.dpdonline.ro/IT4EMWebServices/eshop/
Utilizator DPD/Web Service Username: Este numele utilizatorului optinut de la DPD
pentru conectarea la serviciul web
Parola DPD/Web Service Password

2016/09 Page 6 of 21
 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).

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: - Opencart - system/logs/zitec_dpd.log

2016/09 Page 7 of 21
Configurare COD (Cash on delivery - Plata la livrare)

Aceasta componenta permite clientilor magazinului OpenCart 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 Carrier/Payment Settings 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:

Store switcher: Your store default values

Activ/Enabled: Metoda de plata este activata/dezactivata in orice context pentru
website-ul selectat
Titlu/ Payment method title
Serviciu/ Available for DPD shipping services: Selecteaza serviciul de livrare pentru
care metoda de plata este activa
Description
Tip plata/Payment Type: in general va fi aleasa optiunea Cash
Tip valoare plata/Payment method on delivery: 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.
Cash On Delivery Surcharge minimum amount:
2016/09 Page 8 of 21
 Available for DPD shipping services:
Payment method lables:
Valoare plata/Payment amount: In functie de valoarea selectata la campul anterior,
valoarea campului Valoare plata va fi folosit ca procent sau ca suma fixa.

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

Campurile completate in Tabelul de taxare sunt:

Store
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 9 of 21
 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 COD (plata la livrare)/Minimum COD Surcharge

Procesarea comenzilor

Aspecte generale
In procesul de livrare al comenzii din interfata magazinului OpenCart 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 OpenCart vine in sprijinul administratorilor de magazine online prin
implementarea unei validari automate a codului postal aferent adresei completate de client.

2016/09 Page 10 of 21
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.

2016/09 Page 11 of 21
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.

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

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 Create Shipment sau Shipment management
din partea de sus) 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 DPD Carrier / Shipments.

2016/09 Page 12 of 21
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 (DPD Carrier / Shipments), ulterior apasarea
butonului Check all, urmat de generarea documentului prin apasarea butonului Create
manifest

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 13 of 21
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.

Procesarea fara comunicarea cu DPD.

Asa cum am prezentat mai sus, in sectiunea 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.

2016/09 Page 14 of 21
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/09 Page 15 of 21
Anexa 1.1

2016/09 Page 16 of 21
Anexa 1.2

2016/09 Page 17 of 21
Anexa 1.3

2016/09 Page 18 of 21
Anexa 1.4

2016/09 Page 19 of 21
2016/09 Page 20 of 21
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 intra in meniul extensiei:

Se apasa Postcode update manager

> se alege fisierul descarcat, in cazul nostru coduri_postale.csv si se apasa butonul
Upload & ImportDupa

Dupa ce importul a fost efectuat si actualizarea bazei de date a fost facuta cu succes puteti
utiliza cu succes extensia. Pentru suport puteti trimite mail pe adresa eshop@dpd.ro.

2016/09 Page 21 of 21