Guide utilisateur

Guide utilisateur

Guide utilisateur

Connecteur CEGID Retail SaaS / PrestaShop

Version de la documentation : 9 (30/03/2026)


Contexte

Le connecteur XY-Connect Cegid Retail SaaS est constitué d’un module PrestaShop « XY-Connect pour Cegid SaaS » comprenant notamment deux scripts PHP « import.php » et « export.php ».

Ce connecteur PrestaShop permet de :
  • transmettre les données de Cegid Business Retail vers PrestaShop
  • récupérer les nouvelles commandes PrestaShop dans Cegid
Les échanges de données utilisent des flux au format CSV pour les imports de données et XML via les webservices SOAP mis à disposition par Cegid.

Depuis la version 3.0.0 du module, un nouveau script rfe.php est mis à disposition pour permettre la récupération de fichiers plats enregistrés dans l'outil Cegid RFE.
Si vous disposez de la solution Cegid RFE pour la transmission de fichiers plats, il vous faudra alors appeler le script rfe.php pour télécharger les fichiers CSV dans PrestaShop puis import.php pour lancer l'import de ces fichiers


Les + pour l'e-commerçant

Avec le module « XY-Connect pour Cegid SaaS », vous gagnez en productivité, en cohérence et en sérénité :
  • Votre catalogue en ligne est à jour ainsi que les prix et les stocks affichés par rapport à votre base de données CEGID
  • Les articles et déclinaisons dépubliés dans Cegid sont automatiquement désactivés sur votre boutique PrestaShop
  • Vous diminuez les risques d’incohérence entre votre base Cegid et votre base PrestaShop
  • Vous gagnez du temps en ne ressaisissant plus les données
  • Vos commandes Web sont automatiquement intégrées dans Cegid, vous optimisez les délais de traitement de vos commandes
  • Synchronisations sécurisées : token de sécurité, prise en charge du protocole HTTPS.
  • Données et utilisateurs illimités.
  • Conforme RGPD : le connecteur ne stocke tout simplement pas vos données ! il agit comme une passerelle entre votre site et votre Gestion Commerciale.
  • Simplicité et clareté : vous pilotez vos données depuis Cegid et les enrichissez dans PrestaShop. Pas de troisième interface à utiliser.


Les fonctionnalités

  • Contrôle total des données exportées depuis Cegid vers la boutique PrestaShop (ex: nature du stock pris en compte, import des tarifs TTC etc.)
  • Possibilité de choisir dans quelle catégorie importer les articles dans PrestaShop avec possibilité de désactiver la catégorie pour enrichir les données avant de les rendre disponibles pour vos clients
  • Possibilité d'ajouter et retirer des données au sein des flux d'import CSV (ex: ajouter une colonne pour l'import d'une caractéristique)
  • Synchronisation des articles déclinés
  • Import des packs d'articles avec gestion des composants et quantités
  • Mise à jour des fiches clients dans Cegid lors de l'import des commandes
  • Synchronisation de l'adresse principale des clients
  • Possibilité d'importer des remises articles via un flux CSV dédié et de les associer à des codes de démarque spécifiques, y compris pour des groupes clients
  • Après la 1ère synchronisation, possibilité d'importer uniquement les données qui ont été modifiés depuis la dernière synchronisation pour un traitement plus rapide des données
  • Journaux des synchronisations consultables facilement depuis le back-office via un menu dédié
  • Création des documents Cegid (préparation de livraison, livraison client) directement depuis la fiche commande dans le back-office PrestaShop, via le changement de statuts des commandes (préparation en cours, expédiée)
  • Gestion des retours de commandes : export vers Cegid et import des statuts de retour
  • Import des commandes passées en magasin physique dans PrestaShop, avec gestion des retours magasins
  • Possibilité de désactiver les flux dont vous n'avez pas besoin
  • Support de l'outil Cegid RFE pour le téléchargement des fichiers plats
  • Gestion du module « (WebXY) Cartes cadeaux » pour l'export des commandes contenant des cartes cadeaux


Prérequis

Les éléments ci-dessous sont nécessaire pour le bon fonctionnement du module.

Prérequis web

  • PrestaShop version 1.7.8 ou supérieure (compatible PrestaShop 9)
  • PHP version 7.4 ou supérieure
  • Librairie PHP SOAP installée
  • Le dossier /modules/xyconnectcegid/ ainsi que ses sous-dossiers doivent être accessible en écriture

Prérequis Cegid

  • Création d'un article dans Cegid, non tenu en stock qui contiendra les articles PrestaShop sans référence
  • Création d'un article dans Cegid, non tenu en stock qui contiendra les frais de port des commandes PrestaShop
  • Création d'un article dans Cegid, non tenu en stock qui contiendra le montant des remises panier (règles panier dans PrestaShop)
  • Création d'un article dans Cegid, non tenu en stock qui contiendra le montant du tarif des emballages cadeaux
  • Un motif de démarque pour les remises web par ligne
  • Si vous ne souhaitez pas importer les commandes en tant que tickets dans Cegid, il faudra alors activer le module « Pilotage eCommerce » dans Cegid
  • Le code des devises utilisées dans la boutique e-commerce doivent être strictement identiques au code ISO de PrestaShop (ex : code « EUR » pour la devise Euro)


Fonctionnement

Comme indiqué précédemment, le connecteur est constitué d’un module PrestaShop contenant un script pour l'import des données dans PrestaShop ainsi qu'un second script pour l'export des données vers Cegid.
Ces échanges de données sont réalisés selon les formats suivants:
  • CSV
  • XML, via les webservices Cegid
Voici ci-dessous la liste des flux d'échanges de données disponibles pour le connecteur Cegid / PrestaShop :
Flux
Nom technique
Type d'échange
Format d'échange
Disponible depuis la version
Description
Clients
customer
import
CSV
3.0.0
Import des clients Cegid dans PrestaShop
Articles
product
import
CSV
1.0.0
Import des articles et déclinaisons dans PrestaShop
Packs
pack
import
CSV
3.0.0
Conversion d'articles existants en packs
Etablissements
store
import
CSV
1.0.0
Import des établissements Cegid dans PrestaShop
Stocks
stock
import
CSV
1.1.0
Import des stocks articles et déclinaisons
Remises articles
specificprice
import
CSV
1.0.0
Import des remises articles sous forme de prix spécifiques dans PrestaShop
Commandes magasins
storeOrder
import
CSV
3.0.0
Import des commandes magasins (Cegid) dans PrestaShop
Statuts des retours
orderReturnStatus
import
Webservice
3.0.0
Mise à jour des statuts des retours de commande
Statuts des commandes
orderstatus
import
Webservice
1.0.0
Mise à jour des statuts des commandes
Clients
customer
export
Webservice
3.0.0
Export des clients PrestaShop n'ayant jamais passé commande (désactivé par défaut)
Commandes
order
export
Webservice
1.0.0
Export des commandes PrestaShop vers Cegid via les webservices
Retours
return
export
Webservice
3.0.0
Export des retours de commande de PrestaShop vers Cegid
Statuts des commandes
orderstatus
export
Webservice
4.0.0
Export des statuts des commandes vers Cegid (désactivé par défaut)


Import des données CSV

