10/24/2026, 12:00:36 AM
Introduces an inventoryCountDelete mutation for removing draft inventory counts with idempotency support, returning the deleted ID and user errors. Adds an InventoryBinItemSortKeys enum and new reverse, sortKey, and query arguments to inventoryBinItems connections; and exposes inventoryBinItems on InventoryItem and InventoryLocationItem, available only in the unstable API with Physical inventory preview. Adds a provinceCode field to FulfillmentOrderDestination, providing the province code for destinations. Adjusts InventoryAdjustmentGroup.referenceDocumentUri to clarify the example refers to a committed unit. Updates MarketingEvent.marketedResources description to indicate that resources added in the same request have no guaranteed order. Changes the draftOrderComplete note to state that inventory is committed (not reserved) once the order is finalized, so items are no longer available to others. Extends inventory count error code enums with LOCATION_INVENTORY_MANAGED_BY_FULFILLMENT_SERVICE for better handling of fulfillment‑service‑managed stock.
Deletes a draft inventory count. This operation is irreversible.
Counts that are in progress, in review, completed, or canceled can't be deleted.
Requires an @idempotent directive. Retrying with the same key returns the original deleted ID.
Completes a draft order and
converts it into a regular order.
The order appears in the merchant's orders list, and the customer can be notified about their order.
Use the draftOrderComplete mutation when a merchant is ready to finalize a draft order and create a real
order in their store. The draftOrderComplete mutation also supports sales channel attribution for tracking
order sources using the sourceName
argument, cart validation
controls for app integrations, and detailed error reporting for failed completions.
You can complete a draft order with different payment scenarios:
Note:
When completing a draft order, inventory is committed
for the items in the order. This means the items will no longer be available for other customers to purchase.
Make sure to verify inventory availability before completing the draft order.
The set of valid sort keys for the InventoryBinItem query.
Return type for inventoryCountDelete mutation.
An error that occurs during the execution of InventoryCountDelete.
Possible error codes that can be returned by InventoryCountDeleteUserError.
provinceCodeThe alphanumeric code for the province of the destination. For example, ON.
Returns null if the destination has no province, or if the province isn't recognized for the destination's country.
referenceDocumentUriinventoryBinItemsLOCATION_INVENTORY_MANAGED_BY_FULFILLMENT_SERVICELOCATION_INVENTORY_MANAGED_BY_FULFILLMENT_SERVICELOCATION_INVENTORY_MANAGED_BY_FULFILLMENT_SERVICELOCATION_INVENTORY_MANAGED_BY_FULFILLMENT_SERVICELOCATION_INVENTORY_MANAGED_BY_FULFILLMENT_SERVICEinventoryBinItemsA paginated list of the inventory item's on-hand quantities in each bin, across every location.
Excludes each location's default bin.
Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
inventoryBinItemsA paginated list of the inventory item's on-hand quantities in each bin at the location.
Excludes the location's default bin.
Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
marketedResources