Note : pour connaitre les pré-requis ou en cas de message d'erreur, rendez-vous dans la partie Dépannage, en bas de cet article.

KinTPV communique avec WooCommerce à l'aide de l'API REST de WooCommerce.

Cette API permet à KinTPV et à l'extension KinTPV-WooConnect d'échanger des informations telles que :

• les fiches articles ;
• les stocks ;
• les commandes ;
• les informations de configuration.

Connectez-vous à l'administration de votre site WordPress puis rendez-vous dans :
WooCommerce > Réglages > Avancé > API REST

Cliquez sur Créer une clé API (ou Ajouter une clé selon la version de WooCommerce).

Renseignez ensuite les informations demandées :

• Description : par exemple KinTPV-Connect
• Utilisateur : choisissez un compte utilisateur du site
• Droits : sélectionnez impérativement Lecture / écriture

Validez en cliquant sur Générer une clé API.

WooCommerce affiche alors les deux informations nécessaires à la communication avec KinTPV :

• Clé client
• Secret client

Après validation, la clé apparaît dans la liste des clés API disponibles.

La création de la clé API est maintenant terminée.
Vous utiliserez la clé client et le secret client lors de la configuration de KinTPV et de l'extension KinTPV-WooConnect.

Cette procédure permet d'installer manuellement l'extension KinTPV-WooConnect à partir d'un fichier ZIP.

Cette méthode est notamment utilisée lorsque l'extension vous a été transmise par email ou téléchargée depuis une source externe. Il est également possible d'installer l'extension directement depuis le répertoire officiel WordPress.org.

Depuis le backoffice WordPress, ouvrez le menu Extensions puis cliquez sur Ajouter.

Sur la page d'ajout d'extensions, cliquez sur Téléverser une extension.

Sélectionnez ensuite le fichier ZIP de l'extension KinTPV-WooConnect depuis votre ordinateur.

Lancez l'installation de l'extension.
WordPress décompresse alors l'archive et copie les fichiers nécessaires sur votre site web.

Une fois l'installation terminée, cliquez sur Activer l'extension.

L'extension KinTPV-WooConnect apparaît désormais dans la liste des extensions installées.
Vous pouvez poursuivre avec sa configuration.

L'extension KinTPV-WooConnect doit maintenant être associée aux clés API REST créées précédemment dans WooCommerce.

Ces informations permettront à KinTPV et à l'extension de communiquer de manière sécurisée lors des synchronisations de données.

Depuis le backoffice WordPress, ouvrez le menu KinTPVConnect.

L'écran de configuration affiche alors un message indiquant que la clé API n'est pas encore renseignée.

Reportez dans les champs prévus à cet effet les deux informations obtenues lors de la création de la clé API REST :

• la Clé client ;
• le Secret client.

Enregistrez ensuite les modifications.

Une fois les identifiants enregistrés, l'écran complet de configuration de l'extension devient accessible.

À ce stade, il n'est pas question d'intervenir sur les paramètres de l'extension.
Une partie de la configuration sera transmise depuis KinTPV lors des étapes suivantes de ce tutoriel afin de paramétrer votre extension.

L'objectif de cette étape est simplement d'établir la communication sécurisée entre WooCommerce et KinTPV afin de permettre les futurs échanges de données.

Avant de pouvoir synchroniser des articles avec WooCommerce, KinTPV doit être configuré pour communiquer avec l'extension KinTPV-WooConnect.

Cette configuration se déroule en trois étapes :

• préparation des articles de frais de port ;
• configuration de la connexion avec WooCommerce ;
• envoi des Préférences de KinTPV vers l'extension.

WooCommerce gère nativement les transporteurs et les modes d'expédition.

Cette notion n'existe pas dans KinTPV.
Lorsqu'une commande internet est importée dans le logiciel, chaque frais de port doit donc être associé à un article de la base KinTPV.

Deux méthodes sont possibles :

