Troubleshooting & FAQ
This section helps users identify and resolve common issues when using Business Essentials, as well as answers to frequently asked questions.
The troubleshooting guidance focuses on real-life scenarios encountered during sales and purchase processes, especially when using features such as Advanced Comments, Work Instructions, Customer/Vendor Listing, and Over-Shipments.
Common Issues and Solutions
Issue: Advanced Comments are not inserted in documents
Possible Causes:
- No Advanced Comments configured for the combination:
- Customer / Vendor
- Item or Item relationship
- Comment is defined for a different document type (Sales vs Purchase)
- Comment is inactive or incorrectly set to header/line level
Resolution:
- Verify that Advanced Comments exist for the correct:
- Customer or Vendor
- Item or Item relationship
- Ensure the Document Type matches the document being created
- Confirm whether the comment should appear at header level or at line level
- Review configuration for missing or inconsistent setups
Issue: Items are not allowed in Sales or Purchase documents
Possible Causes
- Item is not included in Customer/Vendor Listing
- Listing rule is set to Blocking instead of Warning
- Incorrect customer or vendor selected
Resolution
- Check if the item is included in the Customer/Vendor Listing
- Review the validation setup:
- Change blocking rules to warnings if flexibility is required
- Confirm correct customer/vendor is used in the document
Issue: Unable to post Over-Shipments
Possible Causes
- Over-shipment functionality not enabled or not applicable
- Restrictions or validation rules prevent exceeding quantity
Resolution
- Verify that Over-Shipment is allowed for the scenario
- Check relevant setup or tolerance rules
- Confirm that users understand when over-shipments are permitted
- Review whether alternative process adjustments are needed
Issue: Zero-quantity lines are still present in documents
Possible Causes
- Cleanup process only triggers in specific actions
- Document has not been processed through the expected step
- Customizations or user actions are bypassing cleanup
Resolution
- Ensure document is released or processed correctly
- Review when the cleanup behavior is triggered
- Confirm that no conflicting logic prevents line removal
Issue: Shortages are not being tracked
Possible Causes
- Feature not properly configured or not monitored
- Users are not completing processes in a way that records shortages
- Quantities are adjusted before posting, hiding discrepancies
Resolution
- Verify how shortages are captured in your process
- Train users to follow correct posting procedures
- Review reports or pages where shortage data is tracked
FAQ
Q: What does Business Essentials change in Business Central?
Business Essentials extends standard sales and purchase processes by adding:
- Automated document communication
- Internal work instructions
- Validation of customer/vendor agreements
- Support for over-shipments and shortages
- Document data quality improvements
Q: Does Business Essentials replace standard functionality?
No. The app extends standard Business Central processes, ensuring compatibility and a seamless user experience.
Q: Can Advanced Comments be defined at multiple levels?
Yes. Comments can be defined for:
- Customer / Vendor
- Item
- Customer/Item or Vendor/Item combinations
They can also be applied to:
- Document headers
- Document lines
Q: Are Work Instructions visible to customers?
No. Work Instructions are internal only and are intended to guide internal users during document processing.
Q: What happens if an item is not in the listing?
This depends on configuration:
- Warning → User can continue
- Blocking → User is prevented from proceeding
Q: When should Over-Shipments be used?
Over-Shipments are typically used when:
- Products are managed in bulk quantities
- Items have variable weight (catchweight)
Q: Can shortages be analyzed afterwards?
Yes. Shortages can be reviewed and used for:
- Operational analysis
- Performance monitoring
- Continuous improvement initiatives
Q: Why are zero-quantity lines removed?
To:
- Improve document clarity
- Avoid irrelevant data being processed or posted
- Reduce user errors