Release

Search

Configuring a distributor for postpaid services

Link copied to clipboard

Using distributors to expand your sales network

Link copied to clipboard

This section demonstrates how to configure a distributor who will be selling your postpaid products to end users, collecting cash payments from them and entering these into the system.

The procedure is very similar to the general residential VoIP set-up described in the Basic residential VoIP service handbook. Only a few additional comments are necessary:

  • A distributor is not allowed to create accounts in the same way as an administrator does – they can only use quick forms to do this.
  • The distributor is allowed to create customers with a zero credit limit and a zero opening balance. In this case, no money is collected from the customer, and so there is no basis for the distributor to receive commission. Thus, for postpaid customers the distributor will only receive commission when they collects money from the customer and then applies this to the customer’s account as a payment.
  • The distributor is not allowed to manage DID numbers nor assign them as account IDs from DID inventory. Therefore, the distributor can only create SIP accounts via a quick form by manually entering phone numbers.

For the configuration demonstration we will use the following example:

To boost your sales you have a distributor who sells your PBX product to small businesses. Thus, the distributor is entitled to create customers and accounts and to record payments received from customers.

Checklist

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.

Operations to be performed by the administrator

Link copied to clipboard

 

Operation

Done

Rating configuration

Create a distributor and set his commission rate

Specify a username and password for the distributor to access the self-care interface

Operations to be performed by the distributor

Link copied to clipboard

Account provisioning

Go to the customer self-care web page and log in using the credentials provided

Create new customers

Generate accounts for customers

Accept payments from customers and record payment information in the system

Create a distributor

Link copied to clipboard

The distributor entity you are about to create will define your relationship with a partner who is distributing your services, and will allow him further service management (e.g., creating his own customers and accounts).

  1. On the navigation menu, select Sales, then Sales agents and click Distributors.
  2. On the Create distributor panel, fill in the distributor details:
    • Name – a short name for this distributor; this will be used on the web interface.
    • Currency – the currency in which this distributor will be billed.
    • Credit limit – assign a credit limit for the distributor.
    • Customer class – customer class allows you to define a policy for automated payment collection. By choosing a specific class here the customer will automatically inherit all of the class properties (grace period, invoice template, etc.).
    • Billing period – choose a billing period for the distributor. A billing period defines the frequency of invoicing for this distributor.
    • Billing period time zone – the time zone in which the distributor will see his xDRs, and which will also define his billing period. For example, if you choose America/New_York here and the billing period is Monthly, the billing period will start on the first day of the month at midnight (12 am) New York time.
    • Default sales commission – this commission is applied when an account is created or a distributor is assigned (e.g., if the distributor's commission percentage is 15%, and a new account with a $10 balance has been created, then the distributor is charged $8.5 and has a $1.5 profit).
    • Default payment commission – this commission is applied when payment is entered (e.g., when the distributor makes payment of $10 towards an account, and his payment commission is 10%, then the distributor is charged $9 and has a $1 profit).

      Add a distrubutor

  3. Click Save.

General info

Link copied to clipboard

Define the distributor’s personal information (such as name, email address, and etc.).

  1. On your distributor’s panel, click Personal info, then click General info.
  2. On the Personal info panel, fill in the distributor’s personal information and an email address for the receipt of accounting information.

Web self-care

Link copied to clipboard

Define credentials and preferred settings (such as language, time zone, date input and output formats) for this distributor’s self-care interface.

  1. On your distributor’s panel, click Personal info, click General info, then click Web self-care.
  2. On the Web self-care panel, define credentials for the distributor self-care interface (such as login, password, time zone, etc.) and other preferred settings:
    • Login – type a username that the distributor will use to log in to the distributor’s self-care interface.
    • Password – type a username that the distributor will use to log in to the distributor’s self-care interface.
    • Time zone – the time zone in which the distributor will see his xDRs, and which will also define his billing period. For example, if you choose America/New_York here and the billing period is Monthly, the billing period will start on the first day of the month at midnight (12 am) New York time.
    • Web interface language – the language to be used on the distributor’s self-care web interface.

      image003

Credit limit

Link copied to clipboard
  1. On your distributor’s panel, click Finances, click General info, then click Credit limit.
  2. On the Credit limit panel, define the Credit limit warning threshold parameter. The distributor can be notified by email when his balance is dangerously close to the credit limit and service will soon be blocked. The threshold can be specified:
    • As a percentage (e.g., 90%). The warning will be sent when the distributor’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.

Invoices and taxation

Link copied to clipboard

Define whether to send this distributor their statistics and invoices by email.

  1. Send statistics via email Summary only – distribute a call summary only, and do not attach a details file; this might be useful in the case of a large amount 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 distributor via email).
  2. Click Save.

Distributor actions

Link copied to clipboard

At this point, you have finished with the administrator part of the work. You just need to send the distributor his login credentials for the PortaBilling self-care interface, while the rest of the tasks described below will be performed by the distributor himself.

Log in to self-care interface

Link copied to clipboard

Open the customer self-care page in a browser (by default https://<your-porta-billing- server-name>:8444) and type in the username/password which was provided to you.

Create customers

Link copied to clipboard

Create a customer

Select a quick form

Fill in the customer information

  1. In the image026 Participants section of the distributor self-care interface, choose Customers.
  2. On the Customer Management page, click add Add and create customer.
  3. Fill in the necessary information and then click save Save.

Add accounts to an existing customer

Link copied to clipboard
  1. Open the Customers page (the page which contains a list of customers). It should look like the screenshot below:

    Add accounts

    Fill in the account quick form

  2. Next to the customer name, click the Account https://demo.portaone.com/images/icons/no_accounts.gif or accounts Accounts icon (in the Accounts column), which will take you to account management for that customer.
  3. Click the add Add icon and create the account.
  4. Fill in the Add Account form and then click save Save.

Record a payment from the end user

Link copied to clipboard

The distributor can accept payment in cash from an end user (the owner of a prepaid or postpaid account) and record it in the billing system. This increases the customer’s available funds, while the amount (minus commission) is added to the distributor’s balance (the amount he owes to the service provider).

  1. Open the Customers page and find the customer you want to record the payment from.

    Record a payment from the end user

  2. Click the customer name.

    Open the balance adjustment wizard

  3. On the Edit Customer page, click Balance Adjustment icon.
  4. Select Manual Payment and click Next.

    Select manual payment

  5. Fill in the required amount of money and add an internal comment. Click Done.

    Specify the ammount

  6. Click save_close Save & Close.

    As soon as payment has been entered, the transaction is also recorded for the distributor (since he collected cash from the customer, and now owes part of it to the service provider). The distributor can check these transactions in the xDR browser.

    Browse the xDR history

On this page

Release
What's new
Admin manuals
Handbooks
API
UI help
Back to main menu
Search