Back to Developer changelog

New parameter on fulfillmentServiceDelete to control inventory behaviour on location removal

API

Effective October 01, 2024

As of GraphQL API version 2024-10 we will introduce a new enum field for the fulfillmentServiceDelete mutation. The inventoryAction field will allow partners to specifiy the behaviour regarding the inventory when deleting a fulfillment service. The options are:

  1. KEEP - this option will convert a Fulfillment Service's locations to be owned by the merchant and therefore the inventory at those locations becomes the responsiblity of the merchant.
  2. DELETE - this option, when there are no outstanding fulfillments, will delete the inventory at the location and then the location itself.
  3. TRANSFER - this is the existing behaviour, where a destinationLocationId is provided as the destination to relocate the inventory to, before the location is deleted.

If either KEEP or DELETE are provided, it is not possible to also specify a destinationLocationId.

If KEEP is provided, then the merchant must have a sufficient remaining quota of locations on their plan for this operation to succeed, an error will be returned if they do not.