InventoryItemSet

InventoryItemSet Type

Represents a collection or set of inventory items grouped by a common Stock Keeping Unit (SKU). InventoryItemSet allows managing multiple instances of the same product type as a single logical unit.

Fields

Field	Type	Description
id	ID!	Unique identifier of the item set
tenantID	UUID!	Tenant identifier
dataTypeID	UUID	DataType identifier for schema validation
dataTypeSlug	String	DataType slug for easier reference
data	Map	Custom metadata stored as JSON
createdAt	Time!	Creation timestamp
createdBy	UUID!	User identifier who created the item set
updatedAt	Time	Last update timestamp
updatedBy	UUID	User identifier who last updated the item set
deletedAt	Time	Deletion timestamp
deletedBy	UUID	User identifier who deleted the item set
sku	String!	Stock Keeping Unit identifier
items	[InventoryItem!]	List of individual inventory items in this set

Interfaces

• Node

Usage Example

query {
  inventoryItemSets(first: 10) {
    edges {
      node {
        id
        sku
        items {
          id
          sku
          inventoryJSONData
        }
        data
        createdAt
        updatedAt
      }
    }
  }
}

Mutation Examples

Create an InventoryItemSet

mutation {
  createInventoryItemSet(input: {
    sku: "PROD-001"
    dataTypeSlug: "product_set"
    data: {
      category: "electronics"
      brand: "TechCorp"
      model: "TC-2024"
    }
    itemIDs: ["item-uuid-1", "item-uuid-2", "item-uuid-3"]
  }) {
    inventoryItemSet {
      id
      sku
      items {
        id
        sku
      }
    }
    workflows {
      id
      status
    }
  }
}

Update an InventoryItemSet

mutation {
  updateInventoryItemSet(
    id: "itemset-uuid-here"
    input: {
      data: {
        category: "consumer_electronics"
        updated_at: "2024-01-15T10:30:00Z"
      }
    }
  ) {
    inventoryItemSet {
      id
      sku
      data
    }
    workflows {
      id
      status
    }
  }
}

Delete an InventoryItemSet

mutation {
  deleteInventoryItemSet(id: "itemset-uuid-here") {
    deletedID
    workflows {
      id
      status
    }
  }
}

Relations

• InventoryItemSet 1:N InventoryItem: An item set contains multiple individual inventory items

• InventoryItemSet N:1 DataType: Item sets can reference a DataType for schema validation

Common Use Cases

• Product Variants: Group items with the same SKU but different attributes (size, color, etc.)

• Batch Management: Manage inventory items received or manufactured in the same batch

• Bundle Products: Create logical groupings of related products sold together

• Kit Assembly: Manage component items that make up a complete product kit

• Inventory Organization: Group items for easier tracking and reporting by product line

Best Practices

• Use consistent SKU naming conventions across your organization

• Leverage the data field to store product-specific metadata

• Consider using DataTypes to enforce consistent data structure

• Monitor item set relationships when performing inventory movements

• Use workflows to track complex operations on item sets