Skip to main content

Using Passfort

What are task expiry dates?

Use task expiry dates to ensure product application tasks are re-evaluated regularly.

You can configure any task so that when a version is passed, it remains valid for a specified number of days, then expires.

By default, a new version is created 30 days before the task version expires and can be passed/failed. You can set an alternative task notification period and change the expiration period.

When the current version expires, the product application uses the next version. For approved product applications, this means the new version must be passed for the product application to remain approved. If the new version is not passed, the product application goes into review.

For example, if you configure the Verify identity task so its versions expire 365 days after they’re passed, customers must have their identities successfully re-verified every year for their product applications to remain approved.

If the task is a Custom task, you can specify that the first instance of the task is skipped. In this case, the task is only displayed on the profile for the first time 30 days before the expiry date is reached. To learn more about how this works, see Skipping the first task version.

If you're using Risk, you can configure different expiry dates for each product application risk level. To enable the Enable risk based expiry period configuration option or to learn how to get Risk, contact us.

Can tasks expire if they don't have an expiry date?

There are some tasks that expire without an expiry date. PEPs, sanctions, and adverse media tasks expire automatically when the decision to reject/cancel a product application is reverted. Tasks that have a Company data check configured with Creditsafe monitoring also expire automatically when new data is returned from Creditsafe.

To see a version of a task, select the Task versions button. Note that this button is only displayed when a task has other versions. To learn more, see What are task versions?

How expiry dates are calculated

A task version’s expiry date is set as soon as the version has been completed.

It’s calculated as the date the current version is passed plus the number of days specified in the task’s configuration.

For example, if a version of the Verify identity task is passed on 1 January 2022 and the task versions are configured to expire after 365 days, that version will expire on 1 January 2023.

The expiry date is calculated from the date the task is Passed, not the date the product application is Approved. In the previous example, even if the product application is approved on 31 December 2021, the Verify identity task expires one day later on 1 January 2022 because it was passed 365 days earlier.

Setting a custom task expiry date

If needed, you can set a custom task expiry date on completed tasks with default expiry configurations. Custom task expiry dates can be used to give your team more time to review an existing customer’s details during periodic reviews or to expire a task to match a customer’s document expiry date.

Users with Read and write permissions for product applications can set a new expiry date.

To set a custom expiry date:

  1. Select the task expiry date to open a dialog.

    Task passed status indicator and task expiry menu button.
  2. Enter a date in the future for the task to expire or click into the date field and select a date from the calendar. Selecting the Expiry reset icon button. icon sets the date to the default date and clears selected reasons or comments.

  3. Select a reason for choosing this task expiry. Optionally, add a comment.

    Edit task expiry date pop out menu.
  4. Select the Update task expiry date button.

Your change to the expiry date is logged in the audit trail and you can set up notifications to alert you when a task expiry date is changed.

Custom task expiry interacts with the default task configuration in different ways.

Note the following behavior:

  • Setting the custom expiry date applies to this task version only. Future versions of the task revert back to the default task expiry.

  • If you mark a completed task back to incomplete and then pass the task again, that task resets to a default expiry configuration.

  • Unlike default task expiry, a custom task expiry date persists even if the risk level has changed.

Setting a custom expiry date (API)

Make a POST request to the endpoint:

http://api.passfort.com/4.0/profiles/<uuid:profile_id>/tasks/<uuid:task_id>/expiry

Send a JSON object with the following information:

Key

Type

expire_at

*Required

Date+time

YYYY-MM-DD HH:mm:ss

reason_description

String

reason_categories

*Required

Array of strings. This can't be an empty array.

Reason categories can be one or more of the following:

DOCUMENT_EXPIRY, APPLICATION_ANNIVERSARY, OTHER

Note that setting expire_at to null will restore the default expiry date.

Examples:

Setting a custom expiry for a task because the applicant's passport expires on a specific date. This can overwrite the expiry date automatically calculated if a task needs to be monitored.

{"expire_at": "2023-12-10 00:00:00", "reason_description": "Passport expires on the 10th of December 2023", "reason_categories": ["DOCUMENT_EXPIRY"]}

Resetting the custom expiry with a comment and a reason category:

{"expire_at": null, "reason_description": "Resetting to the original expiry", "reason_categories": ["OTHER"]}'

Sample response:

