Docs for all releases
Page History
...
Reseller in JeraSoft Billing, in the majority of cases, is a company who has a certain amount of clients and governs their activities in the system. As any company, it can have a range of managers, each responsible for a certain group of company clients. The Manager has a limited functionality: doesn't have his own balance, therefore, cannot perform any transactions; neither origination , nor termination rate table cannot be assigned to him, etc. The Resellers section is designed to provide a user with a possibility to track and manage their company information and activity, build a hierarchy of company affiliates, or assign its managers. The section is presented in a the form of a table with the following columns:
Screenshot: Resellers section
Column name | Description |
---|---|
ID | Reseller's/Manager's identification number |
Name | Name of a reseller/manager |
Available Balance | Reseller's available balance (live balance + credit) |
Clients |
The total amount of a respective reseller's/manager's clients |
Cards |
The total amount of a respective reseller's/manager's calling cards | |
Call Shops | Total number of a respective reseller's/manager's call shops |
The following functional buttons and icons are present in the section:
Button/Icon | Description |
---|---|
Allows creating a new reseller | |
Allows creating a new manager | |
Allows assigning an origination rate table to a respective reseller | |
Allows assigning a termination rate table to a respective reseller | |
Allows viewing a list of a following reseller's/manager's users | |
Allows viewing a history of changes for a respective reseller/manager in the Audit log section | |
Allows viewing reseller's balance operations in the Transactions section | |
Allows viewing a list of reseller's/manager's clients in the Clients section | |
Allows viewing a list of reseller's/manager's calling cards in the Calling Cards section | |
Allows viewing a list of reseller's/manager's call shops for a current reseller/manager in the Call Shops section |
...
In the top right corner of the section above the table, an Advanced Search drop-down menu is located. By clicking on a blue downwards arrow downward arrow icon, a drop-down menu with the following structure is displayed:
Screenshot: Advanced Search drop-down menu
Field | Description | ||
---|---|---|---|
Mode | Select a mode for the resellers' display:
|
To apply the specified search criteria, click the Search button; to cancel the applied parameters, click Reset.
...
Information block | Fields Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
System Information | General information about a company | ||||||||||||
| Specify the name of one of your companies (or affiliates). This field is mandatory. | ||||||||||||
| Indicate a parent for a reseller or make it a root one. By default, the field value is set to root | ||||||||||||
| Select a preferred currency for rates and invoices from the drop-down list of all available ones (see the Currencies section) | ||||||||||||
| Define a the status of a reseller:
| ||||||||||||
| Select a template that will be used for all clients belonging to this reseller or manager by default (see the Clients Template section) | ||||||||||||
| Indicate a tax profile that will be used for this reseller and reflected in invoices (refers to the Taxes Profiles section).
| ||||||||||||
| Select gateway(s) for this reseller | ||||||||||||
Terminator Settings | Reseller's billing settings for outgoing calls | ||||||||||||
| Rates for outgoing events from customers under a current reseller. Enables resellers billing mode
| ||||||||||||
| Termination capacity for all clients, belonging to this reseller. Leave this field empty for unlimited capacity | ||||||||||||
Fraud Protection checkbox | Enables/disables administrator notification in case of multiple simultaneous calls to the same number from the current Reseller.
Here you need to specify the following: | ||||||||||||
| Set minimum time in seconds between sent notifications (minimum interval must be ≥ 0 sec) | ||||||||||||
| Define the amount of the last number digits, which will be ignored when determining a destination number. For instance, with one digit for ignoring, the numbers 123456 and 123457 will be considered the same number. | ||||||||||||
Origination Settings | Current Reseller's billing settings for incoming calls | ||||||||||||
| Here you can set a specific payment mode for a client. Postpaid mode means that a client will have unlimited credit. Otherwise, the client's Balance + Credit value will be checked on RADIUS or SIP authorization. When this field is checked, the Credit field becomes unavailable. | ||||||||||||
| Additional The additional field next to the Postpaid checkbox. User can indicate an amount of reseller's credit | ||||||||||||
| Specify rates for incoming events from customers under a current reseller. Enables resellers billing mode | ||||||||||||
| Indicate origination capacity for all clients, belonging to this reseller. Leave this field empty for unlimited capacity | ||||||||||||
Invoicing Information | Current Reseller's invoicing settings | ||||||||||||
| Allows you to select how the system sets an invoicing date:
| ||||||||||||
| Select an invoice template that will be assigned to a reseller | ||||||||||||
| Allows to define a default format of invoice's name | ||||||||||||
| Define the last used invoice number | ||||||||||||
SureTax Settings | SureTax profile settings. SureTax is a third-party tax calculation engine. This tax calculation is based on the location of the customer’s taxing jurisdiction. This profile is used for further calculation in invoices. To | ||||||||||||
| Specify a unique number that identifies an individual in the SureTax service | ||||||||||||
| Define a unique validation key of the SureTax service | ||||||||||||
Contact Information | Some additional information | ||||||||||||
Company's email (it is required to specify an email to receive notifications). Use only Latin characters. This field is mandatory | |||||||||||||
| Company's postal address | ||||||||||||
| An ID of tax-paying entity | ||||||||||||
| Company's registration ID | ||||||||||||
| Company's bank account info | ||||||||||||
Company Logo | Here you can add a file with a company's logo. To delete the company logo, open the edit form of a respective Reseller with a logo, then click the delete icon to remove the old logo. | ||||||||||||
Mail Templates | A detailed description of all Mail Templates and their configuration is presented at the end of the article |
...
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
|
...
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Email Rates Import Settings information block has been removed from the Resellers settings in VCS 3.16.0 due to the introduction of the Data Source section. |
...
Information block | Fields Description | ||
---|---|---|---|
System Information | General information about a Manager | ||
| Here you can specify the name of a manager. This field is mandatory. | ||
| Select a parent for a manager | ||
| Select a the current status of a manager:
| ||
Contact Information | Some additional information | ||
Manager's email. Use only Latin characters. | |||
| Manager's postal address |
...
- Custom Fields are used as custom variables that will be represented as readable text in invoice templates. A Custom Field allows to add adding information about a client.
- Custom Package Fields are also used as custom variables that allow adding information about a package.
...
- Click the Add Custom Field button.
Specify the Field Key and Title fields for a custom item. For example: , voip_phone_sell as Key and VoIP Phone as common Title, which will be visible for all clients. Please note that the Field Key must contain word characters only.
Add respective notes to the VoIP Phone field in the Client's settings/Package settings > Custom Fields tab.
Create an invoice template and assign it to a target reseller. Then, the Clients Custom Fields and Package Custom Fields tables will appear in the Invoice Template settings. You simply need to add those tables to the invoice template.
Finally, you can generate an invoice.
...
Rates Notification settings in the Resellers profile allow to create a default rate notification for the clients that belong to a target reseller.
...
borderColor | #ffffb3 |
---|---|
bgColor | #ffffb3 |
borderWidth | 2px |
Attention
...
If any rate table (child) in the system has the assigned parent rate table, clients will be notified through the Rate Notification service about the changes in both tables.
...
creating a default rate notification for the clients that belong to a target reseller.
Screenshot: Rates Notifications
...
To configure these settings, open the Rate Notifications tab in the reseller profile. The structure of a tab is as follows:
Field | Description | |
---|---|---|
Date Format | Specify the date format in your export file. Example of the field syntax: if you enter “%d-%m-%Y” here, your date will look like 25-02-2018. | |
Code Deck | Select a code deck here to rewrite code names in an export file if needed | |
Codes Output | Select a way codes must be displayed | |
| Each code is placed into a single row | |
| Codes are grouped by a code name in a row. For example, 5510, 5511, 5512. | |
| Codes are grouped by a code name into ranges plus delimiter. For example, 5510-5512, 5515. | |
Data Format | Specify an output file format, .xls or .csv | |
Fields Delimiter | Set a delimiter for the fields if you've chosen .csv. For .xls format, this field is unavailable | |
With headers row checkbox | Includea row with column names in a file | |
Codes from code deck checkbox | Include only codes, which are present in a specified Code Deck | |
Header Text/Footer Text | Allows to specify additional text into an exported file as a header and footer, respectively |
Description of all columns that could be selected for a rate notification is provided below:
Info |
---|
Note that the first selected column will be the one used for sorting the rates list. |
Column Name | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Code / Code Name | Code or Code Name of a respective rate | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Effective Date | Date, on which a rate to be applied | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Rate | Price | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Min Volume | Minimum The minimum volume of chargeable events | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Interval | Chargeable interval | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Grace Volume | Free of charge interval | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Setup Fee | Interval of a setup fee | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Profile | Time profile (all time, business time, non-business time, weekends) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
End Date | Date, on which the rate ends | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Previous Rate | Rate used before the present time | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Prev Diff | Shows how current rate differs from a previous one after import | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Prev Diff Status | Shows how the current rate's status changed in comparison to a previous one (unchanged, increased, decreased) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Prev Diff (export) | Shows how the current rate differs from a previous one after export | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Prev Diff Status (export) | Rate's changes after the last export. Shows the status of how the current rate differs from a previous one. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Notes | Additional information | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tag | Tags that are assigned to a respective rate | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Policy | Indicated policy of the rate | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Status | Define a current rate status |
...
Templates Configuration Syntax | Description |
---|---|
${client['status']} | Client's status:
|
${client['name']} | Client's name |
${client['balance']} | Client's live balance |
${client['balance_accountant']} | Client's fixed balance |
${client['credit']} | Client's available credit |
${client['c_company']} | Client's official company name |
${client['c_address']} | Post address of a client's company |
${client['c_email']} | Client's email |
${client['locale']} | Client's location |
${client['currencies_id']} | Currency ID, used by a client |
${client['tz']} | Timezone of a client |
${client['taxes_profiles_id']} | Taxes profile's ID, used by a client |
${client['tax_id']} | Customers tax ID of a client's company |
${client['reg_id']} | Registration ID of a client's company |
...
General Configuration Syntax Concerning Company's/Reseller's Data
Templates Configuration Syntax | Description |
---|---|
${company['status']} | Company's status:
|
${company['balance']} | Company's current balance |
${company['balance_accountant']} | Company's fixed balance |
${company['credit']} | Company's available credit |
${company['c_address']} | Company's postal address |
${company['c_email']} | Email of a company |
${company['locale']} | Company's location |
${company['currencies_id']} | Company's currency ID |
${company['tz']} | Company's timezone |
${company['taxes_profiles_id']} | Company's taxes profiles |
${company['name']} | Name of a company |
${company['tax_id']} | Company's customers tax ID |
${company['reg_id']} | Company's registration ID |
...
Configuration Syntax for Mail Template: Invoice and Payment Reminder Notification
...