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 2021. 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 2021-04 inclut l'API de listes de prix, qui offre des améliorations notables pour le contrôle des prix sur les marchés internationaux. Elle inclut aussi la gestion en bloc des codes de réduction avec GraphQL et des informations sur les droits via l'API Storefront.
Le lancement de cette nouvelle API 2021-04 coïncide avec la suppression de la version 2020-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.
1. API de listes de prix
Avec l'ajout de l'API de listes de prix, cette nouvelle version facilite le contrôle des prix à l'international. L'API de listes de prix vous permet de créer un ensemble de « règles contextuelles » spécifiques, qui font varier le prix des produits en fonction de l'emplacement du client. Si une liste de prix existe pour le produit et le pays depuis lequel le client passe une commande, la vitrine virtuelle affichera le prix correspondant en fonction de ces règles.
Voici un exemple de mutation créant une liste de prix qui offre une réduction pour les clients canadiens :
Les listes de prix permettent de définir soit des prix fixes soit des prix relatifs avec un pourcentage d'ajustement par rapport au prix de base. Elles peuvent être appliquées à tous les pays du monde. Les prix peuvent être augmentés ou diminués, et sont ensuite automatiquement appliqués dans la boutique en ligne et sur la page de paiement, sans action supplémentaire du marchand ni ajout de code par l'application.
Dans l'exemple ci-dessus, un client canadien souhaite acheter un sweat depuis une boutique basée aux États-Unis. Sans liste de prix, le comportement par défaut est utilisé : un taux de conversion de devise et une règle d'arrondi sont appliqués, puis le prix ainsi obtenu est affiché au client. Les listes de prix permettent à la boutique de personnaliser le comportement et d'appliquer un prix fixe défini (par exemple, 35,00 CAD) ou un prix relatif préalablement configuré.
Les listes de prix offrent un contrôle beaucoup plus précis sur la tarification des produits. Elles peuvent être entièrement pilotées depuis l'API. Pour plus d'informations sur l'utilisation des listes de prix, consultez notre tutoriel sur la prise en charge de différents modèles de tarification grâce à l'API de listes de prix.
2. Droits via l'API Storefront
À partir de cette version 2021-04, Shopify renverra les informations sur les droits de douane et autres frais d'importation via l'API Storefront. Cela implique que la signification de certaines ressources de commande et de paiement sera modifiée. Certains totaux cumulés incluront ces droits, et d'autres non. Retenez comme principe général que si une valeur calculée incluait auparavant les taxes, elle inclura également les droits.
Totaux qui n'incluent pas les droits :
- Checkout.lineItemsSubtotalPrice
- Checkout.subtotalPriceV2
- Order.currentSubtotalPrice
- Order.subtotalPriceV2
Totaux qui incluent les droits :
- Checkout.paymentDueV2
- Checkout.totalPriceV2
- Order.currentTotalPrice
- Order.totalPriceV2
Pour plus d'informations sur l'ajout des droits dans l'API Storefront, consultez notre article dédié dans le journal des changements pour les développeurs.
3. Améliorations de l'API pour les codes de réduction
Nous avons modifié dans cette version 2021-04 la façon dont les applications peuvent gérer les codes de réduction avec GraphQL. Il est désormais possible d'ajouter en bloc des codes de réduction échangeables, plutôt que de faire des requêtes séparées pour mettre à jour les codes de réduction associés à une règle de tarification donnée.
Voici un exemple de mutation :
Variables :
Une mutation appelée discountCodeCount a également été ajoutée, afin de vous permettre de compter les codes de réduction associés à une boutique donnée. Les applications qui utilisaient auparavant REST pour profiter de la création de codes en bloc ou du point de terminaison de comptage peuvent maintenant utiliser GraphQL et bénéficier du débit supplémentaire avec ces nouvelles mutations.
Restez au courant de toutes les nouveautés
Pour connaitre 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 utilisant toutes les nouvelles fonctionnalités dès leur sortie dans la prochaine version d’API candidate, 2021-07.Rejoignez le programme des partenaires de Shopify
Inscrivez-vous gratuitement au programme partenaire de Shopify. Accédez à des outils et ressources pour aider les marchands Shopify à développer leur activité et faites partie d’un écosystème riche en opportunités.
Devenir partenaire Shopify
Publié par Maud Leuenberger. Maud est la rédactrice en chef du blog français de Shopify.
Texte original par Shayne Parmelee. Traduction par Solenn Marchand. Image : Burst.