Release

Callshop services

Link copied to clipboard

A callshop is a public facility where end users come
to make low-cost international calls. A customer is guided to an available
phone booth (cabin) where he makes calls and pays for them at the cash
desk afterwards. The callshop is managed by a callshop reseller who sets
the tariffs by which the end users are charged. The callshop reseller
usually employs one or more callshop operators. Callshop operators control
the authorized use of the booths, collect payments and provide customers
with receipts.

The following step-by-step scenario explains how a
customer makes a call in a callshop and how he/she is then charged for
it:

  1. First,
    a customer is directed by a callshop operator to an available booth.
  2. The
    callshop operator unlocks this booth to allow the customer to enter.
  3. Once
    inside the booth, the customer dials the desired destination number(s).
  4. When
    the call session ends, the customer leaves the booth.
  5. The
    operator presents the customer with a receipt for the call(s) made.

This handbook demonstrates how to configure a callshop
reseller who provides callshop services to end users. In the example,
the callshop reseller buys traffic from another reseller – for example,
ABC Shuttle. The ABC Shuttle reseller, in turn, buys traffic directly
from the ITSP but does not provide callshop services.

This handbook is intended for:

  • resellers
    who provide VoIP services to callshop owners (a callshop owner is a callshop
    reseller in PortaSwitch)
  • callshop
    owners who provide callshop services to end users
  • callshop
    operators – personnel who operate callshops

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 an administrator

Link copied to clipboard

Operation

Done

Rating
configuration

Create
a wholesale tariff (referred to later as tariff A), which
contains the ITSP’s wholesale rates; make sure this tariff is
designated as Applied To: Reseller

Define
the tariff A rates for the destinations to which calls
will be allowed

Create
a reseller and apply tariff A to him on the Additional
Info
tab

Specify
credentials (login and password) for the reseller to access the
reseller self-care interface

Create
a tariff (referred to later as tariff B) which will be
applied to the reseller’s end users; make sure this tariff is
marked as Managed by: Reseller

Product
configuration

Create
a product for reseller use (referred to later as product A).
The reseller will be able to sell this product to their end users
as well as to resell it through other resellers; make sure this
product is marked as Managed by: Reseller

Create
one rating entry for this product using the PortaSIP node and
an empty access code. This entry will use tariff B to charge
end users and tariff A to charge the reseller

Operations to be performed by a reseller

Link copied to clipboard

Configuring
a callshop reseller

Log
in to the reseller self-care interface using the credentials provided

Create
a callshop reseller

Create
a resale tariff (later referred to as tariff C), which
will be used to charge the callshop reseller

Specify
credentials (login and password) for the callshop reseller to
access the callshop reseller self-care interface

Product
configuration

Provide
the callshop reseller with the product. For this, clone product
A, and ensure that the new product is marked as Managed
by: Callshop reseller

Operations to be performed by the callshop reseller

Link copied to clipboard

Rating
configuration

Log
in to the callshop reseller self-care interface using the credentials
provided

Generate
rates that end users will be charged for calls

Callshop
configuration

Create
a callshop

Assign
a product to the callshop

Add
callshop booths

Configuring
a callshop operator

Create
a callshop operator

Specify
credentials (login and password) for a callshop operator to access
their self-care interface

Administering
a callshop

Change
the product for a callshop (optional)

Operations to be performed by the callshop operator

Link copied to clipboard

Operating
a callshop

Log
in to the callshop operator self-care interface using the credentials
provided

A
customer comes to the callshop to make calls. Unlock a booth for
him. The callshop customer makes calls to desired destinations
from this booth

When
the call session ends, the customer is presented with the receipt
for the call(s) made. Payment is collected

Operations to be performed by an Administrator

Link copied to clipboard

Configuring a reseller

Link copied to clipboard

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

Since
routing plan selection is not supported for callshop resellers, make sure
to define only one rating entry containing the Voice Call service and
one tariff in the product for callshop resellers.

