Create Inventory Item Movement

Create Inventory Item Movement Mutation

Creates a new item movement order to transfer inventory between repositories.

Arguments

Name	Type	Description
input	CreateInventoryItemMovementInput!	Input data for creating the movement

Return Type

InventoryItemMovementOutput - Contains the created movement and any triggered workflows.

Field	Type	Description
itemMovement	ItemMovement!	The created item movement
workflows	[TemporalWorkflow]	Any workflows triggered by this operation

Input Fields

CreateInventoryItemMovementInput:

Field	Type	Description
fromRepositoryID	UUID!	Source repository ID
toRepositoryID	UUID!	Destination repository ID
itemID	UUID!	ID of the item to move
quantity	Int!	Quantity to move
dataTypeID	UUID	Optional data type ID
dataTypeSlug	String	Optional data type slug
data	Map	Custom data for the movement
collectionID	UUID	Optional collection movement ID

Usage Example

mutation {
  # Create a simple item movement
  createInventoryItemMovement(
    input: {
      fromRepositoryID: "shelf-a1",
      toRepositoryID: "packing-station-1",
      itemID: "item-123",
      quantity: 10,
      data: {
        "reason": "Order fulfillment",
        "orderRef": "ORD-2024-001"
      }
    }
  ) {
    itemMovement {
      id
      quantity
      fromRepository {
        name
      }
      toRepository {
        name
      }
      item {
        sku
      }
      blockedBy
    }
  }
}

mutation {
  # Create movement as part of a collection
  createInventoryItemMovement(
    input: {
      fromRepositoryID: "warehouse-bulk",
      toRepositoryID: "pick-face-a1",
      itemID: "item-789",
      quantity: 50,
      collectionID: "collection-456",
      dataTypeSlug: "replenishment_movement",
      data: {
        "priority": "high",
        "triggerLevel": 10
      }
    }
  ) {
    itemMovement {
      id
      quantity
      collectionID
    }
    workflows {
      id
      type
      runID
      status
      startedAt
      completedAt
    }
  }
}

Notes

• Movement validates stock availability (unless from virtual repository)

• Created in pending state - use executeInventoryItemMovement to execute

• Can be part of a collection for coordinated execution

• May be blocked if insufficient stock or business rules prevent it