2020-01 (RC) release notes

Release date Date version is no longer supported
January 1, 2020 January 1, 2021

This page shows the upcoming changes to Shopify's APIs in version 2020-01.

Developer preview

There are currently no new Shopify admin features for the API changes in version 2020-01, and no developer preview. Use a development store for your development environments.

To use the changes to the API, call the 2020-01 version of the API.

REST Admin API changes

You can manage fulfillments with more control using FulfillmentOrder-based fulfillment. To learn more, refer to Managing fulfillments with the FulfillmentOrder resource.

Fulfillment Services

  • Added the fulfillment_orders_opt_in property to fulfillment services.

Assigned fulfillment orders

  • Added a new route GET /admin/api/2020-01/assigned_fulfillment_orders.json?assignment_status=cancellation_requested&location_ids[]=487838322 to retrieve all the fulfillment orders that are assigned to an app at the shop level.

Cancellation requests

  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancellation_request.json to send a cancellation request to a fulfillment service for a fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancellation_request/accept.json to accept a cancellation request sent to a fulfillment service for a fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancellation_request/reject.json to reject a cancellation request sent to a fulfillment service for a fulfillment order.

Fulfillment requests

  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillment_request.json to send a fulfillment request to a fulfillment service for a fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillment_request/accept.json to accept a fulfillment request to a fulfillment service for a fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillment_request/reject.json to reject a fulfillment request to a fulfillment service for a fulfillment order.

Fulfillment orders

  • Added a new route GET /admin/api/2020-01/orders/#{order_id}/fulfillment_orders.json to retrieve a list of fulfillment orders for a specific order.
  • Added a new route GET /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}.json to retrieve a specific fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancel.json to cancel a fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/close.json to close a fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/move.json to move a fulfillment order.

Fulfillments

  • Added a new route GET /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillments.json to retrieve fulfillments associated with a fulfillment order.
  • Added a new route POST /admin/api/2020-01/fulfillments.json to create a fulfillment for one or many fulfillment orders.
  • Added a new route POST /admin/api/2020-01/fulfillments/#{fulfillment_id}/cancel.json to cancel a fulfillment.
  • Added a new route POST /admin/api/2020-01/fulfillments/#{fulfillment_id}/update_tracking.json to update the tracking information for a fulfillment.

GraphQL Admin API changes

Below are all the changes introduced in the 2020-01 version of the GraphQL Admin API.

Updated fields

New fields

You can manage fulfillments with more control using FulfillmentOrder-based fulfillment. To learn more, refer to Managing fulfillments with the FulfillmentOrder resource.

Updated types

New fields

New types

New mutations

Updated mutations

We added support for required minimum purchase amounts for discounts. When a discount requires a minimum amount, a customer's purchase needs to exceed that value to be eligible for the discount.

Updated types

New types

New fields

Updated fields and types

Storefront API changes

Below are all the changes introduced in the 2020-01 version of the Storefront API.

Updated fields and types

Sign up for a Partner account to get started.

Sign up