Guide utilisateur

Connecteur CEGID Retail SaaS / PrestaShop


Version de la documentation : 8 (18/07/2025)


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
  • Mise à jour des fiches clients dans Cegid lors de l'import des commandes
  • Possibilité d'importer des remises articles via un flux CSV dédié et de les associer à des codes de démarque spécifiques
  • 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é
  • 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


Prérequis

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

Prérequis web

  • PrestaShop version 1.7.0 ou supérieure
  • PHP version 7.1 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
import
CSV
3.0.0
Import des clients Cegid dans PrestaShop
Articles
import
CSV
1.0.0
Import des articles et déclinaisons dans PrestaShop
Etablissements
import
CSV
1.0.0
Import des établissements Cegid dans PrestaShop
Stocks
import
CSV
1.1.0
Import des stocks articles et déclinaisons
Remises articles
import
CSV
1.0.0
Import des remises articles sous forme de prix spécifiques dans PrestaShop
Commandes magasins
import
CSV
3.0.0
Import des commandes magasins (Cegid) dans PrestaShop
Statuts des retours
import
CSV
3.0.0
Mise à jour des statuts des retours de commande
Statuts des commandes
import
XML
1.0.0
Mise à jour des statuts des commandes
Clients
export
CSV
3.0.0
Export des nouveaux clients (n'ayant jamais passé commande)
Commandes
export
XML
1.0.0
Export des commandes PrestaShop vers Cegid via les webservices
Retours
export
XML
3.0.0
Export des retours de commande de PrestaShop vers Cegid


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



Paramétrages

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


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.


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 ajouter une association pour chaque pays desservis 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.


 
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 ou 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 é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).

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 2 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
email
E-mail du client bénéficiant de la remise
5
Non
Laisser vide pour ne pas appliquer la remise à un client particulier
price
Nouveau prix de l'article ou de la déclinaison
6
Non
reduction
Montant ou pourcentage de réduction
7
Non
type
Type de réduction
8
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
9
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é
10
Non
from
Date de début de la remise
11
Non
to
Date de fin de la remise
12
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 1.7 / 8, 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"

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 valide ?
ReturnValidated
Retour validé
Retour refusé ?
ReturnRefused
Retour refusé
Retourné ?
Returned
Retourné

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


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.


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.