Skip to main content

Understanding Delinquency Tasks

Learn about the four delinquency task types, how each one is configured, and how they run within a Delinquency Template.

Overview

A delinquency task is an action that runs automatically, or is assigned to a manager to complete by hand, at a set point during delinquency. Delinquency tasks are created inside a Delinquency Template, so each task belongs to a specific Delinquency Stage and runs on a schedule you define. This article explains what each delinquency task type does, what you configure for each one, and how the task creation form changes depending on the type you choose.

Key Concepts

Before you create a delinquency task, it helps to know the key terms this article uses:

  • A delinquency task is a single automated or manual action - for example, applying a fee, sending a notice, locking a unit, or assigning a follow-up to a manager - that runs at a specific point during delinquency. There are four delinquency task types: Apply Fee, Notice, Lockout, and Manual. Each type is covered in detail later in this article.

  • Every delinquency task is assigned to a Delinquency Stage, such as Grace Period, Late, Pre Lien, Lien, or Other. Delinquency Stages are fully explained in the Understanding Delinquency Process: Stages, Templates, and Auctions article (coming soon); this article only covers how a task connects to a stage, not what each stage means or how stages are configure.

  • PTD (Paid Through Date) is the last date the tenant has paid rent through. PTD is the reference point most delinquency task triggers are measured against.

  • A notice template is the Email, SMS, or document content a Notice task sends to the tenant. Notice templates are created separately, under Templates > List > Add New > Delinquency Template, where you choose a type.

  • A Delinquency Template is the blueprint that stores a facility's delinquency stages and delinquency tasks together. You create and configure a Delinquency Template before you can add any tasks to it; that process is covered in the Understanding Delinquency Templates and Their Assignment article.

How Delinquency Tasks Work

Every delinquency task follows the same basic trigger model, regardless of type. Each task has a Delinquency Action Trigger and an After value, which together determine how many days must pass - from PTD or from a previous task - before the task runs. You can also turn on Exclude Weekends, which skips Saturdays and Sundays when calculating the trigger date.

Because the After value can reference either PTD or an earlier task, tasks can depend on one another and become nested within each other based on their execution date:

  • More than one task can be nested within the same earlier task, since several tasks can each use that same task as their trigger.

Delinquency Template task list showing task 2 and task 3 both triggered a number of days after task 1, illustrating two tasks nested within the same task

Delinquency Template task list showing task 2 and task 3 both triggered a number of days after task 1, illustrating two tasks nested within the same task

  • A task can also be nested within a task that is itself nested within another task, creating a multi-level chain of dependent tasks.

Delinquency Template task list showing task 3 triggered a number of days after task 2, which is itself triggered after task 1, illustrating a multi-level chain of nested tasks

Delinquency Template task list showing task 3 triggered a number of days after task 2, which is itself triggered after task 1, illustrating a multi-level chain of nested tasks

ℹ️ Info: Restarting a delinquency process doesn't resume the previous one - it cancels it and builds a brand new process from the unit's current Delinquency Template. Task countdowns in the new process are still anchored to PTD, not to the restart date, so any task whose day count has already passed becomes due immediately. Whether an overdue Notice task runs again depends on the Send Notices choice made at restart: with notices on, overdue Notice tasks execute and send again; with notices off, overdue Notice tasks are skipped, while Apply Fee, Lockout, and Manual tasks still run as scheduled either way.

The four delinquency task types differ in what they do once triggered:

  • An Apply Fee task automatically applies a fee to the tenant's lease.

  • A Notice task sends a templated communication to the tenant, as a document, an email, or an SMS. The notice can be sent to an alternate contact as well.

  • A Lockout task restricts access to the unit. Depending on the type of lock installed on the unit, a Lockout task can trigger a software lockout automatically, or it can prompt a manager to apply a physical lockout.

  • A Manual task adds an action to a manager's dashboard for the manager to complete by hand, such as calling the tenant or physically visiting the unit.

