Différences

Ci-dessous, les différences entre deux révisions de la page.

--- tutoriel:web:install-shopify [01/02/2024 10:12] – kintpv
+++ tutoriel:web:install-shopify [06/05/2024 10:07] (Version actuelle) – [Synchronisation avec Shopify] kintpv
@@ Ligne 1: / Ligne 1: @@
 ====== Synchronisation avec Shopify ======
+KinTPV se synchronise avec Shopify, cela signifie que :
+  * KinTPV envoie vers le site e-commerce les informations du catalogue produits, Articles (description, images, prix, etc.) et Arborescence (=Collection)
+  * KinTPV reçoit les commandes des internautes passées sur Shopify afin de mettre à jour les stocks et le CA.
+===== Paramétrage =====
 Les images valant parfois mieux que des mots, voici chaque étape des manipulations à faire pour configurer la communication entre KinTPV et Shopify.
@@ Ligne 16: / Ligne 21: @@
 {{:tutoriel:install-shopify:img_install-shopify_20221121-143515.png}}
 {{:tutoriel:install-shopify:img_install-shopify_20230717-120446.png}}
-Info concernant l'API version.
+Pour ce qui est de l'[[#api_version|API version]], rendez-vous à la [[#api_version|fin de cette page wiki]] pour connaitre la valeur à renseigner.\\
 {{:tutoriel:install-shopify:img_install-shopify_20230717-120749.png}}
+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").
 Suite au test de synchronisation, voici les 2 messages possibles :
@@ Ligne 57: / Ligne 75: @@
 ===== Erreur courante =====
+==== 413 Request Entity Too Large ====
 Dans le cas où il y aurait une erreur "<nowiki><html></nowiki>",\\
 dont la désignation complète est :
@@ Ligne 88: / Ligne 106: @@
 **__NOTE KINTPV__** : la valeur de //post_max_size// est celle à modifier dans notre cas.
+==== API version ====
+D'après nos constatations, L'équipe Shopify propose une nouvelle version de leur API tous les 3 mois :
+  * 01 - janvier
+  * 04 - avril
+  * 07 - juillet
+  * 10 - octobre
+Dans les Préférences de KinTPV, il faut indiquer une version récente pour éviter tout problème.\\
+A la rédaction de ce propos (1er février 2024), l'API version à utiliser est "__**2023-07**__".
+----
+Si vous recevez un mail provenant de **Shopify Apps Team** dont l'objet est :\\
+//[Action requise] Mettez à jour vos applications Shopify...// (ou similaire)
+<code>
+Bonjour,
+[...]
+Au moins une de vos applications a émis des appels à des API obsolètes au cours
+des 30 derniers jours. Cette version ne sera plus prise en charge à compter du
+avril 1, 2024. Veuillez mettre à jour les applications figurant dans la liste
+ci-dessous en optant pour la version 2023-07 de l'API ou une version supérieure
+afin qu'elles continuent à fonctionner correctement.
+Boutique : xxxx
+Application : KinTPVConnect
+[...]
+</code>
+Il suffit donc de suivre la recommandation faite, à savoir utiliser l'API aaaa-mm indiquée dans le message, en saisissant cette valeur dans le champ "API version" dans les [[manuel:preferences:gestion#site_web|Préférences KinTPV > Gestion > Site Web]].