Table des matières

Synchronisation avec Shopify

KinTPV se synchronise avec Shopify, cela signifie que :

Paramétrage

Les images valant parfois mieux que des mots, voici chaque étape des manipulations à faire pour configurer la communication entre KinTPV et Shopify.

Pour ce qui est de l'API version, rendez-vous à la fin de cette page wiki pour connaitre la valeur à renseigner.
Par défaut, les options :

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 :

Processus de synchronisation

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

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”.

Cas particulier : la base produits Shopify est renseignée AVANT l'installation 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.

Erreur courante

413 Request Entity Too Large

Dans le cas où il y aurait une erreur “<html>”,
dont la désignation complète est : 

<html>
<head><title>413 Request Entity Too Large</title></head>
<body>
<center><h1>413 Request Entity Too Large</h1></center>
<hr><center>nginx/1.21.3</center>
</body>
</html>

Il semblerait que cela proviendrait de l’envoi des photos, le correctif passe par un paramétrage du serveur.

Extrait d'un échange sur un forum sur ce sujet :

« 413 Request Entity Too Large » Shopify Bloque Les Demandes De Plus De 1 Mo ?
Je télécharge des fichiers sur mon serveur à l'aide de ******, et cela fonctionne parfaitement sur les demandes inférieures à 1 Mo.
Cependant, lorsque je télécharge plus de 1 Mo sur mon serveur en une seule requête, ma requête est bloquée et une erreur 413 est générée. Cela montre qu'il provient de NGINX dans la réponse.
La requête n'atteint pas mon serveur et est bloquée côté client. Toute aide serait appréciée.

Réponse :

Vous avez dit que vous téléchargiez des fichiers sur votre serveur. Cette erreur n'a donc rien à voir avec Shopify mais plutôt avec votre serveur.
Jetez un oeil aux exigences de téléchargement de fichiers Shopify :
Le code d'état 413 indique que la demande était supérieure à ce que le serveur peut gérer, soit en raison de contraintes physiques, soit de paramètres. Cela se produit généralement lorsqu'un fichier est envoyé à l'aide de la méthode POST à ​​partir d'un formulaire et que le fichier est plus volumineux que la taille maximale autorisée dans les paramètres du serveur.
Vous devez augmenter la valeur des paramètres memory_limit, post_max_size ou upload_max_filesize dans la configuration de votre serveur.

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 :

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) 

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

[...]

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 Préférences KinTPV > Gestion > Site Web.