Managing DIDs for resellers manually (DID inventory)

When working with large numbers of DID numbers and providing them to customers, it is desirable to provision them as quickly as possible to keep the cash flow going. A great way to achieve this goal is to use resellers, which will thereby boost your sales.

This chapter demonstrates how to enable resellers to provision large numbers of phone numbers (DIDs) using the DID inventory.

Consider the following example:

You, as the residential VoIP service provider, have acquired a pool of Canadian DID numbers and want to provision them to customers within the month. Therefore, you cooperate with your reseller, ABC Shuttle, and permit them to access your pool of DIDs to further provision the DID numbers to their customers.

The sections below provide detailed instructions for how to configure DID provisioning for resellers.

In this handbook, we assume that the reseller has already been configured by the admin. For detailed instructions on how to configure a reseller in PortaSwitch, please refer to the Configuring a reseller for prepaid services or Configuring a reseller for postpaid services handbooks.

1. Operations to be performed by the admin:
   • Upload DID numbers
   • Release the DID numbers to the DID pool
   • Create a pricing DID batch for the reseller
   • Assign the pricing DID batch to the reseller
   • Create a product
   • Provide login credentials to the reseller
2. Operations to be performed by the reseller:
   • Log in to the reseller portal
   • Create a pricing DID batch for a customer
   • Assign DIDs to the pricing batch
   • Create a customer
   • Assign the pricing DID batch to the customer
   • Create accounts

Please refer to the Create a DID Supplier Vendor, Create a DID Batch for the Vendor and Upload DID Numbers sections of the Managing DIDs for customers manually (DID inventory) handbook for detailed instructions on how to upload DID numbers.

Upon upload, the status of DIDs is Frozen. When they are frozen, they are stored in the DID inventory and are therefore unavailable for immediate usage.

To allow resellers to use the uploaded DID numbers, release the DID numbers to the DID pool.

To release the DID numbers to the DID pool:

1. In the navigation menu, select Infrastructure > DID / MSISDN inventory.
2. On the DID numbers tab, click More to open the advanced search criteria. Select a specific vendor batch from the list and click Search.

   

3. Select the appropriate DIDs and click Manage.
4. On the Group operations with DIDs panel that opens, select Pool management, and then select Release DIDs to the pool.

   

5. Click Update. On the refreshed page, you will see that the DID numbers have now been unfrozen and released to the DID pool with the “Available” status.

   

Pricing batches allow you to apply additional charges to your resellers for provisioning and using the DID numbers.

At this step, it is required to create a pricing batch with the DID markup.

1. On the DID / MSISDN inventory page, open the Pricing batches tab and click + Batch.
2. On the Add pricing batch panel, fill in the pricing batch details:
   • Name – type a pricing batch name.
   • Applied to – select Reseller.
   • Type – select Inventoried as the batch contains DID numbers previously uploaded to the DID inventory.
   • Pricing – select Billable.
   • Pricing parameters:
     • Currency – choose the currency used to charge for DID usage.
     • Additional activation fee – specify an amount you want to charge in addition to a DID provider’s activation fee.
     • Additional recurring fee – specify an amount that is always included in the recurring (e.g., monthly) charge.
     • Recurring fee markup – specify a markup that will be included in the recurring amount charged to the reseller in addition to the actual DID cost (charged by a DID vendor).
     • Rounding precision – specify the rounding pattern to obtain “marketable” figures. This will specify the last “preset” digits in the figure.

       

3. Click Save.

Please refer to the UI help for a detailed description of the available fields.

To enable the reseller to access the DID pool for further DID provisioning and apply charges to the reseller for DID number usage, you need to first assign the pricing DID batch to that reseller.

1. On the navigation menu on the left, select Sales > Resellers.
2. On the Reseller panel, navigate to General info > Additional info.
3. Select the pricing batch that you have previously created (e.g., Reseller).
4. Click Save.

   

To allow a reseller to provide services to their customers and apply charges to them for service usage, it is required to create a product for the reseller’s use. Please refer to the "Create a product for the reseller" section of the Configuring a reseller for postpaid services handbook.

Provide the reseller with the credentials to access their portal:

