Tutorijal za instalaciju i korištenje

Ove upute pokazuju kako modul DPD Shipping (SI/HR) instalirate u svoju PrestaShop trgovinu, povežete ga s vašim DPD EasyShip računom, podesite osnovne postavke te izrađujete i ispisujete DPD naljepnice izravno iz PrestaShop narudžbi.

Sadržaj

1. Preduvjeti i instalacija
2. Aktivacija licence
3. Postavke modula
   1. DPD EasyShip račun
   2. Zadane postavke naljepnica
   3. Adresa pošiljatelja
   4. DPD Pickup lokacije i paketomati pri završetku kupnje
   5. DPD dostavna služba i cijene dostave
4. Izrada i ispis DPD naljepnice
5. Grupna izrada i ispis naljepnica
6. Ažuriranja modula
7. Najčešći problemi i rješenja

1. Preduvjeti i instalacija

• PrestaShop 8.0 ili noviji, uključujući PrestaShop 9
• PHP 8.1 ili noviji
• DPD EasyShip račun za Hrvatsku ili Sloveniju

Modul preuzimate iz e-maila koji ste primili nakon kupnje ili iz odjeljka Preuzimanja u svom korisničkom računu na ovoj stranici. Preuzetu datoteku nemojte raspakirati — PrestaShop očekuje ZIP.

U PrestaShop administraciji otvorite Moduli → Upravitelj modula i kliknite Učitaj modul (Upload a module). Povucite ZIP datoteku u prozor ili je odaberite preko select file. PrestaShop modul instalira odmah nakon učitavanja.

Kada je modul instaliran, na popisu modula pojavljuje se redak DPD Shipping (SI/HR) s gumbom Configure. Taj gumb vodi do svih postavki modula.

Sama instalacija napravi još tri stvari:

• izradi DPD dostavnu službu koju pronalazite pod Dostava → Dostavne službe;
• na stranicu narudžbe doda panel DPD Shipping za izradu naljepnica;
• na popis narudžbi doda stupac DPD i dvije grupne radnje.

Ako poslužitelj koristi PHP stariji od 8.1, umjesto postavki prikazuje se jasna poruka koju verziju PHP-a treba osigurati.

2. Aktivacija licence

Izrada DPD naljepnica nije dostupna dok ne aktivirate valjanu licencu. Otvorite Moduli → Upravitelj modula → DPD Shipping (SI/HR) → Configure. Odjeljak License drugi je po redu na stranici s postavkama.

1. Unesite licencni ključ u obliku DPD-XXXX-XXXX-XXXX.
2. Kliknite Activate.

Nakon uspješne aktivacije status licence odmah se osvježi i prikazuje:

• Status — Active ili Blocked
• Plan i Features — mogućnosti uključene u vaš paket, primjerice create, print, delete, bulk, tracking
• This month / Total — broj potrošenih naljepnica prema vašem paketu
• Refreshes by — datum do kojeg modul mora ponovno provjeriti licencu
• Last checked — kada je modul zadnji put provjerio licencu

Licenca vrijedi za jednu domenu. Želite li je prenijeti na drugu trgovinu, kliknite Deactivate da je oslobodite s trenutne domene, a zatim je aktivirajte na novoj. Dok licenca nije aktivna, panel na narudžbi prikazuje upozorenje “No license is active. Enter your license key and activate it to enable label features.” i poveznicu Open settings →.

3. Postavke modula

Sve postavke nalaze se na jednoj stranici — Configure — podijeljene u zasebne odjeljke. Svaki odjeljak ima vlastiti gumb Save, pa ih spremate zasebno.

3.1 DPD EasyShip račun

U ovom odjeljku unosite podatke za povezivanje s vašim DPD EasyShip računom.

• EasyShip server — država i live/test poslužitelj koji koristi vaš DPD EasyShip račun (Croatia live/test, Slovenia live/test)
• Username — korisničko ime za DPD EasyShip
• Password — lozinka za DPD EasyShip. Lozinka se sprema šifrirano; nakon spremanja prikazana je kao •••••••• (saved — leave blank to keep), pa je ponovno unosite samo ako je želite promijeniti

