Cette page tutorielle 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.

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.

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.

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

Cliquez sur Développer des applications.

Puis sur Développer des applications dans le 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.

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

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.

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_customer_merge,read_delivery_customizations,
read_price_rules,write_price_rules,read_discounts,write_discounts,write_inventory,
read_inventory,read_locations,read_online_store_navigation,
write_online_store_navigation,read_orders,read_product_listings,write_product_listings,
read_products,write_products,read_publications,write_publications,
read_purchase_options,write_purchase_options,read_shipping,
read_shopify_payments_accounts,customer_read_customers,customer_read_orders,
shop_app:oauth

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.

Une fois l'application publiée, revenez sur l'onglet d'Aperçu.

Dans la section Installations, cliquez sur Installer l'application.

Shopify ouvre alors l'interface d'administration standard de la boutique et affiche un écran de confirmation.

Cliquez sur Installer pour autoriser l'application à accéder à votre boutique.

L'application est maintenant installée sur votre boutique Shopify.

Revenez dans l'écran dev dashboard, dans le menu de gauche, cliquez sur Paramètres.

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.

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

Renseignez ensuite :

• l'URL de votre boutique Shopify ;
• la version d'API ;
• l'ID Client ;
• le Secret.

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 :

• l'URL de la boutique Shopify ;
• la version de connexion (v2 (2026)) ;
• la version d'API ;
• l'ID Client ;
• le Secret ;
• que l'application a bien été installée sur la boutique ;
• que les autorisations nécessaires ont bien été accordées ;
• qu'une version de l'application a bien été publiée.

Si la version d'API utilisée par votre application Shopify est devenue obsolète, il peut être nécessaire de créer une nouvelle version de l'application.

La procédure est détaillée plus loin dans cette documentation.

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

Pour accéder aux paramètres :
Préférences > Gestion > Site web, bouton “Configuration” de la zone “Envoi des articles”

Ces paramètres déterminent :

• si KinTPV est autorisé à créer de nouveaux produits sur Shopify ;
• comment les produits existants sont identifiés ;
• quelles informations sont mises à jour sur Shopify.

Sélectionnez le ou les magasins dont les stocks doivent être transmis à Shopify.
Si plusieurs magasins sont cochés, leurs stocks sont cumulés avant envoi.

Cette option permet d'interdire à KinTPV la création automatique de nouveaux produits sur Shopify.

Lorsque cette option est cochée :

• KinTPV ne crée jamais de nouveaux produits sur Shopify ;
• seuls les produits déjà présents sur Shopify peuvent être mis à jour ;
• la colonne à la création est ignorée ;
• seule la colonne à la modification est prise en compte.

Le lien entre un article KinTPV et un produit Shopify est alors recherché à partir de l'attribut indiqué :

• sku
• barcode

Le code-barres enregistré dans KinTPV doit alors correspondre à la valeur enregistrée dans le champ choisi sur Shopify.

Cette option limite la synchronisation à la seule gestion des stocks.

Lorsque cette option est cochée :

• les informations descriptives des produits ne sont jamais modifiées sur Shopify ;
• seuls les niveaux de stock sont transmis ;
• la colonne à la création est prise en compte ;
• la colonne à la modification est ignorée (sauf la ligne “Stock → inventory”) ;
• la ligne Stock ➜ inventory doit être cochée dans la colonne à la modification.

Le tableau de correspondance permet de choisir quelles informations seront transmises à Shopify.
“Valeur KinTPV ➜ valeur équivalente sur Shopify”

Cette colonne est utilisée lorsqu'un produit Shopify doit être créé par KinTPV,
et si KinTPV est autorisé à créer les produits sur Shopify.

Cette colonne est utilisée lorsqu'un produit existe déjà sur Shopify.
Si une ligne n'est pas cochée dans cette colonne, KinTPV ne modifiera jamais cette information sur Shopify.

Lorsqu'un produit est créé automatiquement par KinTPV, son état peut être :

• draft : produit créé en brouillon ;
• active : produit immédiatement publié.

Le mode draft est généralement recommandé lors de la première synchronisation pour vérifier son bon fonctionnement.

Dans la majorité des cas :

• Aucune création d'article sur le site : décoché
• Ne mettre à jour que les fiches de stock : décoché

Cette configuration permet :

