Create Inventory Repository Movement

Create Inventory Repository Movement Mutation

Creates a new repository movement order to relocate a dynamic repository (like a pallet or tote) from one location to another.

Arguments

Name	Type	Description
input	CreateRepositoryMovementInput!	Input data for creating the repository movement

Return Type

InventoryRepositoryMovementOutput - Contains the created repository movement and any triggered workflows.

Field	Type	Description
inventoryRepositoryMovement	RepositoryMovement	The created repository movement
workflows	[TemporalWorkflow]	Any workflows triggered by this operation

Input Fields

CreateRepositoryMovementInput:

Field	Type	Description
dataTypeID	UUID	Optional data type ID
dataTypeSlug	String	Optional data type slug
data	Map	Custom data for the movement
executed	Boolean	Whether to execute immediately (default: false)
handler	String!	Handler responsible for the movement
blockedBy	RepositoryMovementBlockedBy	Blocking reason if applicable
collectionID	UUID	Optional collection movement ID
orderID	UUID	Optional associated order ID
position	Int	Position in execution order
fromID	ID	Source repository ID (parent location)
toID	ID!	Destination repository ID (parent location)
repositoryID	ID!	ID of the repository to move

Usage Example

mutation {
  # Move a pallet from one zone to another
  createInventoryRepositoryMovement(
    input: {
      repositoryID: "pallet-123",
      fromID: "zone-receiving",
      toID: "zone-storage-a",
      handler: "forklift-operator-01",
      data: {
        "reason": "Storage optimization",
        "priority": "normal"
      }
    }
  ) {
    inventoryRepositoryMovement {
      id
      repository {
        name
        type
      }
      from {
        name
      }
      to {
        name
      }
      executed
      handler
    }
  }
}

mutation {
  # Create movement as part of a collection
  createInventoryRepositoryMovement(
    input: {
      repositoryID: "tote-456",
      fromID: "staging-area",
      toID: "shipping-dock",
      handler: "system",
      collectionID: "collection-789",
      position: 1,
      dataTypeSlug: "shipping_preparation"
    }
  ) {
    inventoryRepositoryMovement {
      id
      collectionID
      position
    }
    workflows {
      id
      type
      runID
      status
      startedAt
      completedAt
    }
  }
}

Notes

• Repository movements relocate dynamic repositories (containers) within the warehouse

• The repositoryID is the container being moved (pallet, tote, trolley)

• The fromID and toID are the parent locations (zones, areas, docks)

• Created in pending state - use executeInventoryRepositoryMovement to execute

• Can be part of a collection for coordinated execution

• May be blocked for safety or compliance reasons