Overview
The Material Items page displays all material items in your inventory with their total quantities across all locations. You can view location-specific quantities, record counts, and move materials between locations.Viewing Material Items
Desktop View (Grid)
On desktop devices, material items are displayed in an AG Grid table with the following columns:- Item details: Name, description, and other identifying information
- Quantity: Total quantity across all locations for the current site
- Other fields: Additional material item properties
- Sorting: Click column headers to sort
- Filtering: Use the filter panel (sidebar) to narrow results
- Search: Quick search across all columns
- Column Management: Show/hide columns via the columns tool panel
Mobile View (Cards)
On mobile devices or narrow screens, material items are displayed as cards showing key information in an easy-to-read format.Viewing Location Quantities
To see where a material item is located:- Click on a material item row (or tap a card on mobile)
- A dialog opens showing Material Item Location Quantities
- View all bin locations where this material has inventory
- Location: The specific location
- Quantity: Current quantity at that location
- Last Updated: Timestamp of the last count or movement
Recording Material Counts
Important: The system behaves differently depending on whether you’re counting at an existing location or adding to a new location:
- Existing location: The count sets the quantity to the entered value
- New location: The count adds (increments) the quantity
Count at an Existing Location
To update the count for a material item at an existing location:- Open the material item’s location quantities view
- Click on the location you want to count
- The Edit Material Location Count dialog opens
- Location: The current location is pre-selected (can be changed to move material)
- Count: Enter the new quantity (this will set the quantity to this value)
- Reason: Select a reason code (required)
- Click Submit
Add Material to a New Location
To record material at a new location:- Open the material item’s location quantities view
- Click + Add New (mobile) or click outside the grid area (desktop)
- The Add New Material Location Count dialog opens
- Location: Select the location
- Count: Enter the quantity (this will be added to any existing quantity)
- Reason: Select a reason code
- Click Submit
Moving Material Between Locations
To move material from one location to another:- Open the material item’s location quantities view
- Click on the source location (where material currently is)
- In the dialog, select a different location from the dropdown
- Enter the quantity to move
- Select a reason code
- Click Submit
- Deduct the quantity from the source location
- Add the quantity to the destination location
- Record the movement with the reason code and timestamp
Count Operations Explained
The Material module supports two types of count operations:SET Count (Existing Locations)
When you count at an existing location (one that already has a quantity record):- The quantity is set to the entered value
- Example: Location has 50 units, you count 45, result is 45 units
- Use this for physical inventory counts
INCREMENT Count (New Locations)
When you add material to a new location (first time recording at this location):- The quantity is added (incremented) to any existing amount
- Example: You receive 30 units, you enter 30, result is 30 units added
- Use this when receiving or first adding material
Reason Codes
All count and move operations require a reason code. Common reason codes include:- Receiving: Material received from vendor
- Production: Material consumed or moved for production
- Transfer: Moving material between locations
- Cycle Count: Regular inventory count
- Adjustment: Correcting inventory discrepancies
- Damage: Material damaged or lost
Best Practices
Regular Cycle Counts
- Schedule regular counts of high-value or high-volume materials
- Use the SET count operation to correct any discrepancies
- Always provide accurate reason codes
Location Organization
- Organize materials at specific locations for precise tracking
- Keep similar materials in designated areas
- Document your location naming conventions
Movement Tracking
- Use the move operation (not separate add/remove counts) to maintain accurate movement history
- Document the reason for each movement
- Verify source quantity before moving
Common Questions
What’s the difference between counting and moving?
- Counting (same location): Updates the quantity at a location based on physical count
- Moving (different location): Transfers quantity from one location to another
Can I move material to a location that doesn’t exist yet?
Yes! The system will create the location record when you move material to it for the first time.Why do I need a reason code?
Reason codes provide an audit trail and help identify why inventory levels changed. This is important for compliance, troubleshooting discrepancies, and understanding material usage patterns.How often do quantities refresh?
The location quantities view automatically polls for updates every 30 seconds to show near real-time inventory levels.Material Item Images
Material items now support cloud-based image storage for better organization and accessibility.Uploading Images
Image Features
- Cloud Storage: Images are stored securely in the cloud for fast access
- Automatic Optimization: Images are automatically resized for optimal display
- Cross-Device Access: View material images from any device
- Version History: Previous images are retained when updating