Operations to be performed by a reseller

Link copied to clipboard

Log in to the reseller self-care interface

Link copied to clipboard

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.

Sometimes administrators try clicking
the Logout button on the admin interface and then log in using
a reseller’s username and password. This will not work since you are still
in the admin realm, to which your reseller does not have access. You must
log in from the reseller self-care interface.

Create a callshop reseller

Link copied to clipboard

Bear in mind that callshop resellers can only provide
callshop services to end users (no other services may be offered).

Create a callshop reseller

  1. In
    the image007 Participants
    section of the reseller self-care interface, select Callshop Resellers.
  2. On
    the Callshop Reseller Management page, click the image008 Add
    button.
  3. Fill
    in the Add Callshop Reseller form:

    Main form (top)

    Link copied to clipboard
    • Customer
      ID
      – type a short name for the callshop reseller; this will be used
      on the web interface.
    • Customer
      Class
      – select a customer class for this callshop reseller. A customer
      class is a set of various parameters which can be applied to a group of
      callshop resellers. By choosing a specific class here, the callshop reseller
      automatically inherits all of the class properties (grace period, invoice
      template, etc.).
    • Currency
      – select the currency in which this callshop reseller will be charged.
    • Permanent
      Credit Limit
      – assign a credit limit for the callshop reseller.

    Usage charges tab

    Link copied to clipboard

    Create the resale tariff and generate the resale tariff
    rates that the ABC Shuttle reseller will use for charging a callshop reseller
    for outgoing traffic.

    Clone the resale tariff

    Add resale tariff rates

    Click Clone the selected Wholesale Tariff and
    then click Update. The Clone Tariff dialog box opens. Fill
    in the Clone Tariff information fields as described below:

    • Resale
      Tariff Name
      – type the resale tariff name here.
    • Add
      – type a profit markup (in percentage) you wish to apply to rates
      in the wholesale tariff.
    • but
      not less than
      – to reduce the risk of
      profit loss, type a fixed markup here. It will be added to the
      wholesale tariff’s rates if the calculated percentage markup is less than
      the specified fixed markup.
    • Resale
      Tariff Description
      – type the resale tariff description.

    When you are finished, click the Clone button.

    Clone products tab

    Link copied to clipboard

    The product is the main instrument that defines which
    services a reseller can offer to their end users. To provide a callshop
    reseller with a product, the ABC Shuttle reseller clones one of his products.
    The cloned product becomes ‘at the disposal’ of the callshop reseller.

    Clone the product for callshop reseller

    Specify the product name

    Click the Clone button. The Clone Subreseller
    Product
    dialog box opens. Fill in the Clone Subreseller Product
    information fields as described below:

    • Product
      Name
      – type in a name for the callshop reseller’s product.
    • Clone Discount Plan – select this checkbox if you want to
      include the original product’s discount plan with the new product. Otherwise,
      leave it unchecked.
    • Clone All Subscription
      select this checkbox if you want to
      include the original product’s subscription with the new product. Otherwise,
      leave it unchecked.
    • Clone Rates – this option is only
      available if the new product and the original product share the same currency.
      Select this checkbox if you want to clone the original product’s sales
      rates. Alternatively, you can create a new product without defined sales
      rates. To do this, leave this checkbox unchecked.
    • Convert
      Rates
      – this option is only available if the new product’s currency
      differs from the original product’s currency. Leave this option as is
      if you want to use the current exchange rate. Otherwise, adjust the current
      exchange rate as necessary.
      If it is impossible to automatically get the current exchange rate, the
      system fills this field with a 0.00 value. In this case, you need to manually
      enter the exchange rate.

    When you have finished, click the Clone button.

    Web self-care tab

    Link copied to clipboard

    Specify the credentials that the callshop reseller
    will use for accessing their self-care interface.

    Configure self-care access

    • Login
      – type the username that the callshop reseller will use for logging in
      to their self-care interface.
    • Password
      – type the password that they will use.
    • Time
      Zone
      – choose the time zone in which the callshop reseller will see
      their xDRs that will also define their billing period. For example, if
      you select America/Vancouver 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
      – choose the language to be used on the callshop
      reseller self-care interface.

    Information on all other tabs is optional. A more
    detailed description of these tabs can be found in the Create a reseller
    section of the Configuring a reseller for postpaid services or Configuring a reseller for prepaid services handbooks.

  4. Click
    save_close Save&Close.

