Approval workflows don't fire, route to the wrong approver, or skip steps. Email notifications never arrive.
Why it happens
- Workflow rule conditions don't match the document
- Approval roles or user assignments are incorrect
- SMTP configuration broken or address incorrect
- User language or signature path missing
- Custom workflow code not handling all branches
Diagnostic steps
- 1. Re-run the rule manually
Trigger the workflow event on a test document and check the workflow log for the matching rule.
- 2. Validate the rule condition
Most workflow problems are condition expressions that don't match the document data.
- 3. Check assignment
Confirm the assigned user, role, and substitute setup. A missing substitute can silently stall workflows.
- 4. Test SMTP
Use Sage X3's built-in mail test to confirm SMTP credentials, port, and TLS are correct.
Fixes
Repair rule conditions
Rewrite conditions to handle the actual range of document data. Test against historical documents.
Update assignment matrix
Document and maintain the approval matrix. Substitutes for vacations are critical.
Fix SMTP
Use authenticated SMTP with TLS. Many environments inherited insecure or unmonitored mail configurations.
Add workflow monitoring
Daily report of pending workflow tasks aging beyond a threshold.
Prevention
- Approval matrix reviewed quarterly
- SMTP health check in monthly system review
- Workflow aging report distributed to managers
PRH Consulting can resolve this for you
Our sage x3 support practice handles issues like this regularly. Most engagements start with a short scoping call.