Interface Prestashop [Le wiki de Gestan]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
===== Interface Prestashop =====

{{ :wiki:addons:prestashop:logo_prestashop.png?nolink&200|}}

Ce module a été développé afin de synchroniser Gestan et une boutique Prestashop, et notamment:\\
  * Les contacts (Synchro de Prestashop vers Gestan)
  * Les produits (Synchro Bidirectionnelle)
  * Les stocks (Synchro de Gestan vers Prestashop)
  * Les commandes (Synchro de Prestashop vers Gestan)


<bootnote warning>

**Attention aux coûts d'évolution et de maintenance avec Prestashop !** \\ \\

Les évolutions de Prestashop sont fréquentes (6 nouvelles versions de Prestashop en 2023), et induisent des mise à jour de l'extension Gestan pour Prestashop à chaque modification de Prestashop. \\ \\

Cela implique de régler le Prestashop de votre site en mise à jour manuelle, afin de ne pas générer d'incompatibilité. \\ \\

La version minimum de Prestashop nécessaire est la **1.4.0.0**\\ \\
La version maximum actuellement supportée est la **1.8.2.0**\\ \\

Les évolutions de l'extension Prestashop ne sont pas incluses dans la licence initiale, les nouvelles versions de l'extension sont facturées à 50% du prix de base du module, ce qui peut conduire à un total de coût de maintenance assez conséquent. \\ \\

