Guide Connecteur personnalisé : Shopify

En suivant le lien suivant, vous pouvez télécharger mon connecteur personnalisé servant à récupérer des données (GET) depuis votre compte Shopify : https://github.com/Juli3n75/PowerAutomate

PRÉREQUIS
Avant de pouvoir l’utiliser, vous devez créer une Application privée dans l’administration de votre boutique Shopify.
Les deux informations servant à créer la connexion sont les suivantes :

Téléchargemnent et déploiement

Pour utiliser le connecteur, veuillez le télécharger de puis mon profil GitHub : https://github.com/Juli3n75/PowerAutomate-Shopify

Télécharger le fichier nommé MIQUEL.JULIEN.Shopify.swagger.json et se rendre ensuite dans l’administration de Power Automate.
Cliquer sur Données / Connecteurs personnalisés puis cliquer sur Nouveau connecteur personnalisé :

Importer le fichier

Sélectionner le fichier téléchargé et donner le nom souhaité :

Créer le connecteur dans votre plateforme Power Automate

Remarque : Suite au clique sur Continuer, il est possible que l’image du connecteur ne s’affiche pas…
Votre connecteur est maintenant déployé.

Description des actions

Dans le connecteur, il y a une liste d’actions qui sont mises à disposition pour vos flux Power Automate :

Nom de l’actionDescriptionLien Documentation API Shopify
Retrieve all ordersPermet de récupérer toutes les commandes de votre boutique.
Champs obligatoires :
– Status : Any, closed, paid, open
Non obligatoires :
– Created_at_min : Format de la date : YYYY-MM-DD
https://shopify.dev/api/admin/rest/reference/orders/order
Retrieve all productsPermet de récupérer tous les produits de votre boutique.
Champs non obligatoires :
– Status
https://shopify.dev/api/admin/rest/reference/products
Retrieve all contactPermet de récupérer tous les contacts de votre boutique.
Champs non obligatoires :
– State
https://shopify.dev/api/admin/rest/reference/customers
Retrieve one orderPermet de récupérer une commande spécifique de votre boutique.
Champs obligatoires :
– order_id
https://shopify.dev/api/admin/rest/reference/orders/order
Retrieve All Fulfillment EventPermet de récupérer les détails de la commande, les évènements (Statut de livraison, etc.), contenant notammenent la liste des produits de la commande et les infos de livraison.
Champs obligatoires :
– order_id
https://shopify.dev/api/admin/rest/reference/shipping-and-fulfillment/fulfillment
Retrieve fulfillment for an orderPermet de récupérer les évènements d’une commande spécifique.
Champs obligatoires :
– oder_id
– fulfillment_id
https://shopify.dev/api/admin/rest/reference/shipping-and-fulfillment/fulfillment
Retrieve Abandoned checkoutsPermet de récupérer les paniers abandonnés ou en cours.
Champs non obligatoires :
– Created_at_min
https://shopify.dev/api/admin/rest/reference/orders/abandoned-checkouts

Exemple d’utilisation

Dans l’exemple suivant, l’action Retrieve all orders est utilisée.
Le contexte de l’action est le suivant : Je souhaite récupérer uniquement les commandes non traitées du jour.
Pour se faire, ajouter l’action Retrieve all orders dans votre Flux, et paramétrer l’action de cette manière :

Paramétrage de l’action

Le fomat de la date du jour doit être : utcNow(‘yyyy-MM-dd’).
Suite à l’éxecution du flux, voici le code rréceptionné sous format JSON (Jài volontairement enlevé toutes les finormations sensibles et une grande partie des données) :

[
  {
    "id": ,
    "admin_graphql_api_id": "gid://shopify/Order/",
    "app_id": 580111,
    "browser_ip": "38.133.",
    "buyer_accepts_marketing": false,
    "cart_token": "89b3edb2f899d4e4eadcff932e9f47b8",
    "checkout_id": 21089527136420,
    "checkout_token": "5f8aa8a0c6618693d81e61b9cb33afa5",
    "client_details": {
      "accept_language": "en-US,en;q=0.9",
      "browser_height": 657,
      "browser_ip": "38.133.",
      "browser_width": 1349,
      "session_hash": null,
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
    },
    "confirmed": true,
    "contact_email": "",
    "created_at": "2021-07-13T09:21:20-04:00",
    "currency": "CAD",
    "current_subtotal_price": "49.99",
    
[...................................]

Dans l’ensemble des données, une unique commandée ouverte créée ce jour est récupérée. (Voir valeur en gras – Flux executé le 13 juillet 2021)