Operations to be performed by a callshop reseller

Link copied to clipboard

Log in to the callshop reseller self-care interface

Link copied to clipboard

Open the callshop 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.

Generate rates for charging end users

Link copied to clipboard

In order to start selling
a product, the callshop reseller needs to define the rates for
their sales tariff (i.e., rates that end users will be charged). Rates
for the sales tariff can be defined in one of the following ways:

  • Uploaded
    from a .csv or .xls file. The rate upload procedure is described in detail
    in the Rate import handbook.
  • Generated
    during the Clone
    product
    procedure.
  • Generated
    by applying a markup (in percentage) to rates defined in the wholesale
    tariff.

The rate generation procedure by applying a percentage
markup is described below in this section.

Generete rates for charging end users

Go to rates generator

Add rates information

To generate rates for the sales tariff, perform the
following steps:

  1. In
    the image027 Rating
    section of the callshop reseller self-care interface, choose Tariffs.
  2. On
    the Tariff Management page, click on the sales tariff for which
    you want to generate rates. The Edit Tariff page opens.
  3. If
    necessary, modify the tariff parameters. Refer to the Create a tariff
    for reseller’s use
    section of the Configuring
    a reseller for prepaid services
    handbook for more details.
  4. On
    the Edit Tariff page, click the Generate Rates button. The
    Generate Rates dialog box opens.
  5. In
    the Generate Rates dialog box, enter the following parameters:
    • Add
      – type a percentage markup that will be applied to the wholesale tariff
      rates.
    •  but
      not less than
      – to reduce the risk of
      profit loss, type a fixed markup here. It will be added to the
      wholesale tariff’s rates if the calculated percentage markup is less than
      the specified fixed markup.
    • Interval
      First
      – specify the first billing unit (in seconds) for the new rates.
      If this field is left empty, the value for the first billing unit will
      be taken from the wholesale tariff rates.
    • Interval
      Next
      – specify the next billing unit (in seconds) for the new rates.
      If this field is left empty, the value for the next billing unit will
      be taken from the wholesale tariff rates.
  6. Click
    OK.

Create a callshop

Link copied to clipboard

A callshop represents a public facility where customers
can come to make low-cost international calls and pay for them afterwards.
Each callshop reseller can have multiple callshops.

Add a callshop reseller

  1. In
    the image030 Participants
    section of the callshop reseller self-care interface, choose Callshops.
  2. On
    the My Callshops page, click image008 Add.
  3. Fill
    in the Add Callshop form:

    Main form (top)

    Link copied to clipboard
    • Customer
      ID
      – short name for the callshop; this will be used on the web interface.
    • Customer
      Class
      – select a customer class for this callshop. A customer class
      is a set of various parameters that can be applied to a group of callshops.
      The callshop will automatically inherit all of the class properties, such
      as currency rounding up rate, statistics generation, etc.
    • Blocked
      – blocks all booths in this callshop (i.e., if this checkbox is checked,
      all booths in this callshop will become unusable). Leave this check-box
      unselected.
    • Product
      – select a product for this callshop.
    • Currency
      – this field is read-only and displays the currency in which end users
      will be charged. The currency value is taken from the product assigned
      to this callshop.

    Other information fields
    in the New Callshop form are optional and do not need to be specified
    during callshop creation.

  4. Click
    save_close Save&Close.

Generate callshop booths

Link copied to clipboard

Now you can create booths for your callshop.

Callshops

Generate callshops

