changes:cynodbo:july-2025-3.8.6_rc6

Ceci est une ancienne révision du document !


Release Note - CYNOD - Juillet 2025 (version 3.8.6_RC6)

Cette version apporte des corrections critiques liées à la gestion des transactions en conditions dégradées (perte de réseau, plantage, coupure avant mise à jour carte) dans l’application mobile CYNOD.

  1. Workflow de gestion des opérations douteuses
    • Détection automatique des transactions sans retour serveur avec un timeout de 5s
    • Blocage temporaire des nouvelles ventes tant qu’une opération douteuse n’est pas traitée.
    • Page dédiée avec :
      • Vérification du statut (check status)
      • Option d’annulation manuelle
      • Enregistrement du motif, de l’auteur et de la date d’annulation
  2. Optimisation des messages écran
    • Affichage contextuel selon le type d’échec ou de rejet : solde insuffisant, réseau instable, erreur serveur, etc.
  3. Traitement des transactions hybrides
    • Meilleure gestion des opérations commencées online et terminées offline.
    • Vérification post-synchro et régularisation automatique si nécessaire.
  4. Revue du journal FO
    • Corrections sur l’ordre d’affichage des transactions.
    • Mise à jour assurée même en cas de crash ou fermeture inattendue.
    • Marquage explicite des transactions offline.
  1. Traitement des annulations
    • Rejet des annulations sans paramètres complets (motif, auteur…)
    • Enregistrement complet des données d’annulation dans le journal BO
  2. Synchronisation et doublons
    • Amélioration du traitement des opérations déjà enregistrées côté BO.
    • Détection des duplications issues du FO et rejet contrôlé.
  3. Intégrité FO/BO
    • Harmonisation des statuts entre FO et BO lors des scénarios critiques.
    • Meilleur appui aux opérations post-synchro et confirmation.
Composant Fonctionnalité / Correction Statut
——— —————————————— ——–
FO Gestion des opérations douteuses Ajouté
FO Blocage temporaire des ventes Ajouté
FO Affichage messages d’erreur contextualisés Amélioré
FO Synchronisation post-crash Corrigé
BO Rejet contrôlé des duplications Amélioré
BO Enregistrement des annulations non initiées par la système Ajouté

Ce guide vous accompagne dans la gestion des situations exceptionnelles liées aux coupures réseau, timeout ou interruptions pendant la vente. Il décrit les cas les plus fréquents et la manière d’y réagir.

1. Opération douteuse

Contexte : Une transaction a été initiée en ligne, mais aucune réponse n’a été reçue du serveur (timeout de 5 secondes). Elle ne peut pas basculer en mode offline.

Message : “Délai d'attente dépassé. Vérifiez votre connexion internet puis vérifiez le statut de l'opération depuis le journal”

Ce que vous devez faire :

  1. Accédez à la page “Opérations douteuses” qui sera la seule page accessible.
  2. Cliquez sur “Vérifier” pour confirmer si la transaction a été validée.
  3. Si elle est en échec ou n'existe pas, le système procède à l'annulation automatique.
  4. Si elle est validée, le système vous confirme l'opération.

À noter que tant que le terminal détecte une opération douteuse, l'utilisateur ne pourra plus exploiter les fonctions du TPE. L'utilisateur peut à tout moment annuler l'opération, laquelle sera ensuite synchronisée au serveur pour des vérifications et mises à jour de la piste d'audit. Si l'opération a été validée au niveau du serveur, cette dernière sera annulée avec les informations provenant du TPE.

2. Blocage de nouvelle vente

Contexte : Une opération douteuse n’a pas encore été régularisée. En essayant d'exploiter le TPE, une alerte vous signalera qu’une opération est en attente.

Ce que vous devez faire :

  1. Accédez à la page des opérations douteuses.
  2. Vérifiez ou annulez la transaction en attente.
  3. Une fois l'opération traitée, vous pouvez reprendre la vente.

3. Transaction hybride

Contexte : Une vente a été lancée en ligne mais finalisée en offline suite à une coupure réseau.

Comportement :

  • La transaction est enregistrée localement.
  • Elle sera synchronisée automatiquement lorsque la connexion sera rétablie. Si l'opération a déjà été validée au niveau serveur, les informations sur le solde et les cumuls offline seront mises à jour.

Ce que vous devez faire :

  1. Ne relancez pas la vente. Les informations figurent dans le journal FO.
  2. Vérifiez le statut de synchronisation des opérations offline depuis le journal FO une fois la connexion rétablie, ou initiez la synchronisation depuis le menu Divers.
  3. En cas de doute, comparez le journal FO avec le dernier reçu ou demandez une assistance.

4. Fermeture inattendue pendant la vente

Contexte : L’application s’est fermée ou le terminal a redémarré avant la mise à jour carte.

Ce que vous devez faire :

  1. Relancez l’application.
  2. Une alerte vous signalera :
    • que l’opération précédente a bien été enregistrée si le retour serveur a eu lieu (juste avant la mise à jour carte),
    • ou que l’opération a échoué si aucune réponse n’a été reçue (l'opération a été initiée en offline et la mise à jour de la carte a échouée ou ne s'est pas faite.
  3. Accédez à la page des opérations douteuses pour la régulariser.

Q : Que faire si je ne retrouve pas une vente dans le journal ? Rendez-vous dans la page “Opérations douteuses”. Il est possible qu’une transaction soit en attente de confirmation ou ait été annulée.

Q : Comment savoir si une transaction a été acceptée ? Utilisez la fonction “Vérifier le statut” dans la page des opérations douteuses ou vérifiez dans le journal si elle est visible avec l’état “Validée”.

Q : Pourquoi je ne peux pas lancer une nouvelle vente ? Le terminal a détecté une opération non finalisée. Vous devez d’abord la régulariser depuis la page des opérations douteuses.


Date de publication : 14 juillet 2025

Versions concernées :

  • Back Office (BO) : v3.8.6_RC65
  • Front Office (FO mobile) : v3.1.63
  • changes/cynodbo/july-2025-3.8.6_rc6.1752521069.txt.gz
  • Dernière modification: 2025/07/14 19:24
  • par mactar.ba