Skip to content

Item Repair Settings

The Item Repair Settings feature allows managers to configure how individual items should be handled within the repair workflow. This includes two primary settings: the "Repair Not Allowed" field, which completely prevents repair order creation for specific items, and the "Cr. Note Required" field, which redirects items to a credit note process instead of repair.

Overview

With Item Repair Settings, you can:

  • Block repair orders entirely for specific items using the "Repair Not Allowed" field
  • Mark items as requiring credit notes with automatic repair order integration using the "Cr. Note Required" field
  • Automatically assign repair status for credit note workflows when configured in setup
  • Automatically trigger credit note notifications for finance workflow management
  • Provide clear communication to repair technicians about financial processing requirements
  • Maintain clear policies on which items can and cannot be repaired
  • Improve workflow efficiency by preventing unnecessary repair attempts
  • Provide clear communication to customers about item repairability

Understanding Item Repair Controls

Repair Not Allowed Field

The "Repair Not Allowed" field is a powerful control that completely prevents the creation of repair orders for specific items. When this field is enabled:

  • No repair orders can be created for the item through any method (manual entry, API, or assisted setup)
  • Users receive an immediate error message when attempting to add the item to a repair order
  • The item is completely excluded from the repair workflow
  • This setting provides the strongest level of repair prevention

Cr. Note Required Field

The "Cr. Note Required" field enables a sophisticated credit note workflow that integrates seamlessly with repair order processing. When this field is enabled:

  • Repair Order Integration: The setting automatically transfers to repair orders when the item is selected
  • Smart Notifications: Users receive immediate notifications on repair orders when credit notes are required
  • Finance Workflow: Ensures proper financial document creation by alerting users to credit note requirements
  • Manual Override Support: Repair order users can override the inherited setting if circumstances require different handling
  • Process Continuity: Items can still be processed through the repair system while being flagged for alternative financial handling

How Credit Note Required Works

When an item is marked with "Cr. Note Required":

  1. Item Selection: When the item is selected on a repair order, the "Cr. Note Required" field automatically inherits the item's setting
  2. Automatic Status Assignment: If a default status for credit notes is configured in Repair Management Setup, the repair order's status is automatically updated to ensure proper workflow routing
  3. Immediate Notification: A notification appears stating: "The order requires a Credit Note. Please make sure to create proper finance documents."
  4. User Awareness: The notification ensures technicians and managers are aware of special financial processing requirements
  5. Document Creation: Users are prompted to create appropriate financial documents instead of or in addition to standard repair processing
  6. Workflow Flexibility: The repair order can still proceed while ensuring proper financial documentation

Choosing Between Repair Not Allowed and Cr. Note Required

Scenario Recommended Setting Reason
Dangerous or recalled items Repair Not Allowed Complete prevention ensures safety compliance
Obsolete items with no replacement parts Repair Not Allowed No possibility of repair, prevents wasted effort
Items under warranty replacement programs Cr. Note Required Allows processing while redirecting to appropriate channel
High-value items requiring manufacturer service Cr. Note Required Maintains customer service while ensuring proper handling
Items with known safety concerns Repair Not Allowed Strongest protection against inappropriate repair attempts

When to Use Each Field

When to Use Each Field

Consider marking items as "Repair Not Allowed" when:

  • Dangerous Items: Products with safety risks that should never be repaired
  • Recalled Items: Items subject to manufacturer or regulatory recalls
  • Obsolete Items: Products that are completely discontinued with no parts availability
  • Policy Compliance: Items where company policy strictly prohibits repair
  • Legal Requirements: Items where regulations prevent repair activities

Consider marking items as "Cr. Note Required" when:

  • Low-Value Items: Items where repair costs exceed replacement costs and credit notes provide better customer value
  • Warranty Policies: Items under manufacturer policies that require replacement rather than repair, with credit notes facilitating the process
  • Specialized Equipment: Items requiring manufacturer-only servicing where credit notes enable proper vendor coordination
  • Customer Preference Programs: Items where customers prefer replacement over repair, supported by credit note workflows
  • Finance Integration: Items that require special financial handling or documentation for accounting purposes
  • Policy Compliance: Items where company or regulatory policies mandate credit note processing instead of repair

