Retire or Delete an Item Safely
How to Retire or Delete an Item Safely in Muhasib ERP
Overview
This guide will help you stop an item from ordinary use or remove it only when every dependency has been resolved and deletion is approved.
Source blocks deletion when location inventory exists, the item is a BOM ingredient, or it parents variation items. Other historical dependencies and the global delete-after-transaction setting still require verification.
Who can do this
You need access to Item Update for deactivation where supported; Item Delete and explicit business approval for deletion.
Before you start
Back up the database. Review stock at every location/batch/serial, open orders, transactions, BOM ingredient use, parent/variant relationships, integrations, prices, and reports.
Where to find it
Back Office → Items & Advanced Inventory → Manage Items.
Retire or Delete an Item Safely
Step 1: Select the item by stable ID/barcode
Step 2: Prefer disabling/retiring it when the runtime provides a supported status
Step 3: Transfer/adjust stock through approved transactions until reconciled zero
Step 4: Remove it from BOMs and resolve child variants through supported updates
Step 5: Close or correct open transactions/orders
Step 6: Choose Delete only after approval and confirmation
Step 7: Stop on any dependency warning
Check your work
Confirm history remains reportable, stock/GL compare and confirm, the item is not selectable for new work, and no orphan BOM/variant/price/image/serial rows remain in a clone.
If something goes wrong
- Do not delete to hide wrong stock or free licence capacity.
- Use corrections/returns/transfers/adjustments for business data.
Related guides
- Update an Item Safely
- Create an Inventory Adjustment
- Transfer Stock Between Locations
- Create and Verify a Manual Backup