• Suivi détaillé des transporteurs : créez un article distinct pour chaque transporteur ou mode d'expédition utilisé sur votre site (Chronopost, Colissimo, Mondial Relay, etc.).
• Suivi simplifié : créez un seul article générique représentant l'ensemble des frais de port proposé sur votre site web.

La première méthode permet d'obtenir des statistiques détaillées sur les modes de livraison utilisés par vos clients.
La seconde est plus simple à mettre en oeuvre lorsque cette information ne présente pas d'intérêt particulier.

Quel que soit le choix retenu, ces articles ont un Type article spécifique, dédié aux frais de port.

Dans l'exemple ci-dessous, les articles Chronopost et Colissimo utilisent le type article FRAIS DE PORT.

Attribuez à ces articles un prix de vente de 0,00 €. Le montant réellement facturé aux clients sera récupéré depuis WooCommerce lors de l'import des commandes.

Une fois cette préparation terminée, vous pouvez configurer la communication entre KinTPV et WooCommerce.

Ouvrez les Préférences KinTPV > Gestion > Site Web.

Sélectionnez ensuite le module de connexion pour WooCommerce.

Renseignez les informations suivantes :

• l'URL de l'extension WooConnect ;
• la Clé client de l'API REST ;
• le Secret client de l'API REST.

L'URL doit être renseignée sous la forme :
https://votre-site.fr/wp-json/kintpvconnect

Depuis l'écran des Préférences, cliquez sur le bouton “Configuration…” de la zone Envoi des articles.

Renseignez les paramètres demandés :

• critère KinTPV utilisé pour les marques sur le site ;
• Type Article utilisé pour les frais de port ;
• Tarif de vente ;
• magasins dont le stock doit être envoyé.

Cliquez ensuite sur Envoyer les préférences au site web.

Cette opération transmet à WooConnect les informations nécessaires pour :

• associer les taxes ;
• associer les moyens de paiement ;
• associer les frais de port ;
• préparer les futures synchronisations d'articles.

Lorsque le transfert est terminé, KinTPV affiche un message de confirmation.

Vous pouvez maintenant poursuivre la configuration de l'extension KinTPV-WooConnect dans WooCommerce.

Après l'envoi des préférences depuis KinTPV, retournez dans l'écran de configuration de l'extension KinTPV-WooConnect dans le backoffice WooCommerce.

L'ensemble des paramètres nécessaires à la synchronisation est maintenant disponible.

Avant toute synchronisation d'articles, associez les données WooCommerce et les données KinTPV.

• taxes ;
• transporteurs ;
• moyens de paiement.

Cela est nécessaire pour la mise à jour du catalogue produits à partir des infos de KinTPV, et aussi lors de la récupération des ventes web dans le logiciel de caisse.

Par exemple :

• Taux de TVA KinTPV “20” ⇔ Taux WooCommerce “Taux standard”
• Mode d'expédition WooCommerce “Forfait” ⇔ Article KinTPV “La Poste Colissimo”
• Moyen de paiement WooCommerce “Virement bancaire” ⇔ Mode de paiement KinTPV “Virement”

Le tableau de couleurs permet de définit le comportement de l'extension WooConnect lors des synchronisations des produits depuis KinTPV.

• Importés à la création : concerne un produit lorsqu'il est créé dans WooCommerce par KinTPV
• Importés à la modification : lorsqu'un produit WooCommerce est mis à jour par KinTPV

KinTPV transmet systématiquement l'ensemble des informations de ses fiches articles à WooConnect.
C'est ensuite l'extension WooConnect qui “décide” quelles données doivent être créées ou mises à jour dans WooCommerce en fonction des cases cochées dans ce tableau.

Il est possible de choisir qu'une information soit importée uniquement lors de la création du produit.

Dans ce cas :

• lors du premier envoi, la valeur provenant de KinTPV est enregistrée dans WooCommerce ;
• lors des synchronisations suivantes, cette même information n'est plus modifiée, même si elle a changé dans KinTPV.

