Purpose Statement
This article explains how to configure permit automation to automatically approve permits once defined criteria—such as invoice payment and/or inspection completion—have been met. This feature helps departments streamline workflows, reduce manual approvals, and ensure timely permit issuance.
Background Information
Permit automation in First Due allows departments to eliminate manual approval steps by linking permits to invoices and inspection series. Once all required conditions are satisfied (e.g., invoice paid, inspections completed without failures), the system can automatically:
- Change the permit status to Active
- Assign an effective date
- Send the approved permit via email to the applicant
This is especially useful for high-volume permitting processes where efficiency and consistency are critical.
Required Permissions
To configure and use permit automation, users should have access to:
- Permits Module (view/edit permit types)
- Automation settings within permit types
- Invoicing module (create and manage invoices)
- Inspections module (if using inspection-based automation)
- Email/notification settings (for automated delivery)
Video
Step-by-Step Guide
1. Navigate to Permit Types
- Go to the Permits Module
- Select Permit Types
- Open an existing permit type or create a new one
2. Enable Automation
- Scroll to the Automation section within the permit type
- Toggle Automation ON
3. Configure Invoice-Based Auto Approval
- Ensure the Permit is linked to an Invoice
- Enable automation for Invoice Payment
- Define behavior:
- When the invoice is paid, the permit will automatically be approved
- The permit status will update to Active
- (Optional) Enable Automatic Emailing to send the approved permit to the applicant
4. (Optional) Configure Inspection-Based Automation
- Link an Inspection Series to the permit
- Enable inspection-based automation
- Define criteria:
- Permit will only auto-approve if:
- Inspection is completed
- No failures or citations are recorded
- Associated invoice is paid
- Permit will only auto-approve if:
- If any failure or citation exists, automation will not proceed
5. Set the Effective Date
Choose how the permit’s effective date is determined:
- Option 1: Date when all criteria are met (invoice paid + inspections complete)
- Option 2: Date of the initial inspection completion
6. Create and Link an Invoice
- Open a permit record
- Add a fee to generate an invoice
- Save the permit
- Confirm the invoice is linked to the permit
7. Complete the Permit Submission
- Add required details (e.g., signatures)
- Save and submit the permit
- Status should display as Submitted
8. Process Invoice Payment
- Navigate to the Invoicing Module (or take the payment while filling out the Permit)
- Locate the invoice linked to the permit
- Select Apply Payment
- Enter payment details and save
9. Verify Automation
- Return to the permit list
- Refresh the page
- Confirm:
- Status has changed from Submitted → Active
- Permit has been automatically approved
- Email (if enabled) has been sent
Best Practices
- Always test automation settings before deploying to production
- Ensure invoices are properly linked to permits
- Use inspection-based automation only when inspection workflows are standardized
- Enable email notifications to improve customer communication
- Avoid enabling automation if manual review is required for compliance
Troubleshooting & FAQs
Q: The permit did not auto-approve after payment. Why?
A: Verify:
- Account is set up for automation not manual status
- Automation is toggled ON
- Invoice is correctly linked to the permit
- Payment was fully applied
- No inspection failures (if inspection-based automation is enabled)