.. _number-management-cooling:

Number Cooling
--------------

.. _19.3.1|VOSS-639:
.. _20.1.1|VOSS-651:

.. index:: Flowchart;Number Cooling



Overview
.........

Number cooling allows for the automatic aging of numbers after service delete
to prevent immediate reuse of a number. For example, if a user leaves the company,
the phone number that was in use can be placed into a cooling period for a
pre-configured number of days to prevent a new user from receiving unwanted calls
on that number. This feature can be enabled per hierarchy level.

.. note::
   
   Number cooling is enabled and configured in Global Settings.


During the cooling period, the number can't be reused until either the cooling
period has elapsed, or until a Provider administrator has manually removed the
number from the cooling period. Once a number is removed from the cooling
period, it is reintroduced into the pool of available numbers for allocation
to a subscriber, phone, device, etc.

A number cooling auto expiry schedule runs daily. This schedule polls the cooling
**Release Date** field on the number inventory list view to determine which numbers
have completed their cooling period. These numbers are then returned to the list
of available numbers at the specific hierarchy level. For more details refer to
"Number Cooling Auto Expiry Schedule" in the *Advanced Feature Guide*.

The **Cooling & Reservation** form allows a Provider administrator to manually add numbers to a cooling
period (which removes these numbers from the list of available numbers), or to manually
remove numbers from a cooling period (which returns these numbers to the list of
available numbers).





.. rubric:: Related Topics

* :ref:`list-number-inventory-overview`
* :ref:`run-dni-audit-tool`
* 
  .. raw:: latex

     Number Cooling Auto Expiry Schedule in the Advanced Configuration Guide

  .. raw:: html
  
     <a href="concepts-number-cooling-auto-expiry-schedule.html">Number Cooling Auto Expiry Schedule</a>

* 
  .. raw:: latex

     Global Settings in the Core Feature Guide

  .. raw:: html
  
     <a href="concepts-global-settings.html">Global Settings</a>



Apply Cooling
..............

1. Navigate to the required hierarchy level (Provider, Customer or Site) from which you
   want to add numbers to a cooling period.
#. Use the **Action Search** to go to **Cooling & Reservation**. 
#. On the **Cooling & Reservation** page, choose **Apply cooling** from the
   **Select action** drop-down.
#. Enter an optional cooling duration in days (max = 999) to apply to the selected
   numbers. This setting overrides the value set in their global settings. If this
   field is left blank, then the cooling duration set in :ref:`global-settings` for
   each number will apply.
#. Set **Filters** to determine which numbers will be included in the **Available**
   box in the **Select Numbers** area, these include:
   
   * **Include available numbers**
   * **Include cooling numbers**
   * **Contains**. Used to further refine the numbers displayed in the **Available**
     box.
   * **Show numbers at/below hierarchy**. Allows you to select a lower hierarchy
     level than the one selected on the hierarchy breadcrumb. 
     
#. Select one or more numbers in the **Available** box and click **Select** to
   move them to the **Selected** box. 
   
   .. note:: 
      
      The **Available** field won't display used numbers; that is, it only display 
      unused and available numbers.
    
#. Click **Save**. The selected number(s) are placed into a **Cooling** status, and
   are no longer available for use until they reach either the **Release Date** or
   until they are manually removed from cooling.
   
   
Remove from Cooling
.....................

1. Navigate to the required hierarchy level (Provider, Customer or Site) from which
   you want to remove numbers from a cooling period, i.e. add them back into the
   list of available numbers.
#. Use the **Action Search** to go to **Cooling & Reservation**. 
#. On the **Cooling & Reservation** form, choose **Remove from cooling** from the
   **Select action** drop-down.   
#. Set **Filters** to determine which numbers will be included in the **Available**
   box in the **Select Numbers** area, these include:
   
   * **Include cooling numbers**
   * **Expires from cooling within (days)**. 
   * **Contains**. Used to further refine the numbers displayed in the *Available* box.
   * **Show numbers at/below hierarchy**. Allows you to select a lower hierarchy
     level than the one selected on the hierarchy breadcrumb. 
       
#. Select one or more numbers in the **Available** box and click **Select** to
   move them to the **Selected** box. 
#. Click **Save**. The selected number(s) are removed from the cooling period and
   are available for allocation to a subscriber or phone, etc.