Edit Item
The Edit Item page allows you to modify all aspects of an existing item. It shares the same tabbed interface as the Create page, with the item code locked to prevent changes after creation.
Accessing the Page
Section titled “Accessing the Page”- Route:
/items/:id/edit - Menu Path: Item Master Data → Items → Item row → Edit action, or Item Detail → Edit button
- Component:
EditItem.tsx - Source:
/mnt/dev/portal/services/items/frontend/src/pages/EditItem.tsx - Permission: Edit Item
Form Overview
Section titled “Form Overview”The edit form uses the same tabbed layout as the Create page:
| Tab | Description |
|---|---|
| Basic | Core item fields (Item Code is read-only) |
| UOMs | Manage additional units of measure |
| Barcodes | Manage barcode assignments (includes UOM column) |
| Prices | Manage price list entries |
| Categories | Manage additional category mappings |
| Media | Upload/delete images and attachments |
Differences from Create Mode
Section titled “Differences from Create Mode”- Item Code is read-only and cannot be changed
- UOM table shows existing UOMs loaded from the server
- Barcode table includes a UOM column showing which UOM each barcode applies to
- Price table shows existing prices loaded from the pricing-tax service
- Categories tab shows existing category mappings and allows adding/removing
- Media tab shows existing images and attachments with delete support
- Custom Fields section appears on the Basic tab if custom field definitions exist
Basic Tab Fields
Section titled “Basic Tab Fields”All fields are the same as the Create Item page, except:
- Item Code: Read-only (displayed in a disabled input)
- SKU: Editable with real-time uniqueness validation (only validates if changed)
Unsaved Changes Protection
Section titled “Unsaved Changes Protection”The form tracks changes across all tabs and warns you before navigating away with unsaved changes.
Nested Update Behavior
Section titled “Nested Update Behavior”- UOMs, barcodes, prices, categories, and custom fields can be updated as part of the same edit workflow.
- Duplicate barcode values and invalid UOM combinations are blocked during validation.
- When price updates fail but item changes succeed, the page reports partial success so pricing can be retried without losing other edits.
Messages
Section titled “Messages”| Event | Message |
|---|---|
| Update success | Item updated successfully |
| Update error | Failed to update item |
| Partial success | Item was saved but prices could not be updated. Please try saving prices again. |
| File warning | Item was saved but some files could not be processed. Please try again. |