Difference between revisions of "Automation Settings"

From WHMCS Documentation

(Termination Days)
Line 137: Line 137:
  
 
<div class="docs-alert-info">You must configure Ticket Statuses to "Auto-Close" for this setting to take effect. You can learn more about Ticket Statuses and the Auto-Close functionality in our [https://docs.whmcs.com/Support_Ticket_Statuses#Status_Options Status Options documentation].</div>
 
<div class="docs-alert-info">You must configure Ticket Statuses to "Auto-Close" for this setting to take effect. You can learn more about Ticket Statuses and the Auto-Close functionality in our [https://docs.whmcs.com/Support_Ticket_Statuses#Status_Options Status Options documentation].</div>
 +
 +
===Prune Ticket Attachments===
 +
When this setting is enabled, ticket attachments will be automatically deleted after the selected amount of time of inactivity following the closure of a ticket.  This can be set between 1 and 24 months.
 +
 +
For more information on this functionality, see the [[Ticket Attachment Pruning]] documentation.
  
 
==Data Retention Settings==
 
==Data Retention Settings==

Revision as of 10:02, 27 July 2020

The Automation Settings allow you to configure all of WHMCS's automated processes. This includes suspensions, unsuspensions, terminations, how far in advance the system generates invoices, and when the system sends overdue notices. It's the one central place that controls everything that the daily automation tasks do.

To trigger the daily automation tasks, you must configure a Cron Job at a recommended frequency of every 5 minutes. This is usually part of the initial installation of WHMCS.

Watch Video Tutorial

Scheduling

Time of Day

This setting allows you to select the hour in which you'd like WHMCS to perform all daily automation tasks. To function properly, this setting depends on configuring your cron job to run at least once every hour. We recommend setting it to run every 5 minutes to allow other system processes, such as checking for updates, to take place.

Automatic Module Functions

These settings pertain to your customer’s products or services and how the system handles non-payment.

Enable Suspension

Selecting this option will enable automatic suspensions when payments for products or services are overdue. The setting below (Suspend Days) controls the amount of time between your customer becoming overdue and when the system suspends them.

Suspend Days

If you enabled Enable Suspension, this configures the amount of time between a customer's product or service becoming overdue and the system suspending them.

Enable Unsuspension

When you enable this setting, services that the system suspended due to "Overdue on Payment" will automatically become unsuspended when they pay the unpaid invoice for the item. However, if you suspended products or services manually, and assigned a custom reason for suspension, then an automatic reactivation will not occur. For example, you may have manually suspended an item with a reason of "Broken Terms of Service" or "Awaiting ID Verification".

Enable Termination

Enable this option to terminate the client's service (remove it from the server) according to the setting below (Termination Days).

Termination Days

If you selected Enable Termination, this determines the number of days between a product or service becoming overdue and the system terminating that product or service.

Billing Settings

Use these settings to determine how the system generates invoices and sends payment reminders to your customers. Setting the Unpaid and Overdue Reminder settings to 0 will prevent the system from sending the related emails.

Invoice Generation

This is the number of days before the system will generate due date invoices. For example, if this setting is 7, the system will generate an invoice seven days before the due date for products, services, addons, and domains.

Per Billing Cycle Settings

By clicking Advanced Settings, you can specify a different invoice generation setting for each billing cycle. For example, you may want the system to generate invoices for monthly services seven days in advance and generate invoices for annual services 14 days in advance.

Domain Invoice Generation

This optional setting allows you to specify how far in advance to generate domain renewal invoices. You can use this if you want to give a longer time between invoice generation and the due date for domain invoices. This is particularly useful when you don't accept payments online and more time might be necessary to avoid domain expiration.

Leave this setting blank if you want the system to generate all invoices at the same time.

Payment Reminder Emails

If you enable this, the system will remind your customers by email in advance of an unpaid invoice's due date. It does this using the Invoice Unpaid Reminder setting (below). This setting does not apply to Overdue Reminders.

Invoice Unpaid Reminder

The system sends this email before the due date if the invoice remains unpaid, to remind a customer that the invoice will be due soon.

Overdue Reminders

If a customer hasn't paid an invoice in a certain number of days after the due date, the system will email the customer with a reminder.

Add Late Fee Days

If a customer hasn't paid an invoice that is this number of days overdue, your customer will be charged late fees (according to your choices in General Settings).

Overage Billing Charges

Use this to determine how to bill clients for overage (if you enabled this). The first setting will calculate the bandwidth overage costs on the last day of each month and create an invoice that is due immediately. This will create a separate invoice.
The second setting will still calculate the overage change on the last day of the month, but it will not create a separate invoice. Instead, the system will add it to the client's next invoice.

Change Invoice Status

Part of the Payment Reversals feature. Set Invoice to Collections Status. WHMCS uses the collections status for invoices to denote invoices that are bad debts. You can use this to track invoices that have received payment disputes or chargebacks.

Change Due Dates

Part of the Payment Reversals feature. This reverts Next Due Date Increments for the products and services in an invoice. The system considers them as due again, and, in cases where the date is in the past, overdue, which will trigger an automated suspension until repayment is made.

Credit Card Charging Settings

Use these settings to determine how to charge your customer's cards when you use a merchant gateway to handle credit card payments.

Process Days Before Due

This specifies the number of days before the due date that you wish to capture. For example, setting this to 1 would attempt to charge the card for the first time one day before the invoice due date.

Attempt Only Once

By default, the system will attempt to capture payment for unpaid invoices daily until it succeeds. When you enable this option, WHMCS will only attempt to charge the customer’s card once. If it fails, it will not try again until the client or an admin makes a manual payment attempt.

Retry Every Week For

If a credit card is declined and you have enabled this setting, WHMCS will attempt the card once a week for this number of weeks. For example, if you set this to 2, the system would attempt to charge the card two additional times. Set this to 0 to disable this, causing the system to attempt to change the card every day.

CC Expiry Notices Date

This is the day of the month on which the system will send reminder emails to active clients with cards that expire by the end of the month, asking them to update their records. On the 1st of the month, WHMCS will remove any credit cards with an expiration date before that day's date.

We recommend a low value, such as 1, to give clients as much notice as possible to update their card details. For example:

Scenario
Card Expiry Date: March 2020
CC Expiry Noticed Date: 1

Timeline of Events
Reminder email sent: 1st March 2020
Card removed from WHMCS: 1st April 2020

Do Not Remove CC on Expiry

When you enable this option, the client's credit card information will remain on file after its expiration date. When you disable this, the system will remove the credit card details using the setting you specified for CC Expiry Notices Date.

Currency Auto Update Settings

Use these settings for the multi-currency system.

Exchange Rates

When you enable this setting, WHMCS will connect with the European Central Bank and obtain the latest exchange rates. This will ensure your currency conversion functions are always using an accurate rate. For more information, see the list of supported currencies.

Product Prices

When you enable this setting, the system will automatically update your prices according to the exchange rates. For example, if you have a product that costs $1 in your default base currency (USD) and the exchange rate is 0.6 for a second currency (GBP), the product’s price would automatically update to £0.6. Tomorrow, if the exchange rate changed to 0.7, a $1 product would change to £0.7.

Domain Reminder Settings

These settings determine when and how many emails the system sends to your customers to remind them to renew their domain names. You can send a maximum of five reminders. If you set any field to 0 it will disable that email.

You can configure WHMCS to send Domain Renewal Notices before and after a domain has expired.

For more information on this functionality, see the Domain Renewal Notices documentation.

Domain Sync Settings

Domain Sync Enabled

Enable this setting for the domain date and status synchronisation function.

Sync Next Due Date

Use this setting to choose whether to sync the Next Due Date to the Expiry Date, and, if you wish, how many days in advance of it.

Domain Sync Notify Only

If you enable this, the domain sync script won't make any changes. It will only notify admins of the changes it would have made. This is useful for debugging.

Domain Expiry Sync Frequency

A value of 0 will check the domain expiration dates every four hours. Use this setting to set a different frequency. The lowest frequency setting, 1, will check every hour.

Pending Transfer Sync Frequency

A value of 0 will check the domains in Pending Transfer status every four hours. Use this setting to set a different frequency. The lowest frequency setting, 1, will check every hour.

Support Ticket Settings

Close Inactive Tickets

After this amount of time has passed, the system will close any tickets that meet both of the following criteria:

  • The ticket's status is either answered or customer reply.
  • There have been no new replies from staff or the customer.

The system will also send an email to the customer.

Tickets in on hold and in progress status are exempt from auto-closure. Closure takes place when the daily cron job runs.

You must configure Ticket Statuses to "Auto-Close" for this setting to take effect. You can learn more about Ticket Statuses and the Auto-Close functionality in our Status Options documentation.

Prune Ticket Attachments

When this setting is enabled, ticket attachments will be automatically deleted after the selected amount of time of inactivity following the closure of a ticket. This can be set between 1 and 24 months.

For more information on this functionality, see the Ticket Attachment Pruning documentation.

Data Retention Settings

Automatically Delete Inactive Clients

This setting allows you to configure client records to be automatically deleted after a given number of months without invoice or transaction history. This setting defaults to off.

To enable this, you must select the radio option for removing clients automatically and specify a number of months that is greater than 0.

When you enable it, the system performs the Data Retention Pruning task daily and will remove clients that meet the following conditions:

  • Are in a status of Inactive or Closed.
  • Have no invoices that have been marked paid within the number of months you specify.
  • Have no transactions that have been entered or applied within the number of months you specify.
  • Is an affiliate with a balance greater than 0 or has made a referral within the specified retention period.
Important Note: 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 client status can be changed automatically by the system. This is controlled by Client Status Update in Configuration () > System Settings > Automation Settings.

For more information, see the Data Retention Policy Automation page.

Miscellaneous

Cancellation Requests

When you enable the Show Cancellation Link option, enabling this setting will automatically terminate the client’s package on the termination date.

Update Usage Statistics

Enabling this option will display disk and bandwidth usage statistics from the hosting control panel (if it is supported) inside the WHMCS admin and client areas. It will update them on a daily basis.

Client Status Update

WHMCS automatically sets clients with no active products or services to Inactive status. This helps you to distinguish and filter clients effectively. However, you can stop WHMCS from doing this by changing this setting. More information on this feature is available in Client Management.

Disabled — The system won't change the status of a client automatically.

Change client status based on active/inactive products — If a client has no active or suspended products or services, the system will automatically set their account to Inactive status the next time that the cron job runs.

Change client status based on active/inactive products and not logged in for longer than 3 months — In addition to the above option, the system will only set a client's account to inactive when their last login date was over 3 months ago.