Pour importer les données via des fichiers CSV, le module dispose d’un sous-dossier streams/ prévu pour contenir les fichiers CSV récupérés lors des imports de données dans PrestaShop.
Il est possible de créer un sous-dossier par flux d'import (article, stocks, remises etc.) et de placer les fichiers CSV correspondants dans ces sous-dossiers.
Les répertoires de dépôt des fichiers CSV sont paramétrables pour chacun de ces flux.
A la fin des imports des fichiers CSV, ceux-ci sont déplacés à l’intérieur du répertoire streams/archives/.

IMPORTANT : le dépôt de fichiers CSV de Cegid vers PrestaShop est à la charge du client.

Pour démarrer un import de données CSV manuel, il suffit de copier l'URL d'import (disponible au sein de la page de configuration du module) dans votre navigateur.

Vous pouvez mettre en place un import automatique des données CSV via la mise en place d'une tâche CRON.
Il est recommandé de paramétrer la fréquence d'import 5 à 10 minutes après le dépôt de fichier CSV au sein de l'environnement WEB


Export des données XML

L'export des données est réalisé via la bibliothèque PHP SOAP.
Pour démarrer un export de données manuel, il suffit de copier l'URL d'export (disponible au sein de la page de configuration du module) dans votre navigateur.
Vous pouvez mettre en place un export automatique des données via la mise en place d'une tâche CRON.

En ce qui concerne l'export des commandes PrestaShop dans Cegid, celles-ci sont automatiquement envoyées dans Cegid selon les règles suivantes :
  • Le statut le plus récent de la commande doit faire parti des statuts suivants :
  • Paiement accepté
  • En attente de réapprovisionnement (payé)
  • Paiement à distance accepté
  • La commande ne doit pas avoir été flaggé comme étant synchronisée dans Cegid

Pour forcer l’état de synchronisation d’une commande à « non synchronisée », vous pouvez vous rendre au sein du back-office, dans le menu « Xy Connect – associations » > « Commandes » puis cliquer sur le bouton « Oui » de la commande correspondante (voir capture d’écran ci-dessous).



Exécution ciblée d'un seul flux

Disponible depuis la version 3.0.0 du module
Il est possible d'exécuter un seul flux d'import ou d'export à la fois en ajoutant le paramètre stream à l'URL. Cela vous permet de contrôler l'ordre d'exécution des flux et vous donne une plus grande flexibilité pour paramétrer vos tâches CRON.
Exemples :
  • Import des produits uniquement : http://mondomaine.fr/module/xyconnectcegid/import?xytoken=mon_token&stream=product
  • Export des commandes uniquement : http://mondomaine.fr/module/xyconnectcegid/export?xytoken=mon_token&stream=order


Mode simulation (dry_run)

Disponible depuis la version 3.0.0 du module (pour les exports) et 4.0.0 (pour certains imports en Webservice)
Le paramètre dry_run=1 permet de simuler un import ou un export sans effectuer les modifications réelles. Cela permet de vérifier le bon fonctionnement des flux avant de les exécuter en production.
Exemple :
  • http://mondomaine.fr/module/xyconnectcegid/export?xytoken=mon_token&dry_run=1


Paramétrages

Paramètres généraux

L'onglet « Global » de la page de configuration du module contient les paramètres suivants :
  • Token. Jeton de sécurité utilisé pour authentifier les appels aux scripts du module.
  • Mode debug (oui / non). Si activé, les erreurs détaillées seront affichées lors des imports et exports de données.
  • Garder les logs pendant X jours. Durée de conservation des logs de synchronisation (en jours). Les logs plus anciens seront automatiquement supprimés.


Paramètres des produits

Disponible depuis la version 4.0.0 du module
L'onglet « Produits » de la page de configuration du module contient les paramètres suivants :
  • Désactiver automatiquement les nouveaux produits (oui / non). Si activé, les nouveaux articles seront désactivés automatiquement lors de leur import dans PrestaShop. Cela vous permet d'enrichir les fiches produits avant de les rendre visibles pour vos clients.
  • Désactiver la mise à jour du libellé pour les produits existants ? (oui / non). Si activé, le libellé des produits déjà présents dans PrestaShop ne sera pas écrasé lors des synchronisations suivantes. (Disponible depuis la version 4.2.0)


Paramètres des stocks

Disponible depuis la version 4.0.0 du module
L'onglet « Stocks » de la page de configuration du module contient le paramètre suivant :
  • Additionner les lignes de stock lors de l'import (oui / non). Si activé, les lignes de stocks d'un même article / déclinaison seront additionnées avant la mise à jour du stock. Nécessaire si votre export Cegid ne cumule pas les stocks des dépôts avant export vers le fichier CSV. Si ce paramètre est activé, le connecteur importera les fichiers de stocks un par un.


Paramètres des catégories

L'onglet « Catégories » de la page de configuration du module contient les paramètres suivants :
  • Synchroniser les associations produits / catégories (oui / non). Si désactivé, les produits synchronisés seront associés à la catégorie par défaut uniquement.
  • Recherche des catégories (Selon le nom / code ERP / Id PrestaShop). Méthode utilisée pour la recherche des catégories lors de l'association produits / catégories. (Disponible depuis la version 4.0.0)
  • Catégorie racine des produits synchronisés. Les catégories importées depuis Cegid seront enregistrées sous cette catégorie parente (sélection via un arbre de catégories).
  • Synchroniser les associations uniquement pour les nouveaux produits (oui / non). Si désactivé, les associations produits / catégories seront réinitialisées à chaque synchronisation du produit.
  • Réinitialiser toutes les associations produits / catégories (oui / non). Si désactivé, seules les associations provenant de Cegid seront réinitialisées.


Paramètres des prix

L'onglet « Prix » de la page de configuration du module contient les paramètres suivants :
  • Prix des produits exportés depuis CEGID hors taxes (oui / non). Si désactivé, le module recalculera le prix HT des produits en fonction du pays par défaut de la boutique. La désactivation de ce paramètre peut entraîner des différences de prix lors de l'import des produits depuis Cegid. (Disponible depuis la version 1.12.0)
  • Prix des remises exportées depuis CEGID hors taxes (oui / non). Si désactivé, le module recalculera le prix HT des remises en fonction de la règle de taxe du produit. La désactivation de ce paramètre peut entraîner des différences de prix lors de l'import des remises depuis Cegid. (Disponible depuis la version 1.10.0)
  • Écraser les prix spécifiques existants (oui / non). Si désactivé, les remises Cegid ne seront pas créées si un prix spécifique existe déjà dans PrestaShop.
  • Recalculer les pourcentages de remise (oui / non). Si activé, le module recalculera automatiquement les pourcentages de remise lorsque le prix du produit est mis à jour mais que la valeur de la remise n'est pas fournie. L'activation de ce paramètre peut entraîner des différences de prix lors de l'import des commandes dans Cegid.
  • Ventiler les règles de panier dans les produits (oui / non). Si activé, le montant des règles de panier sera réparti dans chaque produit de la commande du client.


Paramètres des commandes