The Create New Task drawer changes depending on which of these four types you select, since each type needs different information to run. The rest of this article walks through what to configure for each task.

Using the Feature

Creating a delinquency task involves opening the task creation drawer and configuring fields that change based on the Task Type you choose.

Prerequisites

Before creating a delinquency task, make sure the following are already in place:

  • Corporate level permissions for Delinquency are enabled: Create Template, Edit Template, and Read Template (Corporate level > Users > Roles&Permissions > [Your Role] > Corporate tab > Delinquency section > enable Create Template, Edit Template, and Read Template).

  • Delinquency Notice Templates already created for Email, SMS, and Document.

  • Users, who can be assigned to a task or set as approvers, already created.

  • One-time fees already created.

Opening the Create New Task Drawer

To create a delinquency task, navigate to Delinquency Templates from the sidebar at the Corporate level, then select List. Open an existing Delinquency Template, or create a new one and save it, then click the template's name. From the template page, click Create New Task to open the Create New Task drawer.

Delinquency Templates page with all Delinquency Templates listed

Delinquency Templates page with all Delinquency Templates listed

Every delinquency task shares the following fields, regardless of type:

  1. Task Name

  2. Delinquency Stage

  3. Task Type

  4. Description

  5. Delinquency Action Trigger: Calendar Days and Day of the Month

  6. After

  7. Exclude Weekends

Fields in the Create New Task drawer

Once you choose a task type, the drawer opens additional fields specific to that type.

Configuring an Apply Fee Task

When you select Apply Fee as the task type, the drawer adds a section where you choose a one-time fee.

Task Type Apply Fee and Fee drop-down menu highlighted in the Create New Task drawer

⚠️ Warning: The one-time fee drop-down lists every one-time fee created company-wide, not only fees already assigned to this facility. If you select a fee that isn't assigned to the facility, the task returns an error message "Fee used in template is not assigned to facility." once the Delinquency Template is assigned to the facility. To resolve this, go to Fees, assign the fee to the facility, then reopen the Delinquency Template.

Turn on the Recurring Fee toggle to have the fee repeat for the duration of the delinquency, rather than applying once. When this toggle is on, three additional options appear:

  1. Generate document for Print

  2. Send email to tenant

  3. Send SMS to tenant

Each option requires selecting a Notice Template.

The Recurring Fee toggle is on and highlighted in the Create New Task drawer

ℹ️ Info: If you turn on the Recurring Fee toggle, this task does not appear in the After drop-down for any tasks created afterward. This happens because a recurring fee tied to a lease repeats until the lease becomes inactive, while a delinquency needs to end at some point; the fee is configured to recur only for the duration of the delinquency, not the full lease term.

Furthermore, the drawer adds an Approvals section. Turn on the Approval Required toggle to require sign-off before the manager can complete the task; doing so reveals a search bar where you select the approver, i.e., the user. If you leave this toggle off, the task appears on the manager's dashboard automatically, with no approval step.

Approvals section in the Create New Task drawer with the Approval Required toggle on

Configuring a Notice Task

When you select Notice as the task type, the drawer shows three sending options:

  1. Generate document for Print

  2. Send email to tenant

  3. Send SMS to tenant

Each option requires selecting a document, email, or SMS notice template, matching the option.

The Create New Task drawer with Task Type set to Notice, showing the Generate document for Print option selected via radio button

The Generate document for Print and Send email to tenant options each include a Generate for Alternate contact toggle. Turn this toggle on to send a notice template for the tenant's alternate contact:

  • When generating a document for print, selecting a document template for the alternate contact is mandatory.

Generate for Alternate contact toggle is on and selecting a document template to send to an alternate contact is mandatory when generating a document for Print

  • When sending an email, selecting an email template for the alternate contact is not mandatory because the template you chose for the main contact will be used for the alternate contact as well.

