wikintpv

le wiki de KinTPV

Outils pour utilisateurs

Outils du site


07-rubrique-synchronisation:03-envoi-web:install-shopify-version2026

Synchronisation avec Shopify — version 2026 - nouvelle méthode

Cette page décrit la procédure actuelle permettant de connecter KinTPV à une boutique Shopify.

Depuis 2026, Shopify a modifié la création et la gestion des applications utilisées pour accéder à l'API.
Les captures d'écran et les étapes décrites ici correspondent à cette nouvelle méthode.

Pour les boutiques configurées avant les évolutions introduites par Shopify en 2026 :
Synchronisation avec Shopify (ancienne méthode)

Principe

La synchronisation permet :

  • d'envoyer depuis KinTPV les informations du catalogue produits vers Shopify ;
  • de mettre à jour les stocks sur la boutique en ligne ;
  • de récupérer dans KinTPV les commandes passées sur Shopify.

Création de l'application Shopify

Cette étape permet de créer l'application qui servira à la communication entre Shopify et KinTPV.

Connectez-vous au backoffice Shopify de votre boutique.

Depuis l'écran d'accueil, cliquez sur le bouton Paramètres situé en bas à gauche.

Paramètres

Une fois dans les paramètres de la boutique, cliquez sur Applications dans le menu de gauche.

Applications

Cliquez sur Développer des applications.

Puis sur Développer des applications dans le Dev Dashboard.

Dev Dashboard

Le Dev Dashboard Shopify s'ouvre dans une nouvelle interface dédiée au développement d'applications.

Vous pourrez alors créer l'application utilisée par KinTPV.

Cliquez sur Créer une appli en bas à droite de l'écran.

Créer une application

Saisissez un nom pour l'application puis cliquez sur Créer.

Le nom est libre. Vous pouvez par exemple utiliser :

  • KinTPV
  • KinTPV-Connect
  • KinTPV-Shopify

Attribuer les autorisations

Une fois l'application créée, il faut attribuer les autorisations nécessaires à KinTPV.

Dans la section Accès, cliquez sur Sélectionner des champs d'accès.

Vous pouvez sélectionner les autorisations une à une ou coller directement la liste des autorisations dans le champ prévu à cet effet.

La liste exacte des autorisations nécessaires à KinTPV est actuellement en cours de validation.

Dans l'attente, il est possible d'attribuer l'ensemble des autorisations disponibles afin de finaliser la connexion.

Autorisations actuellement recommandées. Pour gagner du temps, vous pouvez copier-coller la liste ci-dessous dans le champ des autorisations plutôt que de cocher chaque case individuellement.

read_all_orders,
read_customers,
read_files,
read_inventory,
read_locations,
read_orders,
read_product_listings,
read_products,
read_publications,
write_customers,
write_files,
write_inventory,
write_locations,
write_orders,
write_product_listings,
write_products,
write_publications

Publier

Une fois les autorisations configurées, cliquez sur le bouton Publier.

Shopify demande alors une confirmation de publication.

Il n'est pas nécessaire de renseigner un nom de version ni un message de version.

Cliquez simplement sur Publier.

L'application est maintenant créée et publiée.

Dans le menu de gauche, cliquez sur Paramètres.

Récupérer les infos pour KinTPV

Les identifiants de l'application sont affichés.

Vous devez récupérer :

  • l'ID client
  • le Secret

Ces deux informations devront être renseignées dans la configuration Shopify de KinTPV.

Le bouton de copie situé à droite de chaque valeur permet de les copier directement dans le presse-papiers afin de faciliter leur saisie dans KinTPV.

Paramétrage dans KinTPV

Ouvrez : Préférences > Gestion > Site web

Renseignez les informations récupérées dans Shopify.

API version

Lors de la configuration de Shopify dans KinTPV, indiquez la version d'API utilisée par votre application Shopify.

Shopify fait évoluer régulièrement son API (nouvelle version tous les 3 mois) et retire régulièrement les anciennes versions de son API.

Cette version correspond à celle utilisée lors de la création de la version de l'application dans le Dev Dashboard Shopify.
Exemple : 2026-04


Si Shopify vous informe qu'une version devient obsolète :

  • créez une nouvelle version de l'application ;
  • vérifiez ou ressaisissez les autorisations nécessaires ;
  • publiez cette nouvelle version ;
  • mettez à jour la valeur “API version” dans KinTPV.