Setting Up Repair Controls for Items

Prerequisites

  • You must have Manager permissions to modify item settings
  • The Quick Repair extension must be installed and configured
  • Access to the standard Business Central Item Card

Configuring Repair Not Allowed

  1. In Business Central, navigate to the Items list or use the search function to find Items.

  2. Open the Item Card for the item you want to configure.

  3. Navigate to the Repair tab on the Item Card.

!!! note "Repair Tab Location" The Repair tab is added by the Quick Repair extension and appears as an additional tab on the standard Item Card.

  1. In the Repair tab, locate the Repair Not Allowed checkbox.

  2. Enable the Repair Not Allowed checkbox to completely prevent repair order creation for this item.

!!! warning "Strong Restriction" Once enabled, this item cannot be added to any repair orders until this setting is disabled. This is the strongest form of repair prevention available.

  1. Save your changes by moving to another field or closing the Item Card.

Configuring Cr. Note Required

  1. Follow steps 1-3 above to navigate to the Repair tab on the Item Card.

  2. In the Repair tab, locate the Cr. Note Required checkbox.

  3. Enable the Cr. Note Required checkbox to integrate this item with credit note notification workflows.

!!! tip "Credit Note Integration" This setting enables sophisticated finance workflow integration. When enabled, repair orders using this item will automatically display notifications reminding users to create proper finance documents, while still allowing the repair process to proceed.

  1. Save your changes by moving to another field or closing the Item Card.

Testing Credit Note Integration

To verify the Credit Note Required configuration:

  1. Create a Test Repair Order: Navigate to Repair Orders and create a new repair order
  2. Select the Configured Item: Choose the item you just configured with Cr. Note Required
  3. Verify Field Inheritance: Confirm the "Cr. Note Required" field is automatically set to true on the repair order
  4. Check Notification Display: Verify that the credit note notification appears with the message: "The order requires a Credit Note. Please make sure to create proper finance documents."
  5. Test Manual Override: Manually clear the "Cr. Note Required" field and confirm the notification disappears
  6. Verify Restoration: Set the field back to true and confirm the notification reappears

Understanding Repair Order Validation

What Happens When Repair Not Allowed Items Are Used

When attempting to create a repair order with an item marked as "Repair Not Allowed":

  1. Immediate Validation: The system checks the item's repair status as soon as the Item No. is entered
  2. Error Message Display: Users see the error message: "This item cannot be repaired. The company does not allow creating Repair Orders for this item."
  3. Process Termination: The repair order cannot proceed until a different item is selected
  4. Consistent Enforcement: This validation applies to all methods of repair order creation:
  5. Manual entry through the repair order page
  6. API-based creation
  7. Assisted setup or automated processes

Error Message Details

The system provides clear feedback when repair restrictions are encountered:

"This item cannot be repaired. The company does not allow creating Repair Orders for this item."

This message: - Clearly explains why the action was prevented - Indicates that this is a company policy decision - Helps users understand that they need to select a different item or seek alternative solutions

Managing Repair Settings

!!! note "Repair Tab Location" The Repair tab is added by the Quick Repair extension and appears as an additional tab on the standard Item Card.

  1. In the Repair tab, locate the Cr. Note Required checkbox.

  2. Enable the Cr. Note Required checkbox to mark this item as requiring a credit note instead of repair.

Removing Repair Restrictions

To re-enable repair for an item:

For Repair Not Allowed items: 1. Open the Item Card for the item 2. Navigate to the Repair tab 3. Clear the Repair Not Allowed checkbox 4. Save your changes

For Cr. Note Required items: 1. Open the Item Card for the item 2. Navigate to the Repair tab 3. Clear the Cr. Note Required checkbox 4. Save your changes

