Transcript Module Cdiscount - C Le Marché Marketplace

Module Cdiscount - C Le Marché Marketplace
Version
3.8
Société
SMC
Auteur
Olivier B. (a.k.a Delete)
Date
13/08/12
Mise à Jour
08/04/14
Plateforme
Prestashop
Licence
Commerciale
Description :
CDiscount Marketplace for Prestashop offre les possibilités avec la place de marché « C
Le Marché » de :
–
–
–
Importer les commandes (Import dans le Backoffice Prestashop)
Créer, Exporter les produits (Fiches Produit Complètes)
Envoyer, mettre à jour les offres (Stocks, Prix)
Ce module a été réalisé afin d'eviter les taches répétitives et fastidieuses de mise à jour
et d'import de commandes dans le back-office prestashop.
Le module fonctionne sur la base de l'architecture client/serveur XML.
Les imports/exports sont réalisés instantanémemt et envoyés à la place de marché par
Web Service (SOAP/XML).
SUPPORT :
Le support est gratuit, et s'effectue par email uniquement :
Email : [email protected]
INSTALLATION
L'installation est aisée :
Dans la partie administration du site :
Aller sur l'onglet Modules et cliquez sur Ajouter un nouveau module :
Cliquez sur Choisissez le fichier cdiscount.zip et cliquez sur le bouton "Charger le
Module"
Attention : Sur certaines installation, l'installation automatique de Prestashop ne fonctionne pas.
Dans ce cas dezippez simplement le fichier cdiscount.zip dans le repertoire module de votre serveur.
Rendez vous à nouveau sur la page Module de votre administration et configurez le
module.
CONFIGURATION GENERALE
Authentification :
- Authentification :
Cdiscount vous fournira un login et mot de passe pour le web service.
Si vous n'avez pas ces informations, contactez le support marketplace pour les obtenir :
[email protected]
Notez bien que ce compte peut être différent de votre accès Back-Office marchand.
- Pré-Production :
Le mode préproduction est destiné à réaliser des tests opérationnels en partenariat avec
Cdiscount et le mode débug éventuellement à envoyer des informations au développeur
en cas de problème.
Le mode préproduction ne fonctionne que si l'adresse IP du serveur est ouverte sur le
serveur de préproduction de Cdiscount.
Pour tout renseignement à ce sujet renseignez vous auprès de votre contact technique
Cdiscount.
Notez que le mode Préproduction ne vous sera pas utile. Il est utilisé pour le
développement.
- Debug
A utiliser en cas de demande du support technique Common-Services pour afficher des
diagnostics complets.
IMPORTS
Section Supprimée.
Auparavant les imports des catégories étaient manuels, dorénavant ils sont
automatique.
Rendez vous simplement dans l'onglet Imports pour vérifier que les fichiers sont à jour,
ils sont réactualisés automatiquement quand vous vous rendez dans la configuration du
module après un délai d'une semaine.
PROFILS
La gestion des profils du module Cdiscount est un adaptateur permettant de répartir des
produits provenant de différentes catégories de votre site Prestashop vers d'autre
catégories sur Cdiscount en convertissant leur format.
Les profils contiennent les spécifications liées aux catégories et les modèles les
spécificités liées aux produits.
Vous pouvez associer plusieurs catégories à un profil.
Configuration des profils :
Voici un exemple de profil :
Nom : Nom du mnémotechnique du profil
Univers : Univers / Catégorie principale sur CDiscount
Catégorie Cdiscount : Catégorie contenue dans le fichier importé
Modèle : Modèle lié à ce profil
Vous devrez créer les modèles pour pouvoir finaliser vos profils.
Formule de Prix :
La formule de prix peut être une valeur, un pourcentage, une formule mathématique.
Le caractère @ remplace le prix de référence. @ + 10% par exemple, ajoutera 10% aux
prix exportés pour cette catégorie.
@ + 5 ajoutera 5 euros au prix exporté.
Frais de Port : Frais de port à ajouter ou déduire des frais de port définis dans la
configuration globale du module.
+5 rajoutera 5 euros de frais de port pour ce profil, -5 enlevera 5 euros de frais de port
pour ce profil.
MODELES
Comme expliqué dans la section profil les modèles sont le prolongement des profils.
Le modèles sont liés au spécificités des produits.
–
–
–
Les champs Genre et Public sont généralement obligatoires.
Les autres champs sont généralement facultatifs.
Les champs obligatoires sont marqués d'une croix rouge.
Vous pouvez mettre une valeur par défaut qui sera exportée pour tous vos produits de ce
modèle ou une caractéristique :
Si vous choisissez une caractéristique, la caractéristique associée à votre article sera
envoyée à Cdiscount. Le mapping est appliqué à la caractéristique pour que vous
puissiez envoyer une valeur reconnue par Cdiscount.
Vérifiez les valeurs valides chez Cdiscount : il faut pour cela consulter leur fichier
d'intégration produits disponible dans le backoffice Cdiscount.
Donc :
- La colonne de gauche contiendra la valeur par défaut.
- La colonne de droite contiendra la caractéristique de la fiche produit
Ne précisez rien pour ne rien exporter.
Pour votre premier export, ne renseignez que le minimum, uniquement les champs
obligatoires afin de minimiser le risque d'erreurs. Vous renseignerez que par la suite ces
champs supplémentaires qui viendront alors enrichir votre flux.
Produits et Déclinaisons
Par défaut, les déclinaisons sont exportées en produits séparés sur Cdiscount.
Par exemple si vous avez un produit, un T-Shirt, avec trois déclinaisons Bleu, Blanc,
Rouge, le module exportera trois produits individuels sur Cdiscount, trois produits
séparés.
Si vous souhaitez bénéficier de la fonctionnalité « Variantes » de Cdiscount, donc
l'équivalent des déclinaisons de Prestashop, vous devrez configurer cela dans l'onglet
modèles comme suit :
La place de marché CDiscount nécessite que :
–
La catégorie doit autoriser les Variantes (donc les déclinaisons), vérifiez ce point
avec votre interlocuteur Cdiscount, sinon cela ne fonctionnera PAS.
–
Inconditionnellement que les deux attributs soient indiqués, Couleur et Taille. Si
vous omettez l'un ou l'autre cela ne fonctionnera PAS.
Si vos produits sont tous d'une seule taille ou couleur, et donc n'ont qu'un seul attribut,
vous pourrez indiquer une valeur « Par Défaut ». Ainsi les deux champs seront
correctement renseignés dans le flux de sortie, exemple :
Exemple d'export de Caractéristiques :
Dans l'onglet caractéristique :
Vous avez une caractéristique « Licence »
Sur la fiche produit, dans l'onglet « caractéristique », la caractéristique définie pour
Licence est « Disney » :
Dans l'export du produit :
La valeur sera « Disney ».
Notez que :
- Si sur la fiche produit rien n'est renseigné la valeur par défaut renseignée dans le
modèle sera exportée
- Si la valeur par défaut n'est pas renseignée le champ ne sera pas envoyé
CATEGORIES
Ici seront sélectionnées les categories à exporter.
Ne seront exportés que les produits contenus dans les catégories sélectionnées.
Pour le mode création de fiches produit chaque catégorie doit avoir un profil
sélectionné.
Même si vous sélectionnez un profil,
n'oubliez pas de cocher les cases des catégories choisies !
TRANSPORT
Temps minimum de livraison * :
Indiquez le temps à partir du moment où le colis est considéré comme expédié.
Temps maximum de livraison * :
Indiquez le temps à partir du moment où le colis est considéré comme livré.
*) Ces valeurs commencent à 0 pour 24h.
Transport :
La configuration minimum du transport est :
Les champs encadrés en rouge sont obligatoires.
Ci-après une description des champs numérotés ;
A & B – Transporteurs Associés :
Indiquez les transporteurs et méthodes de transport associés.
– A sont les transports obligatoires
– B les transports facultatifs
Lors de l'export des offres la grille tarifaire associée à ce transporteur sera utilisée :
– Si la grille par poids est renseignée et qu'une valeur correspond, elle est utilisée
– Si la grille par prix est renseignée et qu'une valeur correspond, elle est utilisée
– Sinon, le prix minimum est exporté (1)
Lors de l'import des commandes depuis Cdiscount ce transporteur sera associé à la
commande. Il s'agit juste d'indiquer ce nom sur la facture.
Dans les colonnes de droite, les valeurs de configuration possibles sont :
1 – Minimum
Prix minimum qui sera exporté quelle que soit la grille de frais de port associée au
transporteur. C'est à dire que si le tarif indiqué dans la grille est de 1 euro, que le
tarif minimum est de 5 euros ce dernier sera exporté.
2 – Additonnel
Pourcentage additionnel des frais de port qui seront appliqués. Si la valeur est 50,
le module ajoutera 50% des frais de port calculés comme frais de port
additionnels, c'est à dire si un deuxième produit identique est ajouté au panier
sur Cdiscount.
3 – Delai Min
Délai minimum avant expédition
4 – Delai Max
Délai maximum d'expédition
COMMANDES
Commandes :
Indiquez les états successif des commandes.
Ces paramètres sont utilisés pour actualiser le statut de votre commande sur Cdiscount.
IMPORTANT :
Les commandes en suivi ou en recommandé doivent donner lieu à la saisie du numéro de
suivi de colis dans votre backoffice Prestashop :
Si le numéro de suivi n'est pas renseigné sur la commande, le statut de la commande ne
pourra pas être actualisé sur Cdiscount car ce champ est obligatoire.
Mode Bulk - Mise à jour en masse des statuts de commandes :
Si vous cochez ce mode, la mise à jour des statuts des commandes ne sera plus envoyé
commande par commande, mais lors de l'execution de la tâche planifiée dont l'URL
apparaitra dans l'onglet idoine.
Le script de mise à jour mettra alors à jour toutes les commandes et numéros de suivi à
son éxecution.
Le paramètrage et l'exécution de ce script ne relève pas de notre responsabilité,
adressez vous à votre webmaster pour la configuration et la vérification du bon
fonctionnement. Sinon, désactivez le bulk mode et utilisez le mode standard.
PARAMETRES
–
–
–
Remises et Promotions : autorise les prix remisés et/ou soldés.
Taxes : Exporte les prix avec les taxes
Autoriser le Hors Stock : Exporter les produits même si hors stock
Mode d'Import/Export :
Exporte la référence du produit ou l'ID du produit. Si vos produits n'ont pas de référence
utilisez le champ ID. Sinon préférez le champ Rérérence.
Dans ce dernier cas le champ SKU de Cdiscount sera associé au champ Reference de
Prestashop.
Etat /Condition :
Permet de faire correspondres les états/conditions Prestashop et Cdiscount, idéal si vous
vendez des produits d'occasion.
Notez que cette fonctionnalité n'est pas disponible pour la version 1.3 de Prestashop.
Commentaire :
Permet l'affichage d'un petit commentaire sur la fiche produit.
Email Client :
Créée ou utilise un compte client individuel lors de l'import des commandes.
Un compte client comportant toutes ses coordonnées sera créé dans votre backoffice
Prestashop.
Attention : Cette fonctionnalité requiert des compétences de configuration de votre
serveur de mails, exemple : configuration d'un sous-domaine avec un serveur Nul-SMTP.
MAPPINGS
Permet de faire correspondre des attributs Prestashop avec leur équivalences sur
Cdiscount.
Indiquez l'attribut Cdiscount correspondant à l'attribut de votre boutique :
Exemple : Boutique XS Cdiscount 36
Cette fonctionnalité est essentiellement utilisée pour les tailles et couleurs.
CATALOGUE
L'onglet Catalogue > Cdiscount donne accès aux fonctionnalités d'export et de mise à
jour des offres et des produits.
Préambule Important :
Il est très important de considérer en premier lieu la différence entre une Offre et un
Produit :
–
Une offre est un ensemble de données agrégeant la référence, la quantité, le prix
… il s'agit donc de votre propre « inventaire », votre stock, vos prix.
–
Un produit est un ensemble de données agrégeant la dénomination de l'article, la
description, les images, les caractéristiques, les images, il s'agit donc de données
qui sont potentiellement mutualisées par tous les marchands.
Le module fonctionne en mode "Matching" (correspondance) pour l'envoi des Offres.
Le mode Création quand à lui est utilie pour la création des produits inexistants sur
CDiscount.
Donc, un produit INEXISTANT sur Cdiscount sera envoyé en mode « Création de Produit ».
Export, Mode Création :
L'export permet de créer des produits qui ne sont pas référencés par Cdiscount :
IMPORTANT :
Notez que les fichiers sont automatiquement envoyés par Web Service à la plateforme
Cdiscount mais que ceux-ci sont ensuite traités manuellement par le service intégration.
Ainsi, il faut à maxima regrouper les opérations d'export. A titre d'exemple ; exporter les
produits à créer un fois par semaine.
Les soumissions consécutives et irrégulières ne feraient que détériorer la qualité du
service attendu.
Mise à jour, Envoi ponctuel des Offres :
Le mode mise à jour envoie vos offres sur Cdiscount en mode « Matching » ;
–
Si une offre est existante pour la référence, l'offre est mise à jour.
–
Si l'offre est inexistante mais que le produit est référencé chez Cdiscount,
une nouvelle offre est créée.
Cette opération est basée sur les codes EANs de vos articles que vous avez
précédemment exportés depuis l'onglet création ou d'autres articles référencés par
CDiscount.
Le module génère un package ZIP complet contenant des fichiers XML dans une structure
de répertoires reconnus par Cdiscount.
Le fichier ZIP est envoyé automatiquement par Web Service à Cdiscount.
NB : Le module va utiliser 2 méthodes possibles pour générer le fichier zip. Si aucune
des deux ne fonctionne il y aura une erreur. A ce moment là veuillez nous contacter.
Produits Soldés :
Pour la période de solde, le module va exporter les offres pour lesquelles la fiche
produit aura un prix spécifique borné par date et la case à cocher « En Solde » cochée.
Exemple :
PREMIÈRE MISE EN LIGNE DES OFFRES
La mise en ligne initiale des offres nécessite d'envoyer une première fois toutes vos offres en
s'assurant qu'il n'y ait pas de conflit avec des offres existantes sur la marketplace.
Nous enverrons donc un "flux" d'offres en mode "Purger et Remplacer" ce qui aura pour effet
d'exporter les offres pour toutes les catégories sélectionnées dans la configuration du module et
de remplacer toutes les offres existantes sur la marketplace.
1) Vérifiez la connectivité :
Rendez vous sur la page de configuration du module, onglet Authentification, vérifiez votre login
et mot de passe et cliquez sur vérifier :
2) Envoyez les offres :
Rendez vous à l'onglet Catalogue > Cdiscount et cochez "Purger et Remplacer" :
Cliquez sur "Envoyer", après quelques instants un message apparaitra indiquant que l'envoi a été
effectué. Vérifiez ensuite dans l'onglet "Vos rapports d'intégration d'offres" dans votre backoffice
C Le Marché.
Pour tout support, envoyez nous le « Rapport d'intégration », l'URL de votre fichier ZIP ou
XML affiché dans l'onglet par le module ou le fichier lui même.
N'hésitez pas à nous contacter pour plus de renseignement.
Le support technique s'effectue par email (uniquement) :
[email protected]
N'hésitez pas à nous faire parvenir vos feed back et améliorations souhaitées.
Limites du Support :
– Est hors de responsabilité le paramètrage lié au quantitatif de la boutique (quantité
produits, images, catégories...)
– Sont exclues les mises à jour de versions de la boutique Prestashop
– Sont exclus le changement de serveur, d'hébergeur ou de version de PHP
– Les modifications du module entrainent une révocation de fait du support
– Il ne sera pas offert de support en cas de mises en service multiples ou de changement
majeur du catalogue
Limites de Garantie :
– Nous pouvons vous communiquer une liste d'hébergeur ou vous pouvez choisir n'importe
quel hébergeur recommandé par Prestashop. Si celui ci n'était pas l'un d'entre eux aucune
garantie de fonctionnement ne saurait être appliquée.
– En cas d'abus, de radiation, de révocation ou de résiliation de contrat par la place de
marché nous ne saurions être tenu pour responsable et aucune garantie ni réparation ne
pourrait être réclamée.
– Le logiciel livré est réputé fonctionnel et en état de fonctionner sur un logiciel
Prestashop installé par défaut. C'est à dire tel que livré d'origine. Si l'un d'eux à été
modifié par quiconque la garantie et le support offerts lui seraient alors transférés de
plein droit.
Information sur la licence :
/* NOTICE OF LICENSE
*
* This source file is subject to a commercial license from SARL SMC
* Use, copy, modification or distribution of this source file without written
* license agreement from the SARL SMC is strictly forbidden.
* In order to obtain a license, please contact us: [email protected]
* ...........................................................................
* INFORMATION SUR LA LICENCE D'UTILISATION
*
* L'utilisation de ce fichier source est soumise a une licence commerciale
* concedee par la societe SMC
* Toute utilisation, reproduction, modification ou distribution du present
* fichier source sans contrat de licence ecrit de la part de la SARL SMC est
* expressement interdite.
* Pour obtenir une licence, veuillez contacter la SARL SMC a l'adresse:
[email protected]
* ...........................................................................
* @package
CDiscount
* @copyright Copyright (c) 2010-2013 S.A.R.L SMC (http://www.common-services.com)
* @author
Olivier B.
* @license
Commercial license
* Support by mail : [email protected]
* Support on form : Olivier B > A.K.A delete
* Skype : delete13_fr
*/
Vous pouvez me demander une tarifications spécifique dans les cas suivants :
– Agence Partenaire Prestashop
– Client Multi-Site
– etc...