Table des matières -1) KWISATZ - :...2-1.1) Introduction :...2-1.2) Description :...3-1.2.1) Schéma :...3-1.3) Mise en place :...4-1.3.1) PRESTASHOP :...4-1.3.1.1) Les Web Services :...4-1.3.2) KWISATZ :...5-1.3.2.1) Configuration de KWISATZ :...5-1.3.2.2) Configuration de WKW_MCOMM :...6-1.3.2.2.1) Web Services :...7-1.3.2.2.2) FTP :...8-1.3.2.2.3) Paramètres :...9-1.3.2.2.4) ID de correspondance entre Kwisatz et la plateforme E-Commerce :...14-1.3.2.2.5) Attribut et Catégorie spéciale:...15-1.3.2.2.6) Langues :...17-1.3.2.2.7) Sauvegarde du log :...17-1.4) Correspondance des données KWISATZ avec PRESTASHOP :...18-1.4.1) ID pour la catégorie racine :...18-1.4.2) ID Pour les codes TVA :...19-1.4.3) ID pour les Catégories :...20-1.4.4) ID pour les langues :...21 Page n 1 / 21
-1) KWISATZ - : -1.1) Introduction : Un module d extension permettant la communication directe et native entre KWISATZ et la plateforme e-commerce PRESTASHOP est maintenant disponible. PRESTASHOP est une plateforme complète de commerce électronique gratuite intégrant la gestion du catalogue des produits, des outils de promotion et de marketing, la gestion des commandes, des paiements, le suivi du transport, ainsi que toutes les fonctions essentielles à la mise en place d un site de commerce en ligne. Depuis sa création, la puissance, l ouverture et la gratuité de cette plateforme ne cessent de séduire, et le nombre de Webmasters «convertis» à PRESTASHOP s accroît de jour en jour. C est pour toutes ces raisons, que nous avons décidé de s interfacer avec PRESTASHOP. L interface est directe et s effectue à l aide des Web Services. Un clic suffit pour déclencher la mise à jour du catalogue produit, du stock disponible, des tarifs appliqués sur le Web. Un clic suffit pour récupérer les commandes passées sur le Web et les nouveaux clients référencés. Un clic suffit pour actualiser le statut des commandes en cours. Ces actions peuvent être déclenchées manuellement ou automatiquement, à intervalles réguliers, au travers du module de communication. Nous allons dans les chapitres suivants, présenter toutes les étapes nécessaires pour la mise en place de ce module. Page n 2 / 21
-1.2) Description : Un programme appelé WKW_MCOMM a été développé pour effectuer l interface entre le logiciel KWISATZ et la plateforme PRESTASHOP. -1.2.1) Schéma : Serveur KWISATZ Le logiciel KWISATZ communique avec le programme WKW_MCOMM_WEB sur le port 6203 Disque Dur du serveur C:\WKW\$WEB WKW_MCOMM_WEB communique avec la plateforme WEB au travers des WEB SERVICES via INTERNET Site de commerce en ligne WKW_MCOMM_WEB INTERNET WEB SERVICES SPECIFIQUE KWISATZ KWISATZ Dans KWISATZ Il faut activer dans le logiciel Kwisatz l interface WEB. Vous devez renseigner : => l adresse IP => le Port à utiliser (conseil garder le numéro de port par défaut) pour communique avec le WKW_MCOMM_WEB Dans WKW_MCOMM_DOSSIER Vous devez renseigner dans le programme WKW_MCOMM_WEB : => l adresse du site de commerce en ligne Site de commerce en ligne Dans PRESTASHOP Il faut mettre en place les sripts PHP fournit par la société KWISATZ pour activer les web service spécifiques à l interface KWISATZ, pour autoriser l accès aux Web Services Plateforme PRESTASHOP Le logiciel KWISATZ ne communique pas directement avec le site de commerce en ligne, il doit envoyer ses ordres au programme WKW_MCOMM. Ce programme interprète les ordres provenant de KWISATZ et appel les Web Services mis en place lors du paramétrage de la plateforme PRESTASHOP. Ces Web Services fournissent toutes les fonctionnalités nécessaires pour la mise à jour de la base de données du site (catalogue produit, stocks, catégories, etc.) et pour rapatrier les commandes de ventes et les clients. Le but de ce manuel est de vous guider dans le paramétrage de KWISATZ et de la plateforme PRESTASHOP pour mettre en place l interface de communication. Page n 3 / 21
-1.3) Mise en place : -1.3.1) PRESTASHOP : Pour plus de détail sur PRESTASHOP vous pouvez consulter leur site à l adresse suivante : http://www.prestashop.com Après avoir installé la plateforme PRESTASHOP. Nous allons décrire les différentes étapes à suivre pour paramétrer le site de commerce en ligne dans le but de l interfacer avec le logiciel KWISATZ. -1.3.1.1) Les Web Services : Les Web Services sont des scripts PHP développés par la société KWISATZ qui sont utilisés pour communiquer avec la plateforme PRESTASHOP. Ils doivent être installés dans des répertoires précis du site. Tous ces fichiers sont fournis dans une archive <KWISATZ_PRESTASHOP.zip> qu il suffit de décompresser dans le répertoire racine du site, les fichiers seront automatiquement installés dans les répertoires concernés. Ouverture de l archive KWISATZ_PRESTASHOP.ZIP Lors de la décompression, différents type de fichiers sont installés dans différents répertoire : *.php Les script PHP contenu dans ces fichiers sont nécessaires pour la communication avec WKW_MCOM, pour la gestion à partir du logiciel KWISATZ. Attention, les scripts PHP sont cryptés par le biais de l outil IONCUBE. Vous devez obligatoirement charger la bibliothèque de décryptage IONCUBE sur le serveur du site web. Page n 4 / 21
-1.3.2) KWISATZ : Nous allons maintenant mettre en place les informations nécessaires pour autoriser KWISATZ à communiquer avec la plateforme PRESTASHOP. Pour cela, il faudra configurer le logiciel KWISATZ et mettre en place le programme de communication WKW_MCOMM. -1.3.2.1) Configuration de KWISATZ : Pour autoriser le logiciel KWISATZ à communiquer avec le programme WKW_MCOMM, vous devez aller dans le menu : => Outils => Préférences => Divers => Boutique e-commerce Autoriser la communication avec WKW_MCOMM Boutique en ligne active cocher la case pour dialoguer avec le programme WKW_MCOMM. Module de communication Adresse IP renseigner l adresse IP ou se trouve le programme WKW_MCOMM Module de communication Port renseigner le port utilisé par le programme WKW_MCOMM Pour activer le type d interface en mode PRESTASHOP, il faut ouvrir le fichier : PREFERENCES.INI qui se trouve dans le répertoire : \\WKW\$DOSSIER avec <DOSSIER> qui correspond au code du dossier KWISATZ concerné par le programme WKW_MCOMM. Puis ajouter dans la section [COMMUN] la ligne suivante : WKW_MCOMM_TYPE_INTERFACE=1 Page n 5 / 21
-1.3.2.2) Configuration de WKW_MCOMM : Le programme WKW_MCOMM doit être renommé suivant le code du dossier utilisé par le logiciel KWISATZ. Dans notre exemple, le dossier s appelle <WEB>, ce qui implique que le programme WKW_MCOMM doit être renommé en WKW_MCOMM_WEB. WKW_MCOMM_WEB doit être exécuté au démarrage de la machine et doit toujours être présent dans la barre des tâches (Un petit carré vert apparaît à gauche de l heure). Pour faire apparaître la fenêtre de ce programme, il suffit de faire un clic droit sur le petit carré vert et sélectionner <montrer les détails>. Pour paramétrer ce programme, vous devez cliquer sur le bouton <configurer>. Web Services voir paragraphe 1.3.2.2.1 page 7 FTP voir paragraphe 1.3.2.2.2 page 8 Paramètres voir paragraphe 1.3.2.2.3 page 9 Configuration générale de WKW_MCOMM_WEB ID de correspondance entre KWISATZ et la plateforme Ecommerce voir paragraphe 1.3.2.2.4 page 14 Attribut et Catégorie spéciale voir paragraphe 1.3.2.2.5 page 15 Langues voir paragraphe 1.3.2.2.6 page 17 Sauvegarde du log voir paragraphe 1.3.2.2.7 page 17 Page n 6 / 21
-1.3.2.2.1) Web Services : Informations sur la connexion Web Services avec la plateforme PRESTASHOP. Configuration de la connexion avec les Web Services Adresse Adresse Internet pour se connecter aux Web Services, elle se compose de l adresse du site de commerce en ligne : www.maboutique.fr (ne pas mettre http://) User ne pas renseigner. Password ne pas renseigner. Page n 7 / 21
-1.3.2.2.2) FTP : Informations sur la connexion FTP pour transmettre les photos au site de commerce en ligne. Informations pour la connexion FTP Adresse Adresse à utiliser pour se connecter au serveur FTP du site de commerce en ligne. User Nom d utilisateur à utiliser pour se connecter au serveur FTP du site de commerce en ligne. Password Mot de passe à utiliser pour se connecter au serveur FTP du site de commerce en ligne. Chemin racine Le répertoire à utiliser pour déposer les photos des produits doit être : <kwisatz\images\> Page n 8 / 21
-1.3.2.2.3) Paramètres :... Paramètres Page n 9 / 21
Catégories Type de liaison Établir la correspondance avec les catégories de la plateforme PRESTASHOP et la structure marchandise du logiciel KWISATZ. Vous avez le choix entre : Aucun Aucune correspondance, les produits devront être liés aux catégories dans la partie administration de la plateforme PRESTASHOP. Rayon Les catégories de la plateforme PRESTASHOP correspondent aux Rayons du logiciel KWISATZ. L arborescence dans la plateforme PRESTASHOP n a qu un niveau : Produit => Rayon Famille Les catégories de la plateforme PRESTASHOP correspondent aux Familles du logiciel KWISATZ. L arborescence dans la plateforme PRESTASHOP n a qu un niveau : Famille => Produit Ligne Les catégories de la plateforme PRESTASHOP correspondent aux Lignes du logiciel KWISATZ. L arborescence dans la plateforme PRESTASHOP n a qu un niveau : Ligne => Produit Rayon + Famille Les catégories de la plateforme PRESTASHOP correspondent aux Rayons et aux Familles du logiciel KWISATZ. L arborescence dans la plateforme PRESTASHOP a deux niveaux Rayon => Famille => Produit Rayon + Famille + Ligne Les catégories de la plateforme PRESTASHOP correspondent aux Rayons, Familles et lignes du logiciel KWISATZ. L arborescence dans la plateforme PRESTASHOP a trois niveaux Rayon => Famille => Ligne => Produit Catégorie Envoyer les catégories parentes Fonction obsolète. Page n 10 / 21
Marques articles Exporter Ne pas exporter Exporter en tant que catégorie Exporter en tant que caractéristique Exporter dans la fiche produit Marques articles ID Catégorie racine Si les marques articles sont exporter en tant que catégorie, vous devez renseigner <ID> correspondant dans La plateforme PRESTASHOP. Marques articles Exporter en tant que caractéristique Si les marques articles sont exporter en tant que caractéristique, vous devez renseigner le nom de la caractéristique déclaré dans La plateforme PRESTASHOP. Marques articles Exporter dans la fiche produit Les marques seront exportées dans l attribut <marques> prédéfinie dans la plateforme PRESTASHOP Désactiver la gestion des tarifs Cocher la case pour ne pas gérer les tarifs, ils seront gérer à partir de PRESTASHOP. N tarif utilisé : Définir le niveau de tarif que vous désirez utiliser pour la vente des produits sur le site de commerce en ligne : 0 (pour le tarif standard) 1 (pour le tarif N 1) 2 (pour le tarif N 2) 3 (pour le tarif N 3) 4 (pour le tarif N 4) Envoyer les prix TTC Cocher la case pour envoyer les prix en TTC, sinon les prix seront transmis en HT. Transmettre les promos Cocher la case pour envoyer les promotions, sinon elles seront gérer à partir de PRESTASHOP. Désactiver la gestion des stocks Cocher la case pour ne pas gérer les stocks. Stock Web N magasin associé Indiquer quelle est le stock associé au site de commerce en ligne, la valeur 0 correspond au dépôt central. Stock Web Déduire commandes en cours Cocher la case si vous désirez que le programme déduise automatiquement les quantités en stock lors de l intégration des commandes provenant du site de commerce en ligne.... Page n 11 / 21
Nouveau client Affecter à la famille Indiquer le code famille client à utiliser lors de l intégration des nouveaux clients provenant du site de commerce en ligne. Nouveau client Affecter à la catégorie Indiquer le code catégorie à utiliser lors de l intégration des nouveaux clients provenant du site de commerce en ligne. Code utilisé pour les clients non identifiés Indiquer le code client à utiliser lors de l intégration de commandes ne contenant pas de clients identifiés. Nouveau client Radical ajouté au code Pour distinguer les clients PRESTASHOP des clients magasins, on peut ajouter un radical sur deux caractère au code client PRESTASHOP. Produits Exclure les BIS simples Cocher la case si vous désirez ne pas transmettre les produits BIS au site de commerce en ligne. Produits Status lié à <En sommeil> Cocher la case si vous désirer ne pas transmettre les produits en <En sommeil>. Fréquence de lecture des commandes (minutes) Indiquer le délai en minutes entre chaque scrutation du site de commerce en ligne pour la détection et le rapatriement automatique des commandes clients et la mise à jour de stocks. Import automatique entre J et J- Pour définir le nombre de jour du rapatriement des commandes clients, ajout et modification. ID N Dernière commande lue ne pas renseigner, champ obsolète. Intégré les commandes sous forme de factures Cocher la case pour transformer les commandes en facture KWISATZ. Commandes Ignorer si statut <Annulé> Cocher la case pour ne pas rapatrier les commandes avec le statut <Annulé>. Commandes Ignorer si statut <Bloqué> Cocher la case pour ne pas rapatrier les commandes avec le statut <Bloqué>. Commandes Ignorer si statut <En attente> Cocher la case pour ne pas rapatrier les commandes avec le statut <E attente>. Commandes Ignorer si statut <En attente de paiement> Cocher la case pour ne pas rapatrier les commandes avec le statut <En attente de paiement>. Page n 12 / 21
Code règlement utilisé pour les chèques Renseigner le code du règlement correspondant aux chèques. Code règlement utilisé pour les cartes bancaires Renseigner le code du règlement correspondant aux cartes bancaires. Code règlement utilisé pour PAYPAL Renseigner le code du règlement correspondant à PAYPAL. Code règlement utilisé pour PAYBOX Renseigner le code du règlement correspondant à PAYBOX. Taille Grille unique Renseigner le code de la grille de taille unique, si vous gérer les produits en mode grille 2D ou 3D, mais que que vous je gérer pas les tailles. Colori Grille unique Renseigner le code de la grille de couleur unique, si vous gérer les produits en mode grille 2D ou 3D, mais que que vous je gérer pas les couleurs. Bonnet Grille unique Renseigner le code de la grille de bonnet unique, si vous gérer les produits en mode grille 3D, mais que que vous je gérer pas les bonnets. Page n 13 / 21
-1.3.2.2.4) ID de correspondance entre Kwisatz et la plateforme E-Commerce : Mise en relation des identifiants de certains éléments de la base de données PRESTASHOP avec les éléments de la base de données du logiciel KWISATZ. Configuration de la correspondance des identifiants de PRESTASHOP avec KWISATZ ID Catégorie racine La plateforme PRESTASHOP comporte toujours une catégorie racine qui contiendra les catégories des produits. Vous devez indiquer l identifiant de la catégorie racine que vous avez récupérer à partir de la plateforme PRESTASHOP. KWISATZ se servira de cet identifiant pour transmettre les catégories à la plateforme PRESTASHOP. (voir paragraphe 1.4.1 page 18) ID Code TVA 0 à 5 Vous devez créer les TVA sur la plateforme PRESTASHOP, récupérer les identifiants de chaque TVA créer et les renseigner dans les zones correspondantes. Le logiciel KWISATZ se servira de ces identifiants pour affecter les produits dans le bon identifiant TVA sur la plateforme PRESTASHOP lors de la transmission des articles. (voir paragraphe 1.4.2 page 19) Attribut utilisé pour la taille Cette information est utile lorsque vous travaillez en mode taille/ couleur / bonnet. Il faut créer dans la plateforme PRESTASHOP un groupe d attribut pour pouvoir gérer les tailles. Ensuite, indiquer le nom de l attribut que vous avez défini dans cette zone. Attribut utilisé pour le colori Cette information est utile lorsque vous travaillez en mode taille/ couleur / bonnet. Il faut créer dans la plateforme PRESTASHOP un groupe d attribut pour pouvoir gérer les coloris. Ensuite, indiquer le nom de l attribut que vous avez défini dans cette zone. Attribut utilisé pour le bonnet (profondeur) Cette information est utile lorsque vous travaillez en mode taille/ couleur / bonnet. Il faut créer dans la plateforme PRESTASHOP un groupe d attribut pour pouvoir gérer les bonnets. Ensuite, indiquer le nom de l attribut que vous avez défini dans cette zone. Page n 14 / 21
-1.3.2.2.5) Attribut et Catégorie spéciale: Attribut <Name> Activé Décocher la case si vous ne voulez pas transmettre le champ <libellé> de l onglet <infos web>. Attribut <Description> Activé Cocher la case pour envoyer le champ <Description> de l onglet <infos web>. Attribut <ShortDescription> Activé Cocher la case pour envoyer le champ <Description courte> de l onglet <infos web>. Attribut liste n 1 à n 5 Activé Cocher la case pour gérer l attribut liste (de 01 à 05). Attribut La plateforme PRESTASHOP propose la création de nouvelles caractéristiques pour la fiche article. Si vous créez une nouvelle caractéristique sur la plateforme PRESTASHOP, vous devez indiquer dans cette zone, le nom que vous avez affecté à la caractéristique. Il est possible de créer jusqu à cinq nouveaux attributs de type liste (sous forme de menu déroulant). Titre Indiquer le libellé qui apparaîtra dans la fiche article du logiciel KWISATZ pour le nouvel attribut créé. (voir paragraphe 1.4.3 page 20)... Page n 15 / 21
Catégorie spéciale n 1 à n 5 Activé Cocher la case pour gérer les catégories spéciales (de 01 à 05). Titre Indiquer le libellé qui apparaîtra dans la fiche article du logiciel KWISATZ pour la nouvelle catégorie créé. ID La plateforme PRESTASHOP propose la création de nouvelle catégorie pour la fiche article. Si vous créez une nouvelle catégorie sur la plateforme PRESTASHOP, vous devez indiquer dans cette zone, le nom que vous avez affecté à cette catégorie. Il est possible de créer jusqu à cinq nouvelle catégorie (sous forme case à cocher). (voir paragraphe 1.4.3 page 20) Page n 16 / 21
-1.3.2.2.6) Langues : Langue principale - ID Vous devez renseigner ID de la langue principale de la plateforme PRESTASHOP. Langue n 2 à n 5 Active Cochez la case pour pour gérer une langue supplémentaire. Langue n 2 à n 5 ID Saisir le code <ID> correspondant à la langue. Langue n 2 à n 5 Titre Saisir le libellé de la langue. (voir paragraphe 1.4.4 page 21) -1.3.2.2.7) Sauvegarde du log : Sauvegarde du log Activé Cocher la case pour enregistrer le log dans le fichier : WKW_MCOMM.LOG qui se trouve dans le dossier : \\WKW\$DOSSIER avec <DOSSIER> correspond au code du dossier KWISATZ concerné par le programme WKW_MCOMM. Page n 17 / 21
-1.4) Correspondance des données KWISATZ avec PRESTASHOP : Comme nous l avons vu dans le chapitre précédent, le logiciel KWISATZ doit faire correspondre certains éléments de sa base de données avec les éléments de la base de données de la plateforme PRESTASHOP. -1.4.1) ID pour la catégorie racine : La plateforme PRESTASHOP utilise une catégorie racine comme catégorie principale. Elle sert de conteneur aux catégories des produits. Le logiciel KWISATZ se sert de cette catégorie pour transmettre la structure marchandise (Rayon, Famille, Ligne). Pour retrouver l identifiant de cette catégorie, vous devez accéder à la partie administration de la plateforme PRESTASHOP et sélectionner le menu : => Catalogue => Accueil Exemple : Catégorie racine Barre d adresse : http://127.0.0.1/sitetest_prod/comptoir/index.php?tab=admincatalog&id_category=1&viewcategory&token=8cb7cd953c51a5ffc4788845629f46d9 ID PRESTASHOP de la catégorie racine : 1 Après avoir récupérer l identifiant de la catégorie racine, vous devez saisir cette information dans la configuration du programme WKW_MCOMM, (voir paragraphe 1.3.2.2.4 page 14). Page n 18 / 21
-1.4.2) ID Pour les codes TVA : Vous devez créer les TVA sur la plateforme PRESTASHOP, récupérer les identifiants de chaque TVA et saisir l identifiant dans la fenêtre de configuration du programme WKW_MCOMM. Pour mettre en relation les TVA créées dans le logiciel KWISATZ et les règles créées sur la plateforme PRESTASHOP, vous devez suivre les étapes suivantes : Pour récupérer les identifiants, vous devez accéder à la partie administration de la plateforme PRESTASHOP et sélectionner le menu : =>Paiement => Taxes Exemple : Liste des Taxes Dans notre cas dans le logiciel KWISATZ, le code TVA <1> a été défini au taux de TVA 19,6. ID PRESTASHOP Code TVA 1 (19,6%) : 1 Après avoir récupérer les identifiant des TVA, vous devez saisir cette information dans la fenêtre de configuration du programme WKW_MCOMM, (voir paragraphe 1.3.2.2.4 page 14). Page n 19 / 21
-1.4.3) ID pour les Catégories : La plateforme PRESTASHOP permet de créer de nouveaux champs <Catégories> pour la fiche article. Le logiciel KWISATZ propose des champs supplémentaire pour la compatibilité : 5 champs attribut liste sous forme de menu déroulant 5 champs catégorie spéciales sous forme case à cocher Lorsque vous créez une nouvelle catégorie sur la plateforme PRESTASHOP, vous devez la faire correspondre avec un champs du logiciel KWISATZ. Pour plus de détails sur les catégories, voir la documentation PRESTASHOP. Les catégories se trouvent dans le menu : => Catalogue Liste des catégories Après avoir récupérer les identifiant des catégories, vous devez saisir cette information dans la fenêtre de configuration du programme WKW_MCOMM, (voir paragraphe 1.3.2.2.4 page 14). Page n 20 / 21
-1.4.4) ID pour les langues : La plateforme PRESTASHOP peut gérer plusieurs langues, pour retrouver la langue par défaut et son <ID>, il faut aller dans le menu : =>Outils => Langues Exemple : Listes des langues Dans notre cas la langues principales est le français. ID PRESTASHOP Langue principale - ID : 2 Après avoir récupérer les identifiants des langues, vous devez saisir cette information dans la fenêtre de configuration du programme WKW_MCOMM, (voir paragraphe 1.3.2.2.6 page 17). Page n 21 / 21