Ce que fait le bouton Refresh Access Token de Shopify Connector, pas à pas

Avant de le chercher : où il se trouve et quand il apparaît

Le bouton Refresh Access Token se trouve dans l'écran Shopify Instances, dans les branches 17, 18, 19 et 20 du module. Ce qui suit décrit le code publié pour Odoo 20.0.

• Allez dans le menu Ventes (Sales), puis Shopify, puis Control Center et enfin Instances, et ouvrez la fiche de l'instance.

• Si vous ne voyez pas le bouton, c'est normal avec les valeurs par défaut : il est masqué lorsque le champ Shopify connection a la valeur cloud, qui est la valeur par défaut. Ce champ n'apparaît dans aucune vue.

• Gardez à l'esprit que le bouton est l'exception et non l'étape normale : la section suivante explique ce qui se passe sans l'utiliser.

Ce qui se passe sans rien cliquer

Le renouvellement du jeton ne dépend pas seulement du bouton. Le module comporte une vérification du jeton d'accès de l'instance qui peut aussi le déclencher, et on y arrive sans toucher au bouton.

• Il renouvelle lorsqu'on demande expressément de forcer le renouvellement et que l'instance a un jeton de rafraîchissement.

• Il renouvelle lorsque l'instance a enregistré une date d'expiration, qu'on est à cinq minutes de cette date (ou qu'elle est dépassée) et qu'il y a un jeton de rafraîchissement.

• Sans date d'expiration enregistrée et sans forçage, cette vérification se termine sans rien faire.

• Sans jeton de rafraîchissement, ce chemin ne demande rien à Shopify.

• Voici d'où l'on arrive à cette vérification :

• à l'enregistrement de la fiche d'un transfert ;
• à la validation d'un transfert avec le bouton standard d'Odoo, que le module étend ;
• la tâche planifiée Shopify Process Webhooks, chaque minute, active à l'installation ;
• la tâche planifiée Shopify Pull Stock (Shopify → Odoo), toutes les six heures, désactivée à l'installation ;
• la tâche planifiée Shopify Sync Orders, toutes les cinq minutes, désactivée à l'installation ;
• la tâche planifiée Shopify Sync Products, toutes les heures, désactivée à l'installation.

Si la tâche de stock et son bouton vous intéressent, ils ont leur propre article : ce que fait le bouton Pull Stock.

En cliquant à la main : ce qu'il vérifie et ce qui change

Cliquer sur le bouton est la voie pour renouveler le jeton à la main. Le bouton parcourt les fiches sur lesquelles il agit et, pour chacune, lance le renouvellement.

• Première vérification : que l'instance ait un jeton de rafraîchissement. S'il est vide, l'action s'arrête avec Jeton de rafraîchissement manquant pour l'instance Shopify … (Missing refresh token for Shopify instance …), où le code insère le nom affiché de l'instance.

• Avec un jeton de rafraîchissement, il envoie à Shopify la clé et le secret de l'app de l'instance avec ce jeton, et attend la réponse pendant le délai d'attente configuré dans l'instance, avec un minimum de cinq secondes.

• Il lit la réponse. Si elle ne contient pas de jeton d'accès, l'action s'arrête avec La réponse de rafraîchissement du jeton Shopify n'incluait pas de jeton d'accès. (Shopify token refresh response did not include an access token.).

• Si la réponse contient un jeton d'accès, il enregistre le nouveau ainsi que la date et l'heure de ce renouvellement.

• Si la réponse inclut un nouveau jeton de rafraîchissement, il remplace l'ancien ; sinon, on conserve celui qui existait.

• Si la réponse indique pendant combien de secondes le jeton est valable, il calcule la nouvelle date d'expiration en ajoutant ces secondes au moment présent ; sinon, il ne touche pas à la date d'expiration.

• Rappelez-vous la différence avec le chemin automatique : le bouton ne regarde pas la date d'expiration. À chaque clic, et tant qu'il y a un jeton de rafraîchissement, il demande un nouveau jeton.

Si un message apparaît

Ces messages apparaissent en cliquant sur Refresh Access Token et interrompent l'action avant d'enregistrer quoi que ce soit pour cette instance.

• Avec le message du jeton de rafraîchissement : l'instance n'a pas cette donnée enregistrée et le bouton ne demande rien à Shopify. Rien n'a été modifié.

• Avec le message de la réponse sans jeton d'accès : Shopify a répondu, mais la réponse ne contenait pas de jeton d'accès. Le jeton que l'instance possédait n'a pas été touché.

• Après avoir cliqué, vérifiez que l'action se termine sans aucun de ces messages.

Ce dont le module a besoin

Le module coûte 9 € par version d'Odoo, pour 17, 18, 19 et 20, HT, en paiement unique. Il nécessite en outre l'abonnement à FlexigoTech Cloud : le plan Connecteur coûte 49 €/mois ou 490 €/an HT. Vous pouvez voir chaque version sur la fiche d'Odoo Apps.

Si vous souhaitez de l'aide

FlexigoTech met en place Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure. Si votre instance Shopify ne correspond pas à ce que décrit cette liste, on peut la passer en revue avec vous.

À lire aussi

Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources

• Code du module : flexigobe_shopify_connector 20.0 (c7078cd8): views/shopify_instance_views.xml
• Code du module : flexigobe_shopify_connector 20.0 (c7078cd8): models/shopify_instance.py
• Code du module : flexigobe_shopify_connector 20.0 (c7078cd8): models/fgt_cloud.py
• apps.odoo.com/apps/modules/20.0/flexigobe_shopify_connector
• apps.odoo.com/apps/modules/17.0/flexigobe_shopify_connector
• apps.odoo.com/apps/modules/18.0/flexigobe_shopify_connector
• apps.odoo.com/apps/modules/19.0/flexigobe_shopify_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html