.. _list-number-inventory-overview:


Number Inventory Overview
-------------------------

.. _20.1.1|VOSS-651:



Overview
........

Number inventory allows you to view and manage the number inventory at the
specified hierarchy level. It allows you to track numbers and to see how they are used
in the system. This is done through a number of workflows to ensure the selection
of numbers is limited to those available, and includes the ability to:

* Add, modify, and delete numbers
* View the status of numbers (Used, Used-Utility, Available, Reserved, Cooling). 
* Store additional business data about the numbers.


.. note:: 

   * Internal numbers can't be added if **Number Management** is disabled for the customer. 
     (See *Create and Modify a Customer*)

   * Numbers created in the number inventory are in VOSS-4-UC only; they are not
     synced to Unified CM.


**See Also**:  

* :ref:`concepts-number-status-usage`


Hierarchy
.........

The number inventory can exist at a different hierarchy level to the lines for the
users, services, and devices that consume them, which are typically at site level. 

The inventory can also exist at customer level. This makes it easier if the
allocation and availability of numbers is not site-specific. This saves moving
numbers around sites to increase availability, and keeps a more central inventory
of available numbers. 
It is also important if numbers are shared across sites. If you are a customer
with multiple sites, ensure that the internal numbers you specify are unique across
sites.

If the number allocation is site-specific, the numbers can be added or assigned
to site level.

Number inventory can only exist at provider, customer, or site hierarchy. It is
not applicable to the intermediate hierarchy.


Partition and Cluster
.......................

Number inventory is not partition or cluster aware. If the same numbers are
used multiple times but in different partitions, then these all map to the same
number. This should be taken into account when thinking about the hierarchy level
at which the number inventory exists.

Also, not being cluster aware, if the same number exists on different clusters,
this again will map back to the same inventory value unless numbers are assigned
to the site level.  


Reservation
...........

Numbers can be reserved for future use. For example, for users who will soon be
joining the company. When a number is reserved, it is unavailable and cannot
be allocated to a subscriber, phone, device, etc. See also: :ref:`number-reservation`.


Number Cooling
...............

Numbers can be placed into a cooling period, either manually or automatically. When automated 
number cooling is enabled, numbers are placed into cooling for a predefined period when the 
subscriber or phone associated with the number is deleted.

.. note:: 
  
   Automated number cooling is enabled and disabled in the :ref:`global-settings`. The default is disabled.

While the number is in its cooling period, it is unavailable and cannot be allocated, for example, to a subscriber, phone, 
or device.  

A number is released from cooling and is available for use when:  

* The cooling period reaches its end date
* It is manually released from the cooling period

**See also**:

* :ref:`number-management-cooling`


Number Inventory entries - End-user Provisioning Tasks
......................................................

For more information on provisioning each of these tasks, refer to the relevant
topics in the VOSS-4-UC Core Feature Guide.

+--------------------+-------------------------+------------------------+
| Task               | Menu Default Location   | Notes                  |
+====================+=========================+========================+
|                    |                         | When lines are added   |
|                    |                         | through phones and     |
|                    |                         | subscriber, line       |
|                    |                         | details can be         |
|                    |                         | modified.              |
| Lines              | **Subscriber            |                        |
|                    | Management > Lines**    | The number for the line|
|                    |                         | cannot be modified; if |
|                    |                         | you attempt to change  |
|                    |                         | the number assigned to |
|                    |                         | the line, the operation|
|                    |                         | fails.                 |
+--------------------+-------------------------+------------------------+
|                    |                         | The Dirn > Pattern     |
|                    |                         | contains a list of     |
|                    |                         | available numbers.     |
|                    | **Subscriber            |                        |
| Phones             | Management > Phones >   | Numbers that are used  |
|                    | Lines tab > Dirn >      | are marked as "Used" in|
|                    | Pattern**               | the Number Inventory.  |
|                    |                         |                        |
|                    |                         | Only available numbers |
|                    |                         | are listed.            |
+--------------------+-------------------------+------------------------+
|                    |                         | The Dirn > Pattern     |
|                    |                         | contains a list of     |
|                    |                         | available numbers.     |
|                    | **Subscriber            |                        |
| Subscribers        | Management >            | Numbers that are used  |
|                    | Subscribers > Phones    | are marked as "Used" in|
|                    | > Lines > Dirn**        | the Number Inventory.  |
|                    |                         |                        |
|                    |                         | Only available         |
|                    |                         | numbers are listed.    |
+--------------------+-------------------------+------------------------+
|                    | **Subscriber            | The "Voicemail Line"   | 
|                    | Management >            | list contains numbers  |
|                    | Subscribers >           | provisioned to lines.  |
|                    | Voicemail**             |                        |
+--------------------+-------------------------+------------------------+
|                    |                         | The Number Inventory   |
|                    |                         | list contains          |
|                    |                         | available numbers.     |
|                    | **Subscriber            |                        |
|                    | Management > Quick      | Numbers that are used  |
| Quick Add          | Add Subscriber >        | are marked as "Used"   |
| Subscribers        | Lines > Directory       | in the Number          |
|                    | Number**                | Inventory.             |
|                    |                         |                        |
|                    |                         | Only available numbers |
|                    |                         | are listed.            |
+--------------------+-------------------------+------------------------+
|                    |                         | Numbers provisioned to |
|                    | **Subscriber            | lines are displayed in |
| PLAR (Hotdial)     | Management > PLAR       | the Hotdial            |
|                    | (Hotdial)**             | Destination Pattern    |
|                    |                         | list.                  |
|                    |                         |                        |
|                    |                         | Numbers that are used  |
|                    |                         | are marked as          |
|                    |                         | "Used-Utility" in the  |
|                    |                         | Number Inventory.      |
+--------------------+-------------------------+------------------------+
|                    | **Subscriber            | Numbers provisioned to |
| Hunt Groups        | Management > Hunt       | lines are displayed in |
|                    | Groups > Members >      | the Pattern list.      |
|                    | Directory Number**      |                        |
|                    |                         |                        |
|                    |                         | Numbers that are used  |
|                    |                         | are marked as          |
|                    |                         | "Used-Utility" in the  |
|                    |                         | Number Inventory.      |
+--------------------+-------------------------+------------------------+
|                    | **Subscriber            | Numbers provisioned to |
| Call Pickup Groups | Management > Call       | member lines are       |
|                    | Pickup Groups > Call    | displayed in the       |
|                    | Pickup Group > Line**   | Pattern list.          |
|                    |                         |                        |
|                    |                         | Numbers that are used  |
|                    |                         | are marked as          |
|                    |                         | "Used-Utility" in the  |
|                    |                         | Number Inventory.      |
+--------------------+-------------------------+------------------------+