Embed Size (px)
Citation preview
1 | P a g e
Ghid de instalare pentru modulul
DPD OpenCart
16-02-2015 Versiunea 1.1 Bussiness Development
Manager Dragos Buzea
16-02-2015 Versiunea 1.1 Support Specialist Alexandru Martin
2 | P a g e
Table of Contents Serviciul de livrare DPD ........................................................................................................................ 3
Integrarea cu OpenCart ................................................................................................................... 3 Recomandari ................................................................................................................................... 3 Instalare........................................................................................................................................... 4 Configurare ...................................................................................................................................... 4
Setari livrare ................................................................................................................................. 5 Configurare COD (Cash on delivery - Plata la livrare) .................................................................... 6 Configurare Tabel de taxare ......................................................................................................... 6
Procesarea comenzilor .................................................................................................................... 8 Aspecte generale .......................................................................................................................... 8 Auto-validare cod postal............................................................................................................... 8 Creare livrare ............................................................................................................................. 10 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
3 | P a g e
Serviciul de livrare DPD
Integrarea cu OpenCart 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 ● 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
Recomandari ● Extensia este compatibila cu OpenCart 1.5.x ● 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. ● 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.
4 | P a g e
Instalare
Cerinte pentru instalare:
● OpenCart 1.5.x ● Extensia vQMod instalata anterior ● PHP mbstring ● PHP 5.2 ● PHP SOAP ● Greutatea produselor setata in admin
Integrarea DPD pentru platforma OpenCart foloseste vQMod pentru a putea modifica comportamentul de baza al plaformei OpenCart. Mai multe detalii despre implementarea vQMod gasiti la link-ul urmator https://github.com/vqmod/vqmod/wiki. Va recomandam sa instalati vQMod inaintea modulului DPD. 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 instal. Atentie: instalarea extensiei poate dura cateva secunde. Odata rulat scriptul de instalare se poate trece la configurarea extensiei.
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
5 | P a g e
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:
● Activ/Enabled: Pentru a activa sau dezactiva metoda de plata ● Corecteaza automat codul postal in checkout: 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.
● Titlul metodei de livrare/ Shipping method label: Titlul extensiei ● Utilizator DPD/Web Service Username: Este numele utilizatorului optinut 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.
Puteti vizualiza poza din anexa 1.1
● SERVICE FRONTEND LABELS – pentru fiecare serviciu dpd puteti alege titlul aferent afisat in checkout
6 | P a g e
Atentie!!: Activati doar serviciile de livrare DPD disponibile in contract, pentru a elimina procesarea inutila de date (apeluri ale API-ului DPD).
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:
● 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 ● 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 ● Payment method on delivery – se poate opta daca clientul plateste cu numerar sau cu cardul
la livrare
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:
7 | P a g e
● 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:
● 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 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
8 | P a g e
● 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 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. 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.
9 | P a g e
10 | P a g e
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.
11 | P a g e
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.
12 | P a g e
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
13 | P a g e
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
14 | P a g e
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 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.
15 | P a g e
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.
16 | P a g e
Anexa 1.1
17 | P a g e
Anexa 1.2
Anexa 1.3
18 | P a g e
Anexa 1.4
19 | P a g e
20 | P a g e
21 | P a g e
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 [email protected].
22 | P a g e
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 comportamant/nefunctionalitate corespunzatoare din partea modulului DPD. Suportul (configurare/instalare) se asigura doar clientilor DPD Romania.
