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.
Checklist
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.
Operations to be performed by an administrator
Operation |
Done |
Rating configuration | |
Upload DID Numbers to the DID inventory following the guidelines from the Managing Available Phone Numbers (DID Inventory) handbook | |
Release the DID numbers to the DID pool | |
Create a pricing DID batch for a reseller | |
Assign the pricing DID batch to the reseller | |
Create a product for the reseller use. The reseller will be able to sell this product to end users; make sure this product is marked as Managed by: Reseller. |
Operations to be performed by the reseller
Operation | Done |
Log in to the reseller self-care interface | |
Create a pricing DID batch for a customer | |
Assign some DID numbers to the pricing DID batch | |
Create a customer | |
Assign the pricing DID batch to the customer | |
Account provisioning | |
Assign DID as an account |
Operations to be performed by an administrator
Upload DID numbers
Please refer to the Create a DID Supplier Vendor, Create a DID Batch for the Vendor and Upload DID Numbers sections of the Managing Available Phone Numbers (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.
Release the DID numbers to the DID pool
To allow resellers to use the uploaded DID numbers it is necessary to release the DID numbers to the DID pool.
To use the DID numbers, release them to the DID pool.
- On the navigation menu on the left, select Infrastructure, Inventory and click DID inventory.
- On the DID inventory panel, select Vendor batches.
- On the Vendor batches search panel, type in the specific vendor batch and click Apply filters.
- Click the Number of DIDs.
- On the Results panel, select the appropriate DIDs and click Manage.
- In the Select operations to apply to the selected DIDs dialog, select Pool management, then select Release DIDs to the pool.
- Click Ok.
- Click the Apply button. On the refreshed screen you will see that the DID numbers have now been unfrozen and released to the DID pool with the “Not in use” status.
Create a pricing DID batch for reseller
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.
- On the DID inventory panel, select Pricing batches.
- On the Create a pricing batch panel, fill in the pricing batch details:
- Name – type a pricing batch name.
- Applied to – select Reseller.
- Type of DIDs – select Inventoried as the batch contains DID numbers previously uploaded to the DID inventory.
- Pricing – select Fee-paying.
- 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).
- Decimal places, number – specify the rounding pattern to obtain “marketable” figures. This will specify the last “pre-set” digits in the figure.
Please refer to the PortaBilling Help for a detailed description of the available fields.
- Click Save.
Assign the pricing DID batch to the reseller
To enable 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.
- On the navigation menu on the left select Sales, Sales agents and then Resellers.
- On the Reseller panel, select General info.
- On the General info panel, select Additional info.
- On the Additional info panel, select the pricing batch that you have previously selected (e.g., Reseller).
- Click Save.
Create a product
To allow a reseller to provide services to his 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.
Operations to be performed by the reseller
Log in to the reseller self-care interface
Open the reseller self-care page in a browser (by default: https://<your-porta-billing-server-name>:8442) and log in with the credentials that were provided to you.
Create a pricing DID batch for customer
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.
- In the Networking section of the reseller interface, choose DID Inventory.
- On the DID Inventory page, choose
DID Pricing.
- Press
Add to add a new batch.
- Type in the batch name and click the Pricing Parameters link.
- Define the currency for the DID markup and fill in the Pricing Parameters form. Please refer to PortaBilling Help for a detailed description of available fields.
- Click Save.
- Click the
Save button in the toolbar, or the
Save icon on the left end of the row.
- Repeat steps 1-7 to create other pricing batches with different DID markups within them.
Assign DIDs to the pricing batch
Now it is 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.
- In the Networking section of the reseller interface, choose DID Inventory.
- Select NONE (Unassigned) from the Pricing Batch list and click Search. On the refreshed screen you will see the pool of available DID numbers.
- Select the individual DIDs or, alternatively, use the First N option to automatically process a large number of DIDs at once.
- Choose the Assign Pricing DID Batch option and select the pricing batch created above.
- Click the Apply button. On the refreshed screen you will see that DIDs have been assigned 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 a wrong DID number to a pricing batch, you can release it back to the DID pool. To do this, select the NONE (Clear DID’s Pricing Batch) action.
Create a customer
- In the Participants section of the reseller’s web interface choose Customers.
- Fill in the Add Customer form.
The most important fields are:
Main form (top)
- Customer ID – short name for the customer object; this will be used on the web interface.
- Customer Class – by default, your customer class will be applied. This means that all invoicing and payment collection parameters that are defined will be applicable to this customer.
- Balance Control – specify the way the customer will pay for the service: Postpaid – after consuming the services; Prepaid – prior to consuming the services. Choose Postpaid in this field.
- Currency – the currency in which this customer will be billed.
- Permanent Credit Limit – assign a credit limit for the customer.
Address info tab
- Email – an email address for the distribution of accounting information. After the billing period is over, a list of xDRs and other statistics will be sent to this address.
Web self-care tab
- Time Zone – the time zone for the customer self-care interface.
- Web Interface Language – language to be used on the customer self-care web interface.
Additional info tab
- Send Statistics – Summary only – deliver a call summary only and do not attach a details file; this could be useful in the case of a large number of calls. Other options are Full Statistics (attach a complete list of xDRs) or Do not send (this option prevents the delivery of event statistics to this customer via email).
- Suspend On Insufficient Funds For Subscriptions – specify whether the system should check that the customer has sufficient funds for his/her subscription charges.
Life cycle tab
- Billing Time Zone – time zone in which customer’s billing period will be closed and invoices will be generated.
- Billing Period – frequency of invoice generation. For more details about the different available billing periods, see the PortaBilling Administrator Guide.
Balance & credits tab
- Credit Limit Warning Threshold(s) – the customer can be notified by email when his balance is dangerously close to the credit limit and service will soon be blocked. Here you can enter the value for such a warning threshold. This can be entered:
- As a percentage (e.g., 90%). The warning will be sent when the customer’s balance exceeds that percentage of his credit limit. So, if the credit limit is USD 1000.00 and the threshold is 90%, a warning will be sent as soon as the balance exceeds USD 900.00. This is only applicable when the customer has a positive credit limit.
- As an absolute value. The warning will be sent as soon as the balance goes above the specified value. To specify several credit limit warning thresholds, enter the values, separated by commas.
Assign the pricing DID batch to the customer
- While on the Edit Customer page, go to the Additional Info tab.
- Select the previously created pricing DID batch in the Auto-provision DIDs via Batch list.
- Click
Save.
Create accounts
- Go to the Customers screen. It should resemble the screenshot below.
- Next to the customer name, click on the
Accounts icon (the one in the Accounts column) to go to the account management page for that customer.
- Click on the
Add icon.
- Fill in the Add Account form:
- Account Role – the defined usage for this account. Select Phone line from the list.
- Main Product – assign the main product you want this account to have.
- Click on the Account ID link
- In the DID Number Select dialog box, you will see the list of available DID numbers and the charges associated with them. The charges for DIDs from the DID pool are pre-populated from the customer’s pricing batch.
- Click the DID number link to select it as the account ID.
- Complete the account creation process:
Account info tab
- Type – account type; select credit for postpaid and debit for prepaid service.
- Balance Control – choose the way the balance of the account is controlled. Subordinate – the balance will directly depend on the customer; Individual Credit Limit – this account may have its own balance and credit limit (the customer credit limit still applies.)
- 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.
- Email – enter the account owner’s email address here. If he ever forgets his password for the web self-care pages, he will be able to reset it, and a new password will be sent to this email address. You can also just leave this field empty.
- Batch – a batch is typically used to manage large quantities of one customer’s accounts, so it can be left empty for residential VoIP service – in other words, the account created will not be tied to any specific batch.
Products
- Main Product – choose the main product, which you would like your account to have.
- Add-on Products – assign add-on products to the account, if required.
Additional info tab
- Auto-Provisioning – leave None (manual provisioning) selected.
Life cycle tab
- Activation Date – the date from which the account is usable.
- Specific Date – identifies the date that the account expires. Since we are setting up a postpaid service, which should function for a long time, leave this field blank.
- ____days after First Use – defines the number of days the account remains active after its first use or recharge. Since we are setting up a postpaid service, which should function for a long time, leave this field blank.
- ____days after Last Use – defines the number of days the account remains active after its last use or recharge. Since we are setting up a postpaid service, which should function for a long time, leave this field blank.
Web self-care tab
- Login – account login to web self-care pages. Can be the same as account ID.
- Password – password for the web self-care pages.
- Time Zone – when an account owner (SIP services subscriber) accesses web self-care pages to see a list of his calls, we can show the time in the time zone most appropriate for him.
- Web Interface Language – the language to be used on the customer self-care web interface.
Service configuration tab
Using this tab, you can activate/deactivate various features of the services provided to this account. Note that features are defined per service type (the physical service provided to the user such as Conferencing, Data Service, Voice Calls, Messaging etc.)
Please consult the PortaBilling Help for a description of parameters available here. For now you may leave these with their default values.
TIP: 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.