← Back to Resources

🛠️ Lien Waiver Troubleshooting Guide

Solve Common Issues Quickly

🚨 Quick Problem Solver

🔴 URGENT ISSUES

❗ Payment Blocked - Need Immediate Release

Symptoms: Payment shows "Blocked - Pending Waivers" Solution Path:

  1. Check Waiver Status (Construction → Lien Waivers)
  2. Look for "Overdue" or "Rejected" status

  3. Verify all contractors submitted waivers

  4. Emergency Override (Admin only) Settings → Emergency Controls → Payment Override ⚠️ Requires legal justification

  5. Contact Legal Team: legal@contracting.app

  6. Include project ID and payment details
  7. Provide business justification for urgency

❗ Contractor Cannot Submit Waiver

Symptoms: Upload fails or form won't submit Quick Fixes:

  1. Clear Browser Cache
  2. Press Ctrl+F5 to force refresh

  3. Try incognito/private browsing mode

  4. Check File Requirements

  5. File size under 10MB ✅
  6. Format: PDF, JPG, or PNG only ✅

  7. Document clearly legible ✅

  8. Verify Account Access Profile → Account Status → Verify permissions

🟡 COMMON ISSUES

📄 Document Upload Problems

Problem Cause Solution
"File too large" File exceeds 10MB limit Compress PDF or use lower resolution
"Invalid format" Wrong file type Convert to PDF, JPG, or PNG
"Upload failed" Network/browser issue Try different browser or clear cache
"Document unclear" Poor scan quality Rescan at higher resolution
"Signature missing" No visible signature Ensure signature is clearly visible

📝 Form Validation Errors

Error Message Solution
"State code invalid" Verify project location is correct
"Amount mismatch" Check payment amount matches waiver
"Date in past" Use future through date
"Missing required field" Complete all red asterisk (*) fields
"Legal language modified" Use unmodified statutory language

⏰ Status & Timing Issues

Issue Explanation Action
Waiver shows "Pending" for days Under manual review Contact legal@contracting.app
"Overdue" status but submitted on time System clock difference Contact support with timestamps
Payment released without waiver System misconfiguration Report immediately to security
Waiver expired before use Through date too early Submit new waiver with future date

🔧 Step-by-Step Problem Resolution

Problem: "Waiver Rejected - Resubmission Required"

Step 1: Understand Rejection Reason

Lien Waivers → View Details → Rejection Notes

Common reasons: - ❌ Missing required information - ❌ Incorrect state form used - ❌ Invalid signature or notarization - ❌ Amount doesn't match payment

Step 2: Fix Identified Issues

Step 3: Resubmit

Action Menu → Resubmit Waiver → Upload Corrected Document

Step 4: Monitor Status

Problem: "Multiple Contractors - Some Waivers Missing"

Identification

Project Dashboard → Payment Compliance → View Details

Shows list of all required contractors and waiver status

Resolution Process

  1. Identify Missing Waivers
  2. Red status = Missing waiver
  3. Yellow status = Submitted, under review

  4. Green status = Approved

  5. Contact Missing Contractors

  6. Use built-in messaging: Messages → Send Waiver Reminder
  7. Automated reminder: Bulk Actions → Send Reminders

  8. Phone follow-up for urgent situations

  9. Set Deadlines Waiver Request → Edit → Update Due Date → Save

  10. Escalation Path

  11. Day 1-3: System reminders
  12. Day 4-7: Project manager follow-up
  13. Day 8+: Legal team intervention

Problem: "State Form Not Available"

For Supported States (CA, TX, FL, AZ, NV, UT, WY, MO, GA, MI, MS, MA)

For Unsupported States

  1. Use Generic Form Waiver Type → Select "Generic - Consult Legal"

  2. Get Legal Review

  3. Contact local construction attorney
  4. Verify generic form meets state requirements

  5. Submit attorney approval with waiver

  6. Request State Addition Support → Feature Request → Add State Support Include: State, legal citations, sample forms

📱 Platform-Specific Issues

Mobile Device Problems

File Upload on Mobile

Form Completion on Mobile

Browser Compatibility

Supported Browsers

Known Issues

🎯 Performance Optimization

Faster Processing Tips

  1. Prepare Documents in Advance
  2. Use consistent naming: ProjectName_WaiverType_Date.pdf
  3. Scan at 300 DPI for optimal quality vs. file size

  4. Ensure all pages included in single PDF

  5. Batch Operations Bulk Actions → Upload Multiple → Select All Files → Submit

  6. Template Usage Waiver Templates → Save Project Template → Reuse for Similar Projects

Reduce Approval Time

  1. Complete Information First Time
  2. Double-check all required fields
  3. Use proper legal property descriptions

  4. Include all contractor license information

  5. High-Quality Documents

  6. Clear signatures and text
  7. All pages included
  8. Proper orientation
  9. No shadows or glare

🔍 Advanced Troubleshooting

System Integration Issues

Blockchain Recording Problems

Payment Integration Problems

API Integration Issues

External System Integration

# Test API connection
curl -X GET "https://contracting.app/api/lien-waivers/waivers" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Common API Errors

📊 Performance Monitoring

System Health Indicators

Green Status 🟢

Yellow Status 🟡

Red Status 🔴

When to Escalate

📞 Contact Information

Support Tiers

🟢 Tier 1 - General Support

🟡 Tier 2 - Technical Support

🔴 Tier 3 - Legal/Emergency

24/7 Emergency Contacts

📚 Additional Resources

Training Materials

🎯 Still having issues? Contact our support team with your specific problem, including: - Project ID and waiver ID (if applicable) - Screenshots of error messages - Browser and device information - Steps you've already tried

We're here to help ensure your lien waiver process runs smoothly!

Last Updated: January 2025

← Back to Resources