On-Demand DID Provisioning from PortaSwitch® Owners

This chapter provides instructions for how to provision DID numbers from DID suppliers – other PortaSwitch® owners on-demand.

 

Let us take the following example:

 

The FastNet service provider needs DID numbers to provide residential VoIP services to its customers. It has signed a contract with EasyDIDs to provision DIDs from them on-demand.

 

For DID number usage, FastNet will charge their customers a $5 additional activation fee and an $8 additional monthly recurring fee.

 

If you have a pool of DID numbers and wish to sell them to other PortaSwitch® owners, please refer to the DID Exchange Among PortaSwitch® Owners  handbook.

Checklist

Print the following page and use it to check off the operations you have completed while performing the system setup according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes should be checked), otherwise the service will not work.

 

_Hint_ExclamationMark The checklist below assumes that you have already configured the routing between your system and that of your DID seller according to the instructions provided in the previous chapters.

 

 

Operation

 

Done

Make sure you have configured incoming call delivery from your DID supplier as described in the Incoming Calls from PSTN handbook

[     ]

General configuration

 

Enable the DIDPoolClient on the Configuration server

[     ]

Rating configuration

 

Create a tariff (referred to as tariff A later on) that describes your incoming DID costs (make sure it is NOT a Routing type!)

[     ]

Enter rates in tariff A for the incoming DID range

[     ]

Create a DID supplier vendor using the credentials provided by the DID provisioning vendor

[     ]

Define a connection for this vendor using tariff A

 

Create a pricing DID batch

[     ]

Account provisioning

 

Check that the retail SIP service customer has already been created according to the instructions in other chapters

[     ]

Assign a pricing DID batch to the customer

[     ]

Assign DID as an alias for this customer’s account

[     ]

Configure the DIDPoolClient on the Configuration Server

To obtain DID numbers from your DID supplier, it is necessary to configure PortaSwitch® to operate as a DIDPool client on the Configuration server.

 

1.      Clone the active configuration and open it.

2.      Go to the Admin node and select the BrandedDIDPoolClient for the required billing environment.

3.      Set Yes for the Enabled option.

 

Configure the DIDPoolClient

 

4.      Click the Save button and then the Verify button.

5.      Verify the new configuration and click the Check / Apply button.

 

_Hint_ExclamationMark Note that the Apache service will need to be restarted, so consider applying the configuration during an off-peak time.

Create a Tariff for Incoming DID Costs

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

 

1.      In the  Rating section of the Admin-Index page, choose Tariffs.

2.      On the Tariff Management page, choose https://demo.portaone.com:442/images/icons/add.gif Add.

3.      Fill in the Add Tariff form. In the Applied To select menu, choose Vendor. Then clear the Routing check box, since no routing actually takes place for this vendor, i.e. the vendor will be sending calls to your network.

4.      Click save Save.

Define Rates

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, you can use the wildcard destination (|) to enter a single zero rate in the tariff.

 

1.      Click on the Rates button, then click https://demo.portaone.com:442/images/icons/add.gif Add. Enter the rates applied to you by the EasyDIDs provider.

2.      Click save Save.

Create a DID Supplier Vendor

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

 

1.      In the  Participants section of the admin interface, choose Vendors.

2.      On the Vendor Management page, click  https://demo.portaone.com:442/images/icons/add.gif Add.

 

Create a DID supplier vendor

 

Add vendor information

 

3.      Fill in the Add Vendor form. Please refer to the instructions provided in the Create Vendors chapter of the Basic Residential VoIP Service section for a detailed description.

4.      Click save Save.

5.      Go to the DID Provisioning tab and select the Enable On-Demand Provisioning option.

 

Configure DID provisioning

 

6.      Select the Another PortaSwitch® carrier from the DID Provider list.

7.      Fill in the information obtained from your DID supplier (EasyDIDs in our example):

·       Host – Specify the hostname and port of the DID provider’s server;

·       User Name – Specify the login to connect to the DID provider’s server via API;

·       Password – Specify the password to connect to the DID provider’s server via API.

·       Vendor DID Batch – Either select one of the existing ones or provide a name for a new vendor batch. It will be automatically created in your DID inventory.

·       Incoming Costs Tariff – Select the tariff that describes your incoming DID costs.

·       Accept Calls on SIP Server – Select your PortaSIP® node here.

8.      Click  Save & Close.

Create a Pricing DID Batch

To provision DID numbers to your customers and charge for their usage, it is necessary to create a pricing DID batch and define your DID markup within.

 

1.      In the  Networking section of the admin interface, choose DID Inventory.

2.      On the DID Inventory page, choose  DID Pricing.

3.      Click https://demo.portaone.com:442/images/icons/add.gif Add to add a new batch.

4.      Fill in the Add DID Batch form:

·       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.

·       Pricing Parameters – Click the Pricing Parameters link, select the Add On-Demand from External Vendor option and define the DID price using the following parameters:

o   Vendor – Select the vendor providing DID numbers for this batch (EasyDIDs in this example).

o   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.

o   Additional Activation Fee – Specify 5.

o   Additional Recurring Fee – Specify 8.

o   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.

o   Round the Final Charge Amount – Specify the rounding pattern in order to obtain “marketable” figures. This will calculate the last “pre-set” digits in the figure.

o   ClickSave.

 

Create a Pricing DID batch

 

Specify pricing parameters

 

Save the pricing batch

 

5.      Click the save Save button in the toolbar, or the save_add icon on the left-hand side of the row.

Assign the Pricing DID Batch to a Customer

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

 

1.      In the  Participants section of the main menu, select Customers.

2.      Search for a specific customer and click their name to modify their service configuration.

3.      On the Additional Info tab of the Edit Customer page, select a previously created pricing DID batch in the Auto-provision DIDs via Batch list. Click save Save.

 

Assign the pricing DID batch to a customer

Provision a Number

Similar to on-demand DID provisioning from external providers like DIDWW or DIDX, a DID number can be provisioned as an alias to an existing account.

 

Please refer to the How to handbook for instructions on how to add a DID number as an account alias from the administrator web interface.

Add an alias on customer self-care interface

Alternatively, you can add a DID number as an account alias on behalf of a customer using the customer self-care interface.

 

1.      Log in with the customer’s web access login and password.

2.      On the IP Centrex tab, select DIDs.

3.      Click the Add DID button.

 

Add an alias on customer self-care interface

 

Add a new DID number

 

4.      In the Add new DID number dialog box, filter the DIDs by country and area and select a number. Click OK.

 

Assing the number to

 

5.      Associate the DID number with the phone line:

·       Click the Edit icon.

·       Select the account from the Assigned to list.

·       Click Update.