3.2 Zadane postavke naljepnica

Ovdje određujete zadane vrijednosti za nove DPD naljepnice. Operater ih i dalje može promijeniti na pojedinoj narudžbi prije nego što podaci odu u DPD EasyShip.

• Default service — DPD Business, DPD Home (B2C) ili DPD Shop
• Default add-on services — Predict, Return of document (ROD) i Saturday delivery. Predict se automatski primjenjuje na DPD Home (B2C), dok je Saturday delivery vezan uz DPD Business. Ako dodatna usluga nije dostupna za odabranu vrstu dostave, modul je neće poslati u DPD.
• Label format — PDF A4, PDF A6 ili ZPL za termalne pisače
• Default parcel weight (kg) — zadana težina koja se koristi ako proizvodi u narudžbi nemaju upisanu težinu. Ako zadanu težinu ne želite koristiti, ostavite vrijednost 0
• Sender remark — neobavezna napomena za kurira koja se ispisuje na svakoj naljepnici
• Order status after create — status narudžbe koji se postavlja nakon uspješno izrađene naljepnice. Ako status ne želite mijenjati, ostavite — No change —
• Cash-on-delivery modules — tehnički nazivi modula plaćanja koji znače plaćanje pouzećem, odvojeni zarezom. Narudžbe plaćene jednim od njih dobivaju iznos pouzeća na DPD naljepnicu. Zadana vrijednost cashondelivery odgovara PrestaShopovu modulu za pouzeće; promijenite je samo ako vaša trgovina koristi vlastiti modul.

3.3 Adresa pošiljatelja

Ovaj odjeljak nije obavezan. Ostavite li sva polja prazna, modul će koristiti zadanu adresu pošiljatelja iz vašeg DPD EasyShip računa. Želite li da se na naljepnicama prikazuje druga adresa, primjerice adresa skladišta, ovdje možete unijeti zasebnu adresu pošiljatelja. Država pošiljatelja ograničena je na Hrvatsku i Sloveniju jer modul podržava slanje iz te dvije države.

3.4 DPD Pickup lokacije i paketomati pri završetku kupnje

Ovaj odjeljak upravlja odabirom DPD Pickup lokacije ili paketomata koji kupci vide pri završetku kupnje.

• Pickup-point delivery — glavna postavka za uključivanje ili isključivanje odabira lokacije
• Pickup-point carriers — dostavne službe kod kojih kupac bira mjesto preuzimanja. DPD dostavna služba koju izradi instalacija označena je automatski. Želite li putem DPD-a ponuditi dostavu na adresu, odznačite je i dodajte zasebnu dostavnu službu — naljepnice u oba slučaja izrađujete iz narudžbe.
• Parcel lockers — opcija Hide automated lockers prikazuje samo DPD Pickup lokacije s osobljem i skriva automatizirane paketomate
• Widget language — dvoslovna oznaka jezika, primjerice hr, sl ili en. Ostavite li polje prazno, karta će jezik odabrati automatski

Pri završetku kupnje kupac ispod odabrane DPD dostavne službe dobiva gumb za odabir mjesta preuzimanja koji otvara službenu DPD kartu.

Dok kupac ne odabere mjesto preuzimanja, ne može dovršiti korak dostave i načini plaćanja se ne prikazuju — modul to provjerava na poslužitelju, ne samo u pregledniku. Važno je i to da DPD ograničava plaćanje pouzećem za DPD Pickup lokacije i paketomate na najviše 250 €. Ako je vrijednost narudžbe veća, modul plaćanje pouzećem ne nudi i upućuje kupca na dostavu na adresu.

3.5 DPD dostavna služba i cijene dostave

Instalacija modula izrađuje dostavnu službu DPD koju pronalazite pod Dostava → Dostavne službe. Dostavna služba odmah je aktivna, a cijene dostave određujete jednako kao kod svake druge PrestaShop dostavne službe — klikom na Uredi postavljate zone dostave, cjenovne razrede i rokove isporuke.

