Korisnički priručnik: HUB3 barkod za plaćanje

Modul hub3payment · verzija 1.7.1 · PrestaShop 1.7 i 8 · dD Tech

Modul je besplatan i dolazi bez jamstva i bez obveze podrške. Za usklađenost poslovanja odgovara trgovac. Prilagodbu po mjeri radi dD Tech po ponudi: ddtech.hr. Licenca: AFL-3.0 (datoteka LICENSE u modulu).

1. Što modul radi

Kad kupac odabere plaćanje bankovnom uplatom, modul generira 2D barkod po standardu HUB3 s podacima za uplatu: IBAN primatelja, iznos, model HR00 i poziv na broj te podatke platitelja. Kupac barkod skenira aplikacijom svoje banke i nalog za plaćanje popuni se sam.

Barkod se prikazuje na stranici potvrde narudžbe.
Barkod se sam dodaje u e-mail s podacima za bankovnu uplatu, bez uređivanja predloška (vidi poglavlje 4).
Barkod se sam dodaje na PDF račun dok narudžba nije plaćena (vidi poglavlje 5).
Barkod se generira na vašem poslužitelju, bez vanjskih servisa, bibliotekom TCPDF koja dolazi s PrestaShopom.

Poziv na broj je referenca narudžbe ako se sastoji samo od znamenki; inače se koristi ID narudžbe.

2. Instalacija

Putem administracije (preporučeno)

Prijavite se u PrestaShop administraciju.
Otvorite Moduli → Upravitelj modula i kliknite Učitaj modul.
Odaberite datoteku hub3payment-1.7.1.zip.
Nakon instalacije kliknite Konfiguriraj.

Nadogradnja sa starije verzije: učitajte novu .zip datoteku preko postojećeg modula. PrestaShop pri nadogradnji sam uključuje barkod u e-mailu i na računu; postavke ostaju sačuvane.

Putem FTP-a

Raspakirajte .zip datoteku na svom računalu.
Mapu hub3payment prebacite u mapu /modules/ na poslužitelju.
U administraciji pronađite modul i kliknite Instaliraj.

3. Konfiguracija

IBAN: IBAN primatelja uplate, bez razmaka (npr. HR1234567890123456789).
Ime tvrtke: naziv primatelja uplate.
Adresa i Grad: adresa sjedišta primatelja.
Kliknite Spremi.

Modul radi uz PrestaShopov modul za bankovnu uplatu (ps_wirepayment). Provjerite je li taj modul instaliran i aktivan — za druge načine plaćanja barkod se ne prikazuje.

4. Barkod u e-mailu kupcu

Barkod se u e-mail s podacima za bankovnu uplatu (bankwire) dodaje sam, ispod podataka banke. Predložak e-maila ne treba uređivati. Barkod ide samo u HTML verziju e-maila; tekstualna verzija ostaje nepromijenjena.

Želite barkod na drugom mjestu u e-mailu?

Pronađite predložak za bankovnu uplatu, obično /themes/VAŠA_TEMA/mails/hr/bankwire.html (za engleski /en/bankwire.html).
Na željeno mjesto zalijepite oznaku:
```
{hub3_html_block}
```
Spremite datoteku. Kad oznaka postoji u predlošku, modul barkod stavlja samo na to mjesto i ne dodaje ga drugi put.

Izgled bloka u e-mailu mijenja se u datoteci /modules/hub3payment/views/templates/hook/mail_barcode.tpl.

Za e-mail se slika barkoda sprema u mapu /modules/hub3payment/img/ pod nasumičnim imenom, jer je e-mail klijent dohvaća s poslužitelja. Slika sadrži podatke za uplatu (ime i adresu platitelja), pa staru arhivu te mape po potrebi povremeno obrišite.

5. Barkod na PDF računu

Na PDF račun narudžbe plaćene bankovnom uplatom modul sam dodaje barkod s iznosom, IBAN-om i pozivom na broj. Predložak računa ne treba uređivati.

Barkod se prikazuje samo dok narudžba nije plaćena, kako kupac ne bi platio dvaput. U standardnim postavkama PrestaShop račun izdaje tek u statusu „Plaćanje prihvaćeno”, kada barkod više nije potreban. Ako račun izdajete prije uplate (npr. u statusu „Čeka se bankovna uplata” uključite opciju da se kupcu izda račun), barkod će se na njemu prikazati.

Izgled bloka na računu mijenja se u datoteci /modules/hub3payment/views/templates/hook/pdf_invoice.tpl.

6. Rješavanje problema

Barkod se vidi na webu, ali ne u e-mailu

Provjerite prima li kupac e-mail u HTML obliku; u tekstualnoj verziji e-maila barkoda nema.
Ako ste oznaku {hub3_html_block} dodali ručno, provjerite je li u predlošku za jezik kupca.
Provjerite smije li web poslužitelj pisati u mapu /modules/hub3payment/img/ (uobičajeno dozvole 755 uz vlasnika koji je korisnik web poslužitelja). Ne postavljajte dozvole 777.

Bankovna aplikacija ne prepoznaje barkod

Provjerite je li IBAN ispravno upisan, bez razmaka.
Provjerite sadrže li naziv ili adresa neobične simbole (npr. emojije). Hrvatska slova modul sam prilagođava, ostali simboli mogu smetati.

Barkod se uopće ne prikazuje

Kupac mora odabrati plaćanje bankovnom uplatom.
PrestaShop mora sadržavati biblioteku TCPDF (dolazi uz standardnu instalaciju); bez nje modul ništa ne prikazuje.

Barkoda nema na PDF računu

Provjerite je li narudžba već plaćena; na računu plaćene narudžbe barkoda namjerno nema (vidi poglavlje 5).
Ako vaša tema ima vlastiti predložak računa (/themes/VAŠA_TEMA/pdf/invoice.tpl), on mora sadržavati mjesto za module: {$HOOK_DISPLAY_PDF}. Standardni PrestaShop predložak ga ima.

7. Podrška i prilagodbe

Modul se daje besplatno, bez jamstva i bez obveze podrške. Prilagodbu modula ili rad po mjeri dD Tech radi po ponudi — upit možete poslati putem ddtech.hr.