wikintpv

le wiki de KinTPV

Outils pour utilisateurs

Outils du site


07-rubrique-synchronisation:03-envoi-web:prestashop-connect

Synchronisation avec PrestaShop

Le module KinTPV PrestaConnect permet de synchroniser votre logiciel KinTPV avec votre boutique en ligne PrestaShop.

Il assure la liaison entre les données KinTPV et PrestaShop : produits, catégories, stocks, taxes, transporteurs, modes de paiement et commandes.

Cette page décrit l'installation et la configuration spécifiques à PrestaShop.

Les opérations courantes d'envoi des articles et de récupération des commandes étant communes aux différents connecteurs e-commerce de KinTPV, elles sont présentées dans des pages dédiées.

Il permet notamment :

  • de publier et mettre à jour les informations des produits KinTPV sur votre site PrestaShop ;
    • désignation
    • descriptif
    • prix de vente
    • stock
    • déclinaisons (“attributs” dans PrestaShop)
    • photos (formats acceptés : jpeg, gif ou png)
    • critères (“caractéristiques” dans PrestaShop)
  • de synchroniser les catégories (l'arborescence du site) ;
  • de récupérer les commandes passées sur votre site directement dans KinTPV.

Vous centralisez ainsi la gestion de vos articles et de vos stocks dans KinTPV, sans avoir à saisir les mêmes informations dans les deux logiciels.

Avant la première synchronisation, certaines informations doivent être créées directement dans PrestaShop, notamment les taxes et les transporteurs utilisés sur votre boutique en ligne.

Si vous possédez déjà un site PrestaShop, vous pouvez utiliser KinTPV pour gérer votre boutique physique et le connecter à votre site e-commerce existant.
Vous conservez ainsi votre site, votre catalogue de produits et son référencement, tout en centralisant désormais leur gestion dans KinTPV.


La version du module KinTPV PrestaConnect à utiliser dépend de la version de votre site PrestaShop :

  • PrestaShop 1.5 / 1.6 : PrestaConnect v6
  • PrestaShop 1.7 / 8 : PrestaConnect v8

1. Installation du module PrestaConnect

Depuis le back-office de votre site PrestaShop, ouvrez Modules > Gestionnaire de modules, puis cliquez sur Installer un module.

Sélectionnez le fichier ZIP du module KinTPV PrestaConnect, ou faites-le glisser dans la fenêtre d'installation.

Patientez pendant l'installation du module.

Une fois l'installation terminée, recherchez KinTPV PrestaConnect dans la liste des modules et cliquez sur Configurer.

Note : pour réaliser la configuration complète, vous devez au préalable paramétrer les Préférences de “KinTPV” puis les envoyer au module “KinTPV PrestaConnect”.

2. Connexion de KinTPV à PrestaShop

Récupérer l'URL de traitement

La page de configuration du module PrestaConnect indique une URL de traitement.
Copiez cette adresse : elle devra être saisie dans KinTPV.

Paramétrer la connexion dans KinTPV

Dans KinTPV, ouvrez Préférences > GESTION > Site WEB.

Dans Version du module de connexion, sélectionnez la version de PrestaConnect correspondant à votre site PrestaShop.

Renseignez ensuite :

  • l'adresse de connexion au back-office de votre site PrestaShop ;
  • l'adresse e-mail utilisée pour la connexion ;
  • le mot de passe ;
  • l'URL de traitement copiée précédemment depuis PrestaConnect ;
  • cochez Utiliser request 4D.

Le port de connexion peut également être adapté si la configuration de votre serveur le nécessite, dans ce cas Utiliser request 4D doit être décoché.

3. Configuration de l'envoi des articles

Dans Préférences > GESTION > Site WEB, la partie Envoi des articles permet de définir la manière dont KinTPV transmet les informations à PrestaShop.

Cliquez sur Configuration….

La fenêtre de configuration permet notamment de définir les informations utilisées lors de la synchronisation.

Marque des articles

Dans KinTPV, la marque est gérée sous la forme d'un critère.
Sélectionnez le critère KinTPV utilisé pour renseigner la marque de vos articles.

Frais de port

Avant de configurer les transporteurs dans PrestaConnect, les articles utilisés pour enregistrer les frais de port doivent avoir été créés dans KinTPV, associés au type d'article prévu à cet effet, puis transmis au module avec les préférences.

Pour la préparation et le fonctionnement général des frais de port, consultez :
Gestion des frais de port

Dans la configuration de PrestaConnect, associez ensuite chaque transporteur PrestaShop à l'article KinTPV qui doit être utilisé lors de la récupération des commandes.

Si vous utilisez un seul article générique pour les frais de port, plusieurs transporteurs PrestaShop peuvent être associés à ce même article.

Tarif envoyé sur le site

Sélectionnez le tarif KinTPV utilisé pour les prix de vente publiés sur votre site.

Vous pouvez utiliser le tarif habituel ou créer un tarif spécifique, par exemple WEB, si les prix pratiqués sur votre boutique en ligne sont différents.

Stocks

Sélectionnez le ou les stocks à prendre en compte pour la synchronisation.

Lorsque plusieurs stocks sont sélectionnés, leurs quantités sont cumulées pour déterminer le stock envoyé à PrestaShop.


⇒ Envoyer les préférences à PrestaShop

Une fois ces informations paramétrées dans KinTPV, cliquez sur Envoyer les préférences au site web.

Cette étape est indispensable lors de la mise en place de la connexion : elle transmet à PrestaConnect les informations dont il a besoin pour compléter sa configuration, notamment :

  • les taxes (TVA) utilisées dans KinTPV ;
  • les articles correspondant au type utilisé pour les frais de port ;
  • les types de règlement ;
  • les autres informations nécessaires à la synchronisation.

Une fois les préférences envoyées, retournez dans le back-office de PrestaShop et ouvrez la configuration du module KinTPV PrestaConnect.

Vous pourrez alors établir les différentes correspondances entre les données de PrestaShop et celles de KinTPV.

4. Configuration de PrestaConnect

Retournez dans le back-office de PrestaShop et ouvrez la configuration du module KinTPV PrestaConnect.

La page permet de définir les correspondances et le comportement de la synchronisation entre PrestaShop et KinTPV.

Identification des produits

PrestaConnect propose deux méthodes pour identifier les produits lors de la synchronisation.

Par ID KinTPV

Les produits sont identifiés à partir de leur identifiant KinTPV.
Lors de leur création, l'id KinTPV et l'id PrestaShop sont identiques.
Cette méthode est adaptée notamment à la création d'un nouveau catalogue PrestaShop à partir des articles KinTPV.

Par code-barres

Les produits sont identifiés grâce à leur code-barres.
Cette méthode permet notamment d'établir la correspondance avec des produits déjà présents dans PrestaShop.

Lorsque l'identification est effectuée par code-barres, les codes-barres des produits dans PrestaShop doivent être identiques à ceux des articles correspondants dans KinTPV.

Si les produits existent déjà dans PrestaShop, leurs codes-barres peuvent être reportés dans les articles KinTPV correspondants. À l'inverse, si les codes-barres sont déjà renseignés dans KinTPV, ils doivent être reportés sur les produits correspondants dans PrestaShop.

C'est cette correspondance qui permet à PrestaConnect d'identifier un même produit dans KinTPV et PrestaShop lors de la synchronisation.

Langue utilisée

KinTPV ne synchronise qu'une seule langue avec PrestaShop.
Sélectionnez la langue à importer : les informations provenant de KinTPV seront enregistrées dans cette langue lors de la synchronisation.

Les informations éventuellement renseignées dans les autres langues de votre site PrestaShop ne seront pas modifiées.

Liaison des transporteurs

Associez chaque transporteur utilisé dans PrestaShop à l'article correspondant dans KinTPV.
Cette correspondance permet notamment de gérer correctement les frais de port lors de la récupération des commandes.

Liaison des taxes

Associez chaque taxe KinTPV à la règle de taxe et à la taxe correspondante dans PrestaShop.
Cette correspondance est utilisée lors de la synchronisation des articles et de la récupération des commandes.

Liaison des modes de paiement

Associez les modes de paiement utilisés dans PrestaShop aux types de règlement correspondants dans KinTPV.

Multiboutique

Si votre site PrestaShop utilise le mode multiboutique, vous pouvez associer chaque boutique PrestaShop à la boutique correspondante dans KinTPV.
Cette association permet notamment de gérer l'arborescence des catégories de chaque boutique.

Gestion de l'import

Lors d'une synchronisation, KinTPV transmet à PrestaConnect l'intégralité des informations dont il dispose pour chaque article.
Ce tableau de configuration permet de déterminer quelles informations PrestaConnect doit effectivement enregistrer dans PrestaShop.

La première ligne du tableau, Autoriser Créations / Modifications, permet d'activer ou de désactiver globalement cette gestion :

  • si la case est cochée, PrestaConnect est autorisé à enregistrer dans PrestaShop les informations sélectionnées dans la colonne correspondante ;
  • si la case est décochée, aucune des informations de cette colonne n'est enregistrée dans PrestaShop.

Les deux colonnes correspondent à deux situations différentes :

  • Importés à la création : réglages utilisés lorsque le produit envoyé par KinTPV n'existe pas encore dans PrestaShop et doit être créé ;
  • Importés à la mise à jour : réglages utilisés lorsque le produit existe déjà dans PrestaShop et doit être mis à jour.

Pour chaque information du tableau :

  • si la case est cochée, l'information provenant de KinTPV est enregistrée dans PrestaShop ;
  • si la case est décochée, PrestaConnect n'enregistre pas cette information. Lors d'une mise à jour, la valeur déjà présente dans PrestaShop est donc conservée.

Il est ainsi possible, par exemple, d'utiliser le nom et la description provenant de KinTPV lors de la création d'un produit, puis de décocher ces informations pour la mise à jour. Elles pourront alors être modifiées directement dans PrestaShop sans être remplacées lors des synchronisations suivantes.

Les options situées au-dessus du tableau permettent également :

  • d'activer automatiquement dans PrestaShop les nouveaux produits créés par KinTPV, ou de les laisser désactivés afin de les publier manuellement ;
  • d'importer le code-barres KinTPV dans la référence du produit PrestaShop lorsque cela est nécessaire. Cette option est nécessaire si vos codes-barres ne sont pas au format EAN13.

États des commandes

Sélectionnez les états de commande PrestaShop qui doivent être considérés comme une commande validée par KinTPV.

Une configuration similaire est disponible pour les commandes ayant fait l'objet d'un retour client.

Identifiant des commandes

Les commandes PrestaShop sont identifiées par un numéro incrémental.

En cas de décalage entre l'identifiant recherché par KinTPV et les commandes présentes dans PrestaShop, vous pouvez définir l'identifiant à partir duquel la recherche des prochaines commandes doit commencer.

5. Configuration de la récupération des commandes PrestaShop

Dans KinTPV, ouvrez :
Préférences > GESTION > Site WEB > Récupération des commandes > Configuration…

Cette configuration permet notamment :

  • de définir la fréquence de récupération des commandes ;
  • d'activer ou non leur traitement automatique ;
  • de choisir la date utilisée pour créer les ventes dans KinTPV ;
  • de définir le vendeur associé aux ventes Web ;
  • de définir le comportement concernant les fiches clients reçues depuis PrestaShop ;
  • de configurer la création automatique d'une facture PDF.

La récupération, le contrôle et le traitement des commandes sont communs aux différents connecteurs e-commerce de KinTPV.

Pour le fonctionnement détaillé, consultez :
Récupération et traitement des commandes Web

6. Première synchronisation des articles

Une fois KinTPV et PrestaConnect configurés, vérifiez notamment :

  • la méthode d'identification des produits ;
  • les correspondances des taxes ;
  • les correspondances des transporteurs ;
  • les correspondances des modes de paiement ;
  • les informations que PrestaConnect est autorisé à créer ou modifier.

Effectuez ensuite un premier envoi depuis KinTPV de quelques articles de test afin de vérifier le bon fonctionnement de la synchronisation.

Si votre boutique PrestaShop contient déjà des produits, vérifiez soigneusement la méthode d'identification des articles et les options de création/modification avant d'effectuer une synchronisation importante.

Pour savoir comment envoyer manuellement ou automatiquement les articles vers votre site e-commerce, consultez :
Envoi des articles vers un site e-commerce

À retenir

La connexion entre KinTPV et PrestaShop repose sur deux configurations complémentaires :

  • dans KinTPV : connexion au module PrestaConnect et choix des informations nécessaires aux échanges ;
  • dans PrestaConnect : identification des produits, correspondances entre les données PrestaShop et KinTPV, et choix des informations pouvant être créées ou mises à jour.

Une fois cette configuration terminée :

07-rubrique-synchronisation/03-envoi-web/prestashop-connect.txt · Dernière modification : de KinTPV

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki