9/18/2026, 12:01:05 AM
The unstable API has had publisher changes: the descriptions for inventoryPurchaseOrder and inventoryPurchaseOrders queries were simplified, removing the note about unstable API/preview feature. The mutations discountsAllocatorFunctionRegister and discountsAllocatorFunctionUnregister and their payload types have been removed, meaning apps can no longer register or unregister discounts allocator functions. The draftThemeFilesCommit mutation now explains that a successful commit consumes the session; sessions cannot be reused after a non‑contention commit, and clients must restart staging with a new session ID if they retry. On the InventoryPurchaseOrder type, the legacy referenceName field was removed and a new paginated transfers field was added to link associated inventory transfers. InventoryShipment and InventoryShipmentLineItem gained new cancellation metrics – totalCanceledQuantity at the shipment level and canceledQuantity on each line item. Additional enum values were added: CANCELED to InventoryShipmentReceiveLineItemReason and INVALID_SHIPMENT_INPUT to InventoryShipmentReceiveUserErrorCode; the Collection type received a new createdAt field; the market fields on CompanyLocation and Customer got revised descriptions (while remaining deprecated); InventorySupplierSnapshot replaced supplier with supplierName; and the InventorySupplier type was removed.
Returns an InventoryPurchaseOrder object by ID.
Returns a paginated list of purchase orders.
Registers a discounts allocator function.
Unregisters a discounts allocator function.
Commits staged theme file changes for a caller-provided session. After any attempt other than session lock contention, the session is consumed and scheduled for cleanup. Retry by staging the complete desired snapshot under a new session ID.
Return type for discountsAllocatorFunctionRegister mutation.
Return type for discountsAllocatorFunctionUnregister mutation.
An error that occurs during the execution of a discounts allocator function mutation.
Possible error codes that can be returned by DiscountsAllocatorFunctionUserError.
Represents an inventory supplier associated with a purchase order.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
createdAtThe date and time when the collection was created.
marketmarketreferenceNametransfersThe inventory transfers linked to this purchase order.
totalCanceledQuantityThe total quantity of items marked as canceled across all line items in this shipment.
canceledQuantityThe quantity of items that were marked as canceled in this shipment line item.
CANCELEDINVALID_SHIPMENT_INPUTsuppliersupplierNameThe name of the supplier as it was when the purchase order was created.