ŠTUDIJA PRIMERA
Desetak (SES)
Backend za voucher commerce v večjih nakupovalnih središčih.
Povzetek
- Industrija: Retail / Shopping centers / Voucherji
- Naročnik: SES (Citypark Ljubljana, Europark Maribor, Citycenter Celje, Center Vič Ljubljana, Aleja Ljubljana)
- Deliverable: Custom backend za desetak.si
- Vloga: Sistemska arhitektura, backend implementacija, integracije, operativna orodja
- Integracijske točke: kartična plačila (Saferpay), TRR plačila, FURS fiskalizacija, Pošta Slovenije eSpremnica, email notifikacije
- Status: Produkcijski sistem
Kontekst
SES vodi enoten voucher program preko petih največjih shopping centrov v Sloveniji. Desetak.si je potreboval backend, ki zanesljivo podpira prodajo voucherjev, generira tiskane in fizične oblike ter obvladuje plačila, fiskalizacijo in pošiljanje za vsak center posebej.
Problem
Enostaven checkout ni dovolj za voucher operacije. Sistem je moral pokriti:
- več shopping centrov z ločenimi merchant nastavitvami in operativnimi procesi
- fizično dostavo in print-at-home voucherje
- asinhrone izide plačil (kartica vs. TRR)
- strogo davčno skladnost in potrditev računov (FURS)
- logistiko in spremnice Pošte Slovenije
- avtomatsko komunikacijo s strankami glede na status naročila
Cilji projekta
- Omogočiti online nakup Desetak voucherjev
- Generirati voucherje (PDF z barcode in brandingom)
- Slediti statusom naročila (plačano, izdano, prevzeto, poslano)
- Pošiljati email obvestila glede na stanje
- Podpreti kartična in TRR plačila
- Fiskalizirati račune in beležiti potrditev (FURS)
- Generirati spremnice za Pošto Slovenije
Omejitve in izzivi
- Vsak center zahteva ločeno merchant konfiguracijo in obravnavo.
- Naročila morajo ostati konsistentna v asinhronih plačilnih tokovih.
- Fiskalizacija zahteva pravilno številčenje in potrditev računov.
- Fizične pošiljke potrebujejo strukturirane poštne podatke.
- Sistem mora podpirati B2C in B2B naročila.
Pregled rešitve
Zasnovali smo custom backend, ki orkestrira celoten voucher lifecycle: checkout in seje naročil, iniciacijo plačil in povratne tokove, generacijo in izdajo voucherjev, prehode statusov, fiskalizacijo, poštne oddaje in avtomatsko obveščanje kupcev.
Rezultat je produkcijski sistem, ki povezuje plačila, compliance, izdajo voucherjev in dostavo za večcenterško organizacijo.
Arhitektura in tehnični pristop
Sistem je PHP + MySQL aplikacija z API endpointi, administrativnim vmesnikom in scheduled procesi. Jedro je statusno voden order model:
- `abond` → aktivna košarica / naročilo v nastajanju
- `invalid` → naročilo oddano, a neplačano (TRR ali pending kartica)
- `valid` → plačano
- `redeem` → voucher izdan / izpolnjen
Ključni deli:
- Checkout & cart API: sejne košarice, naslovni podatki, item management
- Plačila: Saferpay PaymentPage za kartice in TRR tok za bančna nakazila
- Voucher generacija: branding predloge, barcode encoding, PDF izhod
- Email workflow: transakcijski templati glede na stanje
- Fiskalizacija: FURS (Davčne blagajne) z EOR/ZOI/QR podatki
- Poštna integracija: Pošta Slovenije eSpremnica (SOAP), RF/VF reference, bulk oddaje
- Admin orodja: pregled naročil, statusi, poročila, batch upravljanje
- Background procesi: opomini za zapuščene košarice in poravnave
Tehnološki sklad
- 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 voucherje
- DataTables + Dompdf za admin izvoz in poročila
Proces implementacije
- Modeliranje order lifecycle-a in statusnih prehodov.
- Implementacija checkout, cart in session endpointov za B2C/B2B naročila.
- Integracija kartičnih in TRR plačilnih tokov.
- Implementacija voucher renderinga in barcode izdaje.
- Dodana fiskalizacija in sledenje računom.
- Integracija Pošta Slovenije oddaje.
- Admin orodja za operacije in poročila.
Rezultati in učinek
- Celoten voucher commerce tok za pet največjih centrov
- Zanesljivo upravljanje plačil in stanj naročil
- Avtomatizirana izdaja voucherjev in komunikacija s strankami
- Vgrajena fiskalna skladnost in potrditev računov
- Operativna orodja za poštne oddaje in pregled naročil
Refleksija
Projekt pokaže, kako jasno definiran statusni model poenostavi kompleksne operativne zahteve. Ko so fiskalizacija, fulfillment in pošta obravnavani kot polnopravne faze, sistem ostane stabilen tudi v realnih obremenitvah.
Povzetek
Desetak backend zagotavlja SES-u produkcijsko voucher platformo: večcenterško, skladno in operativno robustno. Povezuje checkout, plačila, generacijo voucherjev, fiskalizacijo in poštno logistiko v enoten sistem.