{
    "check_ids": [],
    "creation_date": "2022-06-21 13:08:40",
    "custom_expiry": {
        "default_expiry_date": "2024-06-10 13:08:50",
        "expiry_at": "2023-06-07 00:00:00",
        "reason_categories": [
            "DOCUMENT_EXPIRY"
        ],
        "reason_description": ""
    },
    "default_expiry_date": "2024-06-10 13:08:50",
    "form_instance_ids": [],
    "id": "ca6c94df-3777-4a7a-8dae-bb10cb20733d",
    "is_complete": true,
    "is_expired": false,
    "is_skipped": false,
    "nearing_expiry": false,
    "needs_check_automation": false,
    "state": "COMPLETED_PASS",
    "type": "INDIVIDUAL_MANUAL_TASK",
    "variant": {
        "description": "Task that will link to registration forms",
        "id": "a7807aa6-8979-4eb4-9a42-404ec2f467f5",
        "name": "Registration task",
        "task_type": "INDIVIDUAL_MANUAL_TASK"
    },
    "will_expire_at": "2023-06-07 00:00:00"
}

When the expiry date is soon

Before a task version is due to expire:

  1. If the product application is approved, it’s marked as nearing expiry. The product application’s status badge is displayed as Expiring in [X] days. On the day of expiry, it's displayed as Expiring today.

    Profile application showing upcoming expiry tag.

    A notification is displayed. The notification is displayed in the Notifications area if you have your notification preferences for Application assigned to me is nearing expiry and Unassigned application is nearing expiry set to In Passfort. The notification is sent via email if the preferences are set to By email.

    Notifications drop-down showing a notification that an unassigned application is nearing expiry.

    If one product application has multiple tasks with versions nearing expiry, the nearest expiry date is used as the product application’s expiry date.

    You can view all expiring product applications by applying a filter with the Expiring within 30 days refinement.

  2. The task’s status is displayed as incomplete.

    The task indicator is an empty circle.

    Due diligence task list for a product application showing one incomplete task.
  3. The old task version becomes inactive.

    The version status remains Passed, but it’s no longer possible to run checks on this version or change its status to Incomplete. A banner on the version page indicates when it will expire.

    Task notification stating that this task version is expiring.

    During this time, it’s still possible to add/delete task notes on this version.

  4. A new version of the task is created.

    A banner is displayed to indicate it’s the new version. To learn more, see The new task version.

    Notification message stating that the previous version of this task is expiring.

If a Custom task is configured to skip the first version and the first version is nearing its expiry date, this is the first time the task is displayed to users. All actions in these steps take place. The first version of the task is displayed as Passed and inactive.

If a product application is nearing expiry and you want to know which of its tasks are expiring, look for tasks with an incomplete status. Confirm a task is expiring by looking for an expiry banner on the task.

The new task version

Use the new version to evaluate whether the profile still meets the task requirements. You can run new checks, update the task notes, and change the task status to Passed or Failed.

When the new version of the task is created, initially the status is incomplete and there are no task notes.

The smart policy determines what checks are performed when the new version is created:

  • Any checks configured to run automatically are performed on the new version as soon as it’s created. The check results are displayed in the version’s check history.

  • Likewise, if the task has associate smart policies with checks configured to run automatically, those are performed now. The results are displayed on the tasks of the associates’ profiles.

  • Nothing is displayed in the task version’s check history if no checks are configured to run automatically.

    Task page showing no checks have been run.

To run a check manually, use its button, for example, Electronic identity check or Document verification.

Passing/failing the new task version

In most cases, if the smart policy specifies the task is passed automatically as soon as one check passes and at least one check is passed, the new task version is passed automatically.

If the new task version has not passed automatically, it must be passed or failed manually.

Note

New versions of the following tasks are never passed automatically and must be passed manually:

The actions you take to decide whether to pass or fail the new version depends on the nature of the task and your company’s compliance policy. You might:

  • Review information obtained from automated checks.

  • Complete a task form.

  • Upload files, for example, a PEP declaration form, to the Task notes.

  • Record conversations or actions that took place outside of Passfort by adding a note to the Task notes.

To manually pass or fail the task, click Mark task as complete and select Passed or Failed. Optionally, explain why you're passing or failing the task in the Task notes.

