API Shopify : les nouveautés de la version d'avril 2022

Dans cet article, nous allons passer en revue les nouvelles fonctionnalités de l’API que nous venons de lancer en ce mois d'avril 2022. Vous découvrirez ainsi comment ces nouveautés vous aideront à améliorer la qualité de vos applications et votre expérience de développement.

Cette version inclut la toute nouvelle API de segmentation client. Elle intègre aussi de nouvelles fonctionnalités pour suivre le traitement des commandes avec des données relatives aux délais de traitement et d’expédition, et offre une meilleure visibilité de la taxonomie des produits.

Elle ajoute également des fonctionnalités permettant d’offrir des réductions à l'aide de l'API d'abonnement aux applications. Enfin, elle inclut des mises à jour de l'API Storefront qui permettent d'obtenir des devis de livraison à partir de l'API de panier.

Le lancement de cette nouvelle version coïncide avec la suppression de la version 2021-04. Assurez-vous donc de consulter votre rapport de santé (ou health report) des API pour vérifier que vos boutiques sont compatibles et n'oubliez pas de consulter les changements à venir.

Pour connaître la liste complète des changements d’API associés à cette version, consultez les notes de la version 2022-04.

1. Segmentation client

Les segments clients sont une nouvelle fonctionnalité qui remplace les recherches enregistrées de clients. Auparavant, les recherches enregistrées de clients ne permettaient d’effectuer que des recherches en texte libre parmi les clients.

Ainsi, une recherche portant sur le terme « Martin » pouvait renvoyer à des clients portant le prénom Martin ou vivant à Saint-Martin par exemple. Malheureusement, avec les recherches enregistrées, il n'y avait aucun moyen de filtrer ces résultats et de n’extraire que les clients qui vous intéressaient.

Les segments clients offrent beaucoup plus de possibilités. Ils vous permettent de spécifier les champs clients devant correspondre à votre recherche. Par exemple, les segments peuvent inclure :

• Les clients ayant acheté un produit spécifique
• Les clients résidant dans une ville donnée
• Les clients ayant dépensé un certain montant dans la boutique

Les marchands peuvent alors utiliser ces informations pour envoyer des messages marketing aux clients d'un segment donné, ou mieux comprendre le comportement des membres du segment.

Pour créer un nouveau segment à l’aide de l’API, vous pouvez utiliser la mutation segmentCreate avec un nom et la requête que vous souhaitez utiliser pour segmenter les clients :

Réponse :

Pour plus d'exemples et pour voir toutes les requêtes et mutations disponibles pour gérer les segments, consultez notre documentation relative à l'API de segmentation sur le site shopify.dev.

2. Taxonomie des produits

Les types de produits standards, lancés avec la version 2022-01, aident les marchands à organiser les produits de leur boutique. Avec cette version 2022-04, une API est disponible pour obtenir des informations sur tous les types de produits standards pris en charge par Shopify. Ces informations sont accessibles avec productTaxonomyNodes via l'API GraphQL.

La requête suivante va obtenir tous les nœuds de taxonomie des produits associés à des bijoux (jewelry) :

Réponse :

Lorsque vous créez un produit, vous pouvez utiliser les valeurs de types standards proposées pour garantir que les produits s’afficheront au bon endroit sur la boutique en ligne.

Pour en savoir plus sur les types de produits ou pour parcourir la liste complète des nœuds de taxonomie interrogeables avec l'API, consultez notre documentation.

3. Délai de traitement des commandes et délai d’expédition

Trois nouveaux champs sont désormais disponibles via l'API pour vous aider à comprendre les attentes en matière de traitement et d'expédition des commandes fulfillment créées sur les places de marché. Ces champs sont particulièrement importants pour les places de marché qui offrent une garantie de livraison.

Par exemple, il est possible que les marchands doivent traiter certaines commandes avant d'autres pour répondre aux attentes des clients en matière de livraison.

Les trois nouveaux champs disponibles sur ces commandes sont les suivants :

• minDeliveryDateTime : la date et l’heure auxquelles la livraison est attendue au plus tôt.
• maxDeliveryDateTime : la date et heure auxquelles la livraison est attendue au plus tard.
• fulfillBy : la date et heure à laquelle le propriétaire de la boutique doit avoir traité au plus tard tous les articles de la commande afin de respecter les délais de livraison de la commande.

Tous ces champs sont disponibles dans GraphQL et peuvent être récupérés à partir des commandes fulfillment :

4. Réductions sur la facturation des abonnements à des applications

Avec cette version 2022-04, vous pouvez utiliser le champ de réduction dans la mutation appSubscriptionCreate pour offrir une remise sur abonnement dans le cadre des frais récurrents. Ces réductions peuvent être un pourcentage ou un montant forfaitaire déduit du coût de l'abonnement.

Les réductions sur les abonnements aux applications peuvent également s'appliquer à un nombre de cycles de facturation prédéfini. Par exemple, vous pouvez offrir à un marchand 50 % de réduction sur 3 cycles de facturation, avant de rebasculer sur le tarif habituel.

Voici un exemple de mutation créant un abonnement avec une remise de 50 % les 3 premiers mois :

Réponse :

Pour découvrir plus d'exemples de réductions sur les frais récurrents, consultez notre documentation sur le site shopify.dev.

5. Mise à jour du panier de l’API Storefront

CartDeliveryGroups permet aux applications utilisant l'API Storefront d'afficher facilement des informations sur les options de livraison vers une adresse spécifique pour une ou plusieurs rubriques. Si le client est connecté, vous pouvez obtenir des informations sur les options de livraison disponibles directement depuis le panier.

L'objet CartDeliveryGroups inclut l'adresse de destination d'un groupe de livraison et les options de livraison disponibles pour les rubriques de ce groupe. Les options de livraison incluent le nom, le code, la description et le prix du mode d'expédition.

Consultez notre documentation pour les développeurs pour en savoir plus sur cette nouvelle fonctionnalité et apprendre à utiliser les mutations cartCreate et customerCreate afin de créer un panier pour un client connecté.

Restez au courant de toutes les nouveautés

Pour connaître toutes les nouveautés de la plateforme Shopify, abonnez-vous au journal des changements pour les développeurs Shopify, la principale source d’information pour tous les nouveaux lancements de produits. Utilisez régulièrement ce journal et restez à la pointe en adoptant toutes les nouvelles fonctionnalités dès leur sortie dans la prochaine version d’API candidate, 2022-07.

---

Version originale par : Shayne Parmelee / Traduction par : Solenn Marchand