Expose Fulfillment References for Refunded Items in GraphQL

Hey everyone,

I’d like to suggest an enhancement to the Shopify Admin GraphQL API when it comes to refunds. Currently, the refund references only show the order-level LineItem, making it difficult to determine which specific fulfillment line (if any) is associated with a refunded item.

What I’m Proposing:
1. Fulfillment Line ID for Fulfilled Refunds: If an item that has already been fulfilled is refunded, include a reference like fulfillmentLineId to directly correlate the refund with the specific fulfillment line.
2. Fulfillment Order Line ID for Unfulfilled Refunds: If an item is refunded before fulfillment, expose a field like fulfillmentOrderLineId so it’s clear which pending fulfillment order line is affected.

Reason for request:

  • In case of a fulfilled refund it is not possible to know which fulfillment the quantity has affected. When a fulfillment is being cancelled it would not be possible to attribute that refund to the fulfillment being cancelled.
  • If case of a unfulfilled refund with no stock in it is not possible to know which location did the inventory got deducted from since the refund line has null location id.

I believe this addition would simplify workflows and provide a more robust audit trail. If anyone else would find this useful or has any thoughts on how to achieve similar results, please chime in below!

Thanks in advance!