Difference between revisions of "Data Retention Policy Automation"

From WHMCS Documentation

m (Data Retention Settings)
(Automatically Delete Inactive Clients)
Line 14: Line 14:
 
===Automatically Delete Inactive Clients===
 
===Automatically Delete Inactive Clients===
 
   
 
   
This setting deletes client records after a given number of months without invoice or transaction history. This setting defaults to ''Never''.
+
<div class="docs-alert-danger">
 
<div class="docs-alert-warning">
 
 
<span class="title">Paid Invoices and Transactions</span><br />
 
<span class="title">Paid Invoices and Transactions</span><br />
The presence of paid invoices or transactions within the given timeframe defines client records that are kept. Enabling this feature with clients in ''Inactive'' or ''Closed'' that have no invoice or transaction history will result in those clients being deleted immediately.
+
The presence of paid invoices or transactions within the specified period determines whether WHMCS retains client records. If you enable this feature, WHMCS will immediately delete clients who are in the ''Inactive'' or ''Closed'' statuses and have no invoice or transaction history.
 
</div>
 
</div>
+
 
To enable this, select '''After no invoice or transaction activity has occurred for the following number of months:''' and specify a number of months that is greater than <tt>0</tt>.
+
This setting causes the system to perform the '''Data Retention Pruning''' task each day. This will delete client records that meet the following criteria:
+
 
When you enable it, the system performs the '''Data Retention Pruning''' task daily and will remove clients that meet the following conditions:
 
 
 
* A status of [[Automation_Settings#Client_Status_Update|'''Inactive''' or '''Closed''']].
 
* A status of [[Automation_Settings#Client_Status_Update|'''Inactive''' or '''Closed''']].
* No invoices that have been marked paid within the number of months you specify.
+
* No paid invoices within the specified number of months.
* No transactions that have been entered or applied within the number of months you specify.
+
* No entered or applied transactions within the specified number of months.
* An affiliate with a balance of 0 or that has '''not''' made a referral within the specified retention period.
+
* If the client is an affiliate, a commission balance of <tt>0</tt> or no referrals within the specified retention period. <div class="docs-alert-info"><span class="title">Client Status Update</span><br />The system can automatically change the client status. Use the '''[[Automation_Settings#Client_Status_Update|Client Status Update]]''' setting to control this.</div>
 +
 
 +
To enable this setting, select '''After no invoice payment has occurred for the inactive or closed client in the following number of months''' and specify a number of months that is greater than <tt>0</tt>. This setting is disabled by default.
 
   
 
   
If you set '''Delete associated users if the user(s) are not associated with any other client account.''' to '''YES''', the '''Data Retention Pruning''' task will also delete users that are only associated with this client.
+
<div class="docs-alert-info">
 +
<span class="title">WHMCS 8.3 and earlier</span><br />
 +
In WHMCS 8.3 and earlier, this was the '''After no invoice or transaction activity has occurred for the following number of months''' setting.
 +
</div>
 
   
 
   
The system can automatically change the client status. Use the '''[[Automation_Settings#Client_Status_Update|Client Status Update]]''' setting to control this.
+
Optionally, you can set '''Delete associated users if the user(s) are not associated with any other client account.''' to '''YES''' to cause the '''Data Retention Pruning''' task to also delete users who are only associated with this client.
 +
 
 
</onlyinclude>
 
</onlyinclude>

Revision as of 16:13, 17 December 2021

This page describes a feature available in version 7.5 and above

The length of time you must keep data for is often governed by the laws and regulations of your local jurisdiction. One thing most jurisdictions share in common however is that you should only keep personal data for as long as is necessary.

The Data Retention Policy Automation introduced in WHMCS 7.5 allows you to have WHMCS automatically enforce your data retention policy in relation to the length of time you keep your client records for.

Data Retention Settings

The data retention settings are in Configuration () > System Settings > Automation Settings (Setup > Automation Settings in WHMCS 7.10 and earlier).


Automatically Delete Inactive Clients

Paid Invoices and Transactions
The presence of paid invoices or transactions within the specified period determines whether WHMCS retains client records. If you enable this feature, WHMCS will immediately delete clients who are in the Inactive or Closed statuses and have no invoice or transaction history.

This setting causes the system to perform the Data Retention Pruning task each day. This will delete client records that meet the following criteria:

  • A status of Inactive or Closed.
  • No paid invoices within the specified number of months.
  • No entered or applied transactions within the specified number of months.
  • If the client is an affiliate, a commission balance of 0 or no referrals within the specified retention period.
    Client Status Update
    The system can automatically change the client status. Use the Client Status Update setting to control this.

To enable this setting, select After no invoice payment has occurred for the inactive or closed client in the following number of months and specify a number of months that is greater than 0. This setting is disabled by default.

WHMCS 8.3 and earlier
In WHMCS 8.3 and earlier, this was the After no invoice or transaction activity has occurred for the following number of months setting.

Optionally, you can set Delete associated users if the user(s) are not associated with any other client account. to YES to cause the Data Retention Pruning task to also delete users who are only associated with this client.