✎ changes:cynodbo:july-2025-3.8.6_rc6 [cynod]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== 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.

===== Application mobile =====
==== Cynod FO v3.1.63 ====
  - **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
  - **Optimisation des messages écran**
    * Affichage contextuel selon le type d’échec ou de rejet : solde insuffisant, réseau instable, erreur serveur, etc.
  - **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.
  - **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.

===== Application web BO v3.8.6_RC65 =====
  - **Traitement des annulations**
    * Rejet des annulations sans paramètres complets (motif, auteur…)
    * Enregistrement complet des données d’annulation dans le journal BO
  - **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é.
  - **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.

===== Résumé des évolutions =====

| 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é   |

----

===== MAJ Guide Utilisateur - Transactions en conditions dégradées =====

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.

==== Cas de figure ====

=== 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 :**
  - Accédez à la page "Opérations douteuses" qui sera la seule page accessible.
  - Cliquez sur "Vérifier" pour confirmer si la transaction a été validée.
  - Si elle est en échec ou n'existe pas, le système procède à l'annulation automatique.
  - 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 :**
  -  Accédez à la page des opérations douteuses.
  - Vérifiez ou annulez la transaction en attente.
  - 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 :**
  - Ne relancez pas la vente. Les informations figurent dans le journal FO.
  - 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.
  - 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 :**
  - Relancez l’application.
  - 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.
  - Accédez à la page des opérations douteuses pour la régulariser.

==== FAQ ====

**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

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International