Modul ne mijenja cijenu dostave — koristi ono što PrestaShop izračuna iz cjenovnih razreda dostavne službe. Dostavnu službu možete preimenovati, dodati joj logotip ili promijeniti rok isporuke; modul je prepoznaje i nakon preimenovanja.

4. Izrada i ispis DPD naljepnice

Otvorite narudžbu koju želite poslati. U desnom stupcu stranice narudžbe prikazuje se panel DPD Shipping. Ako je narudžba spremna za slanje, vidjet ćete status Ready to ship, a kod paketa s ograničenim brojem naljepnica i podatak o preostalom broju dostupnih naljepnica.

Kliknite Create label da otvorite obrazac za izradu naljepnice. Obrazac je unaprijed ispunjen podacima iz narudžbe i zadanim postavkama vaše trgovine.

• Recipient — ime primatelja, kontakt osoba, e-mail, telefon, ulica, kućni broj, mjesto, poštanski broj i država. Poštanski broj provjerava se u hodu prema DPD podacima.
• Service — vrsta usluge, broj paketa, dimenzije i težina paketa. Kod više paketa modul prikazuje polje za težinu svakog paketa zasebno.
• Parcelshop ID — kod usluge DPD Shop; ako je kupac mjesto preuzimanja odabrao pri završetku kupnje, polje je već ispunjeno.
• Add-on services — dodatne usluge koje se automatski ispunjavaju prema zadanim postavkama naljepnica

Kod narudžbi plaćenih pouzećem modul iznos pouzeća ispunjava sam — u obrascu se prikazuje redak COD s oznakom Auto i iznosom narudžbe. Podijelite li pošiljku na više paketa, pojavljuje se i izbor COD split kojim određujete naplaćuje li se pouzeće samo na prvom paketu, ravnomjerno dijeli ili se u cijelosti pripisuje svakom paketu.

Kada provjerite podatke, u obrascu kliknite Create label. Modul podatke šalje izravno u DPD EasyShip. Ako je naljepnica uspješno izrađena, panel se osvježi i prikazuje broj pošiljke, odabranu uslugu te kod DPD Shop dostave i odabranu DPD Pickup lokaciju ili paketomat.

Nakon izrade naljepnice dostupne su sljedeće mogućnosti:

• Print — otvara ili preuzima naljepnicu za ispis u odabranom formatu, PDF ili ZPL
• Track — otvara javnu DPD stranicu za praćenje pošiljke
• Refresh — ponovno provjerava status pošiljke kod DPD-a
• Delete label — otkazuje naljepnicu. Ako DPD API nije dostupan ili otkazivanje ne uspije, prikazuje se mogućnost Force clear label koja briše samo lokalni zapis naljepnice kako biste mogli pokušati ponovno — upotrijebite je tek kada u DPD portalu potvrdite da je pošiljka doista otkazana.

Broj pošiljke automatski se upisuje u internu napomenu narudžbe (Private note) koja je vidljiva samo osoblju trgovine. Ako ste u zadanim postavkama odabrali Order status after create, nakon izrađene naljepnice mijenja se i status narudžbe.

5. Grupna izrada i ispis naljepnica

Ako vaša licenca uključuje mogućnost bulk, na popisu narudžbi prikazuje se stupac DPD sa statusom pojedine narudžbe. Narudžbe s već izrađenom naljepnicom imaju status Labeled (N) i prečac za ispis, a narudžbe bez naljepnice prikazuju —.

U padajućem izborniku Bulk actions dostupne su dvije radnje:

• DPD: Create labels — izrađuje naljepnice za sve odabrane narudžbe koje ih još nemaju
• DPD: Print labels (combined PDF) — spaja naljepnice odabranih narudžbi u jedan PDF za ispis

