Skip to main content

supplyPurchaseOrders

Retrieves purchase orders with filtering and sorting capabilities.

Authentication​

Authentication is required. Unauthenticated requests will fail.

Permissions​

Requires supply:read_purchase_orders permission for the requested brands.

Brand Filtering​

Results are automatically filtered by brand. If no brand is specified in filters, the current brand from the session context is used. You must have permissions for all brands you request.

Possible Errors​

  • Authentication error if not logged in
  • Permission error if lacking access to requested brands
supplyPurchaseOrders(
  after: String
  before: String
  filters: POFilterInput
  first: Int
  last: Int
  sortField: POSortFieldEnum = CREATED_AT
  sortOrder: SortTypeEnum = DESC
): PurchaseOrderConnection!

Arguments​

supplyPurchaseOrders.after ● String scalar​

Returns the elements in the list that come after the specified cursor.

supplyPurchaseOrders.before ● String scalar​

Returns the elements in the list that come before the specified cursor.

supplyPurchaseOrders.filters ● POFilterInput input​

Filter criteria to narrow down purchase order results

supplyPurchaseOrders.first ● Int scalar​

Returns the first _n_ elements from the list.

supplyPurchaseOrders.last ● Int scalar​

Returns the last _n_ elements from the list.

supplyPurchaseOrders.sortField ● POSortFieldEnum enum​

Field to sort purchase orders by (defaults to created_at)

supplyPurchaseOrders.sortOrder ● SortTypeEnum enum​

Sort direction - ASC for ascending, DESC for descending (defaults to DESC)

Type​

PurchaseOrderConnection object​

The connection type for PurchaseOrder.