Impact on Existing Repairs

  • Repair Not Allowed: Changes only affect new repair order creation. This setting has no impact on existing repair orders since they could not be created while the restriction was active.
  • Cr. Note Required: Changes only affect new repair requests. Existing repair orders in progress will not be automatically affected.

Bulk Management

For organizations with many items requiring repair restrictions:

  1. Use Item Lists: Filter the Items list to identify groups requiring similar settings
  2. Document Decisions: Maintain records of why specific items have repair restrictions
  3. Regular Reviews: Periodically audit repair restrictions to ensure they remain appropriate
  4. Category-Based Approach: Consider using item categories to systematically apply repair settings

Impact on Repair Workflow

For Items Marked as "Repair Not Allowed"

When repair orders are attempted for restricted items:

  1. Prevention at Source: The system prevents repair order creation entirely
  2. Clear User Feedback: Users receive immediate notification about the restriction
  3. Alternative Guidance: Users must select different items or seek management approval to modify settings
  4. Audit Trail: All attempts to use restricted items can be logged for compliance purposes

For Items Marked as "Cr. Note Required"

When repair orders use items configured for credit note processing:

  1. Seamless Integration: The item can be selected and processed normally through the repair system
  2. Automatic Field Inheritance: The repair order's "Cr. Note Required" field automatically inherits the item's setting
  3. Immediate Notification: Users see a notification: "The order requires a Credit Note. Please make sure to create proper finance documents."
  4. Workflow Continuity: The repair process can proceed while ensuring proper financial documentation
  5. Manual Override Capability: Users can override the inherited setting if circumstances require different handling
  6. Smart Notification Management: Notifications appear and disappear based on field changes and page interactions
  7. API Integration: The "Cr. Note Required" field is available through REST APIs for external system integration

Notification Behavior Details

The credit note notification system provides intelligent user guidance:

When Notifications Appear: - Item selection on repair orders (if item requires credit note) - Manual setting of "Cr. Note Required" field to true - Opening repair order pages where the field is already true - Field validation that results in true value

When Notifications Disappear: - Clearing the "Cr. Note Required" field - Removing the item from the repair order - Closing the repair order page - Navigating away from the repair order

Notification Management: - Only one notification appears per repair order session - Notifications are automatically recalled before displaying new ones - Notifications don't persist across page reloads or browser sessions - No notification accumulation or duplication occurs

Integration with Other Repair Features

Both repair control fields work alongside other repair-related information:

  • Repair Parts Information: Items can still have repair parts defined even with repair restrictions
  • Historical Data: Past repair history remains available for reference and analysis
  • Reporting: Both "Repair Not Allowed" and "Cr. Note Required" items are included in repair analytics
  • Item Relationships: Repair restrictions don't affect the item's use in other Business Central processes

API and Integration Behavior

The repair restrictions apply consistently across all access methods:

  • Manual Entry: Direct user entry in repair order pages
  • API Access: Programmatic creation through REST APIs
  • Batch Processing: Automated or bulk repair order creation processes
  • Third-Party Integrations: External systems attempting to create repair orders

Best Practices

Policy Development

  • Clear Criteria: Establish clear guidelines for when items should have repair restrictions
  • Documentation Standards: Document the business reasons for each type of restriction
  • Regular Review Process: Schedule periodic reviews of all repair restrictions
  • Team Training: Ensure all relevant staff understand the differences between restriction types
  • Escalation Procedures: Define processes for handling exceptions or restriction changes

Implementation Strategy

  • Phased Rollout: Start with clearly problematic items before expanding to edge cases
  • User Communication: Inform teams about new restrictions and their implications
  • Change Management: Establish approval processes for modifying repair restrictions
  • Monitoring: Track how restrictions affect workflow efficiency and customer satisfaction

Customer Communication

  • Transparency: Be clear with customers about repair restrictions and alternatives
  • Alternative Solutions: Have processes in place to offer alternatives (replacement, upgrade, refund)
  • Early Notification: Inform customers about restrictions as early as possible in the process
  • Consistent Messaging: Ensure all customer-facing teams communicate restrictions consistently

