STUDIJA SLUČAJA
Desetak (SES)
Backend za voucher commerce u većim trgovačkim centrima.
Sažetak
- Industrija: Retail / Shopping centers / Vaučeri
- Klijent: SES (Citypark Ljubljana, Europark Maribor, Citycenter Celje, Center Vič Ljubljana, Aleja Ljubljana)
- Deliverable: Custom backend za desetak.si
- Uloga: Sistemska arhitektura, backend implementacija, integracije, operativni alati
- Integracijske točke: kartična plaćanja (Saferpay), TRR plaćanja, FURS fiskalizacija, Pošta Slovenije eSpremnica, email notifikacije
- Status: Produkcijski sustav
Kontekst
SES vodi jedinstveni voucher program preko pet najvećih shopping centara u Sloveniji. Desetak.si je trebao backend koji pouzdano podržava prodaju vaučera, generira tiskane i fizičke oblike te upravlja plaćanjima, fiskalizacijom i slanjem za svaki centar posebno.
Problem
Jednostavan checkout nije dovoljan za voucher operacije. Sustav je morao pokriti:
- više shopping centara s odvojenim merchant postavkama i operativnim procesima
- fizično dostavo i print-at-home voucherje
- asinkrone ishode plaćanja (kartica vs. TRR)
- strogo davčno skladnost i potrditev računa (FURS)
- logistiko i spremnice Pošte Slovenije
- automatsku komunikaciju sa strankama ovisno o statusu narudžbe
Ciljevi projekta
- Omogućiti online kupnju Desetak vaučera
- Generirati vaučere (PDF s barkodom i brendingom)
- Pratiti statuse narudžbe (plaćeno, izdano, preuzeto, poslano)
- Slati email obavijesti ovisno o statusu
- Podpreti kartična i TRR plaćanja
- Fiskalizirati račune i beležiti potrditev (FURS)
- Generirati spremnice za Pošto Slovenije
Ograničenja i izazovi
- Svaki centar zahtijeva odvojenu merchant konfiguraciju i obradu.
- Narudžbe moraju ostati konsistentna u asinhronih plaćanja tokovih.
- Fiskalizacija zahtijeva pravilno numeriranje i potvrdu računa.
- Fizične pošiljke trebaju strukturirane poštne podatke.
- Sustav mora podržavati B2C i B2B narudžbe.
Pregled rješenja
Dizajnirali smo custom backend koji orkestrira cijeli voucher lifecycle: checkout i sesije narudžbi, iniciranje plaćanja i povratne tokove, generiranje i izdavanje vaučera, prijelaze statusa, fiskalizaciju, poštne predaje i automatsko obavještavanje kupaca.
Rezultat je produkcijski sustav, koji povezuje plaćanja, compliance, izdajo voucherjev i dostavo za višecenterško organizaciju.
Arhitektura i tehnički pristup
Sustav je PHP + MySQL aplikacija s API endpointima, administrativnim sučeljem i planiranim procesima. Srž je model narudžbi vođen statusima:
- `abond` → aktivna košarica / narudžba u nastajanju
- `invalid` → narudžba oddano, a neplačano (TRR ali pending kartica)
- `valid` → plačano
- `redeem` → voucher izdan / izpolnjen
Ključni dijelovi:
- Checkout & cart API: sesijske košarice, adresni podaci, upravljanje stavkama
- Plaćanja: Saferpay PaymentPage za kartice i TRR tok za bankovne uplate
- Generiranje vaučera: predlošci brendinga, encoding barkoda, PDF izlaz
- Email workflow: transakcijski predlošci ovisno o statusu
- Fiskalizacija: FURS (Davčne blagajne) s EOR/ZOI/QR podacima
- Poštna integracija: Pošta Slovenije eSpremnica (SOAP), RF/VF reference, bulk predaje
- Admin alati: pregled narudžbi, statusi, izvještaji, batch upravljanje
- Pozadinski procesi: podsjetnici za napuštene košarice i usklađivanja
Tehnološki stack
- PHP
- MySQL
- Saferpay JSON API (PaymentPage)
- FURS fiskalizacija (Davčne blagajne)
- Pošta Slovenije eSpremnica (SOAP)
- PHPMailer za transakcijske emaile
- Imagick + Picqer Barcode za PDF vaučere
- DataTables + Dompdf za admin izvoz i izvještaje
Proces implementacije
- Modeliranje order lifecycle-a i statusnih prijelaza.
- Implementacija checkout, cart i session endpointov za B2C/B2B narudžbe.
- Integracija tokova kartičnih i TRR plaćanja.
- Implementacija voucher renderinga i barcode izdaje.
- Dodavanje fiskalizacije i praćenja računa.
- Integracija predaje Pošti Slovenije.
- Admin alati za operacije i izvještaje.
Rezultati i učinak
- Cijeli voucher commerce tok za pet najvećih centara
- Pouzdano upravljanje plaćanjima i statusima narudžbi
- Automatizirano izdavanje vaučera i komunikacija sa strankama
- Ugrađena fiskalna usklađenost i potvrda računa
- Operativni alati za poštne predaje i pregled narudžbi
Refleksija
Projekt pokazuje kako jasno definiran statusni model pojednostavljuje kompleksne operativne zahtjeve. Kad se fiskalizacija, fulfillment i pošta tretiraju kao ravnopravne faze, sustav ostaje stabilan i pri stvarnim opterećenjima.
Sažetak
Desetak backend osigurava SES-u produkcijsku voucher platformu: višecentarsku, usklađenu i operativno robusnu. Povezuje checkout, plaćanja, generiranje vaučera, fiskalizaciju i poštansku logistiku u jedinstven sustav.