API Cegid Retail Y2

Passez en revue les services Cegid Retail Y2 utilisés par The Wallet Crew et accordez l’accès utilisateur de service uniquement pour les parcours Wallet activés.

Cette page répertorie les services Cegid Retail Y2 utilisés par le connecteur et leur rôle. Elle prend en charge un accès par utilisateur de service à privilège minimal pour chaque parcours Wallet activé.

Pour la configuration du connecteur, voir Configurer le connecteur Cegid Retail Y2. Pour la synchronisation des champs client transportés par ces services, voir Mappage des champs Cegid Retail Y2.

En un coup d'œil

Le connecteur utilise deux modèles d’intégration. Les appels de services web récupèrent ou mettent à jour les données à la demande, et les notifications métier signalent les événements qui doivent déclencher une actualisation. La plupart des services sont en SOAP ; la génération des reçus et les données de référence sont en REST.

Client

Recherche, création et mise à jour de client, ainsi que les champs de consentement associés à l’enregistrement. Utilisé par chaque parcours Wallet impliquant un client identifié.

Opérations : rechercher des identifiants client, ajouter un nouveau client, mettre à jour un client.

Fidélité

Cycle de vie des cartes et données du programme. Deux services sont impliqués : le service de fidélité pour les cartes rattachées à un client et le détail d’une carte individuelle, et le moteur de fidélité pour les programmes disponibles dans un magasin.

Opérations : lister les cartes d’un client, créer une carte, lire une carte, lister les programmes actifs pour la création de carte dans un magasin.

Opérations de caisse

Bons, cartes cadeaux, certificats et dépôts rattachés à un client, ainsi que le solde disponible sur un instrument individuel.

Opérations : lister les instruments disponibles d’un client, lire le montant disponible d’un instrument.

Documents de vente

Enregistrements de transaction, pour les parcours de reçu et de commande.

Opérations : lire par clé, lire par référence externe, lister les en-têtes de documents, créer un document.

Rapport de vente

Génération de PDF de reçu, via REST plutôt que SOAP. La génération se déroule en trois étapes : demander le document, interroger jusqu’à ce qu’il soit prêt, le télécharger.

Données de référence

Pays, régions, langues et civilités, lus via REST pour alimenter les options du formulaire d’inscription avec les valeurs reconnues par la propre base de données Cegid de la marque.

Magasins et vendeurs

Le catalogue des magasins et les listes de vendeurs pour les mises en page affichant un conseiller.

Opérations : lister les magasins, lister les vendeurs.

Abonnement aux notifications métier

Gestion de l’abonnement aux notifications décrit dans Notifications métier.

Opérations : lire les abonnements actifs, créer, mettre à jour, supprimer.

Tâches planifiées

Liste et déclenchement des tâches planifiées Cegid, pour les flux qui doivent en exécuter une dans le cadre de l’inscription.

Commandes client

Données de commande, pour les parcours click-and-collect et similaires.

Seuls les services prenant en charge les parcours concernés doivent être accordés. Un programme couvrant l’inscription et l’affichage de la fidélité, sans parcours de reçu, n’exige pas les documents de vente, le rapport de vente ni les commandes client.

FAQ

Le connecteur repose-t-il uniquement sur les notifications ?

Non. Le connecteur utilise des appels directs aux services web pour lire et écrire les données, et des notifications métier uniquement pour réagir aux événements en temps quasi réel.

Quel service génère les PDF de reçu ?

Le service de rapport de vente génère le PDF. Le service des documents de vente est utilisé séparément pour récupérer les données du document et les listes de documents.