Skip to main content

Find products

Use product lookup when a merchant integration needs to resolve Pickware product IDs before reading stock, creating purchasing data, or building order workflows.

Available operations​

  • List and filter products with products.
  • Load a product by global ID with product.
  • Traverse variants through the children field on Product.

Example: find a product by SKU​

query ProductBySku($sku: String!) {
  products(filter: { productNumber: { equals: $sku } }) {
    edges {
      node {
        id
        productNumber
        gtin
        name
      }
    }
  }
}

Example: find a product by GTIN​

The GTIN is exposed as the gtin field on the Product type.

query ProductByGtin($gtin: String!) {
  products(filter: { gtin: { equals: $gtin } }) {
    edges {
      node {
        id
        productNumber
        gtin
        name
      }
    }
  }
}

Store the returned id when the next operation needs a product reference, for example stock mutations or supplier order line items.