Workflow Integration

  • Exception Handling: Define clear processes for handling restricted items that customers want repaired
  • Alternative Processes: Ensure credit note and replacement processes are well-defined and efficient
  • Inventory Management: Consider how repair restrictions affect inventory and procurement decisions
  • Supplier Relationships: Coordinate with suppliers on items requiring manufacturer-only servicing

Managing Multiple Items

Bulk Operations

For managing multiple items with similar characteristics:

  1. Use filtering in the Items list to identify groups of similar items
  2. Apply repair restriction settings consistently across product families
  3. Consider creating item categories or attributes to help identify items requiring restrictions
  4. Document decisions to ensure consistency across your organization

Reporting and Analysis

Use repair restriction data to:

  • Analyze Trends: Identify patterns in which types of items have repair restrictions
  • Process Improvement: Evaluate the effectiveness of restriction policies
  • Customer Impact: Assess how repair restrictions affect customer satisfaction
  • Business Intelligence: Include repair restriction data in broader business analytics
  • Compliance Reporting: Track adherence to safety and regulatory requirements

Troubleshooting

Common Issues

Q: I don't see the Repair tab on the Item Card
A: Ensure the Quick Repair extension is properly installed and you have the necessary permissions to access item details.

Q: The repair control checkboxes are not available
A: Verify that the fields are not hidden in your view. You may need to personalize the Item Card to show all Repair tab fields.

Q: I get an error when trying to create a repair order, but don't know why
A: Check if the item has "Repair Not Allowed" enabled on the Item Card's Repair tab. The error message will indicate if this is the cause.

Q: How do I know if an item has repair restrictions?
A: Check the Repair tab on the Item Card, or use reporting features to identify items with restrictions.

Q: Can I see repair restriction status in the Items list?
A: Both "Repair Not Allowed" and "Cr. Note Required" fields are available in the Items list but are hidden by default. You can add them to your view by personalizing the page.

Q: What's the difference between "Repair Not Allowed" and "Cr. Note Required"?
A: "Repair Not Allowed" completely prevents repair order creation, while "Cr. Note Required" allows processing but redirects to credit note workflow.

Q: Can I override repair restrictions in emergency situations?
A: Repair restrictions must be removed from the Item Card before repair orders can be created. Contact your system administrator or manager to modify these settings.

Credit Note Required Issues

Q: The Credit Note Required setting isn't transferring to repair orders
A: Verify that: - The setting is properly saved on the Item Card (check the Repair tab) - You're using the Item No. field validation (press Tab/Enter after entering the item number) - The item number is correct and exists in the system

Q: Notifications aren't appearing on repair orders
A: Check that: - The "Cr. Note Required" field is actually set to true on the repair order - Notifications are enabled in your Business Central user settings - You haven't accidentally dismissed the notification - You're viewing the repair order card page (notifications don't appear in list views)

Q: How do I test if the Credit Note Required feature is working?
A: Follow these steps: 1. Configure an item with "Cr. Note Required" = true 2. Create a new repair order and select that item 3. Verify the field inherits as true on the repair order 4. Confirm the notification appears with the expected message 5. Test manual override by clearing and setting the field

Q: Can users override the Credit Note Required setting on repair orders?
A: Yes, users can manually override the inherited setting on repair orders. This provides flexibility for exceptional cases while maintaining the default behavior for standard processing.

Q: Do Credit Note Required items appear in reports differently?
A: The "Cr. Note Required" field is available in all repair order reports and can be used for filtering or grouping. Items with this setting can be easily identified for finance and management reporting purposes.

Error Messages

When encountering repair restrictions, you may see:

  • "This item cannot be repaired. The company does not allow creating Repair Orders for this item." - Indicates the item has "Repair Not Allowed" enabled
  • Standard BC validation errors - May occur if the item number doesn't exist or has other issues

For additional support or questions about Quick Repair, contact BC4All support or consult the community forums.