Products

Products define the output items that can be harvested, including their weight specifications and quality attributes. Products are used throughout the system to categorize and validate harvest transactions.

Overview

Purpose: Configure product specifications including weight ranges, packaging, and quality attributes that are used when recording harvest transactions.

A Product record contains:

• Name - Product name or identifier
• Description - Optional product description
• Start Date - When this product became active
• End Date - When this product was deactivated
• Number of Boxes - Packaging configuration
• Display Weight - Weight shown on packaging (grams)
• Tare Weight - Weight of empty packaging (grams)
• Checked Weight - Target weight after quality check (grams)
• Checked Weight Min/Max - Acceptable weight range for checked product (grams)
• Picked Weight - Target weight when picked (grams)
• Picked Weight Min/Max - Acceptable weight range for picked product (grams)
• Pack - Packaging type attribute
• Grade - Product grade attribute
• Quality - Quality level attribute
• Check - Check type attribute

Viewing Products

1. Click Products in the sidebar menu (under Data Management)
2. You’ll see a table with all products

Table Columns

Column	Description
Name	Product name
Description	Product description
Start Date	When the product became active
End Date	When the product was deactivated
Display Weight	Weight shown on packaging (grams)
Tare Weight	Weight of empty packaging (grams)
Created at	When this product was created

Sorting and Filtering

• Click any column header to sort by that column
• Use the Deleted records filter to show archived products
• Click the columns toggle button to show or hide columns

Creating a Product

Who can do this: Super Admin, Data Manager

1. Click Products in the sidebar

2. Click the New product button (top right)

3. Fill in the form:

   Basic Information:

   • Name (required): Enter a product name (e.g., “Premium White Button 250g”, “Grade A Portobello”)
   • Description (optional): Add any relevant details
   • Start Date (optional): When this product became active
   • End Date (optional): When this product was deactivated
   • Number of boxes (optional): Packaging configuration

   Weight Specifications (all in grams):

   • Display weight (g): Weight shown on product packaging
   • Tare weight (g): Weight of empty packaging/container
   • Checked weight (g): Target weight after quality check
   • Checked weight min (g): Minimum acceptable checked weight
   • Checked weight max (g): Maximum acceptable checked weight
   • Picked weight (g): Target weight when initially picked
   • Picked weight min (g): Minimum acceptable picked weight
   • Picked weight max (g): Maximum acceptable picked weight

   Attributes:

   • Pack: Select packaging type from dropdown
   • Grade: Select product grade from dropdown
   • Quality: Select quality level from dropdown
   • Check: Select check type from dropdown

4. Click Create

Understanding Weight Settings

Products have multiple weight fields that serve different purposes:

Display Weight: The weight shown on product labels or packaging. This is what customers see.

Tare Weight: The weight of the empty container or packaging. This is subtracted from total weight to get net product weight.

Checked Weight: The target weight after quality control checks. This is the weight the product should be after inspection and any adjustments.

Checked Weight Min/Max: The acceptable range for checked weight. Products outside this range may need attention.

Picked Weight: The target weight when the product is first picked from the growing area.

Picked Weight Min/Max: The acceptable range for picked weight. This helps identify when picked weights are outside normal parameters.

Understanding Attributes

Pack, Grade, Quality, Check: These are dropdown selections that categorize products. The available options are configured by your administrator. These attributes help organize and filter products for reporting and analysis.

Viewing a Single Product

1. From the Products list, click the eye icon (View) on any row
2. You’ll see all product details including all weight specifications and attributes

Editing a Product

Who can do this: Super Admin, Data Manager

1. From the Products list, click the pencil icon (Edit) on any row
2. Modify the fields as needed
3. Click Save

Updating Weight Specifications

When you update weight specifications:

• Changes will apply to new transactions using this product
• Existing transactions will continue to show the weights that were recorded at the time
• Consider the impact on ongoing operations before changing weight ranges

Deleting a Product

Who can do this: Super Admin, Data Manager

1. From the Products list, click the Edit button
2. Click the Delete button
3. Confirm the deletion when prompted

Bulk Delete

1. Check the boxes next to multiple products
2. Click the Actions dropdown
3. Select Delete selected
4. Confirm the deletion

Warning

Deleting a product will:

• Archive the product (it will be hidden from normal views)
• The product will no longer be available for selection in new transactions
• Existing transactions that used this product will still reference it
• You can restore deleted products using the “Deleted records” filter

Understanding Weight Ranges

Why Min/Max Ranges Matter

Weight min/max ranges help:

• Identify products that are outside acceptable parameters
• Track quality control compliance
• Generate reports on weight variance
• Ensure consistency in product specifications

Setting Appropriate Ranges

When setting min/max ranges:

• Consider your quality standards
• Account for natural variation in product weight
• Set ranges that are achievable but maintain quality
• Review ranges periodically based on actual performance data

Common Workflows

Creating a New Product Line

1. Create a new Product record
2. Enter the product name and description
3. Set all weight specifications based on your product requirements
4. Select appropriate attributes (pack, grade, quality, check)
5. Set start date to activate the product
6. The product is now available for use in transactions

Updating Product Specifications

1. Open the product record
2. Click Edit
3. Update weight specifications or attributes as needed
4. Click Save

Note: Consider the impact on ongoing operations before making changes to active products.

Deactivating a Product

1. Open the product record
2. Click Edit
3. Set an End Date to mark when the product was deactivated
4. Click Save

The product will remain in the system for historical records but won’t appear in active listings.

Troubleshooting

Cannot Create Product

Only Super Admins and Data Managers can create products. Contact your administrator if you need this access.

Attribute Options Not Available

• Attribute options (Pack, Grade, Quality, Check) are configured by your administrator
• Contact your administrator if you need additional attribute options
• You can still create products without selecting all attributes

Weight Values Not Saving

• Make sure you’re entering numeric values
• Weight values are in grams
• Check that min values are less than max values
• Some fields may be optional

Product Not Appearing in Transaction Dropdowns

• Check that the product hasn’t been deleted
• Verify the product has a start date and no end date (or end date is in the future)
• Use the “Deleted records” filter to see if the product was archived

Understanding Weight Calculations

If you’re unsure about weight settings:

• Display Weight = What customers see on the package
• Tare Weight = Weight of empty container (subtracted from total)
• Net Product Weight = Total Weight - Tare Weight
• Checked Weight = Weight after quality control
• Picked Weight = Weight when first picked

Contact your administrator if you need help determining appropriate weight values for your products.