Delete Inventory Item Movement

Delete Inventory Item Movement Mutation

Deletes an existing ItemMovement object from the system, removing a planned or pending movement of inventory items between repositories.

Arguments

Name	Type	Description
id	ID!	The unique identifier of the item movement to delete

Return Type

InventoryItemMovementDeletePayload! - Contains information about the deleted movement and related workflows.

Return Fields

InventoryItemMovementDeletePayload:

Field	Type	Description
deletedID	ID	The ID of the deleted item movement
workflows	[TemporalWorkflow]	Workflow instances that were triggered by the deletion

Usage Example

mutation {
  deleteInventoryItemMovement(id: "movement_123") {
    deletedID
    workflows {
      id
      type
      status
      runID
    }
  }
}

JavaScript Example

const DELETE_INVENTORY_ITEM_MOVEMENT = gql`
  mutation DeleteInventoryItemMovement($id: ID!) {
    deleteInventoryItemMovement(id: $id) {
      deletedID
      workflows {
        id
        name
        status
        workflowID
        runID
      }
    }
  }
`;

const { data } = await client.mutate({
  mutation: DELETE_INVENTORY_ITEM_MOVEMENT,
  variables: {
    id: "movement_123"
  }
});

console.log(`Deleted item movement with ID: ${data.deleteInventoryItemMovement.deletedID}`);

// Check for any triggered workflows
if (data.deleteInventoryItemMovement.workflows.length > 0) {
  console.log('Triggered workflows:', data.deleteInventoryItemMovement.workflows);
}

Important Notes

• Movement State: Only non-executed movements can be deleted. Executed movements become part of the audit trail and cannot be removed

• Workflow Triggers: The deletion may trigger cleanup workflows or notification workflows

• Authorization: Ensure you have proper permissions before deleting item movements

• Data Integrity: The system will prevent deletion if the movement is part of an active collection or order

• Stock Impact: Deleting a movement does not affect current stock levels, as the movement was never executed

• Audit Trail: Deletion events are logged for compliance and audit purposes

• Recovery: Once deleted, the item movement cannot be recovered through the API

Related Operations

After deleting an item movement, you may need to:

• Update related collection movements if this was part of a batch

• Reassign responsibilities to other handlers

• Notify stakeholders about the canceled movement

• Create replacement movements if the transfer is still needed

Common Deletion Scenarios

1. Cancel Planned Movement: Remove a movement that is no longer needed

2. Correct Errors: Delete movements created with incorrect parameters

3. Workflow Cleanup: Remove movements that were part of a canceled workflow

4. Resource Optimization: Delete redundant or duplicate movements

5. Order Cancellation: Remove movements associated with canceled orders