When the task version is passed, the following happens:

  1. The task’s status is displayed as Task passed. The task indicator displays a checkmark.

    Task indicator in profile sidebar showing that the task has passed.
  2. The old task version expires immediately. To learn more about what this means, see Expired task versions.

  3. The application status is determined by the smart policy:

    • If all other tasks are passed and the smart policy is configured so product applications are approved automatically once all tasks are passed, the product application is given the Approved status.

    • If all other tasks are passed and automatic approvals are not configured, the status is displayed as Ready for decision, indicating that a user will need to approve/cancel the product application manually.

    • If more tasks need to be passed, the requirements for the outstanding tasks determine the status.

  4. The expiry date for the new task version is set. It’s calculated as the date the version is passed plus the number of days specified in the task’s configuration.

When the task version is failed, the following happens:

  1. The task’s status is displayed as Task failed.

    Task indicator in profile sidebar showing that the task has failed.
  2. The product application continues to use the old task version until the expiry date is reached. The old task version remains nearing expiry. This means that if the product application is approved, it remains approved until the expiry date is reached. Likewise, if the product application is not yet approved, it can be approved using the old task version until the expiry date is reached.

If you would like to reject or cancel the product application before the expiry date is reached, you can do it manually. Learn how to reject or cancel a product application manually.

If the new task version is incomplete

If the new version is not passed or failed, it remains incomplete, even once the expiry date is reached.

When the new task version is incomplete, the task indicator is an empty circle.

Task indicator in profile sidebar showing that the task is incomplete.

When the expiry date is reached

If the new task version was passed before this point, effectively the expiry date is never reached. This is because the old task version expires once the new version is passed.

However, if the new task version is failed or is incomplete when the expiry date is reached, the following happens:

  1. If the product application is approved, it goes into review.

    Learn what happens to product applications in review.

  2. If the product application is not yet approved, it remains in Onboarding.

    The product application cannot be approved until the new task version is passed.

  3. The task status remains Task failed or Incomplete.

  4. The old task version expires.

    For more information about expired task versions, see Expired task versions.

Expired task versions

Expired task versions provide a record of the checks run. It’s not possible to run any new checks or change the status of an expired task version.

Adding and deleting task notes remains enabled.

A banner is displayed across the task version, indicating when it expired.

If the task expired for a reason other than an expiry date, for example, product applications requiring the task were rejected/canceled, or new check results from Creditsafe monitoring were returned, the reason is displayed in the expiry banner.

Notification that this task version has expired, with a reason for expiry given.

Skipping the first task version

If the task is a Custom task, you can specify that the first instance of the task is skipped.

This means the behavior of the first version is slightly different from other versions.

When the smart policy adds the task to the profile, the following happens:

  • The task is not displayed on the product application, so users cannot see it.

  • The task status of this hidden version is set to Passed.

  • The expiry date begins counting down immediately.

30 days before the first expiry date is reached, the following happens:

  • The task is displayed on the product application for the first time with two versions: the first version and the new version.

  • The first version of the task is displayed as nearing expiry. A banner on the version indicates when it will expire. It is not possible to run checks or change the status.

  • A new version of the task is displayed as incomplete. Checks can be run on this version and the status can be changed to Passed or Failed.

Every subsequent version is displayed and expires as normal.

For example, you could configure a Custom task called "1 Year Review" and specify that its versions expire 365 days after they’re passed and the first version should be skipped. With this configuration, the "1 Year Review" task would not need to be completed when the task is first added, but it must be completed at the end of the task's first year and every year after that.

Changing the task expiry date for existing profiles

If you add, remove, or change a task expiry date, the behavior for existing profiles is as follows.

Adding or changing a task expiry date

When a task expiry date is added or changed, it can be applied to tasks on existing profiles for several reasons. As an example, it will be applied if any of the following changes on the profile:

  • Any task is added to or removed from the profile.

  • The product application status changes. For example, this can happen when a new event is added to a profile via a PEPs, sanctions, or adverse media check, which then puts the product application into Review.

  • The product application risk level changes. Note that the expiry date will be recalculated, even when the task expiry date is not using the Risk based expiry period configuration option.

When the task expiry date is changed, Passfort resets the expiry period for existing tasks to the shortest of the two expiry periods to avoid missed task expiry dates. For example, if a task was originally set to expire every 30 days and it's changed to expire every 365 days, the expiry period for existing tasks will continue to be every 30 days because this is the shortest period. Only new tasks will expire every 365 days.