.. _number-reservation:

Number reservation
------------------

.. _20.1.1|VOSS-651:
.. _24.2|VOSS-1382:
.. _25.3|EKB-25699:



.. tip:: 

   :ref:`use-action-search-to-navigate-automate`

Overview
...........

Number reservation allows numbers to be reserved for future use. Reserved
numbers cannot be allocated to a device or line.

The **Cooling & Reserved Number Management** list view allows a Provider administrator to manually reserve numbers at the
selected hierarchy (Provider, Customer or Site) for a specified number of days.
While a number is within the **Reservation duration (days)** period, it is
unavailable and cannot be used by a device or line.

If the **Reservation duration (days)** period is left blank, the numbers remain
in the **Reserved** status. Currently reserved numbers can be unreserved manually,
thereby *adding them back* to the list of available numbers.



.. raw:: html 

   <p>
      <a href="https://documentation.voss-solutions.com/videos/Manage-Number-Cooling.mp4" target="_blank">Video: <i class="material-icons">videocam</i><br>
      <img src="https://documentation.voss-solutions.com/videos/Manage-Number-Cooling.png" alt="Manage-Number-Cooling-video" style="height:135px;width:240px;border:1px solid black"></a>
   </p>



.. rubric:: Related topics

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

     Reserve a Number for a User in the Core Feature Guide

  .. raw:: html

     <a href="ini-reserve-for.html">Reserve a Number for a User</a>



Reserve numbers for future use 
.................................. 

.. note:: 

   Numbers can be reserved to make them unavailable to assign to any user until they're unreserved. 
   
   A separate feature, *Reserved for*, allows you to reserve numbers for a specific user. When used with *use next available line* during provisioning 
   or onboarding, numbers reserved for a particular user can't be assigned to any other user. See: 

   .. raw:: latex

      Reserve a Number for a User in the Core Feature Guide

   .. raw:: html

      <a href="ini-reserve-for.html">Reserve a Number for a User</a>

   
1. In the Admin Portal, choose the relevant hierarchy level (Provider, Customer or Site) where you 
   want to reserve numbers.
#. Go to **Cooling & Reserved Number Management**. 
#. At the **Select action** drop-down, select **Reserve**.
#. At **Reservation duration (days)**, define the number days to reserve the number/s. 
#. Fill out **Reservation Notes** for the reserved numbers to describe why the numbers
   are being reserved. This is displayed in the **Reservation notes** field on the
   **Number Inventory** list.

   .. note:: 

      Un-reserving the number (setting *Reserved* status to *Available*) automatically 
      clears the **Reservation notes** field.

#. At **Filters**, define filters to determine which numbers will be included in the **Available**
   box in the **Select Numbers** area. Options are:
   
   * Include available numbers
   * Include reserved numbers
   * Contains. Filter criteria 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 placed into a **Reserved** status,
   and are no longer available for allocation to a subscriber or phone, etc. 
   
   .. note::
   
      Individual numbers can also be reserved directly from the **Number Inventory**
      list view by clicking
      on the required number on the list view and then selecting **Reserve Number**
      on the toolbar.
   

.. rubric:: Related topics 

* 
  .. raw:: latex

     Reserve a Number for a User in the Core Feature Guide

  .. raw:: html

     <a href="ini-reserve-for.html">Reserve a Number for a User</a>


Unreserve numbers
...................

1. In the Admin Portal, choose the relevant hierarchy level (Provider, Customer or Site) where you 
   want to remove numbers from reservation (unreserve) to 
   add them back into the list of available numbers.

#. Go to **Cooling & Reserved Number Management**. 
#. From the **Select action** drop-down, choose **Unreserve**.
#. Set **Filters** to determine which numbers will be included in the **Available**
   box in the **Select Numbers** area. Options are:
   
   * Include reserved numbers
   * Contains. Additional criteria 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 **Reserved** status,
   and are available for allocation to a subscriber or phone, etc.   

   If reservation notes were included for a number when it was reserved, un-reserving the number 
   automatically clears any notes in the **Reservation notes** field.