Shopify

Shopify API Release: April 2021

shopify-api-release:-april-2021

Welcome to the April 2021 edition of our API features roundup, designed to help you understand how you can adopt all the latest changes to improve the quality of your apps and streamline your development experience.

This version includes the Price List API, which provides huge improvements to pricing control in international markets. Also released as a part of 2021-04: bulk discount code management with GraphQL and duties information on the Storefront API.

The 2021-04 launch also coincides with the removal of version 2020-04, so remember to check your API health report to make sure you’re compatible and review the changes coming.

Build apps for Shopify merchants

Whether you want to build apps for the Shopify App Store, offer custom app development services, or are looking for ways to grow your user base, the Shopify Partner Program will set you up for success. Join for free and access educational resources, developer preview environments, and recurring revenue share opportunities.

Sign up

1. Price List API

In this version, international pricing control has never been better with the addition of the Price List API. The Price List API allows you to create a set of rules that change products’ prices based on specific “context rules” about the customer’s location. If a Price list exists for the product and geography the customer is ordering from, the storefront will charge a different price based on those rules.

See an example mutation to create a price list for discounted Canadian prices:

Price lists support fixed prices or relative adjusted prices and can be applied to any country in the world. Prices can be increased or decreased, and are then applied automatically in the online store and during checkout with no additional work from the merchant or code that needs to be inserted by the app.

Shopify API release April 2021: Flow chart of the possibilities of fixed prices or relative adjusted prices, using the example of a customer in Canada trying to pay for a product on a US-based store. The three options are: 1. Fixed product price in Canadian dollars. 2. Adjusted relative price, which is based on the American price multiplied by Adjustment multiplied by FX rate plus rounding. 3. Initial price, based on the American price multiplied by FX rate plus rounding.
An example flow of how a Price List is able to change the price of a sweater.

In the example above, a Canadian customer is trying to buy a sweater from a store based in the US. Without a price list, the default behavior would be to apply a FX rate, apply rounding, and then display that price to the customer. Price lists allow the store to instead apply a specific fixed price (ex. $35.00 CAD), or apply a preconfigured adjusted relative price.

Price lists give much finer-grained control over product pricing, and are all controllable through the API. For more information on how to use price lists, refer to our tutorial on supporting different pricing models through the Price List API.

2. Duties through the Storefront API

As of the 2021-04 version, Shopify will return information about duties through the Storefront API. This change means there will be some changes to the meaning of some of the order and checkout resources to support this new functionality. Some summed totals will include duties, and others won’t. A good guiding principle: if it was a calculated value that included taxes before, now it also includes duties.

Totals that don’t include duties:

  • Checkout.lineItemsSubtotalPrice
  • Checkout.subtotalPriceV2
  • Order.currentSubtotalPrice
  • Order.subtotalPriceV2

Totals that do include duties:

  • Checkout.paymentDueV2
  • Checkout.totalPriceV2
  • Order.currentTotalPrice
  • Order.totalPriceV2

For more information on the addition of Duties to the storefront API, visit our post on the Developer Changelog.

3. Discount Code API improvements

As of version 2021-04, we’ve made some changes to how apps can manage discount codes with GraphQL. When managing discounts, it’s now possible to add redeemable discount codes in bulk rather than make individual queries to update discount codes associated with a given Price Rule.

An example mutation:

Variables:

A mutation named discountCodeCount has also been added, allowing you to count the number of discount codes associated with a given shop. Apps that had been previously using REST to take advantage of bulk code creation or the count endpoint can now use GraphQL, and benefit from the added throttle throughput along with these new mutations.

Stay on top of changes

For all Shopify platform changes, make sure to subscribe to the Developer Changelog, the primary source of information for all new product launches. Stay up to date using the changelog, and stay ahead of the curve by adopting new features as soon as they’re shipped into the upcoming 2021-07 release candidate.

Special thanks to our friends at the Shopify Partner Blog for their insights on this topic.

About the author

Steve Hutt

Steve has entrepreneurship in his DNA, starting in the early days of online commerce when he achieved Power Seller status through his eBay store. This propelled him to become a co-founder of VisionPros.com, a contact lens and eyewear retailer. With a successful exit from his startup, he embarked on his next journey into agency work in e-commerce and digital strategy.

Currently, Steve is a Senior Merchant Success Manager at Shopify Plus, where he helps identify, navigate, and accelerate growth in the complex world of commerce.

To maintain his competitive edge, Steve also hosts the eCommerce Fastlane Podcast and Shopify Founder Stories, a top-rated twice-weekly podcast where he interviews Shopify Partners and subject matter experts who share the latest marketing strategy, tactics, platforms, and must-have apps, to help Shopify brands improve efficiencies, grow revenue, profit, and lifetime customer loyalty.

Add Comment

Click here to post a comment