Piloter Prestashop avec OpenERP

Release 1.0

Simon ANDR, Anybox

September 18, 2012

CONTENTS

Introduction 1.1 Prestashop . . . . . . . . . . . . 1.2 OpenERP . . . . . . . . . . . . . 1.3 Connecteur Prestashop OpenERP 1.4 Open-source . . . . . . . . . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

3 3 3 3 4 5 5 5 5 6 6 15 15 15 16 19 19 20 23

Installation de Prestashop 1.5 2.1 Prrequis . . . . . . . . . . . . . . . . 2.2 Mise en place de lenvironnement web 2.3 Mise en place de la base de donnes . . 2.4 Assistant dinstallation . . . . . . . . . 2.5 Conguration web service . . . . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

Installation dOpenERP grce la recipe Anybox 3.1 Prrequis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.2 Installation dOpenERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.3 Conguration du connecteur OpenERP Prestashop . . . . . . . . . . . . . . . . . . . . . . . . . . . Test Fonctionnel 4.1 Un rfrentiel de Prestashop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.2 Un magasin (shop) Prestashop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conclusion

ii

Piloter Prestashop avec OpenERP, Release 1.0

Infos sur ce document version : 1.0 (sept 2012) Auteur : Simon ANDR, septembre 2012 Contributeurs : Christophe Combelles Licence : Creative Commons 3.0 By-Sa propos dAnybox Anybox est spcialise dans les applications dentreprise, grce une expertise sur le logiciel OpenERP. Grce cet outil innovant, nous rpondons vos besoins applicatifs les plus varis, depuis la CRM, jusqu la comptabilit gnrale ou analytique, gestion de stock, gestion de projet, SAV, facturation, achats, RH, etc. Anybox sest construit autour de fortes comptences techniques et son quipe vous assure un niveau de prestation exceptionnel. Notre politique interne sarticule autour de deux axes : une gestion des comptences et une dmarche qualit . Ces deux axes servent de support aux prestations que nous proposons. Retrouvez-vous sur notre site http://anybox.fr

CONTENTS

Piloter Prestashop avec OpenERP, Release 1.0

CONTENTS

CHAPTER

ONE

INTRODUCTION
1.1 Prestashop
Prestashop est une solution de-commerce en PHP, dploye mondialement et populaire pour une certaine simplicit et facilit dutilisation. Historiquement Prestashop est ne en 2005, et t mise en production pour les premires fois en 2007. Se dotant dun code robuste, la solution a su voluer au fur et mesure des versions pour fournir les principaux services ncessaires la vente en ligne. Protant dun design adaptable grce des templates, un code modulaire, et une communaut importante, cette solution permet un support et une stabilit sans prcdent dans le monde de le-commerce.

1.2 OpenERP
OpenERP est une solution libre de progiciel de gestion intgr supportant entre autres la CRM, gestion des stocks, gestion des achats, gestion comptable, comptabilit analytique, ressource humaine, gestion de point de vente. Projet ne dans les annes 2005 sous le nom TinyERP, OpenERP est devenue une solution incontournable dans un march assez ferm. De grandes entreprises ont dj fait le pas. Lergonomie est rgulirement revue grce une politique de retour et danalyse des tches effectues sur lERP. Le choix dun langage de programmation comme Python lui permet dtre la hauteur de tous les ds.

1.3 Connecteur Prestashop OpenERP

Lutilisation de solution de-commerce traditionnelle peut vite trouver ses limites lorsque les besoins en entreprise sont spciques et varis. Cest pourquoi de nombreuses entreprises se tournent vers une synchronisation entre leurs diffrents postes de vente (ici internet) et leur logiciel de gestion. Pour permettre une bonne intgration de ces diffrents composants, il faut travailler avec les meilleurs outils, car lincidence sur la performance de lentreprise peut tre cruciale. Loutil, dvelopp principalement par les socits Akretion et Camp-to-Camp, permet par le web service de Prestashop la synchronisation du catalogue, des commandes, des clients, des stocks. Les diffrents paramtrages type taxes, pays, monnaie, peuvent tre aussi synchroniss. Prestashop est reconnu sous forme dinstance et plusieurs Prestashop peuvent tre mis en relation avec OpenERP, ainsi que dautres solutions de-commerce ou de point de vente. Les avantages peuvent tre multiples, de la gestion clientle, gestion des achats, gestion de stock, gestion comptable. Ce type de module est aussi trs utilis dans les commerces B2B an de permettre davoir diffrentes plateformes de vente.

