Desetak (SES)

Contexte

SES gère un programme de bons d'achat à travers cinq des plus grands centres commerciaux de Slovénie. Le site desetak.si avait besoin d'un backend capable de vendre des bons de manière fiable, de générer des formats imprimables et physiques, et de gérer les réalités opérationnelles du paiement, de la facturation et de la conformité d'expédition pour chaque centre.

Problème

Un simple processus de paiement ne suffit pas pour les opérations de bons d'achat. Le système devait gérer :

• plusieurs centres commerciaux avec des configurations marchandes et des flux opérationnels séparés
• expédition physique vs bons à imprimer à domicile
• résultats de paiement asynchrones (carte vs virement bancaire)
• conformité fiscale stricte et confirmation de facture (FURS)
• logistique postale et documentation d'expédition (Pošta Slovenije)
• communication client automatisée basée sur le statut de commande

Objectifs du Projet

• Permettre aux clients d'acheter des bons Desetak en ligne
• Générer des bons (PDF avec code-barres et image de marque)
• Suivre le statut des commandes à travers le paiement, l'émission et l'exécution
• Envoyer des emails aux clients en fonction des transitions d'état
• Prendre en charge les paiements par carte et les virements bancaires
• Fiscaliser les factures et enregistrer la confirmation (FURS)
• Générer des documents d'expédition pour Pošta Slovenije

Contraintes et Défis

• Chaque centre commercial nécessitait une configuration marchande distincte et une gestion opérationnelle spécifique.
• Les commandes devaient rester cohérentes à travers les flux de paiement asynchrones.
• La fiscalisation nécessitait une numérotation de facture conforme et des confirmations.
• Les expéditions physiques nécessitaient des données postales structurées et l'exportation.
• Le système devait prendre en charge à la fois les scénarios de commande B2C et B2B.

Aperçu de la Solution

Nous avons construit un backend personnalisé qui orchestre le cycle de vie complet des bons : gestion du processus de paiement et de la session de commande, initiation et gestion du retour de paiement, génération et émission de bons, transitions de statut de commande, fiscalisation et enregistrement des factures, intégration de remise postale et emails clients automatisés.

Le résultat est un système prêt pour la production qui relie les paiements, la conformité, l'émission de bons et la livraison pour une organisation de vente au détail multi-centres.

Architecture et Approche Technique

Le système est une application PHP + MySQL avec des points de terminaison API, une interface back-office et des processus planifiés. Le cœur du flux de travail est un modèle de commande basé sur le statut :

• `abond` → panier/session active en cours
• `invalid` → commande passée mais non payée (virement bancaire ou confirmation de carte en attente)
• `valid` → payée
• `redeem` → bon émis / exécuté

Composants clés :

• API de processus de paiement et panier : commande basée sur session, données d'expédition/facture, gestion des articles
• Passerelle de paiement : Saferpay PaymentPage pour les paiements par carte et flux de virement bancaire pour les paiements TRR
• Génération de bons : modèles de marque, encodage de codes-barres, sortie PDF
• Flux d'emails : modèles transactionnels basés sur les transitions d'état
• Service de fiscalisation : FURS (Davčne blagajne) avec gestion EOR/ZOI/QR
• Intégration d'expédition : eSpremnica de Pošta Slovenije (SOAP), génération de référence RF/VF, soumissions en masse
• Tableau de bord administrateur : révision des commandes, mises à jour de statut, rapports, gestion des lots d'expédition
• Tâches en arrière-plan : suivi des paniers abandonnés et réconciliation d'état

Stack Technologique

• PHP
• MySQL
• Saferpay JSON API (PaymentPage)
• Fiscalisation FURS (Davčne blagajne)
• eSpremnica de Pošta Slovenije (SOAP)
• PHPMailer pour les emails transactionnels
• Imagick + Picqer Barcode pour la génération de bons PDF
• DataTables + Dompdf pour les exportations et rapports admin

Processus d'Implémentation

1. Modélisation du cycle de vie des commandes et des transitions d'état à travers le paiement et l'exécution.
2. Implémentation des points de terminaison de processus de paiement, panier et session pour les commandes B2C/B2B.
3. Intégration des flux de paiement par carte et virement bancaire.
4. Construction de la logique de rendu des bons et d'émission de codes-barres.
5. Ajout des points de terminaison de fiscalisation et suivi des factures.
6. Intégration du flux de soumission de Pošta Slovenije.
7. Livraison d'outils admin pour les opérations et les rapports.

Résultats et Impact

• Pipeline de commerce de bons de bout en bout pour cinq grands centres commerciaux
• Gestion fiable des paiements avec des transitions d'état de commande claires
• Émission automatisée de bons et communication client
• Conformité fiscale et confirmation de facture intégrées dans le flux
• Outils opérationnels pour les lots d'expédition et la gestion des commandes

Réflexion

Ce projet met en évidence comment un modèle d'état de commande bien structuré simplifie les exigences opérationnelles complexes. En traitant la fiscalisation, l'exécution et l'expédition comme des étapes de première classe (et non des réflexions après coup), le système reste fiable face aux contraintes du monde réel.

Résumé

Le backend Desetak fournit à SES une plateforme de commerce de bons de qualité production : multi-centres, conforme et robuste opérationnellement. Il connecte le processus de paiement, les paiements, la génération de bons, la fiscalisation et la logistique postale en un seul système cohérent.