Create Inventory Collection Movement

createInventoryCollectionMovement Mutation

Creates a collection of related item movements as a single operation in the inventory system.

Arguments

Name	Type	Description
input	CreateCollectionMovementInput!	Input data for creating the collection of movements

Return Type

CreateCollectionMovementOutput - Contains the ID of the created collection and the list of movements.

Input Fields

CreateCollectionMovementInput:

Field	Type	Description
dataTypeID	UUID	Optional data type ID for the collection
dataTypeSlug	String	Optional data type slug for the collection
data	Map	Custom data associated with the collection
collection	[CollectionMovementArrayInput]	Required array of movement operations to perform
handler	String	Handler for the collection movement

CollectionMovementArrayInput:

Field	Type	Description
handler	String!	Required handler for this specific movement
dataTypeID	UUID	Optional data type ID for this movement
dataTypeSlug	String	Optional data type slug for this movement
data	Map	Custom data for this movement
fromID	ID!	Required source repository ID
toID	ID!	Required destination repository ID
itemID	ID	Optional item ID (if applicable)
quantity	Float	Optional quantity (if applicable)
repositoryID	ID	Optional repository ID for repository-specific operations
orderID	ID	Optional order ID for order-related movements

Usage Example

mutation {
  createInventoryCollectionMovement(
    input: {
      handler: "order_fulfillment",
      data: {
        "order_reference": "ORD-12345",
        "customer_id": "cust-456",
        "priority": "high"
      },
      collection: [
        {
          handler: "pick",
          fromID: "warehouse-main",
          toID: "packing-station-1",
          itemID: "item-123",
          quantity: 2,
          data: {
            "bin_location": "A1-B2"
          }
        },
        {
          handler: "pick",
          fromID: "warehouse-main",
          toID: "packing-station-1",
          itemID: "item-456",
          quantity: 3,
          data: {
            "bin_location": "C3-D4"
          }
        },
        {
          handler: "pack",
          fromID: "packing-station-1",
          toID: "shipping-area",
          data: {
            "package_type": "box",
            "package_dimensions": "30x20x15"
          }
        }
      ]
    }
  ) {
    id
    movements {
      id
      movementType
    }
  }
}