Piloter Prestashop avec OpenERP, Release 1.0

Figure 1.1: synchronisation par Web service

1.4 Open-source
Tous les composants utiliss pour cette dmonstration pratique sont sous des licences open-sources. Cela permet doffrir les outils la pointe de linnovation technologique, et un pouvoir daction trs important aux programmeurs qui dveloppent ces solutions. La qualit de lintgration est ici primordiale car elle dpend fortement des moyens mis en place. Le suivi de projet et des tests rguliers dintgration permettent darriver une couverture importante des besoins des entreprises.

Chapter 1. Introduction

CHAPTER

TWO

INSTALLATION DE PRESTASHOP 1.5

2.1 Prrequis
An de mener un installation de Prestashop 1.5, il vous faut un espace dhbergement PHP >= 5 et une base de donnes Mysql > 5. Vous pouvez vous procurer aussi des solutions dinstallation locales grce un serveur web adapt votre systme dexploitation. Ici linstallation se fera avec Apache comme serveur web et mod_php. La distribution utilise est une Debian Squeeze, trs rpandue dans le monde des serveurs web.

2.2 Mise en place de lenvironnement web

Prestashop se rcupre directement sous forme darchive sur le site web de lentreprise ditrice cette adresse : http://www.prestashop.com/fr/versions-developpeurs Ou pour les dveloppeurs une version SVN existe cette URL : http://svn.prestashop.com/branches/1.5.x/ Vous devez dcompresser larchive rcupre la racine de votre serveur web, sur une debian /var/www/ Pour la version SVN une copie de la version exporte sera sufsante.

2.3 Mise en place de la base de donnes

Les conditions daccs de votre hbergeur doivent permettre de crer une base avec un utilitaire comme PHPMyAdmin. Pour notre exemple nous allons utiliser des donnes dauthentication gnriques avec un nom dutilisateur identique au nom de la base. USER : prestashop PASSWORD :**** DATABASE : prestashop Ce qui nous donne en SQL
CREATE USER prestashop@localhost IDENTIFIED BY ***; GRANT USAGE ON * . * TO prestashop@localhost IDENTIFIED BY *** WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;

Piloter Prestashop avec OpenERP, Release 1.0

CREATE DATABASE IF NOT EXISTS prestashop ; GRANT ALL PRIVILEGES ON prestashop . * TO prestashop@localhost;

IDENTIFIED BY *** : remplacer les astrisques par le mot de passe de votre base. ATTENTION cette requte ne prend pas en compte la scurit de votre installation. Peut tre utilis titre de dmonstration.

2.4 Assistant dinstallation

Une fois le serveur web congur et lanc, vous pouvez valider votre installation grce votre navigateur web, lURL de votre serveur. Votre requte devrait tre redirige automatiquement vers lassistant dinstallation Prestashop. Remarque: pour la version SVN il faut rajouter lURL de votre site install-dev/ La suite de linstallation vriera la conguration de votre hbergement. Ensuite vient la conguration de la base de donnes Ensuite diverses infos utiles pour votre boutique Ensuite la procdure de scurit exige la suppression du rpertoire install/ la racine de votre serveur web, ainsi que le changement de nom du rpertoire admin/, en par exemple backofce/. Pour nir il faut crer un chier .htaccess la racine du serveur web avec des droits daccs sufsants pour que PHP puisse diter ce chier. Vous devriez maintenant avoir une version fonctionnelle de Prestashop votre disposition.

2.5 Conguration web service

An dtablir la communication entre Prestashop et OpenERP, Prestashop va tre accessible en coute travers un service web qui par dfaut est lURL : http://www.monsite.com/api La documentation sur cette API est accessible sur le site de Prestashop. Pour congurer de faon basique cette API nous allons utiliser linterface dadministration Prestashop dont vous devez connatre maintenant lURL. Attention: il faut bien penser activer le web service en plus de la cration de la cl.

Chapter 2. Installation de Prestashop 1.5

Piloter Prestashop avec OpenERP, Release 1.0

Figure 2.1: Assistant dinstallation Prestashop

