Shopify has released new guidelines and updated documentation for the referenceDocumentUri field in inventory adjustment mutations. This field now comes with detailed guidelines to help developers link inventory adjustments to source documents more effectively. Merchants can access adjustment history and traceability data through the "Inventory adjustment changes" report in Analytics or the Adjustment History Page in their admin.
Proper use of referenceDocumentUri directly impacts inventory traceability—a critical capability for merchants who need to troubleshoot stock discrepancies and conduct compliance audits. By following Shopify's new guidelines, your app can help merchants maintain accurate inventory records and quickly identify the source of any adjustment. This strengthens trust in your app and reduces the friction merchants experience when managing their inventory operations.
If you're building or maintaining a Shopify app that handles inventory adjustments, GetShopifyToken makes it easy to securely manage your OAuth tokens and API authentication. Focus on implementing these inventory guidelines while we handle the token security for you.