Inventory
Requires access scope. Also: The user must have permission to view purchase orders.
A purchase order represents an agreement from a merchant to buy goods or services from a supplier. While the agreement is captured on the merchant's side as a purchase order, it’s recorded as a sales order on the supplier side.
Anchor to FieldsFields
- archivedAt (DateTime)
- currency (CurrencyCode!)
- dateCreated (DateTime!)
- destination (LocationSnapshot)
- id (ID!)
- lineItems (InventoryPurchaseOrderLineItemConnection!)
- name (String!)
- orderedAt (DateTime)
- origin (InventorySupplierSnapshot)
- status (InventoryPurchaseOrderStatus!)
- transfers (InventoryTransferConnection!)
- updatedAt (DateTime!)
- Anchor to archivedAtarchived•Date
At Time The date and time the purchase order was archived.
- Anchor to currencycurrency•Currency
Code! non-null The currency for the purchase order's cost values. The shop's currency will be used if one isn't provided during creation.
Show enum values
- Anchor to dateCreateddate•Date
Created Time! non-null The date and time the purchase order was placed.
- Anchor to destinationdestination•Location
Snapshot The target containing the destination location of the purchase order.
Show fields
- •ID!non-null
A globally-unique ID.
- Anchor to lineItemsline•Inventory
Items Purchase Order Line Item Connection! non-null A list of the purchase order's line items.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to lineItemIdline•ID
Item Id ID of the purchase order line item.
- Anchor to queryquery•String
A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.
Show filters
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to sortKeysort•Purchase
Key Order Line Item Sort Keys Default:ID Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.
Show enum values
Arguments
- Anchor to namename•String!non-null
The name of the purchase order.
- Anchor to orderedAtordered•Date
At Time The date and time the purchase order was confirmed with the supplier.
- Anchor to originorigin•Inventory
Supplier Snapshot The supplier snapshot where the purchase order originates from.
Show fields
- Anchor to statusstatus•Inventory
Purchase Order Status! non-null The current status of the inventory purchase order.
Show enum values
- Anchor to transferstransfers•Inventory
Transfer Connection! non-null The inventory transfers linked to this purchase order.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
- Anchor to updatedAtupdated•Date
At Time! non-null The date and time when the purchase order itself was last updated. Adding, changing, or removing line items doesn't change this value. Each line item's
reflects changes to that line item.
Anchor to QueriesQueries
- inventoryPurchaseOrder (InventoryPurchaseOrder)
- inventoryPurchaseOrders (InventoryPurchaseOrderConnection!)
- •query
Returns an
object by ID.Show fields
- •ID!required
The ID of the inventory purchase order.
Arguments
- •ID!
- •query
Returns a paginated list of purchase orders.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to queryquery•String
A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.
Arguments