On-demand DID provisioning from DIDWW

1. Create a tariff for incoming DID costs
2. Enter rates for your vendor tariff
3. Create a DID supplier vendor
4. Create a pricing DID batch
5. Assign a pricing DID batch to a customer
6. Provision DIDs

Create a tariff that describes the costs of incoming DIDs from the DID provider.

1. On the navigation menu on the left, select Service catalog and click Tariffs.

   

2. On the Create tariff panel, fill in the tariff details:
   • Name – a short name for the tariff; this is the name you will see in the select menus.
   • Currency – indicates the currency in which the vendor charges you.
     The currency for the tariff may be chosen only once, and cannot be changed later.
   • Service – select Voice calls.
   • Applied to – select Vendor.
   • Routing – leave the Routing disabled, since no routing actually takes place for this vendor, i.e., the vendor will be sending calls to your network.
   • Define prices – set per individual rate code.
   • Code group set – select None.

     

3. Click Save.

The process of entering incoming call rates is similar to the one described for other vendors. If your vendor does not actually apply per-minute charges to deliver incoming calls to your network (e.g., DID World Wide bills each DID on a fixed monthly fee basis, with no per-minute charges), you can use the wildcard rate code (|) to enter a single zero rate in the tariff.

1. On the vendor tariff panel, click Rates and enter the rates applied to you by the DID provider.

   

2. Click Save.

This entity is required to keep track of incoming DID expenses and to provide an adequate level of security on the network, and also to configure the interconnection with the DID vendor via their API to query, reserve and release phone numbers.

1. Navigate to Infrastructure > Vendors, and click Add.
2. On the Create vendor panel, fill in the vendor details:
   • Name – type a short name for the vendor object; this will be used on the web interface (for example, DID Supplier).
   • Currency – choose the currency in which this vendor charges you.
   • Opening balance – this indicates a starting balance for the vendor; the default is zero.
   • Billing period – split period for vendor statistics.

     

3. Click Save.
4. Since for better security every incoming call to your network must be authorized, you can create an account under the vendor which will be used for such authorization. The account can be created on the Authorization panel.
5. Go to the General configuration panel and select DID provisioning to configure on-demand provisioning of phone numbers.
6. On the DID provisioning panel, turn on the toggle to enable on-demand provisioning and specify the following information:
   • Select DIDww from the DID provider list.
   • Register on the provider’s web site to obtain the User name (API user) and API key necessary for receiving authorization on the DIDWW server. To do that, go to www.didww.com and enter the information in the appropriate fields.
   • Specify a new vendor DID batch or choose one created earlier. All DID numbers allocated from this vendor will be assigned to a specified batch. Note that if a new batch is specified here, it will automatically be created in the DID Inventory.
   • Select the tariff that defines your incoming DID costs (the one created above) from the Incoming costs tariff list.
   • Select the PortaSIP node from the Vendor should send calls to list.

   

7. Click Save.

When a DID vendor is saved, PortaBilling requests configuration data from the selected DID provider and automatically creates all the required connections for receiving calls under this vendor. The specified incoming costs tariff is assigned to all connections by default.

The pricing DID batches are sets of pricing parameters that are applied to different customer groups for DID usage (e.g., for DID usage, you may want to charge your residential customers differently from your business customers).

1. On the DID inventory panel, select Pricing batches.
2. On the Add pricing batch panel, fill in the pricing batch details:
   • Name – type in a short name for the pricing DID batch object.
   • Applied to – select Customer, since this is the batch that will be used for charging customers.
   • Type – select On-demand from external vendor.
   • Vendor – select the vendor providing DID numbers for this batch (DIDWW in this example).
   • Pricing – select Billable and define the pricing parameters:
     • Currency – select the currency to be charged for DID usage. Note that this batch can only be assigned to customers who use the same currency.
     • Additional activation fee  – specify a configurable fixed amount that is charged upon allocation of a new number in addition to the DID provider’s activation fee.
     • Additional recurring fee  – specify a configurable fixed amount that is always included in the recurring (monthly) charge.
     • Recurring fee markup  – specify a configurable increase of the DID cost (charged by the DID provider) included in the recurring charge in addition to the actual DID cost.
     • Decimal places, number – specify the rounding pattern to obtain “marketable” figures. This will specify the last “pre-set” digits in the figure.

       

3. Click Save.

On-demand DID provisioning enables the customer to browse, online, the complete inventory of DID or toll-free numbers available on the DID vendor side. When a number is selected, the sign-up process on the PortaSwitch side will reserve and allocate that number on the DID provider side and provision it inside of PortaSwitch (e.g., as an alias to an existing account). When the customer decides that he no longer needs the number (or changes the number to something else), the reverse procedure will happen – the number will be released on the DID provider side and the account/alias will be removed in PortaBilling.

To assign DID numbers to your customers, do the following:

1. On the Customer panel, select General info and go to the Additional info tab.
2. Select a previously created pricing DID batch in the Auto-provision DIDs via batch field.

   

3. Click Save.

Once a batch of numbers for DID auto-provisioning have been assigned, these numbers can be provisioned for this customer on the DID provider side. This is usually done by an end user. Please consult the DIDs (External numbers) section of the PortaBilling help or the … add a DID number as an account alias via On-demand DID provisioning chapter of the How to… section for more information about provisioning DIDs.