On-Demand DID Provisioning (DIDWW)


Create a Tariff for Incoming DID Costs

Enter Rates for Your Vendor Tariff

Create a DID Supplier Vendor

Create a Pricing DID Batch

Assign a Pricing DID Batch to a Customer

Provision DIDs



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 basic SIP services according to the instructions provided in the previous chapters.






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

[     ]

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

[     ]



Program the parameters (phone #, password and SIP server address) into the SIP phone and make a test call

[     ]

Create a Tariff for Incoming DID Costs

Create a tariff that describes the costs of incoming DIDs from this DID 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.


Create a tariff for incoming DID costs

Enter Rates for Your Vendor Tariff

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 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 DID provider.

2.      Click save Save.


Enter rates for your vendor tariff


Add rates


Add the rate information



Create a DID Supplier Vendor

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 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 the vendor information


Configure DID provisioning


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

6.      Go to the DID Provisioning tab to configure on-demand provisioning of phone numbers:

·       To enable the interconnection with a DID provider, check the Enable On-Demand Provisioning check box.

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

7.      Click save_close Save & Close.


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.

Create a Pricing DID Batch

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.      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 (DIDWW 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 a configurable fixed amount that is charged upon allocation of a new number in addition to the DID provider’s activation fee.

o   Additional Recurring Fee – Specify a configurable fixed amount that is always included in the recurring (monthly) charge.

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 specify the last “pre-set” digits in the figure.

o   ClickSave.


Create a pricing DID batch


Go to Pricing Parameters


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 end of the row.

6.      Repeat steps 1-5 if it is necessary to create more pricing DID batches.

Assign a Pricing DID Batch to a Customer

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 Additional Info tab select a previously created pricing DID batch in the Auto-provision DIDs via Batch list. Click save Save.


Assign a pricing DID batch to a customer

Provision DIDs

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.