CASESTUDIE
Desetak (SES)
Voucher-commerce backend voor multi-center retailoperaties.
Overzicht
- Branche: Retail / Shopping centers / Vouchers
- Klant: SES (operator van Citypark Ljubljana, Europark Maribor, Citycenter Celje, Center Vič Ljubljana, Aleja Ljubljana)
- Opgeleverd: Maatwerk backend voor voucher-commerce op desetak.si
- Rol: Systeemarchitectuur, backend implementatie, integraties, operationele tooling
- Integratiepunten: kaartbetalingen (Saferpay), bankoverschrijvingsflows, FURS-fiscalisatie, Pošta Slovenije eSpremnica, e-mailnotificaties
- Status: Productiesysteem
Context
SES runt één voucherprogramma over vijf van de grootste shopping centers in Slovenië. De desetak.si site had een backend nodig die vouchers betrouwbaar kan verkopen, printable en fysieke formaten kan genereren en de operationele realiteit kan afhandelen rond betaling, facturatie en verzending-compliance per center.
Probleem
Een simpele checkout is niet genoeg voor voucher-operations. Het systeem moest het volgende afhandelen:
- meerdere shopping centers met aparte merchant setups en operationele flows
- fysieke verzending vs. print-at-home vouchers
- asynchrone betalingsuitkomsten (kaart vs. bankoverschrijving)
- strikte fiscale compliance en factuurbevestiging (FURS)
- postlogistiek en verzenddocumentatie (Pošta Slovenije)
- geautomatiseerde klantcommunicatie op basis van orderstatus
Projectdoelen
- Klanten Desetak-vouchers online laten kopen
- Vouchers genereren (PDF met barcode en branding)
- Orderstatus tracken over betaling, uitgifte en afhandeling
- Klantmails sturen op basis van status-transities
- Kaartbetalingen en bankoverschrijvingen ondersteunen
- Facturen fiscaliseren en bevestiging vastleggen (FURS)
- Verzenddocumenten genereren voor Pošta Slovenije
Beperkingen & Uitdagingen
- Elk shopping center vereiste een eigen merchant-configuratie en operationele afhandeling.
- Orders moesten consistent blijven over asynchrone betaalflows.
- Fiscalisatie vereiste conforme factuurnummering en bevestigingen.
- Fysieke verzending vereiste gestructureerde postdata en export.
- Het systeem moest zowel B2C- als B2B-bestelscenario’s ondersteunen.
Oplossingsoverzicht
We hebben een maatwerk backend gebouwd die de volledige voucher-lifecycle orkestreert: beheer van checkout en ordersessies, betalingsinitiatie en afhandeling van return-URL’s, voucher-generatie en -uitgifte, orderstatus-transities, fiscalisatie en factuurregistratie, integratie voor overdracht aan de post en geautomatiseerde klantmails.
Het resultaat is een productieklaar systeem dat betalingen, compliance, voucher-uitgifte en levering samenbrengt voor een multi-center retailorganisatie.
Architectuur & Technische aanpak
Het systeem is een PHP + MySQL-applicatie met API-endpoints, een backoffice-UI en geplande processen. De kern van de workflow is een statusgedreven ordermodel:
- `abond` → actieve winkelwagen/sessie in uitvoering
- `invalid` → order geplaatst maar onbetaald (bankoverschrijving of pending kaartbevestiging)
- `valid` → betaald
- `redeem` → voucher uitgegeven / afgehandeld
Kerncomponenten:
- Checkout- en cart-API: sessiegebaseerde ordering, verzend-/factuurdata, itembeheer
- Betaalgateway: Saferpay PaymentPage voor kaartbetalingen en een bankoverschrijvingsflow voor TRR-betalingen
- Voucher-generatie: branded sjablonen, barcode-encodering, PDF-output
- E-mailworkflows: transactionele templates op basis van status-transities
- Fiscalisatie-service: FURS (Davčne blagajne) met EOR/ZOI/QR-afhandeling
- Verzendintegratie: Pošta Slovenije eSpremnica (SOAP), RF/VF referentie-generatie, bulk-inzendingen
- Admin-dashboard: orderbeoordeling, statusupdates, rapportages, beheer van verzendbatches
- Achtergrondtaken: opvolging van verlaten winkelwagens en statusreconciliatie
Technologiestack
- PHP
- MySQL
- Saferpay JSON API (PaymentPage)
- FURS-fiscalisatie (Davčne blagajne)
- Pošta Slovenije eSpremnica (SOAP)
- PHPMailer voor transactionele e-mails
- Imagick + Picqer Barcode voor PDF voucher-generatie
- DataTables + Dompdf voor admin-exports en rapportages
Implementatieproces
- Orderlifecycle en status-transities gemodelleerd over betaling en fulfillment.
- Checkout-, cart- en sessie-endpoints geïmplementeerd voor B2C/B2B-orders.
- Kaart- en bankoverschrijvingsflows geïntegreerd.
- Voucher-rendering en barcode-uitgifte-logica gebouwd.
- Fiscalisatie-endpoints en factuurtracking toegevoegd.
- Pošta Slovenije inzendworkflow geïntegreerd.
- Admin-tooling opgeleverd voor operaties en rapportage.
Resultaten en impact
- End-to-end voucher-commerce-pipeline voor vijf grote shopping centers
- Betrouwbare betaalafhandeling met duidelijke orderstatus-transities
- Geautomatiseerde voucher-uitgifte en klantcommunicatie
- Fiscale compliance en factuurbevestiging ingebouwd in de flow
- Operationele tooling voor verzendbatches en ordermanagement
Reflectie
Dit project laat zien hoe een goed gestructureerd orderstatusmodel complexe operationele vereisten vereenvoudigt. Door fiscalisatie, fulfillment en verzending als volwaardige fases te behandelen (niet als bijzaak), blijft het systeem betrouwbaar onder praktische randvoorwaarden.
Samenvatting
De Desetak-backend biedt SES een voucher-commerceplatform op productieniveau: multi-center-bewust, compliant en operationeel robuust. Het verbindt checkout, betalingen, voucher-generatie, fiscalisatie en postlogistiek in één samenhangend systeem.