Send to Alternate contact toggle is on and selecting email template for alternate contact is not mandatory when sending email to tenant

Configuring a Lockout Task

Selecting Lockout as the task type does not add any new fields to the drawer. A Lockout task restricts access to the unit once its trigger date passes. Whether that happens automatically through a software lockout, or manually through a physical lockout that a manager applies, depends on the type of lock installed on the unit.

Configuring a Manual Task

Selecting Manual as the task type adds a Define User Task section with three mandatory fields: User Task Name, Assign Task to, and Description. A Manual task can represent any action a manager needs to complete by hand, such as calling the tenant or placing a physical lock on the unit.

Create New Task drawer with Manual task type which displays a Define User Task section

ℹ️ Info: Manual tasks, as Apply Fee tasks, may also require approval from a manager before they appear on the assignee's dashboard and are executed.

Viewing, Editing, and Configuring a Task

Once a task exists within a Delinquency Template, you can view its current configuration, edit it, or delete it from the task list.

To view a task's configuration, click the view icon to open the Task Details drawer. This drawer displays every field exactly as it's currently configured - including Task Name, Task Type, Stage, the relevant notice or fee settings, and Applies After - but none of the fields can be changed from this view.

Task Details drawer showing the read-only configuration of a Notice task named 1st Notice

To edit a task, click the pencil icon to open the Edit Task drawer. This drawer contains the same fields as the Create New Task drawer, pre-filled with the task's current configuration. Every field can be changed except Task Type. Once you're done, click Save Task to save your changes.

Edit Task drawer with the same fields as the Create New Task drawer, pre-filled with a task's existing configuration

ℹ️ Info: Task Type cannot be changed once a task is created. If a task needs a different type, delete it and create a new one instead.

To delete a task, click the delete icon to open a confirmation modal naming the task you're about to remove.

Delete confirmation modal naming the task 1st Notice and asking the user to confirm, with Delete and Cancel buttons

⚠️ Warning: Deleting a task is permanent and cannot be undone. Confirm you have the right task selected before clicking Delete.

FAQs

These are the most commonly asked questions about delinquency tasks.

1. Does a Lockout task always trigger a software lockout?

No. A Lockout task can trigger a software lockout, or it can prompt a manager to apply a physical lockout, depending on the type of lock installed on the unit.

2. Can I select more than one delivery method for a single Notice task?

No. Generate document for Print, Send email to tenant, and Send SMS to tenant are mutually exclusive options for a Notice task; you can select only one per task. If you need more than one delivery method, create a separate Notice task for each one.

3. Do I need to select a separate template for the alternate contact?

It depends on the delivery method. When generating a document for print, selecting a document template for the alternate contact is mandatory once the Generate for Alternate contact toggle is on. When sending an email, selecting a separate template is optional - if you don't select one, the template chosen for the main contact is used for the alternate contact as well.

4. Can a Manual task be any action?

Yes. A Manual task can represent any action a manager completes by hand, such as calling the tenant or visiting the unit in person.

5. Do Apply Fee tasks require approval the same way Manual tasks do?

Yes. Both Apply Fee tasks and Manual tasks can require sign-off from an approver before they appear on the assignee's dashboard and are executed, using the Approval Required toggle.

6. Can I change a task's type after it's created?

No. Task Type is the only field that can't be edited once a task is created. If a task needs a different type, delete it and create a new one instead.

7. How does Restart Delinquency handle nested tasks with day-based countdowns?

A restart doesn't resume the old process - it cancels it and creates a brand new process from the unit's current Delinquency Template. Countdowns in the new process are anchored to PTD, not to the restart date, so any task whose day count has already passed becomes due immediately. The Send Notices choice made at restart controls what happens to those overdue tasks: with notices on, overdue Notice tasks execute and send again; with notices off, overdue Notice tasks are skipped, while Apply Fee, Lockout, and Manual tasks still run normally either way.

Related Articles

Did this answer your question?