Item Movements

Item Movements Query

Returns a paginated list of ItemMovement objects, with optional filtering and ordering.

Arguments

Name	Type	Description
after	Cursor	Returns the elements in the list that come after the specified cursor
first	Int	Returns the first n elements from the list
before	Cursor	Returns the elements in the list that come before the specified cursor
last	Int	Returns the last n elements from the list
orderBy	ItemMovementOrder	Ordering options for movements returned from the connection
where	ItemMovementWhereInput	Filtering options for movements returned from the connection

Return Type

ItemMovementConnection! - A connection to a list of ItemMovement objects with pagination information.

Usage Example

query {
  # Get all pending movements for a specific item
  itemMovements(
    where: {
      itemID: "item-123",
      executedAt_NULL: true
    },
    orderBy: { direction: ASC, field: CREATED_AT }
  ) {
    edges {
      node {
        id
        quantity
        fromRepositoryID
        toRepositoryID
        fromRepository {
          id
          name
        }
        toRepository {
          id
          name
        }
        item {
          sku
          data
        }
        blockedBy
        createdAt
      }
      cursor
    }
    totalCount
  }
}

query {
  # Get blocked movements that need attention
  itemMovements(
    where: {
      blockedBy_NOT_NULL: true,
      executedAt_NULL: true
    },
    first: 20
  ) {
    edges {
      node {
        id
        quantity
        blockedBy
        item {
          id
          sku
        }
        fromRepository {
          id
          name
        }
        toRepository {
          id
          name
        }
        createdAt
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Common Filters

• executedAt_NULL: true - Find pending movements

• executedAt_NOT_NULL: true - Find executed movements

• blockedBy_NOT_NULL: true - Find blocked movements

• collectionID: "..." - Find movements in a specific collection

• fromRepositoryID / toRepositoryID - Filter by source/destination

• itemID - Filter by specific item

Notes

• Movements are created in pending state and executed later

• Use executeInventoryItemMovement mutation to execute a movement

• Blocked movements indicate issues like insufficient stock

• Virtual repositories bypass stock validation