This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Notifications métier

Utilisez les notifications métier Cegid Retail Y2 pour actualiser les données des cartes Apple Wallet et Google Wallet après une activité en magasin.

Cegid peut avertir The Wallet Crew lorsqu’une activité pertinente se produit. Cela actualise rapidement les données de Carte Wallet après un achat ou une mise à jour de fidélité. Les notifications sont facultatives et comportent d’importantes contraintes de configuration.

Le point de terminaison et l’abonnement sont distincts

Cette distinction explique l’essentiel de la confusion autour de la fonctionnalité, et elle n’est pas évidente dans l’interface.

The Wallet Crew expose toujours un point de terminaison de notification pour une connexion configurée. Il est authentifié et accepte les notifications dès lors que Cegid pointe vers lui, quel que soit le paramètre défini dans la console d’administration.

Ce que Écouter la notification métier Le paramètre sert à gérer le abonnement dans Cegid. Lorsqu’il est activé, The Wallet Crew s’enregistre comme abonné aux notifications de Cegid en utilisant les identifiants fournis à côté de l’interrupteur, et se réenregistre chaque fois que la configuration du connecteur est enregistrée.

Un administrateur Cegid qui configure l’abonnement manuellement dans Cegid reçoit des notifications fonctionnelles en laissant le paramètre désactivé. À l’inverse, activer le paramètre prend le contrôle d’un abonnement qui peut appartenir à un autre système.

Ce que Cegid envoie et ce qui se passe

Une notification transporte des identifiants, pas du contenu. Le connecteur relit l’enregistrement concerné depuis Cegid et actualise les cartes concernées.

Événement
Déclenché lorsque
Effet

Client créé

Un enregistrement client est créé dans Cegid.

Enregistré ; disponible pour l’automatisation en aval.

Client mis à jour

Un enregistrement client est modifié.

Chaque Carte liée à ce client est actualisée.

Ticket créé

Une vente est finalisée ou enregistrée.

Le client est identifié à partir du document et ses Cartes sont actualisées.

Fidélité mise à jour

Une opération de carte de fidélité est enregistrée.

Le client est identifié à partir de la carte et ses Cartes sont actualisées.

Autre

Tout autre événement Cegid atteignant le point de terminaison.

Enregistré comme événement générique. Aucune actualisation de Carte n’est déclenchée.

Les reçus mis en attente sont délibérément ignorés, car la transaction n’est pas terminée.

Volume et doublons

Le trafic de notifications dans un parc de magasins actif est important, et chaque notification qui entraîne une actualisation génère ses propres lectures Cegid. L’activation des notifications augmente la consommation de Cegid, et les paramètres de limite de débit et de cache dans Configuration avancée doivent être examinés en même temps.

Le point de terminaison ne déduplique pas sur l’identifiant d’événement. Une notification livrée plus d’une fois est traitée plus d’une fois. Comme le traitement consiste à lire l’état actuel et à actualiser une Carte, le résultat est correct mais le travail est répété.

Retrait d’une configuration

Un abonnement enregistré dans Cegid continue d’envoyer des notifications jusqu’à sa suppression dans Cegid. La mise hors service d’un locataire Wallet Crew ne le supprime pas, et un abonnement pointant vers un locataire retiré peut continuer à diffuser pendant longtemps. La suppression de l’abonnement relève de la procédure de mise hors service décrite dans Runbooks d’exploitation.

FAQ

Les notifications métier sont-elles nécessaires pour que les Cartes restent à jour ?

Non. Les Cartes sont actualisées chaque fois qu’elles sont reconstruites. Les notifications font que cela se produit rapidement après une activité en magasin, plutôt que selon le calendrier de la plateforme Wallet.

Les notifications arrivent, mais une Carte ne change pas. Pourquoi ?

Il est très probable que l’événement relève de la catégorie générique, qui est enregistrée mais ne déclenche pas d’actualisation. La première étape consiste à confirmer le type d’événement envoyé par Cegid.

Deux systèmes peuvent-ils recevoir des notifications Cegid ?

Pas directement, car Cegid ne prend en charge qu’un seul abonnement. Un middleware qui détient l’abonnement et le relaie vers les deux est l’arrangement habituel.

Mis à jour