Différences

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

--- tutoriel:web:install-shopify [01/09/2023 11:28] – [Cas particulier : la base produits de Shopify est renseignée AVANT l'installation de KinTPV] kintpv
+++ tutoriel:web:install-shopify [06/05/2024 10:07] – [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}}
+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 34: / Ligne 53: @@
   * "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".
+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".
@@ Ligne 55: / 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 86: / 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]].