referenceDocumentUri does not appear in the UI

Fulfillment & Inventory
1

I tried filling out referencedocumenturi field in inventorySetQuantities mutation.

I would expect it to show up as a link on “inventory adjustment history”, however nothing shows up:

CleanShot 2025-02-03 at 17.31.40
CleanShot 2025-02-03 at 17.31.401556×412 38 KB

Where can I expect reference document URI to show up in the UI?

2

Hi just to confirm, is this screenshot from the Shopify admin or your own UI? Can you post the full mutation you’re making?

3

Yes, the screenshot is from Shopify Admin UI (full URL).

Mutation and response below. You can see that reference document id has been echoed back.

{"query":"
  mutation InventorySet($input: InventorySetQuantitiesInput!) {
    inventorySetQuantities(input: $input) {
      inventoryAdjustmentGroup {
        createdAt
        reason
        referenceDocumentUri
        changes {
          name
          delta
        }
      }
      userErrors {
        field
        message
      }
    }
  }
","variables":{
"input":{
  "name":"available",
  "reason":"correction",
  "quantities":[
    {
      "inventoryItemId":"gid://shopify/InventoryItem/41502250205220",
      "locationId":"gid://shopify/Location/36756848676",
      "quantity":111
    }
  ],
  "ignoreCompareQuantity":true,
  "referenceDocumentUri":"http://www.kruszewski.com/"}
  }
}

Response:

{
  "data": {
    "inventorySetQuantities": {
      "inventoryAdjustmentGroup": {
        "createdAt": "2025-02-07T17:10:27Z",
        "reason": "correction",
        "referenceDocumentUri": "http://www.kruszewski.com/",
        "changes": [
          {
            "name": "available",
            "delta": -12
          },
          {
            "name": "on_hand",
            "delta": -12
          }
        ]
      },
      "userErrors": []
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 11,
      "actualQueryCost": 11,
      "throttleStatus": {
        "maximumAvailable": 4000.0,
        "currentlyAvailable": 3989,
        "restoreRate": 200.0
      }
    }
  }
}

Updated screenshot:

CleanShot 2025-02-07 at 18.58.50
CleanShot 2025-02-07 at 18.58.501172×663 104 KB

4

@Liam-Shopify Any updates here? I’m seeing the same behavior where neither ledgerDocumentUri or referenceDocumentUri are linked/displayed in the UI. Our requests were using 2024-04

5

Hey folks - I did connect with the product team on this, and our team are aware and working on resolving this. I don’t have an ETA to share on when this will be resolved, but I’ll report back here when I have more info.

2 Likes
6

Hi @nealshepherd & @Dropstream_Team, you’ll see this now on adjustment history as you expected in initial post, as well as in the new inventory adjustment reports in analytics.

Let us know what you think.

If you use

^gid:\/\/[^\/]+\/[^\/]+\/[^\/?]+(\?.*)?$

which matches format:

gid://xxxx/xxxx/xxxxxx
or
gid://xxxx/xxx/xxxx?tsest=1234

so like
gid://appName/purchaseOrder/123456789

You’ll get the best popover experience as we can then parse into the title of the popover on adjustment history page. Otherwise, any valid URI works.

1 Like
7

Also see: Using referenceDocumentUri for inventory traceability

1 Like