Comme solution alternative à Prestashop, nous recommandons [[wiki:extensv15:woocommerce|l'extension Woocommerce]], dont les fonctionnalités sont équivalentes, mais les coûts de maintenance sont bien moindres.

</bootnote>


==== Comment ça marche ? ====

Prestashop permet via des Webservices (son API), de communiquer avec lui. On peut tout voir et tout modifier: une vraie belle idée de l'équipe de Prestashop !

Heureusement, cette porte de communication n'est ouverte qu'aux détenteurs d'un précieux sésame: la clé du Webservice. Vous trouverez dans la [[https://wiki.gestan.fr/doku.php?id=wiki:extensv15:prestashop#cote_prestashop|section Paramétrage]] toutes les explications pour l'obtenir.

Cette page vous semble longue ? Rassurez-vous, c'est simplement parce qu'elle est ultra-détaillée, afin que le paramétrage soit facile !

===== Installation =====

L'installation de l'extension est effectuée via le [[wiki:v15:admin:extensions|gestionnaire d'extensions]].


===== Paramétrage =====

==== Côté Prestashop ====

Pour commencer, il vous faut créer une clé Webservice de votre boutique Prestashop : connectez-vous au BackOffice de votre boutique (votre accès réservé en tant qu'administrateur).

Passez ensuite votre souris sur l'onglet "Paramètres avancées" puis "Webservice". Une fois sur cette page, cliquez sur "Ajouter une clé de service Web".

{{:wiki:addons:webservice.png?nolink&800|Ajout d'une clé de service Web}}

Générez une clé automatiquement (améliore la sécurité comparativement à une clé saisie manuellement), puis sélectionnez toutes les cases du tableau dessous. Enregistrer, voilà, votre clé est créée !

{{:wiki:addons:webservice2.png?nolink&800| Génération de la clé}}

<WRAP center round info 60%>
Il faut au moins un produit et une famille dans Prestashop pour que la synchronisation fonctionne !
</WRAP>


==== Côté Gestan ====

Pour accéder à la fenêtre de paramétrage, sur Gestan, allez dans Outils -> Paramètres de l'application -> Paramétrage des extensions -> Connecteur Prestashop ou installez le fichier WDL fourni par ICS.

Pour la gestion des prix spéciaux, vous pouvez également placer le fichier FI_ProdTerritoire.wdw transmis par ICS et de le placer dans le répertoire "C:\Users\[votre nom d'utilisateur]\AppData\Roaming\GESTAN_15".

A l'ouverture de Gestan, il faut aller dans le menu "Outils -> Paramètres de l'application -> Etats et fenêtres de remplacement", puis, après avoir coché la case "Prendre en compte les fenêtres de remplacement", d'indiquer "FI_ProdTerritoire.wdw" dans le champ "FI Produit Fiche".


=== Onglet "Paramétrage Webservice" ===

{{:wiki:addons:prestashop:1.png?nolink&800|Paramétrage Webservice}}

  * **Adresse du serveur**: Adresse (URL) de votre boutique Prestashop
  * **Clé API**: La clé API précédemment créée

<wrap center round tip>
Ne vous cassez pas la tête ! Pour éviter les erreurs de frappe, copier-coller ces deux éléments !
</wrap>

=== Onglet "Civilités" ===

{{:wiki:addons:prestashop:2.png?nolink&800|Civilités}}

Gestan et Prestashop doivent avoir des combinaisons de civilités identiques. Celles de Gestan sont visibles sur cet onglet. Dans le menu "Clients > Titres de civilités" de Prestashop, veillez à ce que soit identique (ID et Nom).


=== Onglet "Options" ===

{{:wiki:addons:prestashop:3.png?nolink&800|Options}}

**Eléments synchronisés**

Vous pouvez choisir de synchroniser ou non les //adresses des contacts//, les //zones de commentaires//, les //numéros de téléphones// ou encore les //images de couverture// des produits.


**Attributs**

Les produits Prestashop peuvent utiliser des attributs, qu'il est plus simple d'importer pour des questions de rapidité. Si vous ne savez pas quoi faire, cliquez simplement sur ce bouton !

**Envoi**

Pour gérer les frais de transports liés à vos commandes Prestashop, vous pouvez soit sélectionner un produit déjà existant de votre base Gestan, ou utiliser un produit générique.

=== Onglet "Mappage" ===

{{:wiki:addons:prestashop:4.png?nolink&800|Mappage}}

<wrap center round info 100%>
(Un mappage est une association des données appartenant à Prestashop avec les données appartenant à Gestan, de manière à ce que que l’on puisse passer harmonieusement des premières aux secondes)
</wrap>


Avant tout, cliquez sur les deux boutons supérieurs: **Importer les familles Prestashop** et **Importer les produits Prestashop**. Pas d'inquiétude, cela ne va pas les importer dans votre base Gestan, mais dans un fichier temporaire utile à la synchronisation.\\
Une fois cette manipulation effectuée, vous pourrez mappez les familles et les produits.

{{:wiki:addons:prestashop:4a.png?nolink&800|Mappage des familles}}

Pour chaque famille Prestashop, indiquez vers quelle famille (ou sous-famille si elles sont gérées) doivent être synchronisée les produits.

<WRAP center round important 60%>
Il faut qu'une famille Prestashop soit importée (et donc qu'elle existe) et que le mappage soit fait, sans quoi vous ne verrez aucun produit dans le sens Gestan -> Prestashop
</WRAP>



=== Onglet "Divers" ===

{{:wiki:addons:prestashop:5.png?nolink&800|Divers}}

**Affichage**

Si vous ne souhaitez voir que les clients, produits ou commandes non-importés, décochez les cases correspondances. Cela permet une meilleure lisibilité.

Pour un gain de performance, vous pouvez n'afficher que l'ID des clients lors de la lecture des commandes. 

**Factures**

En plus de la création de commande, ce module peut créer automatiquement des factures si vous cochez la case correspondante. Les factures peuvent également être notées comme réglées si c'est le cas.

**Ecritures**

Dans le cas où vous créez des factures, des écritures comptables peuvent également être automatiquement créées. Il vous suffit d'entrer un compte bancaire et l'imputation souhaitée par défaut.

===== Utilisation =====

==== Généralités ====

Il existe 4 fenêtres d'import:
  * Produits
  * Stock
  * Contacts
  * Commandes

Elles fonctionnent toutes de la même manière. Vous pouvez lire la liste des éléments grâce au bouton **Lire** (//On a beaucoup réfléchi pour la dénomination de ce bouton, puis on s'est dit que c'était assez explicite finalement !//)\\
Une fois lu, les éléments s'affichent: vous pouvez sélectionner ceux que vous souhaitez importer, puis cliquer sur **Exécuter**.\\
Un bouton **Arrêter** s'affichera, vous permettant d'arrêter le traitement (//là aussi le choix du nom de bouton a été mûrement réfléchi//).

Un compte-rendu sera affiché à la fin du traitement.

{{:wiki:addons:relecture.png?nolink | Relecture}}Permet la relecture des éléments

{{:wiki:addons:select.png?nolink| Tout sélectionner}}Permet de sélectionner/désélectionner tous les éléments d'un seul clic.


==== Spécificité produits ====

{{ :wiki:addons:prestashop:7.png?nolink&800 |}}

La 1<sup>ère</sup> colonne vous permettra de sélectionner les produits à importer ou non.

La 2<sup>ème</sup> colonne comporte le nom du produit, suffixé par le mot //"Attribut"// s'il s'agit d'un produit à attributs. **Bon à savoir: chaque attribut Prestashop créé un produit dans Gestan**.

La 3<sup>ème</sup> colonne montre le prix du produit, pour une meilleure lisibilité.

Enfin, la 4<sup>ème</sup> colonne vous montre le statut du produit: **Ajout vers Gestan**, **Mise à jour Gestan**, **Mise à jour Prestashop**, **Ajout Prestashop**.

Les ligne surligné en vert sont les produits lus de Prestashop. Ceux en jaune sont ceux provenant de Gestan.

==== Spécificité stock ====

{{:wiki:addons:prestashop:9.png?nolink&800 |}}

{{:wiki:addons:yeux.png?nolink |Stock}}Permet d'afficher ou de cacher les produits non-gérés (non-synchronisés)


==== Spécificité contacts ====

{{:wiki:addons:prestashop:8.png?nolink&800|Contact}}

La 1<sup>ère</sup> colonne vous permettra de sélectionner les contacts à importer ou non.

La 2<sup>ème</sup> colonne comporte le nom du contact.

La 3<sup>ème</sup> colonne comporte le prénom du contact.

La 4<sup>ème</sup> colonne comporte l'email du contact.

Enfin, la 5<sup>ème</sup> colonne vous montre le statut du contact: **Ajout** ou **A jour**.

En cas de conflit d'adresses (plusieurs adresses pour un seul contact), une fenêtre vous permettra de sélectionner laquelle utiliser pour quoi.//

{{:wiki:addons:conflit.png?nolink&450|Conflit d'adresses}}//

Vous avez la possibilité d'afficher les adresses disponibles: les adresses sélectionnées sont surlignées en vert.


==== Spécificité commandes ====

{{:wiki:addons:prestashop:6.png?nolink&800|Commandes}}

Pour l'import des commandes, deux options s'offrent à vous:
  * L'import par plage de date (renseigner la date de début et de fin puis sélectionnez l'option **Lire dans la plage sélectionnée**.
  * L'import depuis la dernière commande (option **Lire depuis la dernière importation**). Cette option vous permet de ne lire que les commandes créées depuis la dernière importation. Si aucune importation n'avait été alors effectuée, le module les lirait toutes.

<wrap center round tip 100%>
Si vous souhaitez réinitialiser le compteur de dernière commande, cliquez sur la gomme {{:wiki:addons:gomme.png?nolink|Gomme}}
</wrap>

===== Limitations =====

  * La version nécessaire de Gestan est la 15.xx
  * La version minimum de Prestashop nécessaire est la 1.4.0.0
  * La version maximum actuellement supportée est la 1.8.2.0
  * Le module demande des informations à votre boutique Prestashop et il se peut que votre hébergeur limite le nombre de ces demandes. Si votre base Prestashop est importante //(plusieurs milliers de commandes par exemple)//, la première importation risque de prendre un certain temps, voir de se bloquer.
  * L'option //mod_security// de votre serveur ne doit pas être activée. En cas de doute, contactez votre hébergeur.
  * Si rien ne fonctionne et que vous êtes chez OVH, essayer d'ajouter ces deux lignes dans votre fichier htaccess: 
<code>
RewriteCond %{HTTP:Authorization} ^(.*)//

RewriteRule . - [E=HTTP_AUTHORIZATION:%1]//
</code>

-----------------
{{:wiki:tags:voir_aussi.gif?nolink |}}**Autres articles "Extensions V15"**

[[wiki:v15:admin:extensions|Comment installer une extension]] 

<nspages wiki:extensv15 -nbCol=2 -textPages="" -h1 -r -simpleLineBreak >