2.5. Conguration web service

Piloter Prestashop avec OpenERP, Release 1.0

Chapter 2. Installation de Prestashop 1.5 Figure 2.2: Vrication des prrequis systme

Piloter Prestashop avec OpenERP, Release 1.0

Figure 2.3: Conguration de la base de donnes

2.5. Conguration web service

Piloter Prestashop avec OpenERP, Release 1.0

Figure 2.4: Conguration de la boutique

10

Chapter 2. Installation de Prestashop 1.5

Piloter Prestashop avec OpenERP, Release 1.0

Figure 2.5: Conguration service web Prestashop Ensuite il faut gnrer le chier .htaccess pralablement cr. lenregistrement de cette page : Le chier est automatiquement gnr aprs

Si votre chier.htaccess est correctement gnr, vous pouvez tester votre web service travers lURL http://www.monsite.com/api Un nom dutilisateur vous sera demand, cest la cl de lAPI fournie plus haut. Le mot de passe restera vide. Pour exemple vous pouvez lister les produits de votre Prestashop sur cette url http://www.monsite.com/api/products/

2.5. Conguration web service

11

Piloter Prestashop avec OpenERP, Release 1.0

Figure 2.6: Cration cl dAPI Prestashop

12

Chapter 2. Installation de Prestashop 1.5

Piloter Prestashop avec OpenERP, Release 1.0

Figure 2.7: Gnration .htaccess

2.5. Conguration web service

13

Piloter Prestashop avec OpenERP, Release 1.0

14

Chapter 2. Installation de Prestashop 1.5

CHAPTER

THREE

INSTALLATION DOPENERP GRCE LA RECIPE ANYBOX

3.1 Prrequis
OpenERP est rcuprable de diffrentes manires Vous pouvez vous rfrer la documentation ofcielle OpenERP: http://doc.openerp.com/v6.1/install/linux/index.html Un base de donnes PostgreSQL doit tre accessible par linstance dOpenERP. Les modules ncessaires linstallation du connecteur Prestashop OpenERP sont rcuprables par les dpts sur le Launchpad. https://launchpad.net/prestashoperpconnect Le nombre de dpendances tant important, nous installerons OpenERP grce la recipe buildout Anybox. http://www.buildout.org/ http://pypi.python.org/pypi/anybox.recipe.openerp/1.0.3

3.2 Installation dOpenERP

OpenERP est installable par la recipe Anybox. Cest un ensemble de scripts permettant dautomatiser le dploiement dune application Python et de son environnement. Ceci est particulirement utile an de sassurer davoir un projet dployable rapidement lidentique et sur diffrentes plateformes. Sur un systme de type Debian (ou autre distribution) il suft de crer un rpertoire avec deux chier: bootstrap.py et buildout.cfg bootstrap.py est tlchargeable sur : http://python-distribute.org/bootstrap.py Ci-dessous buildout.cfg:
[buildout] parts = openerp find-links = http://download.gna.org/pychart/ versions = versions extensions = buildout.dumppickedversions gp.vcsdevelop vcs-extend-develop = git+https://github.com/akretion/prestapyt.git#egg=prestapyt [openerp] recipe = anybox.recipe.openerp:server version = 6.1-1

15

Piloter Prestashop avec OpenERP, Release 1.0

eggs =

prestapyt requests unidecode

addons = bzr bzr bzr bzr

lp:~extra-addons-commiter/openobject-extension/oerp6.1-cleanning addons-extension last:1 lp:~extra-addons-commiter/e-commerce-addons/oerp6.1-cleanning addons-e-commerce last:1 lp:prestashoperpconnect addons-prestashop last:1 lp:~extra-addons-commiter/product-extra-addons/oerp6.1-cleanning product-extra-addons la

[versions] MarkupSafe = 0.15 Pillow = 1.7.7 PyXML = 0.8.4 babel = 0.9.6 feedparser = 5.1.1 gdata = 2.0.16 lxml = 2.3.3 mako = 0.6.2 psycopg2 = 2.4.4 pychart = 1.39 pydot = 1.0.28 pyparsing = 1.5.6 python-dateutil = 1.5 python-ldap = 2.4.9 python-openid = 2.2.5 pytz = 2012b pywebdav = 0.9.4.1 pyyaml = 3.10 reportlab = 2.5 simplejson = 2.4.0 vatnumber = 1.0 vobject = 0.8.1c werkzeug = 0.8.3 xlwt = 0.7.3 zc.buildout = 1.5.2 zc.recipe.egg = 1.3.2 zsi = 2.0-rc3

