Shopify Restock a Product Variant

arazzo: 1.0.1
info:
  title: Shopify Restock a Product Variant
  summary: Read a variant to find its inventory item, resolve a location, and set the available quantity.
  description: >-
    Restocks a specific product variant by quantity. The workflow lists the
    product's variants to resolve the variant's inventory item, lists locations
    to resolve the target location, and sets the available quantity for that
    inventory item at that location. This is the variant-centric entry point for
    keeping stock accurate. Every step spells out its request inline so the flow
    can be read and executed without opening the underlying OpenAPI description.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-530.10
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-530.10
      capability_name: Stock Level Management
      spec: shopify-inventory-levels-api-openapi.yml
      confidence: 0.85
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: inventoryLevelsApi
  url: ../openapi/shopify-inventory-levels-api-openapi.yml
  type: openapi
- name: locationsApi
  url: ../openapi/shopify-locations-api-openapi.yml
  type: openapi
- name: productVariantsApi
  url: ../openapi/shopify-product-variants-api-openapi.yml
  type: openapi
workflows:
- workflowId: restock-product-variant
  summary: Set a variant's available stock at the primary location by resolving its inventory item.
  description: >-
    Resolves a variant's inventory item from the product, resolves the primary
    location, and sets the variant's available quantity there.
  inputs:
    type: object
    required:
    - productId
    - variantId
    - available
    properties:
      productId:
        type: integer
        description: The product ID owning the variant.
      variantId:
        type: integer
        description: The variant ID to restock (matched within the product's variants).
      available:
        type: integer
        description: The absolute available quantity to set.
  steps:
  - stepId: resolveVariant
    description: >-
      List the product's variants and select the matching variant so its
      inventory item id can be used for the stock update.
    operationId: listProductVariants
    parameters:
    - name: product_id
      in: path
      value: $inputs.productId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      inventoryItemId: $response.body#/variants/0/inventory_item_id
  - stepId: resolveLocation
    description: List the store's locations and use the first location as the target.
    operationId: listLocations
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      locationId: $response.body#/locations/0/id
  - stepId: setLevel
    description: >-
      Set the available quantity for the variant's inventory item at the
      resolved location.
    operationId: setInventoryLevel
    requestBody:
      contentType: application/json
      payload:
        inventory_item_id: $steps.resolveVariant.outputs.inventoryItemId
        location_id: $steps.resolveLocation.outputs.locationId
        available: $inputs.available
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      available: $response.body#/inventory_level/available
      inventoryItemId: $response.body#/inventory_level/inventory_item_id
  outputs:
    inventoryItemId: $steps.resolveVariant.outputs.inventoryItemId
    locationId: $steps.resolveLocation.outputs.locationId
    available: $steps.setLevel.outputs.available