Označite narudžbe, odaberite željenu radnju i pričekajte da se obrada završi. Nakon obrade prikazuje se obavijest s rezultatom: koliko je naljepnica izrađeno, preskočeno ili neuspješno, a kod ispisa i poveznica Download combined PDF. Poveznica vrijedi za jedno preuzimanje — trebate li PDF ponovno, ponovite radnju.

6. Ažuriranja modula

Modul sam provjerava je li dostupna nova verzija. Stanje vidite u odjeljku Updates na stranici s postavkama: instalirana verzija, je li dostupna novija i vrijeme zadnje provjere.

• Check now — odmah provjerava je li dostupna nova verzija
• Update now — pojavljuje se kada je ažuriranje dostupno; modul ga preuzima i instalira sam, a prethodnu verziju prije zamjene datoteka sprema kao sigurnosnu kopiju

Provjera se izvodi automatski jednom dnevno, a ažuriranja dolaze iz vašeg licencnog kanala, pa je za njih potrebna aktivna licenca. Ako automatsko ažuriranje nije moguće, novu verziju uvijek možete instalirati ručno — jednako kao kod prve instalacije, preko Učitaj modul.

7. Najčešći problemi i rješenja

Što vidite	Što to znači
“No license is active…” na narudžbi	Licenca nije aktivirana. Otvorite Configure → License i unesite licencni ključ.
“This license is bound to a different domain.”	Licenca je aktivirana na drugoj domeni. Na prethodnoj trgovini kliknite Deactivate ili nas kontaktirajte da je oslobodimo.
Status Blocked, poruka o isteku ili privremenoj obustavi	Licenca trenutačno nije valjana za izradu naljepnica. Provjerite paket i plaćanje ili nas kontaktirajte ako status nije očekivan.
“Credit limit reached…”	Potrošili ste sve naljepnice iz svog paketa. Kod paketa Mini 200 brojač se ponovno postavlja prvog dana sljedećeg kalendarskog mjeseca; 20 naljepnica besplatne probe jednokratna je zaliha, pa je tada vrijeme za kupnju paketa.
“Refresh pending…” uz aktivnu licencu	Licencni poslužitelj pri zadnjoj provjeri nije bio dostupan. Naljepnice tijekom razdoblja počeka rade normalno; modul pokušava ponovno automatski.
Crvena poruka o pogrešci u obrascu za naljepnicu	DPD EasyShip odbio je zahtjev, primjerice zbog neispravne adrese, ili poziv nije uspio. Gumb se mijenja u Retry kako biste mogli pokušati ponovno.
Upozorenje uz poštanski broj	Uneseni poštanski broj ne odgovara DPD podacima za odabrano mjesto. Upozorenje je informativno i ne blokira izradu naljepnice; poveznicom u upozorenju možete preuzeti mjesto koje predlaže DPD.
Mogućnost “Force clear label”	Prikazuje se kada otkazivanje naljepnice preko DPD API-ja nije uspjelo. Briše lokalni zapis u modulu kako biste naljepnicu mogli izraditi ponovno — upotrijebite je tek kada je pošiljka u DPD portalu doista otkazana.
Kupac ne može dalje na plaćanje	Odabrana je DPD dostavna služba s mjestom preuzimanja, a kupac mjesto još nije odabrao. Prikazuje se poruka “Please choose a DPD pickup point for your order.”
Plaćanje pouzećem nije dostupno	Vrijednost narudžbe premašuje 250 €, što je DPD-ovo ograničenje pouzeća za mjesta preuzimanja i paketomate. Kupac neka odabere dostavu na adresu ili drugi način plaćanja.
Umjesto postavki prikazuje se poruka o PHP-u	Trgovina radi na PHP-u starijem od 8.1. Ažurirajte PHP kod svog davatelja usluge; modul se tek nakon toga pokreće.

Ako problem ne uspijete riješiti, javite nam se — možete odgovoriti izravno na e-mail s licencnim ključem i dodati koju verziju PrestaShopa i PHP-a koristite te što točno piše u poruci o pogrešci.