Linstallation se poursuit grce aux commandes : python bootstrap.py bin/buildout Ensuite nous lanons OpenERP grce la commande bin/start_openerp OpenERP est accessible par dfaut depuis votre navigateur web sur le port 8069: http://localhost:8069 Ensuite le menu Manage Databases nous permet de crer une base de donnes de dmonstration

3.3 Conguration du connecteur OpenERP Prestashop

Le connecteur OpenERP devrait tre dans la liste des modules installables OpenERP Le connecteur est fonctionnellement divis en deux parties. Une premire partie (prestashoperpconnect) permet la synchronisation dOpenERP avec Prestashop. Une seconde partie (prestashoperpconnect_catalog_manager) permet la gestion du catalogue disponible

16

Chapter 3. Installation dOpenERP grce la recipe Anybox

Piloter Prestashop avec OpenERP, Release 1.0

Figure 3.1: Cration base de donnes OpenERP sur la boutique Prestashop par OpenERP. Un simple clic sur le bouton Install, sufra installer les modules ncessaires au connecteur pour fonctionner.

Ensuite des assistants de conguration apparatront. Vous pouvez cliquer sur Suivant sans modier les options par dfaut dans le cadre de la dmonstration.

3.3. Conguration du connecteur OpenERP Prestashop

17

Piloter Prestashop avec OpenERP, Release 1.0

18

Chapter 3. Installation dOpenERP grce la recipe Anybox

CHAPTER

FOUR

TEST FONCTIONNEL
4.1 Un rfrentiel de Prestashop
Un fois install vous pouvez commencer mettre en place une instance de Prestashop dans OpenERP. Tout se passe dans le menu administration/PrestashopERPconnect/Prestashop Instances Pour cela vous allez renseignez votre URL de site Prestashop (location), la version de votre Prestashop (Referential version) , un nom (name) pour votre instance, et votre cl de Web service (Webservice Key) cre prcdemment sur linterface dadministration Prestashop. Un lment important ne pas oublier : la conguration des langues dans longlet Conguration !

Toujours dans la mme vue que pour linstance, longlet Referential actions Nous permet de charger les correspondances dobjet (Reload Referential Mapping Template) et ensuite lancer la synchronisation des principaux objets type pays, devises, taxes (Synchronize Referential Settings). Cette premire synchronisation est indispensable pour la plupart des autres actions. Si elle choue, vriez lurl de votre boutique ainsi que lactivation du webservice ct Prestashop. Les autres boutons permettent dimporter les principaux objets type client, produit, an de raliser un premier import des donnes dj prsentes dans linstance prestashop.

19

Piloter Prestashop avec OpenERP, Release 1.0

4.2 Un magasin (shop) Prestashop

Depuis la version 1.5 de Prestashop, le multi boutique est intgr. Donc une instance de Prestashop peut avoir plusieurs magasins avec des conditions, prix, catalogues diffrents. Lors de la cration de linstance prcdente, un shop a t automatiquement cr. Nous allons dans un autre menu : Prestashop Shop

Cest ici que les commandes, les stocks, se synchronisent. Ce menu vous permettra de congurer dans quels entrepts vos commandes sont retires, et quelle liste de prix est applique au catalogue export.

20

Chapter 4. Test Fonctionnel

Piloter Prestashop avec OpenERP, Release 1.0

4.2. Un magasin (shop) Prestashop

21

Piloter Prestashop avec OpenERP, Release 1.0

22

Chapter 4. Test Fonctionnel

CHAPTER

FIVE

CONCLUSION
Le connecteur OpenERP Prestashop est une base de travail parfaite pour tablir la communication entre un ERP et une boutique en ligne. Nous pouvons grce aux modules relier de un plusieurs Prestashop, avec des versions de Prestashop type 1.4 et 1.5. Les outils de CRM, stock, compta se trouvent beaucoup plus maniables pour une entreprise aux processus personnaliss. La compatibilit avec le module de synchronisation OpenERP -> Magento permet davoir un socle commun de gestion de ces outils e-commerce.

23