Generate booths

  1. In
    the image037 Participants
    section of the callshop reseller self-care interface, choose Callshops.
  2. On
    the My Callshops page, click the Booth icon next to the
    callshop for which you want to generate booths. The Booths Management
    page opens.
  3. On
    the Booths Management page, click image008 Generate.
    The Generate Booths dialog box opens.
  4. In
    the Generate Booths dialog box, enter the number of booths to be
    used in this callshop.
  5. Click
    OK.

Create a callshop operator

Link copied to clipboard

Callshop operators are the personnel who operate callshops
and perform such duties as: control the authorized use of booths, collect
payments from customers and provide customers with receipts.

Create a callshop operator

  1. In
    the image041 CC
    Staff
    section of the callshop reseller self-care interface, choose
    Callshop Operators. The Operator Management page opens.
  2. On
    the Operator Management page, click image008 Add.
  3. Fill
    in the New Callshop Operator form:
  • Callshop
    – select a callshop that the callshop operator will operate.
  • Login
    – type the username that the callshop operator will use to log in to their
    self-care interface.
  • Password
    – type the password that the callshop operator will use to log in to their
    self-care interface.
  • Time
    Zone
    – specify the time zone in which the callshop operator will see
    the xDRs.
  • Web
    Interface Language
    – select the language to be used on the callshop
    operator self-care interface.

Now your callshop is configured and ready to operate.
The guidelines on how to operate a callshop are outlined in the sections
below.

Change the product for a callshop (optional)

Link copied to clipboard

To quickly respond to shifting market demands, callshop
resellers can easily adapt their sales rates by changing products in their
callshops. Once a new product is chosen, this new product is assigned
to all booths in this callshop.

Change the product for a callshop

  1. On
    the Edit Callshop page, open the Product dropdown list.
  2. Choose
    the desired product from the list and click save_close Save&Close.

Operations to be performed by a callshop operator

Link copied to clipboard

Log in to the callshop operator self-care interface

Link copied to clipboard

Open the callshop operator self-care page in a browser
(by default https://<your-porta-billing-server-name>:8446)
and log in with the credentials that were provided to you.

Lock/unlock a booth

Link copied to clipboard

A customer comes to the callshop to make calls. Unlock
a booth for him/her.

Lock / unlock a booth

  1. In
    the image046 Participants
    section of the callshop operator self-care interface, choose Booths.
    The Booths Management page opens.
  2. On
    the Booths Management page, choose a free booth and click the image047Click
    to Unlock
    icon to unlock the booth. The customer can then make calls
    to desired destinations.
  3. Once
    the customer leaves the booth, to prevent unauthorized use of the booth,
    click the image048Click
    to Lock
    icon to lock it.

Present the customer with a receipt

Link copied to clipboard

Present the customer with the receipt for the call(s)
made in the booth.

Present the customer with a receipt

Prepare the receipt

Print the receipt

  1. On
    the Booths Management page, click the image053 Checkout
    icon for the booth from which the calls were made. The Booth Call Summary
    dialog box opens.
  2. In
    the Booth Call Summary dialog box, check/fill in the following
    information fields:
    • Total
      Call Charges
      – this shows the total charges for the calls made from
      the booth.
    • Rounded
      Charges
      – this shows the total charges rounded up to the value specified
      for this callshop. For example, setting the rounding up value to 0.05
      will round up 1.26 to 1.30; setting it to 1.00 will round up 1.26 to 2.00.
    • Additional
      Charges
      – this presents additional charges a callshop operator may
      add to the customer’s bill (such as internet usage or a cup of coffee).
    • Amount
      Due
      – this shows the total amount the customer must pay.
    • Amount
      Paid
      – this shows the amount paid by the customer.
    • Change
      Due
      – this calculates the change the operator returns to the customer.
  3. Click
    the Pay button to submit the payment information and then click
    the Print button to print the receipt.
  4. Collect
    payments from the customer, return change and provide him/her with a receipt.

On this page

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