ItemMovement

Item Movement Type

Represents a movement of items between repositories. Item movements are orders or tasks to transfer specific quantities of an inventory item from one location to another.

Fields

Field	Type	Description
id	ID!	Unique identifier of the movement
tenantID	UUID!	Tenant identifier
createdAt	Time!	Creation timestamp
createdBy	UUID!	User identifier who created the movement
updatedAt	Time	Last update timestamp
updatedBy	UUID!	User identifier who last updated the movement
deletedAt	Time	Deletion timestamp
deletedBy	UUID!	User identifier who deleted the movement
dataTypeID	UUID	Data type identifier
dataTypeSlug	String	Data type slug
data	Map	Custom data associated with the movement
fromRepositoryID	UUID!	Source repository ID
toRepositoryID	UUID!	Destination repository ID
itemID	UUID!	ID of the item being moved
quantity	Int!	Quantity to move
executedAt	Time	When the movement was executed
executedBy	UUID	User who executed the movement
blockedBy	ItemMovementBlockedBy	Reason if movement is blocked
collectionID	UUID	ID of collection movement if part of one
fromRepository	Repository	Source repository object
toRepository	Repository	Destination repository object
item	InventoryItem	The inventory item being moved
collection	InventoryCollection	Collection movement this belongs to
transactions	[Transaction!]	Related inventory transactions

Interfaces

• Node

Movement States

• Pending: Created but not yet executed (executedAt is null)

• Executed: Movement has been completed (executedAt is set)

• Blocked: Movement cannot proceed (blockedBy is set)

Usage Example

query {
  itemMovements(
    where: {
      itemID: "550e8400-e29b-41d4-a716-446655440000",
      executedAt_NULL: true
    }
  ) {
    edges {
      node {
        id
        quantity
        executedAt
        blockedBy
        fromRepository {
          name
          type
        }
        toRepository {
          name
          type
        }
        item {
          sku
          data
        }
      }
    }
  }
}

Notes

• Movements validate stock availability when created (unless from virtual repository)

• Executing a movement updates stock records and creates transactions

• Movements can be blocked by insufficient stock or other business rules

• Collection movements allow grouping multiple movements for coordinated execution