Shopify API Release: April 2020

The 2020-04 API release is here. Learn what’s included in this release, including duty and tax calculation by default, Storefront API updates, rich media filenames, and more. Read more to get the highlights of the platform changes coming with this API version.

Welcome to the April 2020 edition of our API features roundup, designed to help you understand how all the changes of our latest API release can be adopted to improve the quality of your apps.

Most of the changes in our 2020-01 release focused on merchandising, and order and fulfillment flows. This quarter’s release, however, includes the introduction of duty and tax calculation, as well as updates to the Storefront API.

Let's dig into the changes in the 2020-04 release by discovering new features for checkout, and additional fields in Storefront API objects.

Released as part of 2020-04

Below are the features included in the 2020-04 release.

1. Duty and tax calculation

For merchants selling internationally, allowing buyers to pay duties in the checkout can reduce the risk of delayed orders at customs, added shipment costs, and buyers rejecting shipments.

The 2020-04 version introduces a Duties and taxes developer preview that gives you an early look at how your clients will be able to provide total cost clarity to their buyers using estimated duties and taxes at checkout. This will not only help your users’ customers pay for duties at checkout, but will also allow you to surface duties and taxes in your app’s workflows.

NOTE: Duty and tax estimates are placeholder values while the feature is in developer preview.

This release allows apps to read the duties paid on an order through the REST and GraphQL Admin API, and refund them through the GraphQL API. Refunds and order line items with duties now have a duties field. Orders will also feature original_total_duties_set as well as the current_total_duties_set after refunds. 

Most importantly, the total_price_set on orders now includes any duties that have been paid during checkout across all API versions. Once this feature launches to merchants, all stores that enable duty and tax calculation will include duties in order totals by default and refunds will need to process duty returns on applicable orders.

To learn more about refunding duty and tax information through the API and how you can update your app to include duties, check out our tutorial.

2. Storefront API additional fields on products and orders

In the 2020-01 version, we introduced order editing, allowing apps to help manage all aspects of orders on a shop, including edits to line items on existing orders. The Storefront API Order object has been updated to reflect these new features and includes new fields to help you display orders on custom storefronts accurately—even after they’ve been edited.

The new Storefront Order object includes LineItem objects as well as order edit information, fulfillment status, and pricing details.

As part of the 2020-04 version, the Storefront API also exposes new fields to support translations and internationalization, and inventory status and counts.

You can read all about the new Storefront API fields in our release notes.

3. Exposing rich media filenames

In the last API version, we introduced a media connection for products in GraphQL. In order to make it easier to work with rich media files, we’re exposing media filenames with two new fields: expose_video_filename and expose_model3d_filename.

To learn more about how to use this connection and start including richer media experiences on the product page, visit our guide on working with product media.

2019-04 version removal postponement

As mentioned in our recent post on How Shopify Partners are Responding to COVID-19, we’ve decided to postpone the 2019-04 version removal to July 1, 2020, so that you can focus on helping merchants and other partners in these challenging times. Instead, both 2019-04 and 2019-07 API versions will be removed on July 1st. 

This postponement also means that the move from page-based to cursor-based pagination will come into effect for all endpoints on July 1, which should simplify the migration process for your apps. You can find more information on how to migrate your app in our post on how to use relative pagination in your app.

For those of you who’ve already put in the time and energy to update, we want to say thank you for your diligence and understanding in the extension—your efforts haven’t gone to waste. You’re now ahead of the game, and can focus on more pressing matters for your business, clients, and app users.

Stay on top of changes

To stay up to date with the changes coming to the next release, remember to subscribe to the Developer Changelog so that you can start using features as soon as they ship into the release candidate for 2020-07. You can also subscribe to What’s New for Shopify Partners, our monthly product email, via the link below.