À l'inverse, lorsqu'une case est cochée dans la colonne Importés à la modification, WooConnect mettra à jour cette donnée à chaque synchronisation.

Cette configuration permet de déterminer précisément quelles informations sont pilotées par KinTPV et lesquelles peuvent être modifiées directement dans WooCommerce sans être écrasées lors des synchronisations ultérieures.

Cette section présente un exemple complet de synchronisation d'un article KinTPV vers WooCommerce.

L'objectif est de vérifier que la communication entre KinTPV et WooConnect fonctionne correctement avant d'envisager la synchronisation d'un catalogue complet.

Le catalogue WooCommerce est vide et ne contient encore aucun produit.

Dans KinTPV, une fiche Article est prête à être synchronisée.

L'exemple utilisé est un ballon de football comportant :

• une référence ;
• un code-barres ;
• un descriptif long ;
• un descriptif court ;
• plusieurs photos ;
• une déclinaison de type Couleur ;
• des stocks distincts pour chaque valeur de déclinaison.

Chaque ligne de stock possède leur propre code-barres et leur propre stock.

L'article est ensuite envoyé vers le site web à l'aide de la fonction de synchronisation de KinTPV.
Pendant le traitement, KinTPV affiche la progression de l'envoi.

Une fois la synchronisation terminée, le produit apparaît dans le backoffice WooCommerce.

En consultant la fiche produit dans l'administration WooCommerce, on retrouve les informations provenant de KinTPV :

• nom du produit ;
• catégories ;
• descriptifs ;
• images ;
• déclinaisons ;
• codes-barres ;
• quantités en stock.

Dans cet exemple, les quatre déclinaisons de couleur ont été créées automatiquement avec leurs propres références et niveaux de stock.

Le produit est également disponible sur la boutique en ligne.

Le visiteur peut :

• consulter les descriptifs ;
• visualiser les photos ;
• sélectionner une déclinaison ;
• connaître le stock disponible ;
• ajouter le produit à son panier.

Cette première synchronisation permet de valider que les échanges entre KinTPV, WooConnect et WooCommerce fonctionnent correctement avant la mise en ligne d'un volume plus important d'articles.

Une fois la synchronisation d'un premier article validée, vous pouvez procéder à l'envoi d'une sélection d'articles ou de l'ensemble de votre catalogue vers WooCommerce.

KinTPV propose plusieurs méthodes permettant de synchroniser les articles selon vos besoins :

• envoi manuel d'un article
• envoi manuel d'une sélection d'articles
• synchronisation complète
• mise à jour automatique

Pour découvrir les différentes possibilités disponibles, consultez la page Envoi des articles vers le site web.

Si une erreur “API non disponible” apparait, vérifiez en premier lieu la configuration des permaliens WordPress.
En effet, la structure par défaut de permaliens (Simple) n'est pas compatible avec le fonctionnement de l'API REST utilisée par WooCommerce.

Rendez-vous dans : Réglages > Permaliens
et sélectionnez n'importe quelle option autre que Simple.

Dans certaines configurations, l'API REST peut rencontrer des difficultés lorsque les champs Adresse web de WordPress (URL) et Adresse web du site (URL) contiennent des valeurs différentes.

Rendez-vous dans : Réglages > Général
et vérifiez que les deux champs contiennent exactement la même adresse.

WooCommerce gère parfois difficilement les valeurs de déclinaisons utilisant une virgule comme séparateur décimal.
Lorsque vos déclinaisons contiennent des nombres décimaux, utilisez un point à la place de la virgule.

Exemple : 7.25 ou 8.5 plutôt que 7,25 et 8,5

En cas de problème de communication entre KinTPV et WooCommerce, consultez le log HTTP.

Ce journal enregistre les échanges réalisés entre KinTPV et le site web et constitue généralement une source d'information utile pour identifier l'origine d'une erreur de synchronisation.