L'onglet « Commandes » de la page de configuration du module contient les paramètres suivants :
  • Importer les tickets (oui / non). Si activé, les commandes PrestaShop seront importées en tant que tickets dans Cegid (au lieu de commandes). Si ce paramètre est activé, le flux « Statuts de commandes » sera désactivé. (Disponible depuis la version 1.13.0)
  • Utiliser le code EAN 13 en tant qu'identifiant (oui / non). Si activé, le code EAN 13 sera utilisé pour identifier les articles / déclinaisons lors de l'export des lignes des commandes au lieu de la référence PrestaShop.
  • Séparer les articles des packs (oui / non). Si activé, les articles des packs seront séparés en X lignes en fonction des composants lors de l'export des commandes.
  • Séparer les règles de panier (oui / non). Si désactivé, les règles de panier seront regroupées en une seule ligne de remise lors de l'export des commandes.
  • Utilisation des frais de port natifs de Cegid (oui / non). Si activé, les frais de port seront stockés dans le pied du document Cegid (PIEDPORT). Si désactivé, les frais de port seront stockés en tant que ligne article séparée.
  • Livrer automatiquement les commandes exportées (oui / non). Si activé, les commandes exportées seront automatiquement marquées comme livraison client dans Cegid.

Les paramètres « Utiliser le code EAN 13 », « Séparer les articles des packs », « Séparer les règles de panier », « Frais de port natifs » et « Livrer automatiquement » sont disponibles depuis la version 4.0.0 du module.


Paramètres des cartes cadeaux

Disponible depuis la version 4.0.0 du module
L'onglet « Cartes cadeaux » de la page de configuration du module contient le paramètre suivant :
  • Code de paiement des cartes cadeaux. Si renseigné, ce code sera utilisé pour les paiements effectués avec une carte cadeau lors de l'export des commandes. Ce paramètre est compatible avec le module « (WebXY) Cartes cadeaux ».


Identifiants de connexion à la base Cegid

Afin de pouvoir envoyer les commandes PrestaShop dans Cegid, il est nécessaire de remplir les champs suivants :
  • URL racine des services web CEGID. Il s'agit de votre point d'entrée vers l’application Cegid Retail (sans le port), habituellement affiché au sein de la barre de titre de l'application (ex : https://123456-retail-ondemand.cegid.cloud/Y2/)
  • Login CEGID. Il s'agit de votre login (avec domaine) au sein de l'application CEGID Retail (ex : MON_DOMAINE\LOGIN)
  • Mot de passe CEGID. Il s'agit du mot de passe d'accès à l'application Cegid
Depuis la version 3.0.0 du module, il est possible de paramétrer les accès des base Cegid de test et de production directement depuis la page de configuration du module. Un interrupteur permet de changer le mode d'accès du module vers Cegid (test / production).


Préfixes

Afin de distinguer les nouveaux clients et les commandes web des données déjà présentes dans Cegid, des préfixes de code clients et de commandes sont à mettre en place.
Par défaut, les préfixes de référence interne des commandes (paramètre « Préfixe des commandes ») et des codes clients (paramètre « Préfixe des clients ») sont définis sur WEB.
Ces préfixes ne peuvent dépasser 6 caractères
Ainsi, un client ayant passé commande et qui n'existe pas dans Cegid aura alors un code client commençant par le préfixe paramétré en back-office (défaut WEB). La référence interne de la commande commencera par le préfixe défini en back-office (défaut WEB).


Motif de démarque pour les prix spécifiques PrestaShop

Lorsqu’un article de la commande est remisé, le module utilise un motif de démarque spécifique pour les remises web.
Les motifs de démarque se trouvent au sein du menu « Paramètres » > « Front-office » puis « Motif de démarque » dans Cegid.


Lorsque le motif de démarque a été créé dans Cegid, il faut copier son code (champ « Motif de démarque » sur la capture ci-dessus) et le renseigner au sein du paramètre Code de démarque CEGID par défaut du module PrestaShop.

Depuis la version 1.10.0 du module PrestaShop, Il est possible d’exporter les remises CEGID dans un flux séparé. Les codes de démarque remontés dans Cegid lors de l’import des commandes seront donc automatiquement synchronisés en fonction des remises appliquées dans PrestaShop.
Le paramètre Code de démarque CEGID par défaut sera utilisé uniquement pour les remises créées directement dans PrestaShop.


Des articles pour stocker les articles divers, frais de port, emballages et remises panier

Comme indiqué précédemment dans la rubrique Prérequis Cegid, 4 articles doivent être créés dans Cegid pour stocker :
  • les articles divers
  • les frais de port
  • les emballages cadeaux payants
  • les remises panier

Ces articles doivent être non tenus en stock

Lorsque l’article divers a été créé, il faut copier son code (champ « Code article ») et le renseigner au sein du paramètre « Code du produit divers dans CEGID » du module PrestaShop.

Lorsque l’article de frais de port a été créé, il faut copier son code (champ « Code article ») et le renseigner au sein du paramètre « Code du produit des frais de port dans CEGID » du module PrestaShop.

Lorsque l’article des emballages cadeaux a été créé, il faut copier son code (champ « Code article ») et le renseigner au sein du paramètre « Code du produit emballages cadeaux dans CEGID » du module PrestaShop.

Lorsque l’article des remises web a été créé, il faut copier son code (champ « Code article ») et le renseigner au sein du paramètre « Code du produit remises dans CEGID » du module PrestaShop.


Export des articles

Deux paramètres sont disponibles pour les exports des commandes :
  • Code de l'établissement e-commerce. Les commandes exportés depuis PrestaShop seront associé à cet établissement Cegid
  • Code du dépôt central (OPTIONNEL). Les commandes exportés depuis PrestaShop seront associé à ce dépôt de livraison

Depuis la version 4.0.0 du module, un paramètre supplémentaire est disponible : Code de l'établissement e-commerce pour les retours. Si ce paramètre n'est pas renseigné, le code principal d'établissement e-commerce sera utilisé pour les retours de commandes.


Chemins et noms de fichiers des imports CSV