• la création automatique des nouveaux produits ;
• la mise à jour des produits existants ;
• la synchronisation des stocks.

Si votre boutique Shopify contient déjà des produits avant la mise en place de KinTPV, reportez-vous au chapitre : “Cas particulier : la base produits Shopify est renseignée AVANT l'utilisation de KinTPV”.

Le bouton Configuration… de la zone Récupération des commandes permet de paramétrer la récupération des ventes Shopify dans KinTPV.

Lorsque KinTPV récupère une commande Shopify, certaines informations du site web doivent être associées à celles existantes dans KinTPV, via les tableaux de correspondance :

• les taxes Shopify / les taxes KinTPV ;
• les modes de livraison Shopify / les articles KinTPV utilisés pour les frais de port.

Si votre boutique Shopify contient déjà des produits avant la mise en place de KinTPV, il est possible de créer automatiquement les liens entre les fiches Shopify et les fiches articles KinTPV.

Dans le cadre de la synchronisation KinTPV / Shopify :

• le SKU Shopify doit correspondre au code-barres KinTPV ;
• chaque produit à rapprocher doit donc posséder le même identifiant dans les deux systèmes.

Le bouton Lier les articles permet alors à KinTPV de parcourir le catalogue Shopify et de rechercher automatiquement les correspondances.

Lorsqu'une correspondance est trouvée entre le SKU Shopify et le code-barres KinTPV,
KinTPV enregistre alors le lien dans sa base Articles.

Une fois cette opération effectuée, les synchronisations suivantes utilisent directement ces liens pour mettre à jour les produits et les stocks sans nouvelle recherche.

Lorsque KinTPV doit synchroniser un article avec Shopify, plusieurs cas sont possibles.

• La ligne de stock (pour une valeur de déclinaison) KinTPV n'est pas encore liée à une fiche Variant Shopify (absence d'id Variant)
  • Si la liste des produits Shopify n'est pas encore chargée, KinTPV récupère les produits depuis Shopify.
  • KinTPV recherche alors une correspondance entre :
    • le champ SKU de Shopify ;
    • et le code-barres de la fiche stock KinTPV.
  • Si une correspondance est trouvée :
    • l'id Variant Shopify est enregistré dans la fiche de stock KinTPV ;
    • l'id Product Shopify est enregistré dans la fiche Article KinTPV.

• La ligne de stock (pour une valeur de déclinaison) KinTPV est déjà liée à une fiche Variant Shopify
  • KinTPV utilise directement les identifiants enregistrés.
  • KinTPV récupère l'identifiant technique Inventory Item associé au Variant.
  • KinTPV transmet ensuite à Shopify la quantité en stock présente dans KinTPV via l'API de mise à jour des stocks.

Cette recherche par SKU n'est normalement nécessaire qu'une seule fois. Une fois les liens enregistrés dans KinTPV, les synchronisations suivantes utilisent directement les identifiants Shopify mémorisés.

Shopify retire régulièrement les anciennes versions de son API.

Lorsque la version utilisée par votre application n'est plus supportée, il est nécessaire de créer puis publier une nouvelle version de l'application.

Depuis le Dev Dashboard Shopify, ouvrez votre application puis :

• soit cliquez sur le bouton Nouvelle version depuis l'onglet Aperçu ;
• soit ouvrez le menu Versions puis cliquez sur Création de version.

Lors de la création de cette nouvelle version :

• vérifiez les autorisations accordées à l'application ;
• ajoutez les éventuelles nouvelles autorisations nécessaires ;
• relevez la nouvelle version d'API utilisée ;
• publiez la nouvelle version.

Après avoir publié une nouvelle version de l'application dans le Dev Dashboard Shopify, il est nécessaire de mettre à jour l'application installée dans la boutique.

Depuis le backoffice Shopify, ouvrez :

• Applications
• KinTPV-Connect

Cliquez ensuite sur le bouton Ouvrir l'application.

Shopify affiche alors les nouvelles autorisations demandées par la version publiée.

Cliquez sur Mettre à jour afin d'appliquer les nouvelles autorisations.

Une fois la mise à jour terminée, vous pouvez revenir dans KinTPV et :

• mettre à jour éventuellement la valeur API version dans KinTPV ;
• effectuer un nouveau test de connexion.