On-demand DID provisioning from DIDWW

Link copied to clipboard


Link copied to clipboard

Use this checklist 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.

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

Link copied to clipboard

Create a tariff that describes the costs of incoming DIDs from this 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 object; 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.
    • Applied to – choose Vendor here.
    • 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.

      Create a tariff for incoming DID costs

  3. Click the Save button.

Enter rates for your vendor tariff

Link copied to clipboard

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. On the vendor tariff’s panel, click Rates and enter the rates applied to you by the DID provider.

    Add rates to your vendor tariff

  2. Click Save.

Create a DID supplier vendor

Link copied to clipboard

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 left upper corner click menu to open the navigation menu.
  2. On the navigation menu, select Infrastructure, then select Vendors.

    Create a vendor

  3. 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.
  4. Click Save.Configure DID provisioning
  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 panel.
  6. Go to the General configuration panel and select DID provisioning to configure on-demand provisioning of phone numbers.
  7. On the DID provisioning panel, use a slider 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 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 Accept calls on SIP server list.
  8. 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.

Create a pricing DID batch

Link copied to clipboard

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 Create a 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 of DIDs – select On-demand from external vendor option.
    • Vendor – select the vendor providing DID numbers for this batch (DIDWW in this example).
    • Pricing – select Fee-paying 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.

        Create a pricing DID batch

  3. Click Save.

Assign a pricing DID batch to a customer

Link copied to clipboard

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 Personal, then General and go to Additional info panel.
  2. On the Additional info panel, select a previously created pricing DID batch in the Auto-provision DIDs via batch field. Click Save.Assign a pricing DID batch to a customer

Provision DIDs

Link copied to clipboard

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.

On this page

What's new
Admin manuals
UI help
Back to main menu