OpenSi Connect pour Magento Guide de lʼutilisateur Décembre 2010 Version 2.0 Auteurs Franck Jacob Ludovic Garnier Pierre Verger Olivier Coeytaux Guide de lʼutilisateur OpenSi Connect pour Magento" Page 1 sur 35
Sommaire Présentation générale!... 4 Fonctionnement du module!... 6 Format dʼéchange des données!... 6 Sécurité des échanges!... 6 Installation du module!... 7 Récupération de la clé dʼinstallation Magento!... 7 Saisie de cette clé dans le backoffice Magento!... 8 Vider la cache du site Magento!... 9 Le module est installé!!... 10 Interface de configuration du module web!... 11 Définitions des flux dʼinformation entre Magento et OpenSi!... 12 Création de nouveaux attributs sous Magento!... 14 Récapitulatif des champs synchronisables en Magento et OpenSi!... 14 Création dʼun produit simple!... 16 Onglet «General» (ou «Général»)!... 16 Onglet «Description» (ou «Description»)!... 16 Onglet «Prices» (ou «Prix»)!... 16 Onglet «Inventory» (ou «Inventaire»)!... 16 Onglet «Categories» (ou «Catégories»)!... 17 Que se passe-t-il maintenant?!... 18 Création dʼun produit configurable!... 19 Onglet «General» (ou «Général»)!... 19 Onglet «Description» (ou «Description»)!... 19 Onglet «Prices» (ou «Prix»)!... 19 Onglet «Inventory» (ou «Inventaire»)!... 19 Guide de lʼutilisateur OpenSi Connect pour Magento" Page 2 sur 35
Onglet «Associated Products» (ou «Produits associés»)!... 20 Que se passe-t-il maintenant?!... 20 Création dʼun produit de type «bundle»!... 21 Onglet «General» (ou «Général»)!... 21 Onglet «Description» (ou «Description»)!... 21 Onglet «Prices» (ou «Prix»)!... 22 Onglet «Inventory» (ou «Inventaire»)!... 22 Onglet «Bundle items» (ou «Articles packagés»)!... 22 Que se passe-t-il maintenant?!... 24 Création dʼun produit de type «grouped»!... 27 Création dʼun produit de type «Downloadable» ou «Virtual»!... 28 Modification dʼarticle!... 29 Modification des informations de base dʼune fiche article!... 30 Modification de prix!... 30 Modification des stocks!... 30 Modification du SKU!... 30 Gestion des comptes client (Site vers OpenSi)!... 31 Création dʼun compte client web (Site vers OpenSi)!... 31 Mise à jour dʼun compte client web (Site vers OpenSi)!... 31 Création dʼune commande client web (Site vers OpenSi)!... 31 Création d'une transaction bancaire (Site vers OpenSi)!... 34 Récupération des états de commande (OpenSi vers Site)!... 34 Etats de commandes d'opensi!... 34 Etats de commandes d'opensi Correspondance Magento!... 34 Etats logistique OpenSi Correspondance Magento!... 35 Récupération du tracking colis (OpenSi vers Site)!... 35 Guide de lʼutilisateur OpenSi Connect pour Magento" Page 3 sur 35
Présentation générale Lʼobjectif de ce guide est de vous détailler les modalités de fonctionnement du module «OpenSi Connect» pour la plateforme «Magento». Ce module «OpenSi Connect» permettra à votre site e-commerce Magento de dialoguer avec OpenSi E- Commerce et de synchroniser automatiquement les commandes clients, le catalogue dʼarticles, les stocks et les tarifs. Après lʼinstallation du module «OpenSi Connect» sur un site e-commerce Magento, une interface de configuration et de gestion des échanges est disponible dans le backoffice du site, onglet «OpenSi». OpenSi et Speedinfo sont des marques déposées. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 4 sur 35
Conventions Dans la suite du document, nous appellerons : Commerçant : le propriétaire du site e-commerce que lʼon désire connecter à OpenSi Site ou site-e-commerce : le site internet ou lʼapplication à connecter à OpenSi Module OpenSi Connect : le module développé par Speedinfo à installer sur la boutique Magento. OpenSi ou OpenSi E-Commerce : la suite logicielle de comptabilité et de gestion commerciale exposant sur internet des services web pour se connecter à un site ou une application Service_id : lʼidentifiant unique du commerçant pour utiliser les services web OpenSi E-Commerce. Ce champs est de type numérique (fourni par Speedinfo) Code_site_web : le code du site e-commerce dans OpenSi E-Commerce, champ de 5 caractères alphanumériques (paramétré dans OpenSi E-Commerce par le commerçant) Produit parent : un produit qui contient dʼautres produits (par exemple un pack contentant 1 t-shirt + 1 pull) Produit enfant : les produits contenus dans un produit (par exemple, le t-shirt et le pull sont des produits enfant du pack) Guide de lʼutilisateur OpenSi Connect pour Magento" Page 5 sur 35
Fonctionnement du module Format dʼéchange des données Le module «OpenSi Connect» fonctionne via des services web (ou WebServices) REST. Ces services web permettent dʼéchanger des données au travers de messages au format XML via le protocole HTTP. Pour plus dʼinfomations concernant les services web : http://fr.wikipedia.org/wiki/service_web Sécurité des échanges Afin d'assurer la sécurité et la confidentialité des données échangées, les connexions au serveur de services web s'effectuent selon le protocole standard HTTPS. Lʼaccès aux services web est protégé par une authentification HTTP BASIC par login et mot de passe. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 6 sur 35
Installation du module Le module OpenSi Connect est disponible sur le site Magento Connect : http://www.magentocommerce.com/magento-connect/speedinfo/extension/5076/speedinfo_opensi Récupération de la clé dʼinstallation Magento Pour récupérer la clé dʼinstallation Magento, rendez-vous à cette adresse http://www.magentocommerce.com/magento-connect/speedinfo/extension/5076/speedinfo_opensi et cliquez sur «Get Extension Key» et copiez la clé dans votre presse-papier. NB : vous devez possédez un compte (gratuit) afin de la récupérer. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 7 sur 35
Saisie de cette clé dans le backoffice Magento Vous devez maintenant saisir cette clé dans le backoffice Magento Pour cela, allez dans «System» / «Magento Connect» / «Magento Connect Manager» Guide de lʼutilisateur OpenSi Connect pour Magento" Page 8 sur 35
Installez la clé en suivant les instructions à lʼécran. Vider la cache du site Magento Videz maintenant le cache des fichiers du site Magento. Pour cela, allez dans «System» / «Cache management» / «Refresh» Guide de lʼutilisateur OpenSi Connect pour Magento" Page 9 sur 35
Sur la ligne de titre grisée, cliquez sur «Select All». Sur cette même ligne de titre, sélectionnez «Refresh» dans la liste déroulante puis cliquez sur le bouton «Submit». Le module est installé! Un onglet OpenSi est désormais disponible dans le menu du backoffice. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 10 sur 35
Interface de configuration du module web Onglet «OpenSi» / «Configuration» Les codes dʼaccès vous sont fournis par Speedinfo. La configuration permet de gérer les éléments suivants : Paramétrage du Service_id, identifiant commerçant dʼaccès aux services OpenSi Paramétrage du login HTTP, l'identifiant de l'utilisateur des services web Paramétrage du mot de passe http de l'utilisateur des services web Paramétrage du Code_site_web (identifiant du site dans OpenSi) Paramétrage du code dépôt de stock (identifiant du dépôt dans OpenSi) Configuration des fréquences dʼappel de chaque service web Guide de lʼutilisateur OpenSi Connect pour Magento" Page 11 sur 35
Définitions des flux dʼinformation entre Magento et OpenSi Ci-dessous l'ensemble des services web disponibles, qui permettent d'échanger des informations entre votre site et OpenSi E-Commerce, sont décrits ainsi que le sens du flux. Les champs obligatoires en création sont notés en caractères gras Les champs obligatoires en modification sont notés en caractères gras et soulignés En modification, seuls les champs présents sont modifiés Figure 1 : Définition des flux OpenSi site e-commerce Le bloc ERP correspond à OpenSi. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 12 sur 35
Création dʼarticles Basé sur la version 1.4.1.1 de Magento Dans ce chapitre, nous allons voir comment créer de nouveaux articles sur le site web (Magento). La création de nouveaux articles sʼeffectue uniquement sur le site web (Magento). Les informations sont ensuite remontées par le module OpenSi Connect dans OpenSi E-Commerce. Nous partons du principe que seuls les champs obligatoires sont remplis (nous ne nous occupons pas des images par exemple). Bonnes pratiques Lors de la création dʼun nouvel article, il faut toujours penser à remplir les champs suivants : Le website (ou site web) La famille (attribut à créer) Les prix (prix de vente et prix dʼachat) Le stock Attention, si un stock est renseigné dans Magento, il est vivement conseillé de renseigner un prix d'achat. Sinon la valorisation du stock sera fausse dans OpenSi et il ne sera plus possible de la modifier par la suite. Attention : La création de lʼattribut famille et de son renseignement nʼest pas obligatoire dans Magento. Si la famille nʼest pas renseignée, la mention NC sera ajoutée dans la fiche article OpenSi. Afin dʼillustrer au mieux le guide dʼutilisation, nous fournissons tout au long de ce guide des exemples de pratiques liées à une activité e-commerce de vêtements (par exemple des produits avec une gestion de taille, couleur ) Il est bien entendu que OpenSi peut aussi sʼadapter à des activités e-commerce différentes. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 13 sur 35
Création de nouveaux attributs sous Magento Pour optimiser pleinement le fonctionnement entre OpenSi et Magento, vous devez créer des attributs personnalisés (14 attributs différents) qui nʼexistent pas par défaut dans Magento (valable pour tous les types de produits). Liste des attributs personnalisés à créer : Sur la base de notre exemple (boutique de vêtements), les attributs à créer seraient : Liste des attributs personnalisés N Type dʼattribut Nom possible de lʼattribut Exemple 1 Famille1 Famille T-Shirt 2 Famille2 Sous famille T-Shirts manches courtes 3 Famille3 Sous sous famille 4 Attribut1 Couleur Jaune, vert, bleu 5 Attribut2 Taille S, M, L, XL 6 Attribut3... 7 Attribut4... 8 Attribut5... 9 Attribut6... 10 CodeEAN CodeEAN 1234567890123 11 Longueur (en mètre) Longueur 12 Largeur (en mètre) Largeur 13 Hauteur (en mètre) Hauteur 14 Volume (en mètre cube - m3) Volume Récapitulatif des champs synchronisables en Magento et OpenSi Tous les champs nommés ci-dessous sont envoyés de Magento vers OpenSi lors de la création dʼun nouvel article. N Description Type Article 1 Référence article Chaine de 40 caractères au maximum 2 Désignation Chaine de 100 caractères au maximum Guide de lʼutilisateur OpenSi Connect pour Magento" Page 14 sur 35
3 Statut de publication Valeurs possibles : «activé» ou «désactivé» 3 Taux de TVA pour la France Liste déroulante 4 Description 1 Texte de longueur indéterminée 5 Description 2 Texte de longueur indéterminée 6 Marque Fabricant Chaine de 40 caractères au maximum 7 Stock Nombre décimal de 10 chiffres au total dont 3 chiffres après la virgule 8 Famille 1 Chaine de 40 caractères au maximum 9 Famille 2 Chaine de 40 caractères au maximum 10 Famille 3 Chaine de 40 caractères au maximum 11 Attribut 1 Chaine de 40 caractères au maximum 12 Attribut 2 Chaine de 40 caractères au maximum 13 Attribut 3 Chaine de 40 caractères au maximum 14 Attribut 4 Chaine de 40 caractères au maximum 15 Attribut 5 Chaine de 40 caractères au maximum 16 Attribut 6 Chaine de 40 caractères au maximum 17 Tarif 1 HT (en ) 18 Tarif 1 TTC (en ) 19 Prix dʼachat (en HT) Nombre décimal de 14 chiffres au total dont 4 chiffres après la virgule Nombre décimal de14 chiffres au total dont 4 chiffres après la virgule Nombre décimal de14 chiffres au total dont 4 chiffres après la virgule 20 Code barre EAN Chaine de 15 caractères au maximum 21 Poids brut en kg Nombre décimal de10 chiffres au total dont 3 chiffres après la (poids total avec lʼemballage) virgule Nombre décimal de6 chiffres au total dont 2 chiffres après la 22 Volume en m 3 virgule 23 Hauteur en m Nombre décimal de6 chiffres au total dont 2 chiffres après la virgule 24 Longueur en m Nombre décimal de6 chiffres au total dont 2 chiffres après la virgule 25 Largeur en m Nombre décimal de6 chiffres au total dont 2 chiffres après la virgule Guide de lʼutilisateur OpenSi Connect pour Magento" Page 15 sur 35
Création dʼun produit simple Catalog Manage Products Catalogue Gérer les produits La création dʼun nouvel article (type simple) sʼeffectue directement sur le site web (Magento). Nous partons du principe que si votre produit simple contient des attributs, ces derniers auront déjà été créé auparavant. Onglet «General» (ou «Général») Remplissez les champs obligatoires : Name, SKU, Weight, Status et visibility Onglet «Description» (ou «Description») Remplissez les champs : Description, Short Description Onglet «Prices» (ou «Prix») Rentrez les prix : Price, Cost et Tax Class Onglet «Inventory» (ou «Inventaire») Remplissez le champ obligatoire «Qty» et passez le «Stock Availability» à «In Stock» Guide de lʼutilisateur OpenSi Connect pour Magento" Page 16 sur 35
Onglet «Categories» (ou «Catégories») Sélectionnez la ou les catégories dans laquelle le nouvel article doit se retrouver sur le site web. ATTENTION : Le renseignement dʼune catégorie nʼest pas obligatoire dans Magento mais vous devez la remplir si vous voulez retrouvez votre produit sur le site web (Magento). Sauvegardez votre produit. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 17 sur 35
Que se passe-t-il maintenant? Une fois votre produit sauvegardé, le module OpenSi Connect va créer votre produit dans OpenSi (sous condition que celui-ci nʼexiste pas encore). Attention, veuillez prendre note que lors de la création dʼun article, tous les champs sont envoyés à OpenSi. Cela signifie que les prix (prix de vente, prix dʼachat) ainsi que les stocks doivent être bien renseignés. Si vous devez modifier ces derniers, vous ne pourrez plus le faire directement sur le site web (Magento) mais directement dans OpenSi. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 18 sur 35
Création dʼun produit configurable Catalog Manage Products Catalogue Gérer les produits La création dʼun nouvel article (type configurable) sʼeffectue directement sur le site web (Magento). Nous partons du principe que vous avez déjà créé les attributs que vous utiliserez pour créer votre produit. Onglet «General» (ou «Général») Remplissez les champs obligatoires : Name, SKU, Weight, Status et visibility Onglet «Description» (ou «Description») Remplissez les champs : Description, Short Description Onglet «Prices» (ou «Prix») Rentrez les prix : Price et Tax Class Onglet «Inventory» (ou «Inventaire») Passez le «Stock Availability» à «In Stock» Guide de lʼutilisateur OpenSi Connect pour Magento" Page 19 sur 35
Onglet «Associated Products» (ou «Produits associés») Sélectionnez les produits à associer à votre produit configurable. Sauvegardez votre produit. Que se passe-t-il maintenant? Une fois votre produit configurable sauvegardé, le module OpenSi Connect va créer uniquement les produits «enfants» dans OpenSi. En effet, le produit configurable étant un produit «virtuel» dépendant du stock des produits enfants, celui-ci nʼest pas créé dans OpenSi. De la même manière que les produits simples, lors de la création dʼun article, tous les champs sont envoyés à OpenSi. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 20 sur 35
Création dʼun produit de type «bundle» Catalog Manage Products Catalogue Gérer les produits La création dʼun nouvel article (type bundle) sʼeffectue directement sur le site web (Magento). Nous partons du principe quʼun produit de type «bundle» est un produit qui contient dʼautres produits enfants, qui formeront le contenu du produit parent. Par exemple, vous vendez à lʼunité 1 t-shirt à 15 et 1 pull à 30, et vous voulez créer un pack qui contiendra ces 2 articles pour 40 (au lieu de 45 ). Dans l" a version actuelle OpenSi, seule les options de création expliquées ci dessous permettent une synchronisation des bundles entre Magento et OpenSi. Nous partons du principe que les quantités et options du bundle sont imposés au client. En cas de non respect de ce mode de fonctionnement, le traitement des commandes ainsi que le suivi des stocks ne pourraient être assuré de manière optimale. Il faut donc bien faire attention lors de la création de ce type de produits et toujours vérifier que les champs «obligatoire» et «Quantité définie par lʼutilisateur» soient respectivement «Oui» et «Non» (Nous y reviendrons plus tard dans le document) Onglet «General» (ou «Général») Remplissez les champs obligatoires : Name, SKU, Weight, Status et visibility. Une des particularités des produit «bundle» est que le SKU et le poids peuvent être rendu dynamique (à partir des produits qui composeront le bundle). Dans notre exemple, nous changerons le SKU (passage de dynamique à Fixed) et nous lui attribuerons une valeur. Nous laisserons à lʼinverse le champs «Weight» en dynamique. Onglet «Description» (ou «Description») Remplissez les champs : Description, Short Description Guide de lʼutilisateur OpenSi Connect pour Magento" Page 21 sur 35
Onglet «Prices» (ou «Prix») Rentrez les prix : Price et Tax Class Onglet «Inventory» (ou «Inventaire») Passez le «Stock Availability» à «In Stock» Onglet «Bundle items» (ou «Articles packagés») Sélectionnez les produits qui composeront le bundle. Etape 1 : Premièrement, cliquez sur «Add New Option» (ou «Ajouter une option»). Le bloc suivant apparait à l'écran. Etape 2 : Vérifiez bien que le champ «Is Required» (ou «Obligatoire») est «Oui». Cliquez sur «Add selection» (ou «Ajouter une sélection»). Le bloc devient : Etape 3 : Recherchez les produits que vous souhaitez ajouter pour configurer votre produit bundle. Attention, nʼen sélectionnez quʼun seul et cliquez sur «Add Selected Product(s) to Option» (ou «Ajouter les produits sélectionnés à lʼoption») Guide de lʼutilisateur OpenSi Connect pour Magento" Page 22 sur 35
Vous devriez avoir à l'écran : Veuillez noter également lʼimportance de passer le champ «User Defined Qty» (ou «Quantité définie par lʼutilisateur») à «Non» Pour inclure dʼautres produits dans votre produit configurable, vous devez repartir de lʼétape 1 et répéter cette action autant de fois quʼil y a de produits enfants. Une fois votre produit bundle créé, il devrait ressembler à ceci : Guide de lʼutilisateur OpenSi Connect pour Magento" Page 23 sur 35
Sauvegarder votre produit bundle. Que se passe-t-il maintenant? Une fois votre produit bundle sauvegardé, le module OpenSi Connect va créer tous les produits, le parent ainsi que les enfants dans OpenSi. De la même manière que les produits simples, lors de la création dʼun article, tous les champs sont envoyés à OpenSi. Ensuite vous devez aller dans OpenSi pour rattacher les produits enfants aux parents. Dans OpenSi, allez dans : «Stocks» / «Articles», rechercher votre produit parent (le bundle). Une fois sur sa fiche article, il faut changer «la composition de lʼarticle» en «forfait». Guide de lʼutilisateur OpenSi Connect pour Magento" Page 24 sur 35
Un nouvel onglet «composition» apparait en haut, cliquez dessus. En bas de la fenêtre, sélectionnez le nom de la famille du produit concerné. Les produits que vous avez créé sur le site web (Magento) vont être affichés dans le bloc de gauche. Passez les à droite (avec la même quantité que définie dans le site web (Magento)) et sauvegardez. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 25 sur 35
Vous avez terminé la création dʼun produit «bundle». Guide de lʼutilisateur OpenSi Connect pour Magento" Page 26 sur 35
Création dʼun produit de type «grouped» Catalog Manage Products Catalogue Gérer les produits La création dʼun nouvel article (type groupé) sʼeffectue directement sur le site web (Magento). La procédure à suivre est la même que celle dʼun produit configurable. Le produit groupé nʼest pas créé dans OpenSi. Seuls les produits enfants le sont (à condition quʼils nʼexistent pas sous OpenSi). Guide de lʼutilisateur OpenSi Connect pour Magento" Page 27 sur 35
Création dʼun produit de type «Downloadable» ou «Virtual» Catalog Manage Products Catalogue Gérer les produits La création dʼun nouvel article (type downloadable ou virtual) sʼeffectue directement sur le site web (Magento). La procédure à suivre est la même que celle dʼun produit simple. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 28 sur 35
Modification dʼarticle La mise à jour dʼun article en fonction des champs à modifier sʼeffectue soit sur dans le back office de Magento soit sur OpenSi E-Commerce. Dans OpenSi, l article est mis à jour sous condition que la référence de l article existe dans OpenSi. D : champ disponible ND : champ non disponible N Disp Description Magento Description OpenSi Article Type Sens de synchronisation 1 D General - Name Désignation Chaine de 100 caractères au maximum Magento => OpenSi 2 D General - SKU Référence du Chaine de 40 caractères au produit maximum Magento => OpenSi 3 D General - Poids brut en kg Nombre décimal de10 chiffres (poids total avec au total dont 3 chiffres après la Magento => OpenSi Weight lʼemballage) virgule 4 D Web / Publication Valeur possible : «activé» ou General - Status web «désactivé» Magento => OpenSi 5 D General - Tax Taux de TVA pour Liste déroulante Class le France Magento => OpenSi 6 D General - Manufacturer 7 D Price - Price Marque Tarif 1 HT - Tarif 1 TTC 8 D Price - Cost Prix achat HT 9 D Description - Description Description - 10 D Short Description 11 D Inventory - Qty 12 D Inventory - Stock Availability 14 D Famille 1 15 D Famille 2 16 D Famille 3 17 D Attribut 1 18 D Attribut 2 19 D Attribut 3 20 D Attribut 4 Description 1 Description 2 Quantité en stock disponible Chaine de 40 caractères au Magento => OpenSi maximum Nombre décimal de14 chiffres au total dont 4 chiffres après la OpenSi => Magento virgule Nombre décimal de14 chiffres au total dont 4 chiffres après la OpenSi => Magento virgule Texte de longueur indéterminée Magento => OpenSi Texte de longueur indéterminée Magento => OpenSi Liste déroulante Chaine de 40 caractères au maximum Chaine de 40 caractères au maximum Chaine de 40 caractères au maximum Chaine de 40 caractères au maximum Chaine de 40 caractères au maximum Chaine de 40 caractères au maximum Chaine de 40 caractères au maximum OpenSi => Magento Magento => OpenSi Magento => OpenSi Magento => OpenSi Magento => OpenSi Magento => OpenSi Magento => OpenSi Magento => OpenSi Guide de lʼutilisateur OpenSi Connect pour Magento" Page 29 sur 35
21 D Attribut 5 22 D Attribut 6 23 D Code barre EAN 24 D Poids brut en kg (poids total avec lʼemballage) Chaine de 40 caractères au maximum Chaine de 40 caractères au maximum Chaine de 15 caractères au maximum Nombre décimal de10 chiffres au total dont 3 chiffres après la virgule Magento => OpenSi Magento => OpenSi Magento => OpenSi Magento => OpenSi 25 D Volume en m 3 total dont 2 chiffres après la Magento => OpenSi Nombre décimal de6 chiffres au virgule Nombre décimal de6 chiffres au 26 D Hauteur en m total dont 2 chiffres après la Magento => OpenSi virgule Nombre décimal de6 chiffres au 27 D Longueur en m total dont 2 chiffres après la Magento => OpenSi virgule Nombre décimal de6 chiffres au 28 D Largeur en m total dont 2 chiffres après la virgule Magento => OpenSi Modification des informations de base dʼune fiche article La modification dʼarticle sʼeffectue sur le site web (Magento). Sous OpenSi, toutes les informations sont mises à jour SAUF les prix de vente et prix dʼachat ainsi que les stocks. Modification de prix La modification de prix (tarifs de vente de base et tarifs dʼachats) doit nécessairement sʼeffectuer sous OpenSi ( OpenSi est considéré comme «le maître» à ce niveau).opensi mettra à jour ces informations sur le site web. En cas de modification de ces informations sous Magento, celles-ci ne seront donc pas reprises dans OpenSi. Ces modifications seront automatiquement remplacées par celles contenues dans Opensi. Modification des stocks La modification des stocks doit nécessairement sʼeffectuer sous OpenSi ( OpenSi est considéré comme «le maître» à ce niveau).opensi mettra à jour ces informations sur le site web. En cas de modification de ces informations sous Magento, celles-ci ne seront donc pas reprises dans OpenSi. Ces modifications seront automatiquement remplacées par celles contenues dans Opensi. Modification du SKU Attention, si une modification de SKU doit être effectuée, un nouveau produit sera recréé. Ceci est dû au fait que dans Magento, lʼid de lʼarticle nʼest pas le SKU (qui peut ensuite être modifié). Sous OpenSi, lʼid de lʼarticle est le SKU. Guide de lʼutilisateur OpenSi Connect pour Magento" Page 30 sur 35
Gestion des comptes client (Site vers OpenSi) Création dʼun compte client web (Site vers OpenSi) La création de clients a lieu sur le site web. Lorsquʼun client est créé sur le site web, il est envoyé à OpenSi pour création. Le client est créé dans OpenSi sous condition que ce client nʼexiste pas déjà pour ce site web. Mise à jour dʼun compte client web (Site vers OpenSi) Lorsquʼun client est mis à jour sur le site web, il est envoyé à OpenSi pour mise à jour. Le client est modifié dans OpenSi sous condition que ce client existe pour ce site web. Clients Web N Disp Description Type 1 D Code site web dans OpenSi Chaîne de 5 caractères au maximum 2 D Login Chaîne de 60 caractères au maximum 3 ND Civilité Disponible en prochaine version 4 D Nom** Chaîne de 30 caractères au maximum 5 D Prénom Chaîne de 30 caractères au maximum 6 D Société** Chaîne de 50 caractères au maximum 8 D Téléphone Chaîne de 20 caractères au maximum 9 D Fax Chaîne de 20 caractères au maximum 10 D E-mail Chaîne de 60 caractères au maximum ** sont obligatoires soit Nom, soit Societé Création dʼune commande client web (Site vers OpenSi) Lorsquʼune commande est faite par un client sur le site web, elle est envoyée à OpenSi pour création. Dans OpenSi la commande est créée à lʼétat «non validée», sous condition que son numéro nʼexiste pas déjà pour ce site web. Le compte client web, le mode dʼexpédition et le mode de règlement seront créés sʼils nʼexistent pas. La commande envoyée à OpenSi contient les champs suivants : Guide de lʼutilisateur OpenSi Connect pour Magento" Page 31 sur 35
Commande N Disp Description Type 1 D N Commande sur le site web Chaîne de 20 caractères au maximum 2 D Code site web dans OpenSi Chaîne de 5 caractères au maximum 3 D Login Chaîne de 60 caractères au maximum 4 D Date commande Date 5 D Edition_TTC true ou false (TTC ou HT) 6 D Mode d'expédition Chaîne de 30 caractères au maximum 7 D Frais de port 8 D 9 D Taux de TVA applicable sur les frais de port Remise en % sur la commande complète Nombre décimal de 10 chiffres au total dont 2 chiffres après la virgule Nombre décimal de 4 chiffres au total dont 2 chiffres après la virgule Nombre décimal de 5 chiffres au total dont 2 chiffres après la virgule 10 D Mode de règlement Chaîne de 25 caractères au maximum 11 ND Civilité facturation 12 D Nom facturation** Chaîne de 30 caractères au maximum 13 D Prénom facturation Chaîne de 30 caractères au maximum 14 D Société facturation** Chaîne de 50 caractères au maximum 15 D Ligne adresse 1 facturation Chaîne de 80 caractères au maximum 16 D Ligne adresse 2 facturation Chaîne de 50 caractères au maximum 17 D Ligne adresse 3 facturation Chaîne de 50 caractères au maximum 18 D Code postal facturation Chaîne de 10 caractères au maximum 19 D Ville facturation Chaîne de 50 caractères au maximum 20 D Code pays facturation Chaîne de 2 caractères 21 D Téléphone facturation Chaîne de 20 caractères au maximum 22 D Fax facturation Chaîne de 20 caractères au maximum 23 D E-mail facturation Chaîne de 60 caractères au maximum 24 ND Civilité livraison 25 D Nom livraison** Chaîne de 30 caractères au maximum 26 D Prénom livraison Chaîne de 30 caractères au maximum 27 D Société livraison** Chaîne de 50 caractères au maximum Guide de lʼutilisateur OpenSi Connect pour Magento" Page 32 sur 35
28 D Ligne adresse 1 livraison Chaîne de 80 caractères au maximum 29 D Ligne adresse 2 livraison Chaîne de 50 caractères au maximum 30 D Ligne adresse 3 livraison Chaîne de 50 caractères au maximum 31 D Code postal livraison Chaîne de 10 caractères au maximum 32 D Ville livraison Chaîne de 50 caractères au maximum 33 D Code pays livraison Chaîne de 2 caractères 34 D Téléphone livraison Chaîne de 20 caractères au maximum 35 D Fax livraison Chaîne de 20 caractères au maximum 36 D E-mail livraison Chaîne de60 caractères au maximum 37 D Complément d'information livraison (code porte, étage, bâtiment, consigne au livreur ) Chaîne de 100 caractères au maximum 38 D Etat de la commande Voir statut des commandes 39 D Statut logistique Voir statut des commandes 40 D N Commande Chaîne de 11 caractères au maximum ** sont obligatoires soit Nom_Liv, soit Societe_Liv / soit Nom_Fact, soit Societe_Fact Ligne dʼune commande N Disp Description Type 1 D Référence article Chaîne de 40 caractères au maximum 2 D Désignation Chaîne de 100 caractères au maximum 3 D Quantité Nombre décimal de 10 chiffres au total dont 3 chiffres après la virgule 4 D Prix unitaire HT ou TTC (selon le Nombre décimal de 14 chiffres au total dont 4 chiffres champs Edition_TTC de la après la virgule commande qui est à true ou false) 5 D Remise en % sur lʼarticle Nombre décimal de 5 chiffres au total dont 2 chiffres après la virgule 6 D Taux de TVA Nombre décimal de 4 chiffres au total dont 2 chiffres après la virgule Guide de lʼutilisateur OpenSi Connect pour Magento" Page 33 sur 35
Création d'une transaction bancaire (Site vers OpenSi) Lorsque le site web reçoit la confirmation de paiement dʼune commande de la part de sa banque, la confirmation de paiement est envoyée à OpenSi pour création d'une transaction bancaire (règlement) sur la commande web spécifiée, sous condition que le numéro de pièce n'existe pas déjà pour cette commande. La commande concernée sera alors validée. Le mode de règlement sera créé s'il n'existe pas. ATTENTION : Le numéro de transaction bancaire ne peut être envoyé à OpenSi (il est différent pour chaque module de paiement). Le numéro de commande est indiqué à la place pour faciliter le rapprochement. Transactions bancaires/commandes N PP Description Type 1 D Code site web dans OpenSi Chaîne de 5 caractères au maximum 2 D N Commande sur le site web Chaîne de 20 caractères au maximum 4 D Mode de règlement Chaîne de 25 caractères au maximum 5 D Date de la transaction Date 6 D Montant de la transaction Nombre décimal de 14 chiffres au total dont 2 chiffres après la virgule Récupération des états de commande (OpenSi vers Site) Les états des commandes sur le site web sont mis à jour régulièrement avec ceux dʼopensi. Etats de commandes d'opensi Dans OpenSi, lʼétat dʼune commande peut changé. La commande est créée à lʼétat «non validé» et peut passer à lʼétat «validée», puis «clôturée» ou «annulée». Afin d'établir les correspondances des états de commande dans OpenSi et sur votre site web, nous vous communiquons ci-dessous les valeurs des différent états (ou statuts) des commandes dans OpenSi qui vous seront données dans les réponses des services web. Lorsqu'un changement d'état de commande est remonté d'opensi sur le site, il est possible d'utiliser le système d'envoi de mail du site pour informer le client du changement de statut de sa commande. Etats de commandes d'opensi Correspondance Magento Etats OpenSi Non Validée Validée Annulée Clôturée Etats Magento (Pending) En Attente (Processing) En cours de traitement (Canceled) Annulée (Complete) Terminée Guide de lʼutilisateur OpenSi Connect pour Magento" Page 34 sur 35