Delete Picking Order Item

deletePickingOrderItem Mutation

Deletes an existing picking order item from the system. This removes the item from its associated picking order and may trigger workflow updates.

Arguments

Name	Type	Description
id	ID!	Required ID of the picking order item to delete

Return Type

PickingOrderItemDeletePayload! - Contains information about the deletion operation and associated workflows.

Response Fields

PickingOrderItemDeletePayload:

Field	Type	Description
deletedID	ID	ID of the deleted picking order item
workflows	[TemporalWorkflow]	Any workflows triggered by the deletion

Usage Example

mutation {
  deletePickingOrderItem(id: "item-550e8400-e29b-41d4-a716-446655440000") {
    deletedID
    workflows {
      id
      type
      id
      runID
      status
    }
  }
}

JavaScript Example

const deletePickingOrderItemMutation = `
  mutation DeletePickingOrderItem($id: ID!) {
    deletePickingOrderItem(id: $id) {
      deletedID
      workflows {
        id
        type
        id
        runID
        status
      }
    }
  }
`;

const variables = {
  id: "item-550e8400-e29b-41d4-a716-446655440000"
};

// Using fetch or your preferred GraphQL client
const response = await fetch('/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    query: deletePickingOrderItemMutation,
    variables: variables
  })
});

const result = await response.json();
console.log('Deleted picking order item:', result.data.deletePickingOrderItem);

Bulk Deletion Example

You can delete multiple picking order items by calling the mutation multiple times:

const itemIds = [
  "item-550e8400-e29b-41d4-a716-446655440000",
  "item-123e4567-e89b-12d3-a456-426614174000",
  "item-987fcdeb-51d2-12d3-a456-426614174000"
];

const deleteResults = await Promise.all(
  itemIds.map(async (id) => {
    const response = await fetch('/graphql', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      },
      body: JSON.stringify({
        query: deletePickingOrderItemMutation,
        variables: { id }
      })
    });
    
    const result = await response.json();
    return result.data.deletePickingOrderItem;
  })
);

console.log('Bulk deletion results:', deleteResults);

Conditional Deletion Example

You might want to delete items based on certain conditions:

// First, query the picking order to get its items
const getPickingOrderQuery = `
  query GetPickingOrder($id: ID!) {
    pickingOrder(id: $id) {
      id
      orderitems {
        id
        sku
        quantity
        data
      }
    }
  }
`;

// Get the picking order
const orderResponse = await fetch('/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    query: getPickingOrderQuery,
    variables: { id: "550e8400-e29b-41d4-a716-446655440000" }
  })
});

const orderResult = await orderResponse.json();
const pickingOrder = orderResult.data.pickingOrder;

// Delete items with quantity 0 or marked as cancelled
const itemsToDelete = pickingOrder.orderitems.filter(item => 
  item.quantity === 0 || 
  (item.data && item.data.status === 'cancelled')
);

// Delete the filtered items
for (const item of itemsToDelete) {
  await fetch('/graphql', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN'
    },
    body: JSON.stringify({
      query: deletePickingOrderItemMutation,
      variables: { id: item.id }
    })
  });
}

Notes

• The picking order item must exist and be accessible to the current user

• This operation is irreversible - deleted items cannot be recovered

• The deletion may trigger workflows to update the parent picking order status

• The operation may fail if the item is currently being processed in a workflow

• Inventory reservations associated with the item may be released

• Users must have appropriate permissions to delete picking order items

• Consider the impact on the overall picking order when removing items

• Audit logs will record the deletion for compliance purposes

• If this is the last item in a picking order, consider whether the order itself should be deleted