1. The reseller portal URL (by default https://<porta-billing-server-name>:8442).
2. Their login and password (defined on the Reseller > General info > Web-self care tab).

Log in to the reseller portal using the provided URL and credentials.

A pricing batch contains DID numbers that will be provided to customers by the reseller. The DID markup defined within a pricing batch allows you to apply additional charges to customers for using the DID numbers. At this step, it is necessary to create a pricing batch for customers and define the DID markup within it.

1. Navigate to Infrastructure > DID/MSISDN inventory.
2. On the DID/MSISDN inventory page, open the Pricing batches tab and click + Batch.
3. On the Add pricing batch panel, fill in the pricing batch details:
   • Name – enter a unique name for a batch (e.g., "Pricing batch customers").
   • Applied to – select Customer.
   • Type – select Inventoried as the batch contains DID numbers previously uploaded to the DID inventory.
   • Pricing – select Billable.
   • Pricing parameters:
     • Currency – specify the currency (e.g., USD) for the DID markup.
     • Additional activation fee – specify an amount you want to charge in addition to the DID provider's activation fee.
     • Additional recurring fee – specify an amount that is always included in the recurring charge.
     • Recurring fee markup – specify a markup that is included in the recurring amount. It is calculated as a percentage of the Recurring cost amount (charged by a DID vendor).
     • Rounding precision – select the number of decimals to round the DID charges in an individual xDR (e.g., 0.00001 (5 decimals)).
     • Description – optionally, enter a short description for your pricing batch.

       

4. Click Save.
5. Repeat steps 1-4 to create other pricing batches with different DID markups within them.

It is now required to assign some DID numbers to the pricing batch. When the DID numbers from this batch are provisioned to customers, the customers are charged according to the pricing parameters defined within the pricing batch.

1. Navigate to Infrastructure > DID/MSISDN inventory.
2. On the DID numbers tab, select None from the Pricing batch dropdown list, and click Search. You will see the pool of available DID numbers.
3. Select DID numbers. To choose all DIDs on the page, select the checkbox next to the DID number column header. To choose DID numbers on all pages, click Select on all pages.
4. On the Group operations with DIDs panel, select the Assign the pricing batch checkbox.
5. Select the pricing batch from the dropdown list (e.g., "Pricing batch customers"), and click Update.

   

6. In the dialog window that opens, click Update to confirm assigning DID numbers to the pricing batch.

   

Repeat steps 1-5 and assign DID numbers to other pricing batches you have created.

TIP: If you have accidentally assigned the wrong DID number to a pricing batch, you can release it back to the DID pool. To do this, select None in the Pricing Batch dropdown list and click Update. In the dialog window that opens, click Update to confirm unassigning the selected DID numbers. 

1. On the navigation menu, select Sales > Customers, and click + Customer.
2. On the Add customer panel, fill in the customer details:
   • Balance control – specify the way the customer will pay for the service (Postpaid – after consuming the services; Prepaid – prior to consuming the services).
   • Name – type a customer name (e.g., John Welsh).
   • Currency – choose the currency in which this customer will be billed.
   • Credit limit – assign a credit limit for the customer.
   • Business model – specify a business model that defines what type of service is to be provided to the customer.
   • Customer class – by default, a customer class created by the admin on your behalf will be applied. This means that all invoicing and payment collection parameters that are defined in this customer class will apply to this customer. If you want to create another customer class for your customers, navigate to Sales > Customer classes. Click + Add and fill in the fields.
   • Billing period – choose a billing period for the customer. A billing period defines the frequency of invoicing for this customer.
   • Billing period time zone – choose a time zone in which customer’s billing period will be closed and invoices will be generated.

     

3. Switch to the other tabs to configure additional settings, such as self-care credentials.
4. Click Save.

1. On the customer page, go to General info > Additional info.
2. Select the previously created pricing DID batch from the Auto-provision DIDs via batch dropdown list (e.g., Pricing batch customers).

   

3. Click Save.

1. Open the customer page and go to Accounts / DIDs.
2. On the Accounts tab, click +Add. Click DID next to the ID field to select a DID number from the available DID numbers list.

   

3. On the Assign DID panel, fill in the following fields:
   • Search DID numbers among – specify whether to search through DIDs available in the DID pool (unallocated) or among the DIDs assigned to this customer (e.g., select unallocated).
   • Define the geographical location of the DID number – specify the country and area of the DID number.
   • Define the DID number pattern – specify the DID number pattern (e.g., specify 1 to search for DIDs with the prefix 1).

     

4. Click Next.
5. On the Choose number step, you will see a list of available DID numbers that match your search query and their associated charges. The charges for DIDs from the DID pool are pre-populated from the customer’s pricing batch. Select a DID number (e.g., 12125554401) and click Assign.

   

6. Fill in the account details on the General tab:
   • Account type – select one of the following account types (e.g., Credit):
     • Debit – is usually associated with prepaid cards and has its own balance.
     • Credit – will be invoiced for incurred costs.
   • Account role – select an account role that defines usage for this account (e.g., Phone line).
   • Service password – together with the account ID, this password will be used to authenticate registrations and call attempts on the SIP server. It is very important to assign a secure (difficult to guess) password to prevent the account from being wrongfully entered and used to inject fraudulent calls to your network. You can generate a secure password by clicking Generate password .
   • Balance control – select whether the credit account has an individual balance and credit limit or uses that of the customer. Select one of the balance control types (e.g., Subordinate):
     • Subordinate – the balance will directly depend on the customer.
     • Individual credit limit – the account has an individual account balance and credit limit. When the balance reaches the limit, services are not available for this account.
   • Activation – select when to activate the account:
     • Immediately – activates an account right after its creation.
     • Specific date – specify the exact date when you’d like to activate the account.

     

7. On the Products tab, select the main product you want this account to have.

   

8. On the Web interface tab, fill in the following fields:
   • Login – specify an account login to the self-care web interface. Can be the same as the account ID.
   • Password – generate a password for the self-care web interface by clicking Generate password .
   • Time zone – select a time zone that will be used when the account owner (SIP services subscriber) accesses the self-care web interface to view their call history.
   • Web interface language – select the language to be used on the self-care web interface.

     

9. Click Save&Edit details.
10. On the created account page, specify additional information on the Service configuration page.

You can activate/deactivate various features of the services provided to this account. Note that the features are defined per service type (the physical service provided to the user, such as Conferencing, Data Service, Voice calls, Messaging, etc.). Please refer to the service configuration documentation for more details. For now, you may leave these with their default values.

You can expand the DID provisioning network and boost sales by allowing your subresellers to provision DID numbers. Please refer to the How To… section for more information about subreseller DID provisioning.