Il est possible de changer les dossiers d’import des fichiers CSV depuis la page de configuration du module.
Par défaut, le chemin est « /modules/xyconnectcegid/streams/ » mais il est possible de séparer les flux par dossier (voir l'exemple ci-dessous).


Les paramètres de préfixes des noms de fichiers CSV permettent de restreindre les fichiers CSV importés au sein de la boutique PrestaShop.
Par exemple, si le paramètre « Préfixe du nom de fichier des produits » est défini sur products_, seuls les fichiers dont le nom commence par products_ seront importés dans PrestaShop.

Lorsqu’un fichier CSV est importé dans PrestaShop, celui-ci est déplacé au sein du dossier /modules/xyconnectcegid/streams/archives/YYYY-MM-JJ/. Il est également renommé pour éviter tout accès à distance direct.


Découpage des fichiers CSV volumineux

Disponible depuis la version 3.0.0 du module
Pour les fichiers CSV très volumineux, un script csvsplitter est disponible pour découper automatiquement les fichiers CSV en attente d'import en plusieurs fichiers plus petits de 2000 lignes maximum. Cela permet d'éviter les dépassements de mémoire ou de temps d'exécution lors de l'import.
L'URL d'accès au script est :
  •  http://mondomaine.fr/module/xyconnectcegid/csvsplitter?xytoken=mon_token 
Il est recommandé d'appeler ce script avant le script d'import si vos fichiers CSV sont susceptibles de contenir un grand nombre de lignes.


Association des données entre Cegid et PrestaShop

PrestaShop et Cegid étant deux environnements différents, des associations manuelles doivent être effectuées avant de pouvoir lancer les synchronisations de commandes.
Ces associations concernent les éléments suivants :
  • Titres de civilité
  • Moyens de paiement
  • Pays
  • Taxes
  • Transporteurs
  • Groupes clients


Titres de civilité

Dans Cegid, la gestion des titres de civilité se trouve au sein du menu « Paramètres » > « Clients » puis « Civilité ». Dans PrestaShop, ce paramétrage se trouve au sein du menu « Paramètres de la boutique » > « Clients » puis « Titres de civilité ».

La gestion des associations de code se trouve au sein du back-office de la boutique PrestaShop, au sein du menu « Xy Connect – associations » > « Titres de civilité ». Cliquer sur le bouton + permet d’ajouter une nouvelle association.



Modes de paiement

Dans Cegid, la gestion des modes de paiement se trouve au sein du menu « Paramètres » > « Gestion » puis « Modes de paiement ». Dans PrestaShop, il s’agit de tous les modules de paiements.
Les associations de modes de paiement se font également en fonction de la devise utilisée lors du paiement de la commande. C’est-à-dire qu’il est possible d’affecter un module de paiement PrestaShop à plusieurs modes de paiement dans Cegid en fonction de la devise.

La gestion des associations de code se trouve au sein du back-office de la boutique PrestaShop, au sein du menu « Xy Connect – associations » > « Paiements ». Cliquer sur le bouton + permet d’ajouter une nouvelle association.


Depuis la version 1.14.0 du connecteur, il est possible d’affecter des paiements customisés à des moyens de paiement Cegid.
Cela vous permet par exemple d’affecter des commandes importées depuis des marketplaces de type Amazon, Cdiscount etc. via un seul module, vers plusieurs modes de paiement dans Cegid (exemples encadrés en bleu dans la capture d'écran ci-dessus).

Pays

Dans Cegid, la gestion des pays se trouve au sein du menu « Paramètres » > « Généralités » > « Pays ». Dans PrestaShop, l’association code pays CEGID / code ISO PrestaShop se fait au sein du menu « Xy Connect – associations » > « Pays ». Cliquer sur le bouton + permet d’ajouter une nouvelle association.

Ce paramétrage permet d’identifier le pays lors de la création des adresses clients dans CEGID lors de la création des clients et la remontée des commandes.
Attention ! Vous devez vérifier les associations pour chaque pays desservi par vos transporteurs.


Codes de taxe

Depuis le flux d’import d’articles dans PrestaShop, vous pouvez indiquer la TVA Cegid utilisée (ex : normale, réduite…) pour chaque produit afin de les associer aux différentes règles de taxes PrestaShop.
Pour cela, il est nécessaire d’utiliser le menu d’association des taxes qui se trouve dans le back-office, menu « Xy Connect – associations » > « Taxes ».
Cliquer sur le bouton + permet d’ajouter une nouvelle association.


https://slite.com/api/files/f0JSWqHdA0fLc4/EUxdzrLsR5goiM-a4q9TlSgDItK5w-image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiVXJhdEtXRTVCWmpPY1giLCJpYXQiOjE3NzYwNTYxODgsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiQ3VTLUpsSVY0Rk5MM0wiLCJleHAiOjE3Nzg2NDgxODh9.-P66E8-J4JS64n6guT8J7cj-Zp89auBYPZhDZxXPM0s

Si aucun code de TVA n’est précisé lors de l’import des articles, une règle de taxe sera choisie selon le pays par défaut de la boutique. Cette association sera alors effectuée uniquement pour les nouveaux produits.


Transporteurs

Disponible depuis la version 3.0.0 du module
Lors de l'export de commandes de PrestaShop vers Cegid, un code transporteur est utilisé pour la synchronisation du transporteur utilisé. L'association entre un code et un transporteur se configure au niveau du menu d’association des transporteurs qui se trouve dans le back-office, menu « Xy Connect – associations » > « Transporteurs ».

Attention, le champ utilisé pour la synchronisation des transporteurs n'est uniquement présent au sein du module Cegid Omnichannel. Ainsi, si l'option "Importer les tickets" est activée, le code transporteur ne sera pas exporté.

Cliquer sur le bouton + permet d’ajouter une nouvelle association.


Groupes clients

Disponible depuis la version 3.0.0 du module
Lors de l'import / export de clients, un code de groupe client est utilisé pour la synchronisation du groupe par défaut associé aux différents clients. L'association entre un code et un groupe client se configure au niveau du menu d’association des groupes qui se trouve dans le back-office, menu « Xy Connect – associations » > « Groupes ».



Flux d'échanges de données

Ces échanges se font à l’aide des scripts import.php (pour les traitements de données importés depuis Cegid) et export.php (pour les envois de données de PrestaShop vers Cegid).
Depuis la version 3.0.0 du module, un nouveau script rfe.php est utilisé pour télécharger les fichiers déposés dans Cegid RFE. Ainsi, il est possible de traiter les fichiers déposés dans Cegid RFE en lançant le script rfe.php pour télécharger les fichiers plats puis import.php pour les traiter.

Ces fichiers se trouvent à l’intérieur du dossier /controllers/front/ et sont accessibles par défaut aux URL :
  •  http://mondomaine.fr/module/xyconnectcegid/import?xytoken=mon_token 
  •  http://mondomaine.fr/module/xyconnectcegid/export?xytoken=mon_token 
  •  http://mondomaine.fr/module/xyconnectcegid/rfe?xytoken=mon_token&type=import 
La valeur du token de sécurité est générée de façon aléatoire et automatique à l’installation du module et est disponible au sein de la page de configuration du module

Chaque flux de données est disponible au sein de 2 fichiers de configuration au format JSON.
Un fichier import.json regroupe tous les flux de données du sens Cegid vers PrestaShop. Un fichier export.json regroupe les flux de données du sens PrestaShop vers Cegid.
Ces 2 fichiers sont propres à chaque boutique et sont disponibles au sein du dossier « /config/ID_SHOP/ » du module où ID_SHOP correspond à l’identifiant de la boutique PrestaShop.
Par principe, il ne faut pas effectuer de suppression physique au niveau de la base de données Cegid, il est préférable de procéder à des suppressions logiques (fermeture d’article / de client / etc)


Import des clients dans PrestaShop

Title
Title
Fichier de configuration
import.json
Nom du flux
customer
Type d'échange
CSV
Par défaut voici comment le connecteur importe les données CSV relatives aux clients
Clé JSON
Nom de la donnée
Numéro de colonne
Remarque
code_erp
Code client
1
Identifiant unique du client
customer_email
Email
2
lastname
Nom de famille
3
firstname
Prénom de famille
4
closed
Fermé
5
Client actif ou inactif
title_id
Titre de civilité
6
Code du titre de civilité du client
siret
Code SIRET
7
ape
Code APE
7
birthday_year
Année de naissance
9
Sur 4 caractères (ex: 1991)
birthday_month
Mois de naissance
10
Sur 2 caractères (ex: 09)
birthday_day
Jour de naissance
11
Sur 2 caractères (ex: 01)
optin_email
Optin & Inscrition à la newsletter
12
Voir ci-dessous pour explication
last_modification_date
Date de modification du client
13
Utilisé pour savoir quelle adresse e-mail est la plus récente entre Cegid et PrestaShop
default_group
Groupe client par défaut
14
Code du groupe client
Gestion de l'inscription à la newsletter & partage des données avec les partenaires
La synchronisation de ces 2 données dépend de la valeur du champ optin_email.
1. Inscription à la newsletter
Si la valeur du champ correspond à BrandOnly, UsableByBrand ou ForPartners, alors le client est inscrit à la newsletter
2. Partage des données avec les partenaires
Si la valeur du champ correspond à ForPartners, alors le client autorise le partage de ses données avec les partenaires


Import des articles dans PrestaShop

Title
Title
Fichier de configuration
import.json
Nom du flux
product
Type d'échange
CSV
Seuls les articles unitaires et dimensionnés sont transmis de Cegid vers PrestaShop. Les articles génériques ne sont pas synchronisés. A l’import dans PrestaShop, si un article est « inactif » (c-à-d fermé ou Invisible e-commerce) et qu’il n’existe pas dans la base de données PrestaShop, alors celui-ci est ignoré.

Le champ « Code article » de Cegid alimente le champ « Référence » de PrestaShop. Attention, le champ « Référence » de PrestaShop ne contenant que 32 caractères, l’utilisation de la cinquième dimension des articles dimensionnés CBR est incompatible avec le bon fonctionnement du module.
Un article décliné ne peut donc pas avoir plus de 4 groupes d'attributs en même temps.

Par défaut, le connecteur se base sur le champ Code article de Cegid en tant que clé unique pour la synchronisation des articles et déclinaisons.
Il est donc impératif que chaque article, chaque déclinaison possèdent leur propre référence.

Il est possible de se baser sur un autre champ en tant que clé unique de synchronisation des articles / déclinaisons (ex : code EAN 13).
Pour cela, vous devrez modifier le fichier import.json et affecter le champ object_key: true à la colonne en question.
N'oubliez pas de remplacer également la clé reference_parent qui contient le champ parent_ref qui fait référence à la clé unique de l'article parent (pour les articles déclinés).
Voici ci-dessous un exemple d'un connecteur utilisant le code EAN en tant que clé primaire.

{
    "product": {
        "class": "\\Product",
        "enabled": true,
        "type": "local",
        "fileExtension": "csv",
        "data": {
          "ean13": {
            "index": 0,
            "object_key": true
          },
          "ean13_parent": {
            "index": 1,
            "parent_ref": true
          },
          [...]
    }
}
Le type de poids synchronisé (brut, net ou douanier) est laissé libre à l'e-commerçant. Cependant, le poids doit toujours être synchronisé dans la même unité pour tous les produits (« g », « kg » etc.).

Dans PrestaShop, seul le prix HT est stocké dans la base de données PrestaShop.
Depuis la version 1.6.0 du module PrestaShop, il est possible d’exporter les prix TTC depuis CEGID via le paramètre « Prix des produits exportés sans taxes depuis CEGID ». Le connecteur recalculera alors le prix HT des produits et des déclinaisons en fonction des codes de taxe CEGID des produits ou du pays par défaut de la boutique PrestaShop.

Il est à noter qu’il est fortement déconseillé d’exporter les tarifs des produits en TTC afin d’éviter au maximum les écarts d’arrondis.

Pour les articles dimensionnés, une colonne est prévue pour contenir la clé unique (par défaut le code article) du produit parent. Le module crée des attributs et des valeurs d’attributs en fonction des dimensions et des éléments de dimensions Cegid.
Chaque dimension (groupe d'attribut dans PrestaShop) possède sa propre colonne. Pour ajouter une nouvelle colonne, vous devez ajouter une nouvelle clé dans le fichier import.json

Exemple de paramétrage d'import du groupe d'attribut Couleur
"couleur": {
  "index": i,
  "is_attribute": true, // Obligatoire pour déclarer une colonne en tant que groupe d'attribut
  "public_name": "Couleur" // Nom du groupe d'attribut, affiché en front et back-office
}

Pour les articles possédant des caractéristiques, il est possible de rajouter des colonnes dans le fichier import.json. Pour ajouter une nouvelle caractéristique, vous devez ajouter le code suivant :
"matiere": {
  "index": i,
  "is_feature": true, // Obligatoire pour déclarer une colonne en tant que caractéristique
  "public_name": "Matière" // Nom de la caractéristique, affiché en front et back-office
}

Depuis la version 1.16.0 du module, le connecteur permet d'associer les articles aux fabricants. Pour cela, vous devez ajouter une colonne selon le format suivant :
"manufacturer": {
  "index": i,
  "is_manufacturer": true // Obligatoire pour déclarer une colonne en tant que fabricant
}

Depuis la version 1.6.0 du module, le connecteur permet d'associer les articles à une arborescence de catégorie. Pour cela, vous devez ajouter une colonne ou plusieurs colonnes pour chaque profondeur de catégorie selon le format suivant :
"category1": {
  "index": i,
  "is_category": true, // Obligatoire pour déclarer une colonne en tant que catégorie
  "category_depth": 0 // Profondeur de catégorie
},
"category2": {
  "index": j,
  "is_category": true,
  "category_depth": 1
},
"category3": {
  "index": k,
  "is_category": true,
  "category_depth": 2
},
"category4": {
  "index": l,
  "is_category": true,
  "category_depth": 3
}

Pour les boutiques multilingues, le connecteur permet d'associer des colonnes à une certaine langue d'un champ.
Par exemple, vous pouvez associer une colonne au libellé anglais des articles.
"nameEN": {
  "index": i,
  "lang": true, // Indique que le champ est multilingue
  "iso": "EN", // Indique dans quelle langue doit être insérée la donnée
  "ps_field": "name" // Indique dans quel champ PrestaShop la donnée doit être insérée
}

Le connecteur ne permet pas l'association d'images aux articles.Pour une association en masse d'images à votre catalogue, nous vous conseillons l'utilisation de notre module d'import d'images .


Le connecteur ne permet pas l'association de documents joints aux articles. Pour une association en masse de documents PDF à votre catalogue, nous vous conseillons l'utilisation de notre module d'import PDF .


Par défaut voici comment le connecteur importe les données CSV relatives aux articles
Clé JSON
Nom de la donnée
Numéro de colonne
Remarque
reference
Référence de l'article ou de la déclinaison
1
reference_parent
Référence de l'article parent
2
Si l'article est un article unitaire (sans déclinaisons), laissez cette colonne vide.
Si l'article est une déclinaison, mettez la référence de l'article générique dans cette colonne
ean13
Code EAN13
3
name
Libellé de l'article
4
Libellé dans la langue par défaut de la boutique
active
Actif
5
Article actif ou inactif. Si l'article est inactif et qu'il n'existe pas dans PrestaShop, il sera alors ignoré
wholesale_price
Prix d'achat
6
Prix d'achat HT de l'article
price
Prix de vente
7
Prix de vente (HT ou TTC selon paramétrage) publique de l'article ou de la déclinaison
tax_code
Règle de taxe
8
Code de taxe Cegid appliqué à l'article.
Attention ! Bien penser à paramétrer les associations des codes de taxes
weight
Poids
9
Le type de poids synchronisé (brut, net ou douanier) est laissé libre à l’utilisateur.
description
Description longue
10
stocks
Stock
11
Stock disponible à la vente
available_date
Date de disponibilité
12
manufacturer
Fabricant
13


Import des packs dans PrestaShop

Title
Title
Fichier de configuration
import.json
Nom du flux
pack
Type d'échange
CSV
Disponible depuis la version 3.0.0 du module
Ce flux permet de convertir des articles existants en packs dans PrestaShop. Les articles doivent donc avoir été préalablement importés via le flux d'import des articles.
Chaque ligne du fichier CSV représente un composant d'un pack.
Depuis la version 4.1.0 du module, il est possible de spécifier la quantité de chaque composant directement dans le fichier CSV.

Exemple simplifié :
PACK001;3701234560001;Pack été;false;PROD001;2
PACK001;3701234560001;Pack été;false;PROD002;5
PACK002;3701234560003;Pack sport;false;PROD008;2
Dans l'exemple ci-dessus, le PACK001 contiendra 2 unités de PROD001 et 5 unités de PROD002. Pour le PACK002, il contient 2 unités de PROD008

Clé JSON
Nom de la donnée
Numéro de colonne
Obligatoire ?
Remarque
reference
Référence du pack
1
Oui
Doit correspondre à la référence d'un article existant dans PrestaShop
ean13
Code EAN13
2
Non
name
Libellé du pack
3
Oui
ferme
Fermé
4
Non
Si l'article est fermé dans Cegid, il sera désactivé dans PrestaShop
composant
Référence du composant
5
Oui
Référence du composant
composant_quantity
Quantité de composant
6
Non
Quantité de composant vendue (si vide, le composant sera vendu en 1 unité)


Import des établissements dans PrestaShop

Title
Title
Fichier de configuration
import.json
Nom du flux
store
Type d'échange
CSV
Les établissements importés via ce flux sont intégrés en tant que boutique dans PrestaShop. Cela aura donc un impact sur la liste des boutiques affichées sur la page « Nos magasins » en front-office.

Par défaut voici comment le connecteur importe les données CSV relatives aux établissements
Clé JSON
Nom de la donnée
Numéro de colonne
Obligatoire ?
Remarque
erp_code
Code Cegid de l'établissement
1
Oui
name
Nom de l'établissement
2
Oui
address1
Adresse 1
3
Oui
address2
Adresse 2
4
Non
Utilisé en tant que 2ème ligne d'adresse
postcode
Code postal
5
Non
city
Ville
6
Oui
country
Pays
7
Oui
Code pays associé à l'établissement
Attention ! Bien penser à paramétrer les associations des pays
state
Etat
8
Non
Code ISO de l'état associé à l'établissement
phone
Numéro de téléphone
9
Non
email
Adresse e-mail
10
Non
latitude
Latitude
11
Non
longitude
Longitude
12
Non
active
Actif
13
Oui
monday_hours
Horaires lundi
14
Non
tuesday_hours
Horaires mardi
15
Non
wednesday_hours
Horaires mercredi
16
Non
thursday_hours
Horaires jeudi
17
Non
friday_hours
Horaires vendredi
18
Non
saturday_hours
Horaires samedi
19
Non
sunday_hours
Horaires dimanche
20
Non


Import des stocks dans PrestaShop

Title
Title
Fichier de configuration
import.json
Nom du flux
stock
Type d'échange
CSV

Par défaut voici comment le connecteur importe les données CSV relatives aux stocks
Clé JSON
Nom de la donnée
Numéro de colonne
Obligatoire ?
Remarque
reference
Référence de l'article ou de la déclinaison
1
Oui
quantity
Stock
2
Oui
Stock disponible à la vente


Import des remises articles dans PrestaShop

Title
Title
Fichier de configuration
import.json
Nom du flux
specificprice
Type d'échange
CSV
Depuis la version 1.10.0 du module, il est possible de définir si les prix des remises importés depuis Cegid sont en HT ou TTC.
Le paramètre « Écraser les prix spécifiques existants ? » du back-office permet d’indiquer si l’on souhaite écraser un prix spécifique créé manuellement dans PrestaShop si celui-ci entre en conflit avec une remise Cegid (même client, plage de dates etc.).
Le paramètre « Recalculer le pourcentage des remises ? » du back-office permet d’exporter les remises dont seul le nouveau tarif article est exporté.

Par exemple, un article A ayant comme prix de base 100 € voit son prix baissé à 80 €. Lorsque cette option est activée, le module va automatiquement calculer le pourcentage de réduction appliqué afin de l’afficher en front-office dans PrestaShop (listes et fiches produits).

Depuis la version 3.0.0 du module, le flux de remises supporte l'association à des groupes clients. Lorsqu'un e-mail client est renseigné et que ce client appartient à un groupe ayant un code ERP associé, la remise sera également liée au groupe client correspondant.

Par défaut voici comment le connecteur importe les données CSV relatives aux remises
Clé JSON
Nom de la donnée
Numéro de colonne
Obligatoire ?
Remarque
reference
Référence de l'article ou de la déclinaison remisé
1
Oui
erp_code
Code du motif de démarque
2
Oui
iso_code
Code ISO 3 du pays concerné par la remise
3
Non
Laisser vide pour ne pas appliquer la remise à un pays donné
currency
Code ISO de la devise
4
Non
Laisser vide pour ne pas appliquer la remise à une devise donnée
group
Code ERP du groupe client bénéficiant de la remise
5
Non
Laisser vide pour ne pas appliquer la remise à un groupe donné
email
E-mail du client bénéficiant de la remise
6
Non
Laisser vide pour ne pas appliquer la remise à un client particulier
price
Nouveau prix de l'article ou de la déclinaison
7
Non
reduction
Montant ou pourcentage de réduction
8
Non
type
Type de réduction
9
Oui
Pour une remise en pourcentage, renseignez une des valeurs suivantes :
percent, pourcentage, pourcent ou %
Pour une remise en montant, renseignez une des valeurs suivantes :
montant, € ou $
reduction_tax
Remise HT ou TTC
10
Oui
0 = Remise HT
1 = Remise TTC
A noter : ce paramètre ne concerne que les remises en montant
from_quantity
Remise à appliquer à partir de X quantité
11
Non
from
Date de début de la remise
12
Non
to
Date de fin de la remise
13
Non


Import des commandes magasins

Title
Title
Fichier de configuration
import.json
Nom du flux
storeOrder
Type d'échange
CSV
Aucun paramétrage n'est disponible pour ce flux.
Lors de l'installation du module, celui-ci créé un nouveau statut de commande Commande magasin. Toute commande Cegid importée dans PrestaShop utilise ce statut de commande.

Les commandes magasins importées dans PrestaShop utilisent l'adresse du magasin en tant qu'adresse de livraison. Dans PrestaShop, l'adresse du magasin se trouve au niveau du menu "Paramètres de la boutique" > "Contact", au niveau de la rubrique "Coordonnées" de l'onglet "Magasins"

Depuis la version 4.0.0 du module, le flux gère également les retours effectués en magasin. Une commande est considérée comme un retour si la quantité des lignes est négative. Lors de l'installation du module, un statut de commande Retour magasin est automatiquement créé pour ces retours.

Dans ce flux, chaque ligne correspond à un article d'une commande. Ainsi, pour une commande de 3 articles, le fichier CSV devra contenir 3 lignes distinctes.
Exemple simplifié d'un fichier CSV d'une commande magasin :
REFERENCE_INTERNE_COMMANDE;REFERENCE_ARTICLE;PRIX_UNIT;QTE
commande_1;demo_1;12.90;2
commande_1;demo_2;5.99;1
commande_1;demo_3;10;2
...

Clé JSON
Nom de la donnée
Numéro de colonne
Remarque
order_internal_reference
Référence interne de la commande
1
order_external_reference
Référence externe de la commande
2
Référence de la commande dans PrestaShop. Si vide, une référence aléatoire est automatiquement générée.
customer_erp_code
Code client dans Cegid
3
order_date
Date de la commande
4
invoice_address_alias
Alias de l'adresse
5
Adresse de facturation
invoice_address_address_1
Ligne 1 de l'adresse
6
Adresse de facturation
invoice_address_address_2
Ligne 2 de l'adresse
7
Adresse de facturation
invoice_address_postcode
Code postal de l'adresse
8
Adresse de facturation
invoice_address_city
Ville de l'adresse
9
Adresse de facturation
invoice_address_country
Code du pays de l'adresse
10
Adresse de facturation
reference
Référence du produit
11
product_name
Nom du produit
12
qty
Quantité commandée
13
unit_price_tax_excl
Prix unitaire (HT)
14
unit_price_tax_incl
Prix unitaire (TTC)
15
discount_amount
Montant de remise
16
total_tax_excl
Montant total (HT)
17
total_tax_incl
Montant total (TTC)
18


Import des statuts des commandes dans PrestaShop

Title
Title
Fichier de configuration
import.json
Nom du flux
orderstatus
Type d'échange
Webservice
Aucun paramétrage n'est disponible pour ce flux.

Lors de l'import des statuts des commandes, le module vérifie les éléments suivants dans l’ordre :
  • La commande est-elle annulée ? Si oui, la commande PrestaShop passe au statut « annulé »
  • La commande est-elle reçue par le client ? Si oui, la commande PrestaShop passe au statut « livré »
  • L’envoi de la commande est-il en cours ? Si oui, la commande PrestaShop passe au statut « expédié »
  • La commande est-elle validée ? Si oui, la commande passe au statut « En cours de préparation »
Vérification
Donnée analysée du Webservice
Nom du champ CEGID
Etat PrestaShop
Commande annulée
CancelStatus
PIECE.GP_STATUTANNUL
Annulé
Commande reçue
FollowUpStatus = RecievedByCustomer
MPIECEECO.MEJ_CDEECOMSUIVI
Livré
Expédition en cours
ShippingStatus = InProgress ou Totally
MPIECEECO.MEJ_CDEECOMEXPED
Expédié
Validée
FollowUpStatus
MPIECEECO.MEJ_CDEECOMSUIVI
Préparation en cours


Import des statuts des retours

Title
Title
Fichier de configuration
import.json
Nom du flux
orderReturnStatus
Type d'échange
Webservice
Aucun paramétrage n'est disponible pour ce flux
L'état de retour est conditionné selon la valeur du champ Cegid MPIECEECO.MEJ_CDEECOMRETOUR :
Vérification
Donnée analysée du Webservice
Etat PrestaShop
Retour accepté ?
ReturnAccepted
Retour validé
Retour validé ?
ReturnValidated
Retour validé
Retour refusé ?
ReturnRefused
Retour refusé
Retourné ?
Returned
Retourné
Depuis la version 4.0.0 du module, le statut Cegid ReturnAccepted (Retour accepté) est également supporté et déclenche le statut « Retour validé » dans PrestaShop.


Export des clients de PrestaShop vers Cegid

Title
Title
Fichier de configuration
export.json
Nom du flux
customer
Type d'échange
Webservice
Ce flux permet l'export des prospects de la boutique PrestaShop vers Cegid.
Un prospect est un compte qui n'a pas encore passé commande et qui n'a jamais été intégré dans Cegid.

Par défaut, ce flux est désactivé afin de limiter le nombre de requêtes entre PrestaShop et Cegid.
Il est recommandé de laisser ce flux désactivé sauf dans les cas suivants :
- le nombre de compte client PrestaShop est relativement faible (environ 500 comptes)
- si vous souhaitez intégrer tous les comptes clients dans Cegid même s'ils n'ont pas encore passé de commande

A noter, les clients sont automatiquement exportés lors de l'export des commandes

Depuis la version 4.2.0 du module, les champs suivants sont également exportés vers Cegid lors de l'export des clients :
Champ PrestaShop
Champ Cegid
Remarque
N° TVA
TIERS.T_NIF
(Identifiant NIF / n°TVA)
Code APE
TIERS.T_APE
(Division commerciale du client)
Numéro de SIRET
TIERS.SIRET
Client actif
TIERS.T_FERME
Un client désactivé dans PrestaShop sera fermé dans Cegid
Adresse principale
Adresse du client
Synchronisation de l'adresse principale du client (Disponible depuis la version 4.2.0)

Depuis la version 4.2.0 du module, la valeur du champ indiquant si le client est une société (TIERS.T_PARTICULIER) dépend de la présence d'un numéro de Siret au niveau du client PrestaShop.


Export des commandes de PrestaShop vers Cegid

Title
Title
Fichier de configuration
export.json
Nom du flux
order
Type d'échange
Webservice
Lors de l'export des commandes, la fiche client est mise à jour dans CEGID selon les règles suivantes :
    Si le code Client Cegid transmis par PrestaShop est renseigné, alors le client est modifié dans Cegid en fonction de la fiche client PrestaShop.
    Si le code Client ERP transmis par PrestaShop est vide et s’il existe un client dans CEGID possédant la même adresse e-mail PrestaShop, alors le client est modifié.
    Si le code Client ERP est vide et s’il n’existe pas de client dans CEGID correspondant à l'adresse e-mail du compte PrestaShop, alors le client est créé dans CEGID.

Le code Client ERP est déterminé par rapport à l’identifiant client WEB auquel on applique le préfixe paramétré.
L’identifiant client est toujours d’une longueur de 10 caractères.
Exemples :
  • Code Client Web = 1563 ; Préfixe = « WEB »  à Code Client ERP = WEB0000001563
  • Code Client Web = 12 ; Préfixe = « W » à Code Client ERP = W0000000012

Le champ « Référence interne » GP_REFINTERNE est composé d’un préfixe paramétrable suivi du numéro de commande PrestaShop.
Le champ « Référence externe » GP_REFEXTERNE est alimenté depuis le champ « Référence » de PrestaShop. Il s’agit d’une référence unique de la commande sur le site e-commerce.

Depuis la version 4.0.0 du module, les données supplémentaires suivantes sont exportées avec les commandes :
  • Numéro de transaction (PIEDECHE.GPE_CBNUMTRANSAC) : le numéro de transaction du paiement est exporté
  • Transporteur (MPIECEECO.MEJ_TRANSPORT) : le code du transporteur utilisé est exporté (nécessite l'association des transporteurs)
  • Code du point relais : si le client a sélectionné un point relais, le code est exporté dans l'adresse de livraison (PIECEADRESSE.GPA_ADRESSE3). Les modules colissimo et unifiedco sont supportés.

Les commandes contenant uniquement des articles virtuels (sans transporteur physique) sont également supportées.

Depuis la version 4.0.0 du module les notions de Numéro ERP & Souche ERP sont enregistrées en base de données et consultables au niveau du menu « Xy Connect – associations » > « Commandes »

Depuis la version 4.2.0 du module, la valeur du champ indiquant si le document est facturé en HT (PIECE.GP_FACTUREHT) dépend du fait que le montant TTC payé par le client corresponde ou non au montant HT de la commande.


Gestion des cartes cadeaux

Disponible depuis la version 3.1.0 du module
Lorsque le module « (WebXY) Cartes cadeaux » est installé et qu'une commande contient un paiement par carte cadeau, un règlement supplémentaire est automatiquement généré lors de l'export de la commande. Le code de paiement utilisé pour la carte cadeau est paramétrable au niveau de l'onglet « Cartes cadeaux » de la page de configuration du module.


Export des statuts de commande PrestaShop (Documents Cegid)

Disponible depuis la version 4.0.0 du module
Les documents Cegid liés aux commandes PrestaShop (Préparation de livraison, Livraison client, etc.) sont affichés directement sur la page de détail de chaque commande dans le back-office PrestaShop. Disponible uniquement si le flux d'export des statuts des commandes PrestaShop est activé (flux désactivé par défaut).


La liste de tous les documents liés aux commandes PrestaShop est également disponible dans un menu dédié : « Xy Connect – associations » > « Documents ».



Export des retours

Title
Title
Fichier de configuration
export.json
Nom du flux
return
Type d'échange
Webservice
Seuls les retours dont l'état est "En attente de confirmation" (ID #1) sont exportés vers Cegid.
Un document de type "Annonce de retour" (ReturnNotice) est alors créé dans Cegid.
Ce document est associé à l'établissement e-commerce et au dépôt paramétrés au niveau de la page de configuration du module.

Depuis la version 4.0.0 du module, les données supplémentaires suivantes sont exportées avec les retours :
  • Code de l'établissement : l'établissement associé au retour (utilise le code de l'établissement pour les retours si paramétré, sinon le code d'établissement principal)
  • Code du moyen de paiement : le moyen de paiement associé au retour
  • Document d'origine : la commande d'origine est associée au retour dans Cegid
  • Montant total des produits retournés : exporté en tant que paiement


Export des statuts de commandes

Title
Title
Fichier de configuration
export.json
Nom du flux
orderstatus
Type d'échange
Webservice
Disponible depuis la version 4.0.0 du module. Ce flux est désactivé par défaut.

Ce flux permet l'export des changements de statuts de commandes vers Cegid. Les statuts PrestaShop suivants déclenchent un export :
Statut PrestaShop
Identifiant
Document Cegid créé
Préparation en cours
PS_OS_PREPARATION
Préparation de livraison
Expédiée
PS_OS_SHIPPING
Livraison client
Pour activer ce flux, changez la propriété enabled à true dans le fichier export.json. WebXY recommande de laisser ce flux désactivé et laisser Cegid gérer le cheminement des commandes et importer leur changement de statut Cegid vers PrestaShop via le flux d'import des statuts des commandes


Journaux de synchronisation (Logs)

La page des journaux de synchronisation permet de consulter l'historique détaillé de toutes les synchronisations effectuées entre PrestaShop et Cegid. Elle est accessible depuis le back-office, via le menu « Xy Connect » > « Logs ».

Tableau de bord

En haut de la page, trois indicateurs synthétiques offrent une vue d'ensemble rapide de l'état des synchronisations sur la période de conservation des logs (paramétrable via le paramètre « Garder les logs pendant X jours » dans l'onglet Global).
Ces indicateurs sont :
  • les avertissements
  • les erreurs bloquantes
  • les succès
Lorsqu'une synchronisation est en cours (détectée si le dernier log date de moins d'une minute), un bandeau d'information « Synchronisation des données en cours » est affiché avant la liste des synchronisations.


Liste des synchronisations

Sous le tableau de bord, un tableau liste toutes les synchronisations enregistrées. Chaque ligne correspond à une exécution d'un flux d'import ou d'export et affiche les informations suivantes :
Colonne
Description
Icône de statut
Indicateur visuel coloré du résultat global de la synchronisation : succès (vert), avertissement (orange), erreur (rouge) ou information (bleu)
ID
Identifiant unique du log
Type de synchro
Import ou Export
Nom du flux
Nom du flux concerné (ex : Produits, Stocks, Commandes etc.)
Temps d'exécution
Durée de la synchronisation en secondes
Code HTTP
Code HTTP retourné par la synchronisation (ex : 200 pour succès, 400 pour erreur côté client, 500 pour erreur serveur)
Date de synchro
Date et heure du début de la synchronisation
Fichier
Lien de téléchargement vers le fichier CSV source archivé (si disponible). Si le fichier d'archive n'existe plus, une icône de lien cassé est affichée

Le tableau est paginé avec 20 entrées par page. Une barre de navigation en bas du tableau permet de parcourir les pages.


Détails d'un log

En cliquant sur une ligne du tableau, les détails de la synchronisation sont chargés dynamiquement. Ces détails sont affichés dans un sous-tableau qui s'ouvre sous la ligne cliquée. Chaque ligne de détail contient :
  • Icône de sévérité : information (bleu), succès (vert), avertissement (orange) ou erreur (rouge)
  • Message : description précise de l'opération effectuée (ex : « Produit XXX créé », « Stock mis à jour pour la déclinaison YYY », « Erreur : référence introuvable »)
  • Code d'erreur : code technique de l'erreur le cas échéant
  • Classe de l'objet : type d'objet PrestaShop concerné (Product, Combination, Customer, Order, etc.)
  • ID de l'objet : identifiant PrestaShop de l'objet concerné
Si le log de détail contient plus de 20 entrées, une pagination dédiée permet de naviguer entre les pages de détails.


https://slite.com/api/files/D6IhHNuq4A-BsK/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiVXJhdEtXRTVCWmpPY1giLCJpYXQiOjE3NzYwNTYxODgsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiQ3VTLUpsSVY0Rk5MM0wiLCJleHAiOjE3Nzg2NDgxODh9.-P66E8-J4JS64n6guT8J7cj-Zp89auBYPZhDZxXPM0s


Filtres de recherche

La page de logs propose deux niveaux de filtrage pour retrouver rapidement les informations souhaitées.

Recherche par objet

Un formulaire de recherche en haut de la liste permet de filtrer les logs par objet PrestaShop :
  • Recherche de produits et déclinaisons : recherche par référence, code EAN13, nom du produit ou identifiant PrestaShop. La recherche couvre à la fois les produits parents et les déclinaisons.
  • Recherche de clients : recherche par adresse e-mail, nom, prénom ou identifiant PrestaShop du client.
  • Recherche de commandes : recherche par référence de commande ou identifiant PrestaShop de la commande.
Lorsqu'une recherche par objet est effectuée, la liste est remplacée par un tableau de résultats affichant directement les détails des logs correspondants (date, message, code d'erreur, classe de l'objet et ID de l'objet). Un bouton « Réinitialiser les filtres » permet de revenir à la vue complète.

Filtres par colonne

Des champs de filtrage sont directement intégrés dans l'en-tête du tableau principal, permettant de filtrer les logs selon les critères suivants :
Filtre
Type de champ
Description
ID
Texte
Recherche par identifiant de log
Type de synchro
Liste déroulante
Filtrer par Import ou Export
Nom du flux
Liste déroulante
Filtrer par flux spécifique (Produits, Stocks, Commandes, etc.)
Code HTTP
Texte
Recherche par code HTTP (ex : 200, 400, 500)
Date de synchro
Sélecteur de date
Filtrer les logs d'une date spécifique
Les listes déroulantes sont automatiquement remplies avec les types de synchronisation et les noms de flux réellement présents dans les logs.
Un bouton de recherche et un bouton de réinitialisation permettent respectivement de lancer la recherche et de supprimer les filtres appliqués.


Purge automatique des logs

Les anciens logs sont automatiquement supprimés à chaque chargement de la page des logs ainsi qu'à chaque import / export. La durée de conservation est définie par le paramètre « Garder les logs pendant X jours » dans l'onglet Global de la page de configuration du module.
Lors de la suppression, les détails des logs associés sont également supprimés.