Pour consulter les versions actuellement supportées par Shopify :
https://shopify.dev/docs/api/usage/versioning

Test de la connexion

Cliquez sur le bouton : Tester la connexion

Deux résultats sont possibles :

  • la connexion est établie
  • la connexion échoue

En cas d'échec, vérifiez les autorisations accordées à l'application ainsi que les informations saisies dans KinTPV.
Si nécessaire, reprendre la procédure depuis le début.

Configuration à l'envoi (des produits)

Note : Si votre base Shopify était renseignée avant d'utiliser KinTPV, référez vous au chapitre
Cas particulier : la base produits Shopify est renseignée AVANT l'utilisation de KinTPV”.

Rappel : seuls les articles cochés “publier web” dans KinTPV sont synchronisés.

Le comportement des synchronisations diffère selon la configuration de KinTPV (cf. Préférences > Gestion > Site web, bouton “Configuration” de la zone “Envoi des articles”).

Configuration standard

  • “Aucune création d'article sur le site” : DÉCOCHÉ
  • “Ne mettre à jour que les fiches de stock” : DÉCOCHÉ

Si l'article KinTPV NE possède PAS l'id de son équivalent Shopify alors KinTPV crée (ou pas…) la fiche product sur le site, en fonction des éléments cochés dans la colonne “à la création”.
Le produit créé sur le site aura le status “Draft” (brouillon) ou “active” selon votre configuration.

Sinon, KinTPV met à jour les données du site, selon les choix cochés de la colonne “à la modification”.


Par défaut, les options :

  • Aucune création d'article sur le site, faire le lien selon l'attribut [ ]
  • Ne mettre à jour que les fiches de stock (aucune modification de la fiche d'article)

sont décochées.

Aucune création d'article sur le site, faire le lien selon l'attribut [ ]
⇒ Cette option n'accepte que 2 valeurs : “sku” ou “barcode”.
Cela signifie que le code-barres KinTPV correspond à un code-barres enregistré dans le champ “sku” de Shopify, ou dans le champ “barcode” de Shopify.
⇒ Si cette option est cochée, alors la colonne “à la création” du tableau de configuration est ignorée, mais la colonne “à la modification” est prise en compte.

Ne mettre à jour que les fiches de stock (aucune modification de la fiche d'article)
⇒ Si cette seconde option est cochée, alors il faut cocher la case “Stock → inventory” dans la colonne “à la modification” du tableau de configuration.
Dans tous les cas, la fiche produit ne sera pas modifiée sur le site (hormis le stock).
⇒ Si cette option est cochée, la colonne “à la création” du tableau de configuration est prise en compte, et la colonne “à la modification” est ignorée (sauf la ligne “Stock → inventory”).

Configuration à la réception (des commandes)

Lier les articles existants

Cas particulier : la base produits Shopify est renseignée AVANT l'utilisation de KinTPV

:!: Avant de “publier web” un article dans KinTPV, veillez à ce que son équivalent Shopify possède un sku.
Le sku Shopify correspond au code-barres KinTPV.

  • La fiche Article KinTPV n’est pas encore liée avec la fiche Product Shopify (lien direct par id Product)
    ⇒ KinTPV récupère toutes les fiches Product de Shopify depuis le dernier id product récupéré
  • La fiche de stock KinTPV n’est pas encore liée avec la fiche variant Shopify (lien direct par id variant)
    • Si la liste Products n'est pas chargée ⇒ récupérer TOUS les products de Shopify
    • KinTPV recherche la fiche variant par le lien “manuel” sku (Shopify) = code-barres (KinTPV)
    • Si une fiche variant est trouvée
      ⇒ mise à jour du lien direct “id variant” dans la fiche de stock KinTPV
      ⇒ ET mise à jour de l’id Product dans la fiche Article KinTPV.
  • La fiche de stock KinTPV est liée avec la fiche variant Shopify (lien direct par id variant)
    • KinTPV interroge Shopify pour récupérer Inventory_item à mettre à jour.
    • KinTPV envoi la valeur du stock à mettre à jour : inventory_levels/set avec available = quantité en stock dans KinTPV.

Le bouton “Lier les articles” permet de “scanner” le catalogue produits du site et de faire le lien avec les Articles KinTPV (ce lien est enregistré dans KinTPV, pas dans Shopify).

07-rubrique-synchronisation/03-envoi-web/install-shopify-version2026.txt · Dernière modification : de kintpv

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki