_TUTO_module_magento Table des matières -1) - :...2-1.1) Introduction :...2-1.2) Description :...3-1.2.1) Schéma :...3-1.3) Mise en place :...4-1.3.1) MAGENTO :...4-1.3.1.1) Les Web Services :...4-1.3.1.2) Création d un utilisateur :...7-1.3.1.2.1) Le rôle :...7-1.3.1.2.2) L utilisateur :...8-1.3.2) :...9-1.3.2.1) Configuration de :...9-1.3.2.2) Configuration de WKW_MCOMM :...10-1.3.2.2.1) Web Services :...11-1.3.2.2.2) FTP :...12-1.3.2.2.3) Paramètres :...13-1.3.2.2.4) ID de correspondance entre Kwisatz et la plateforme E-Commerce :...18-1.3.2.2.5) Attribut et Catégorie spéciale:...20-1.3.2.2.6) Multi-boutiques & Multi-vues :...23-1.3.2.2.7) Sauvegarde du log :...23-1.4) Correspondance des données avec MAGENTO :...24-1.4.1) ID MAGENTO du WebSite :...24-1.4.2) ID pour le groupe d attributs catalogue :...25-1.4.3) ID pour la catégorie racine :...26-1.4.4) ID Pour les codes TVA :...27-1.4.4.1) Création d une TVA sous MAGENTO :...27-1.4.4.1.1) Création des classes de TVA client :...28-1.4.4.1.2) Création des classes de TVA produit :...29-1.4.4.1.3) Création des zones de taxes :...30-1.4.4.1.4) Création des règles de TVA :...32-1.4.4.2) Récupération des identifiants :...34-1.4.5) Les attributs :...35-1.4.6) Création d un nouvel attribut :...36 Page n 1 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1) - : -1.1) Introduction : Un module d extension permettant la communication directe et native entre et la plateforme e-commerce MAGENTO est maintenant disponible. MAGENTO 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» à MAGENTO s accroît de jour en jour. C est pour toutes ces raisons, que nous avons décidé de s interfacer avec MAGENTO. 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 et permettre aux clients de suivre en direct l état d avancement de leurs commandes. 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 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.2) Description : Un programme appelé WKW_MCOMM a été développé pour effectuer l interface entre le logiciel et la plateforme MAGENTO. -1.2.1) Schéma : Serveur Le logiciel communique avec le programme WKW_MCOMM_WEB sur le port 6203 Disque Dur du serveur C:\WKW\$WEB Dans WKW_MCOMM_WEB WKW_MCOMM_WEB communique avec la plateforme WEB au travers des WEB SERVICES via INTERNET 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 INTERNET Site de commerce en ligne WEB SERVICES SPECIFIQUE Vous devez renseigner dans le programme WKW_MCOMM_WEB : => l adresse du site de commerce en ligne => Le nom d utilisateur => Le mot de passe à utiliser pour la connexion avec les web service Site de commerce en ligne Dans MAGENTO Il faut mettre en place les sripts PHP fournit par la société pour activer les web service spécifiques à l interface, puis créer : => un nom d utilisateur => un mot de passe pour autoriser l accès aux Web Services Plateforme MAGENTO Le logiciel 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 et appel les Web Services mis en place lors du paramétrage de la plateforme MAGENTO. 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 et de la plateforme MAGENTO pour mettre en place l interface de communication. Page n 3 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3) Mise en place : -1.3.1) MAGENTO : Les informations contenu dans ce chapitre sont tirées du document : MAGENTO Guide Utilisateur à l adresse : http://www.magentocommerce.com/wiki/doc/user_guide_in_franch?rev=1224849005 Après avoir installé la plateforme MAGENTO à l aide du guide utilisateur. 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. -1.3.1.1) Les Web Services : Les Web Services sont des scripts PHP développés par la société qui sont utilisés pour communiquer avec la plateforme MAGENTO. Ils doivent être installés dans des répertoires précis du site. Tous ces fichiers sont fournis dans une archive <_MAGENTO.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 MAGENTO_.zip Décompression dans le répertoire racine... Page n 4 / 37 Copyright 2009 - Développement
_TUTO_module_magento Lors de la décompression, différents type de fichiers sont installés dans différents répertoire : App\etc\module\_Communication.xml Déclaration du nouveau service de communication avec le logiciel. App\code\local\\Communication\etc\config.xml Déclaration de l arborescence des répertoires utilisés pour le service de communication. App\code\local\\Communication\etc\api.xml Déclaration des différentes classes contenant les routines nécessaires pour la communication avec le logiciel. App\code\local\\Communication\Model\Produits\Api.php Script PHP contenant les fonctions nécessaires pour la gestion du catalogue produits à partir du logiciel. App\code\local\\Communication\Model\librairie\Api.php Script PHP contenant des fonctions diverses utiles pour la communication avec le logiciel. App\code\local\\Communication\Model\Commandes\Api.php Script PHP contenant les fonctions nécessaires pour la gestion des commandes clients à partir du logiciel. App\code\local\\Communication\Model\Clients\Api.php Script PHP contenant les fonctions nécessaires pour la gestion des clients à partir du logiciel. App\code\local\\Communication\Model\Categories\Api.php Script PHP contenant les fonctions nécessaires pour la gestion des catégories à partir du logiciel. App\code\local\\Communication\Model\Attributs\Api.php Script PHP contenant les fonctions nécessaires pour la gestion des attributs à partir du logiciel. 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 Apache.... Page n 5 / 37 Copyright 2009 - Développement
_TUTO_module_magento Pour activer les Web Services de communication avec le logiciel, Vous devez rafraîchir le cache de la plateforme MAGENTO. Cette opération s effectue à partir du menu : => Système => Gestion du cache> 1) Sélectionner <Sélectionner tout> 2) Puis <Valider> (Actions : Rafraîchir) Inscription des Web services pour dans MAGENTO Après avoir sélectionné <Sélectionner tout>, vous devez cliquer sur le bouton <Valider> (Actions : Rafraîchir). A partir de ce moment, MAGENTO a chargé les informations nécessaires pour l utilisation des Web Services de communication avec le logiciel. Si vous désirez vérifier la présence de ces Web Services, il suffit d aller dans le menu : => Système => Configuration => Avancé puis cliquer sur <Désactiver la sortie des modules> Web Services pour Vérification de la présence des Web services pour Page n 6 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.1.2) Création d un utilisateur : Pour accéder aux Web services, vous devez définir un rôle et créer un utilisateur. Cet utilisateur servira pour se connecter aux Web Services. -1.3.1.2.1) Le rôle : Le rôle permet de définir les modules auxquels aura accès l utilisateur utilisant ce rôle. Pour créer un nouveau rôle, vous devez aller dans le menu : => Système => Services web => SOAP/XML-RPC - Rôles Cliquer sur le bouton <Nouveau rôle> pour ajouter un rôle. Donner un nom au rôle puis <Sauvegarder le rôle> Indiquer les <Accès aux ressources> autorisés puis <Sauvegarder le rôle> (dans notre cas l accès à toutes les ressources est autorisé). Le rôle est crée. Page n 7 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.1.2.2) L utilisateur : L utilisateur servira pour se connecter aux Web services à partir du logiciel. Pour créer un nouvel utilisateur, vous devez aller dans le menu : => Système => Services web => SOAP/XML-RPC - Utilisateurs Cliquer sur le bouton <Nouvel utilisateur> pour ajouter un utilisateur Renseigner les <Informations du compte> Nom d utilisateur Identifiant de l utilisateur. Prénom Prénom de l utilisateur. Nom Nom de famille de l utilisateur. Email Adresse email de l utilisateur. Clé d API Mot de passe de l utilisateur. Confirmation de la clé d API Confirmation du mot de passe de l utilisateur. Ce compte est Actif ou inactif cet utilisateur. Lié l utilisateur à un rôle puis <Sauvegarder l utilisateur> A partir de ce point, MAGENTO est prêt à communiquer avec le logiciel. Page n 8 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.2) : Nous allons maintenant mettre en place les informations nécessaires pour autoriser à communiquer avec la plateforme MAGENTO. Pour cela, il faudra configurer le logiciel et mettre en place le programme de communication WKW_MCOMM. -1.3.2.1) Configuration de : Pour autoriser le logiciel à 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 Page n 9 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.2.2) Configuration de WKW_MCOMM : Le programme WKW_MCOMM doit être renommé suivant le code du dossier utilisé par le logiciel. 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>. Configuration générale de WKW_MCOMM_WEB Web Services ( voir paragraphe 1.3.2.2.1 page 11 ) FTP ( voir paragraphe 1.3.2.2.2 page 12 ) Paramètres ( voir paragraphe 1.3.2.2.3 page 13 ) ID de correspondance entre et la plateforme Ecommerce ( voir paragraphe 1.3.2.2.4 page 18 ) Attribut et Catégorie spéciale: ( voir paragraphe 1.3.2.2.5 page 20 ) Muti-Boutiques & Muti-vues ( voir paragraphe 1.3.2.2.6 page 23 ) Sauvegarde du log ( voir paragraphe 1.3.2.2.7 page 23 ) Page n 10 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.2.2.1) Web Services : Informations sur la connexion Web Services avec la plateforme MAGENTO. 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://) et ajouter le texte : /api/xmlrpc User Nom d utilisateur pour se connecter aux Web Services. Il a été déclaré précédemment sur la plateforme MAGENTO ( voir paragraphe -1.3.1.2.2) page 8 ) Password Mot de passe associé à l utilisateur. Il a été déclaré précédemment sur la plateforme MAGENTO ( voir paragraphe -1.3.1.2.2) page 8 ) Page n 11 / 37 Copyright 2009 - Développement
_TUTO_module_magento -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 Répertoire à utiliser pour déposer les photos des produits Page n 12 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.2.2.3) Paramètres : Paramètres... Page n 13 / 37 Copyright 2009 - Développement
_TUTO_module_magento Catégories Type de liaison Établir la correspondance avec les catégories de la plateforme MAGENTO et la structure marchandise du logiciel. Vous avez le choix entre : Aucun Aucune correspondance, les produits devront être liés aux catégories dans la partie administration de la plateforme MAGENTO. Rayon Les catégories de la plateforme MAGENTO correspondent aux Rayons du logiciel. L arborescence dans la plateforme MAGENTO n a qu un niveau : Produit => Rayon Famille Les catégories de la plateforme MAGENTO correspondent aux Familles du logiciel. L arborescence dans la plateforme MAGENTO n a qu un niveau : Famille => Produit Ligne Les catégories de la plateforme MAGENTO correspondent aux Lignes du logiciel. L arborescence dans la plateforme MAGENTO n a qu un niveau : Ligne => Produit Rayon + Famille Les catégories de la plateforme MAGENTO correspondent aux Rayons et aux Familles du logiciel. L arborescence dans la plateforme MAGENTO a deux niveaux Rayon => Famille => Produit Rayon + Famille + Ligne Les catégories de la plateforme MAGENTO correspondent aux Rayons, Familles et lignes du logiciel. L arborescence dans la plateforme MAGENTO a trois niveaux Rayon => Famille => Ligne => Produit Catégorie Envoyer les catégories parentes Fonction obsolète. Marques articles Exporter Ne pas exporter Exporter en tant que catégorie Exporter en tant qu attribut filtrable 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 MAGENTO. Marques articles Attribut filtrable Si les marques articles sont exporter en tant qu attribut filtrable, vous devez renseigner <ID> correspondant dans La plateforme MAGENTO.... Page n 14 / 37 Copyright 2009 - Développement
_TUTO_module_magento Désactiver la gestion des tarifs Cocher la case pour ne pas gérer les tarifs, ils seront gérer à partir de MAGENTO. 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 MAGENTO. 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. 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 MAGENTO des clients magasins, on peut ajouter un radical sur deux caractère au code client MAGENTO.... Page n 15 / 37 Copyright 2009 - Développement
_TUTO_module_magento 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. Import automatique entre J et JPour définir le nombre de jour du rapatriement des commandes clients, ajout et modification. ID N Dernière commande lue <obsolète> Intégré les commandes sous forme de factures Cocher la case pour transformer les commandes en facture. 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>. 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.... Page n 16 / 37 Copyright 2009 - Développement
_TUTO_module_magento 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. Autres modes de règlements personnalisés Règlements n 1 à n 5 Activé Cocher la case pour ajouter un mode de règlement MAGENTO. Méthode Renseigner le nom de la méthode utilisé par MAGENTO. Code règlement Renseigner le code du règlement correspondant dans. Page n 17 / 37 Copyright 2009 - Développement
_TUTO_module_magento -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 MAGENTO avec les éléments de la base de données du logiciel. Configuration de la correspondance des identifiants de MAGENTO avec ID WebSite La plateforme MAGENTO est capable de gérer plusieurs sites de commerce en ligne, chaque site à son propre identifiant. Le logiciel a besoin de connaître l identifiant du site avec lequel il va communiquer. Vous devez indiquer dans cette zone l identifiant du site que vous avez récupérer à partir de la plateforme MAGENTO. ID Groupe d attributs catalogue La plateforme MAGENTO est capable de gérer plusieurs jeu d attributs et le logiciel ne gère qu un. Vous devez indiquer dans cette zone l identifiant du jeu d attribut que vous avez récupérer à partir de la plateforme MAGENTO. ID Catégorie racine La plateforme MAGENTO 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 MAGENTO. se servira de cet identifiant pour transmettre les catégories à la plateforme MAGENTO. ID Code TVA 0 à 5 Vous devez créer les TVA sur la plateforme MAGENTO, récupérer les identifiants de chaque TVA créer et les renseigner dans les zones correspondantes. Le logiciel se servira de ces identifiants pour affecter les produits dans le bon identifiant TVA sur la plateforme MAGENTO lors de la transmission des articles.... Page n 18 / 37 Copyright 2009 - Développement
_TUTO_module_magento Attribut utilisé pour la taille Cette information est utile lorsque vous travaillez en mode taille/ couleur / bonnet. Il faut créer dans la plateforme MAGENTO un attribut de type liste 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 MAGENTO un attribut de type liste 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 MAGENTO un attribut de type liste pour pouvoir gérer les bonnets. Ensuite, indiquer le nom de l attribut que vous avez défini dans cette zone. Page n 19 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.2.2.5) Attribut et Catégorie spéciale: Attribut <Name> Activé Cocher la case pour envoyer 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 texte n 01 à n 05 Activé Cocher la case pour gérer l attribut texte (de 01 à 05). Attribut La plateforme MAGENTO propose la création de nouveaux champs ou attributs pour la fiche article. Si vous créez un nouvel attribut sur la plateforme MAGENTO, vous devez indiquer dans cette zone, le nom que vous avez affecté à l attribut. Il est possible de créer jusqu à cinq nouveaux attributs de type texte (champ pouvant contenir jusqu à 80 caractères). Titre Indiquer le libellé qui apparaîtra dans la fiche article du logiciel pour le nouvel attribut créé.... Page n 20 / 37 Copyright 2009 - Développement
_TUTO_module_magento Attribut mémo n 01 à n 05 Activé Cocher la case pour gérer l attribut mémo (de 01 à 05). Attribut La plateforme MAGENTO propose la création de nouveaux champs ou attributs pour la fiche article. Si vous créez un nouvel attribut sur la plateforme MAGENTO, vous devez indiquer dans cette zone, le nom que vous avez affecté à l attribut. Il est possible de créer jusqu à cinq nouveaux attributs de type mémo (un mémo est un champ capable d accepter jusqu à 65 000 caractères). Titre Indiquer le libellé qui apparaîtra dans la fiche article du logiciel pour le nouvel attribut créé. Attribut liste n 1 à n 5 Activé Cocher la case pour gérer l attribut liste (de 01 à 05). Attribut La plateforme MAGENTO propose la création de nouveaux champs ou attributs pour la fiche article. Si vous créez un nouvel attribut sur la plateforme MAGENTO, vous devez indiquer dans cette zone, le nom que vous avez affecté à l attribut. 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 pour le nouvel attribut créé.... Page n 21 / 37 Copyright 2009 - Développement
_TUTO_module_magento 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 pour la nouvelle catégorie créé. ID La plateforme MAGENTO propose la création de nouvelle catégorie pour la fiche article. Si vous créez une nouvelle catégorie sur la plateforme MAGENTO, vous devez indiquer dans cette zone, <ID> que vous avez affecté à catégorie. Il est possible de créer jusqu à cinq nouvelle catégorie (sous forme case à cocher). Page n 22 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.3.2.2.6) Multi-boutiques & Multi-vues : Fonction obsolète. -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 concerné par le programme WKW_MCOMM. Page n 23 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4) Correspondance des données avec MAGENTO : Comme nous l avons vu dans le chapitre précédent, le logiciel 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 MAGENTO. -1.4.1) ID MAGENTO du WebSite : La plateforme MAGENTO est capable de gérer plusieurs sites de boutiques en ligne, chaque site peut a son propre WebSite (pour plus de détails, voir la documentation MAGENTO). a besoin de connaître l identifiant du WebSite sur lequel il est rattaché. Pour récupérer l identifiant du WebSite, vous devez accéder à la partie administration de la plateforme MAGENTO et sélectionner le menu : => Système => Gestion des magasins Lorsque vous sélectionner le WebSite que vous désirez rattacher au logiciel, dans la barre d adresse, la plateforme MAGENTO visualise l identifiant du WebSite sélectionné. Cliquer sur cette zone Visualisation de la liste des WebSite Récupération de l identifiant du WebSite barre d'adresse du navigateur : http://127.0.0.1/magento_172/index.php/admin/system_store/editgroup/group_id/1/key/7cdf749766504e8e89430198deb345dc/ Identifiant Website : 1 Après voir récupéré l identifiant du Website, Vous devez saisir cette information dans la configuration du WKW_MCOMM : <ID - Website> Saisir l identifiant du WebSite : 1 Page n 24 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.2) ID pour le groupe d attributs catalogue : La plateforme MAGENTO peut utilisé plusieurs jeux d attributs et le logiciel se ne sert que d un seul jeux pour transmettre les informations. Pour retrouver l identifiant de ce jeu d attribut, vous devez accéder à la partie administration de la plateforme MAGENTO et sélectionner le menu : => Catalogue => Attribut => Gérer les jeux d attributs La liste apparaît, en sélectionnant un élément, vous pourrez récupérer l identifiant du jeu d attributs. Cliquer sur cette zone Visualisation de la liste des jeux d attributs Récupération de l identifiant du jeu d attribut barre d'adresse du navigateur : http://127.0.0.1/magento_172/index.php/admin/catalog_product_set/edit/id/4/key/dc3b24b9969793940de9a89d5d2928f3/ Identifiant Groupe d attributs catalogue : 4 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 : <ID Groupe d attributs catalogue> Saisir l identifiant du du groupe d attributs catalogue : 4 Page n 25 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.3) ID pour la catégorie racine : La plateforme MAGENTO utilise une catégorie racine comme catégorie principale. Elle sert de conteneur aux catégories des produits. Le logiciel 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 MAGENTO et sélectionner le menu : => Catalogue => Gérer les catégories La catégorie racine est l élément du premier niveau de l arbre apparaissant à gauche de la fenêtre. En sélectionnant cet élément, vous pourrez récupérer l identifiant de la catégorie principale. Catégorie racine Liste des catégories Identifiant catégorie racine : 2 Récupération de l identifiant de la catégorie racine Identifiant Catégorie racine : 2 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 : <ID - Catégorie racine> Saisir l identifiant de la catégorie racine : 2 Page n 26 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.4) ID Pour les codes TVA : Vous devez créer les TVA sur la plateforme MAGENTO, récupérer les identifiants de chaque tva créée et saisir l identifiant dans la fenêtre de configuration du programme WKW_MCOMM. -1.4.4.1) Création d une TVA sous MAGENTO : Sur la plateforme MAGENTO les TVA sont gérées par le biais des règles de TVA. Ces règles dépendent du taux de taxe, du lieu de facturation, de la classe du produit, de la classe du client et du montant de la facture (pour plus de détails, voir la documentation MAGENTO). Pour mettre en relation les TVA créées dans le logiciel et les règles créées sur la plateforme MAGENTO, vous devez suivre les étapes suivantes : Création de deux «classe de TVA client» Soumis Non soumis Création de quatre «classe de TVA Produit» Frais de port Produit non taxés Produits taxés au taux normal Produits taxés au taux réduit Création de deux «zones de taxe» Taux normal 19.6 Taux réduit 5.5 Création de deux «règles de TVA» Taux réduit 5.5 Taux normal 19.6 Page n 27 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.4.1.1) Création des classes de TVA client : Pour créer une classe de TVA client, vous devez accéder à la partie administration de la plateforme MAGENTO et sélectionner le menu : => Ventes => TVA => Classes de TVA client Dans notre cas, nous allons créer deux classes : Clients non soumis Clients soumis Clic sur bouton <Add New> pour ajouter une nouvelle classe de TVA Gestion des classes de TVA client 1) Saisir le libellé de la classe de TVA 2) Clic sur bouton <Sauvegarder la classe> pour enregistrer la nouvelle classe de TVA Création d une nouvelle classe de TVA Deux classes de TVA client ont été créées Page n 28 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.4.1.2) Création des classes de TVA produit : Pour créer une classe de TVA produit, vous devez accéder à la partie administration de la plateforme MAGENTO et sélectionnez le menu : => Ventes => TVA => Classes de TVA produit Dans notre exemple, nous allons créer quatre classes : Produits non taxés Produits taxés taux normal Produits taxés au taux réduit Frais de port. Clic sur bouton <Add New> pour ajouter une nouvelle classe de TVA produit Gestion des classes de TVA produit 1) Saisir le libellé de la classe de TVA 2) Clic sur bouton <Sauvegarder la classe> pour enregistrer la nouvelle classe de TVA Création d une nouvelle classe de TVA Quatre classes de TVA ont été créées Page n 29 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.4.1.3) Création des zones de taxes : Pour créer une zone de taxe, vous devez accéder à la partie administration de la plateforme MAGENTO et sélectionnez le menu : => Ventes => TVA => Gérer les zones de taxes et de taux Dans notre exemple, nous allons créer deux zones de taxes : Taux réduit 5.5 Taux normal 19.6 Création des zones de taxes Création d une nouvelle zone de taxe Identifiant de taxe Libellé de la taxe. Pays Pays où s applique la taxe. Dans notre exemple, la taxe s applique à la France. Etat / Région / Département Région ou département où s applique la taxe. Dans notre exemple, la taxe s applique à toutes les régions et tous les départements. Code postal Code postal où s applique la taxe. Dans notre exemple, la taxe s applique à tous les codes postaux. Taux Taux de la taxe. Dans note exemple, le taux de la taxe est de 19.6%.... Page n 30 / 37 Copyright 2009 - Développement
_TUTO_module_magento Deux zones de taxes ont été créées Page n 31 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.4.1.4) Création des règles de TVA : Pour créer une règle de TVA, vous devez accéder à la partie administration de la plateforme MAGENTO et sélectionnez le menu : => Ventes => TVA => Gérer les règles de TVA Dans notre exemple, nous allons créer deux règles de TVA Taux réduit 5.5 Taux normal 19.6 Création des règles de TVA Création d une règle de TVA... Page n 32 / 37 Copyright 2009 - Développement
_TUTO_module_magento Nom (usage interne) libellé de la règle de TVA. Classe de TVA clients Quelle classe de TVA client utilisée pour cette règle. Dans notre exemple, nous utilisons la classe de TVA client <soumis>. Classe de TVA produits Quelle classe de TVA produit utilisée pour cette règle. Dans notre exemple, nous utilisons la classe de TVA produit <Produits taxés au taux normal>. Taux de TVA Quel taux de TVA utilisé pour cette règle. Dans notre exemple, nous utilisons le taux de TVA <Taux normal 19.6>. Priorité Si plusieurs règles de TVA sont appliquées en même temps, les règles de TVA ayant la même priorité sont additionnées. Sinon, elles sont appliquées en cascade suivant le niveau de priorité. Ordre de tri Position dans la liste des règles de TVA. Deux règles TVA ont été créées Page n 33 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.4.2) Récupération des identifiants : Après avoir créé les TVA sur la plateforme MAGENTO, nous allons maintenant affecter les identifiants de chaque TVA dans les zones correspondantes du programme WKW_MCOMM. Pour récupérer les identifiants, vous devez accéder à la partie administration de la plateforme MAGENTO et sélectionner le menu : =>Ventes => TVA => Classes de TVA produit Cette opération devra être effectuer pour tous les classes de TVA déclarées. Sélectionner la classe de TVA Liste des classes de TVA Identifiant classe de TVA Produits taxés au taux normal : 2 Récupération de l identifiant de la classe de TVA Après avoir récupérer l identifiant de la classe de TVA, vous devez saisir cette information dans la zone <ID pour code TVA> de la fenêtre de configuration du programme WKW_MCOMM. Dans notre cas, la classe <Produits taxés au taux normal> correspond au code TVA <1> dans le logiciel, le code TVA <1> a été défini au taux de TVA 19,6.... Page n 34 / 37 Copyright 2009 - Développement
_TUTO_module_magento Le code de TVA 1 est lié à l identifiant 2 de la classe de tva produit sur la plateforme MAGENTO Renseigner l identifiant de la classe de TVA produit -1.4.5) Les attributs : La plateforme MAGENTO permet de créer de nouveaux champs <attributs> pour la fiche article. Le logiciel propose des champs supplémentaire pour la compatibilité : 5 champs de type chaîne de texte champ pouvant contenir jusqu à 80 caractères 5 champs de type mémo champ pouvant contenir jusqu à 65 0000 caractères 5 champs liste sous forme de menu déroulant 5 champs catégorie spéciales sous forme case à cocher... Lorsque vous créez un nouvel attribut sur la plateforme MAGENTO, vous devez faire correspondre le nouvel attribut à un des nouveaux champs du logiciel. Dans notre exemple, nous allons crée un nouvel attribut qui contiendra les caractéristiques techniques du produit. Pour plus de détails sur les attributs, voir la documentation MAGENTO. Page n 35 / 37 Copyright 2009 - Développement
_TUTO_module_magento -1.4.6) Création d un nouvel attribut : Pour créer un nouvel attribut, vous devez accéder au panneau d administration de la plateforme MAGENTO et sélectionner le menu : => Attributs => Gérer les attributs Dans notre exemple, nous allons créer un attribut <caractéristique> de type <mémo>. Il servira à renseigner les caractéristiques techniques du produit. Clic sur «Nouvel attribut» pour ajouter un nouvel attribut Liste des attributs Nom de l attribut (Pour plus de détails, veuillez consulter la documentation MAGENTO) Création d un nouvel attribut Page n 36 / 37 Copyright 2009 - Développement
_TUTO_module_magento Cocher <Activé> puis renseigner le champ <Attribut> et le champ <Titre> Page n 37 / 37 Copyright 2009 - Développement