2016/09 Page 1 of 21

Ghid de instalare modul

DPD OpenCart

27-08-2015 Versiunea 1.2 Bussiness Development Manager

Dragos Buzea

27-08-2015 Versiunea 1.2 Support Specialist Alexandru Martin

18-01-2016 Update Support Specialist Alexandru Martin

27-09-2016 Update Support Specialist Manager Produs

Alin Dorobantu Octavian Lipan

2016/09 Page 2 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 3 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 4 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 5 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 6 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 7 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 8 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 9 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 10 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 11 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 12 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 13 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 14 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 15 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 16 of 21

Anexa 1.1

2016/09 Page 17 of 21

Anexa 1.2

2016/09 Page 18 of 21

Anexa 1.3

2016/09 Page 19 of 21

Anexa 1.4

2016/09 Page 20 of 21

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