Configurable Exception Product Handling in Bill of Materials (BOM)

| Overview

This enhancement introduces special handling for configurable exception products within the Bill of Materials (BOM) workflow. Unlike standard BOM products, exception products follow predefined business rules for selection, quantity calculation, editability, reset behavior, and bulk update operations.

The objective of this feature is to support labor and service-based products whose quantities are derived from overall hardware value rather than being manually maintained by users.

The list of exception products is environment-specific and managed through backend configuration, allowing future additions or modifications without requiring application code changes.

| Configurable Exception Products

The following products are treated as exception products based on the active environment configuration.

Carrier Environment

75F / Airoverse Environment

Note: The above products are configurable through backend configuration and may vary by environment.

| Product Availability

Exception products are displayed in the Add Product dialog only when configured for the active environment.

Once an exception product is added to the BOM, the same product cannot be added again. The product is removed from the available product selection list until it is deleted from the BOM.

This prevents duplicate service or labor line items.

| Quantity Assignment Logic

The quantity behaviour differs from standard BOM products.

Scenario 1: Empty BOM

If an exception product is added when no products exist in the BOM:

• The quantity entered by the user in the Add Product dialog is retained.
• The entered quantity becomes the BOM quantity.

Scenario 2: Existing BOM

If products already exist in the BOM:

• The exception product quantity is automatically derived.
• Quantity is calculated as:

Quantity = Ceiling (10% × Total Hardware Price Before Discount)

Where:

• Total Hardware Price includes all applicable hardware products.
• Discount values are ignored during the calculation.
• Upper rounding (ceiling) logic is applied.

Example:

| Dynamic Quantity Recalculation

Exception product quantities maintain a dependency on BOM pricing.

Whenever hardware products are:

• Added
• Removed
• Updated
• Quantity modified
• Price modified

the exception product quantity is automatically recalculated.

This ensures service and labor costs remain aligned with the current BOM value.

| Linked Quantity Indication

When quantity is derived from BOM pricing:

• A link indicator is displayed beside the quantity.
• The icon indicates that the quantity is system-calculated and linked to BOM product pricing.

This provides visual clarity that the value is not manually maintained.

Edit Restrictions

To preserve calculation integrity, exception products have additional restrictions.

Quantity Editing

Users cannot manually modify the quantity when the value is derived from BOM calculations.

The quantity field remains disabled.

Product Replacement

Users cannot replace an exception product using the Product dropdown.

The product selection control remains disabled for exception rows.

Product Selection in Other Rows

Exception products are excluded from product replacement dropdowns shown on standard BOM rows.

This ensures exception products can only be added through the Add Product workflow.

| Delete Behaviour

Exception products can be deleted using the standard Delete action.

Upon deletion:

• The product row is removed from the BOM.
• The product becomes available again within the Add Product dialog.
• Users may re-add the product if required.

| Reset BOM Behaviour

Standard Reset BOM

When users perform a Reset BOM operation:

• Exception products remain in the BOM.
• Exception product rows are not removed.
• Existing exception product rules continue to apply.

Reset Due to Equipment Change

When equipment modifications trigger a BOM reset:

• Exception products remain in the BOM.
• Quantities are recalculated using the updated BOM values.
• Quantity linkage remains active.

This prevents users from losing manually added service or labor products during BOM regeneration.

| Bulk Edit Support

Bulk Edit operations fully support exception products.

All validations and restrictions applied in the standard BOM workflow are enforced during bulk updates, including:

• Duplicate prevention
• Quantity calculation rules
• Quantity edit restrictions
• Product replacement restrictions
• Dynamic recalculation behaviour
• Reset handling

This ensures consistent behaviour regardless of how BOM updates are performed.