Model: view/NumberInventoryAudit

Audit Number Inventory

Audit Number Inventory

Overview

Automate allows you to perform an audit of the number inventory to ensure that the status and usage values of each number aligns to the devices or services configured with these matching numbers.

Note

For more information about the values for Status and Usage, see Number Status and Usage.
Numbers that are in a Cooling or Reserved state aren't included in an audit.
For vendor-specific audit details, see Vendor Specific Guidance and Notes.
You can only run the number inventory audit for customers that have number management enabled. See Create and Modify a Customer.
You can view the list of internal numbers, and move, delete, and export them as required, on the Number Inventory list view (default menu, Number Management > Number Inventory).

For Microsoft environments, available numbers are added (else updated if present) to the inventory, with:

status: Available
vendor: Microsoft
number type: Operator Connect or Calling Plan

Note

For details, see: Audit Process in Microsoft Environments

The audit creates new numbers for devices or services that don't already exist, and updates existing number entries so that the Status and Usage fields display accurate information at the time the audit is run. Importantly, number entries are not deleted.

To access the flowcharts, view the topic via the release documentation at: https://documentation.voss-solutions.com/automate.html

Number Inventory Audit and Hierarchies

The table describes the difference between running a number audit inventory at the customer level compared to the site level:

Customer

Running the number inventory audit at customer level adds directory numbers at the customer level for services that exist at site or customer level, provided that there is not already a directory number for that service at site level.

If there are already directory numbers at the site level, then those numbers are also updated.

This is a mixed mode of audit, which audits directory numbers at both customer and site level. For example, if directory numbers only exist at customer level, then the audit only adds and updates directory numbers that exist at the customer.

If there are directory numbers at site level, the audit will still add new directory numbers at the customer level, but will also update the existing directory numbers at site level.

Site

Running the number inventory audit at site level adds directory numbers at site level, and updates any existing directory numbers at site level only. No customer level directory numbers will be audited and no directory numbers will be added to customer level for customer level services.
You can choose to audit either all the sites for the customer, or selected sites

Note

For sites using Site Location Code-based dial plans, number inventories can be created only at the site hierarchy. The customer hierarchy won't be available.

Audit Number Inventory Common Errors

The table describes common errors and steps to resolve, when running audit number inventory:

Error	Resolution
Duplicate device profiles (same profile name) in different clusters	Ensure that device profiles are not duplicated across the sites.
Duplicate phones (same MAC) in different clusters	Ensure that phones are not duplicated across the clusters.
Same internal number in one or more clusters	Ensure that internal numbers (even in different partitions) are not duplicated across clusters.

Run a Number Inventory Audit

Note

You can only run Audit Number Inventory from a customer hierarchy. If you try to run it from a hierarchy that is not of type Customer, you will be prompted to choose a valid customer hierarchy.

Log in to VOSS Automate as provider or reseller administrator.
Select the relevant Customer hierarchy level.
Go to Audit Number Inventory (via, default menu Number Management > Audit Number Inventory).
From the Is Number Inventory deployed at Customer or Site Level drop-down, select an option, either of the following:
- If your number inventory is deployed at customer level, select Customer, then click Save to run the audit number inventory at all sites at the selected customer.
- If your number inventory is deployed at site level, choose Site, then, at Would you like to audit all sites or a subset of sites, select an option:
  - Select All to run audit number inventory at all sites at the selected customer.
  - Select Specific to choose the sites where you want to audit the number inventory, then select sites, one or more (maximum 200), from Available to Selected in the transfer box.
    
    Note
    
    The number of sites you have in your environment may exceed the number of sites displayed in the transfer box. You can use a contains search to filter the list for the sites you want to include in the number inventory audit.
  Click Save to run audit number inventory.
View transaction progress. The number inventory is updated at the hierarchy you specified, and below.

New tool that audits line and utility number (Pilots)

Model Details: view/NumberInventoryAudit

An asterisk * in the title indicates the field is mandatory.
If a field has a default value, it is shown in the Description column.
If the field type is an array, the Field Name has a .[n] suffix, where n is the array index placeholder.
Object and array field names are listed to provide context. If a field belongs to an object or an array, the full field name is shown in dot separated notation.

Title		Description	Details
Is Number Inventory deployed at Customer or Site Level ?		Default: Site	Field Name: iniModel Type: String Default: Site Choices: ["Customer", "Site"]
Would you like to audit all sites or a subset of sites ?		Default: All	Field Name: scope Type: String Default: All Choices: ["All", "Specific"]
	Sites		Field Name: site_X.[n] Type: Array
Number		When populated only this number will be audited	Field Name: iniNumber Type: String