Billing: Difference between revisions

From VoIPmonitor.org
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 1: Line 1:
= Billing feature overview =  
== Billing Feature Overview ==


* two price types in CDR - customer and operator price (to see differences between various operators)  
* Two price types in CDR: Customer and operator (for comparing operators).
* multiple billing tables - for each of your operator and for each customer  
* Multiple billing tables: For each operator and customer.
* billing watchdog rule quota - per hour / day / week / month aggregated per src IP or per tel. number  
* Billing watchdog rules: Quotas per hour/day/week/month aggregated by src IP or tel. number.
* billing watchdog rule expensive destination
* Billing watchdog rules: For expensive destinations.


= Settings -> Billing configuration =
== Settings > Billing Configuration ==


In this section you can see sections "billing type / rules, state holidays, operator assignment, customer assignment, exclude, aggregation, currency and settings.  
Sections: Billing type/rules, state holidays, operator assignment, customer assignment, exclude, aggregation, currency, settings.


== billing type / rules ==
=== Billing Type / Rules ===


Here you need to create at least one billing table which will be used to bill customer and operator price. If you do not need to have customer price but only operator price, just create one billing table for each operator (if you have different pricing for each operator) and do not check "Default customer billing" checkbox. You will then assign the billing table in section "operator assignment"
Create at least one billing table for customer/operator prices. For operator-only, create per operator and assign in "operator assignment" without "Default customer billing".


* Name: name of the billing table
* Name: Billing table name.
* State holidays: choose holidays table which will be used if peak is enabled
* State holidays: Assign holidays table for peak/offpeak.
* Default price: is price per minute (offpeak if peak/offpeak enabled)  
* Default price: Per-minute (offpeak if peak/offpeak enabled).
* Enable peak / offpeak: enable billing based on peak / offpeak
* Enable peak/offpeak: For time-based billing.
* Default price peak: is price per minute for peak period (and offpeak if peak/offpeak enabled)
* Default price peak: Peak per-minute.
* Default T1: number of seconds for the first impulse.
* Default T1: First impulse seconds.
* Default T2: lenght of period. For example call was 30 seconds length and T1 is 10 and T2 is 6 the number of seconds to bill will be 10 + 4*6 = 34 seconds.  
* Default T2: Period length (e.g., 30s call, T1=10, T2=6: Bill 10 + 4*6 = 34s).
* Default customer billing: if checked all customer prices who are not assigned in "customer assignment" will be billed based on this billing table
* Default customer billing: Applies to unassigned customers.


After creating billing table you need to add billing rules: (you can export / import them via CSV)  
Add billing rules (CSV export/import):


* name: of the billing rule
* Name: Rule name.
* prefix number: rule will match based on the same prefix
* Prefix number: Match prefix.
* fixed number: rule will match based on the same exact number
* Fixed number: Match exact.
* price: price for the destination (offpeak if peak/offpeak enabled)
* Price: Destination (offpeak if enabled).
* price peak: price for the destination in peak period (if peak/offpeak enabled)
* Price peak: Peak destination.
* override default peak offpeak: change the default peak/offpeak
* Override default peak/offpeak: Custom times.
* t1: set custom T1 timer
* T1: Custom first impulse.
* t2: set custom T2 timer
* T2: Custom period.


== state holidays ==
=== State Holidays ===


Table of state holidays which you can assign in billing table. Those days will be treated as offpeak. You need to define this only in case your billing are based on peak/offpeak.  
Holidays table for offpeak treatment. Define only for peak/offpeak billing.


== operator assignment ==
=== Operator Assignment ===


To be able to bill CDR based on to what operator call is going through you need to create rule for each of operator and select billing table. If you create and assign the table customer price will be not calculated if call is coming from operator. This way the system knows that it should bill only outgoing calls. If you would like to have customer and operator price in CDR you need to create at least two billing tables and the customer one set as "default customer billing" and assign the operator billing table in this section to the operator IPs.  
Rules per operator with billing table. Excludes customer price for operator calls (bills outgoing only). For both prices: One default customer table, assign operator tables here.


You can override default international prefix settings for each operator (for details see [[#settings]]
Override international prefixes per operator (see [[#settings]]).


== customer assignment ==
=== Customer Assignment ===


If you need to bill some customers differently so the default customer billing table is not enough you can create rules to apply different billing tables to customers based on their source IP or source Tel. numbers. (prefixes or fixed numbers)
Apply different tables to customers by src IP or tel. numbers/prefixes if default insufficient.


You can override default international prefix settings for each operator (for details see [[#settings]]
Override international prefixes per customer (see [[#settings]]).


== exclude ==
=== Exclude ===


If you do not want to bill CDR for some IP or numbers you can set rules for them here. Rules allows to choose for what source or destination IP should be excluded as well as for source or destination tel. prefixes / numbers.  
Rules to exclude billing by src/dst IP or tel. prefixes/numbers.


== aggregation ==
=== Aggregation ===


Aggregation feature summarize called sum based on ip source or tel. number source for hours days weeks months. This aggregation is used in fraud/alerts in billing over quota rules.  
Summarizes costs by src IP/tel. number for hour/day/week/month/year. Used in fraud/alerts for quota rules.


=== settings ===
==== Settings ====


* enable by addresses: aggregates per source IP address
* Enable by addresses: Per src IP.
* enable by numbers: aggregates per tel. number
* Enable by numbers: Per tel. number.
* week start
* Week start.
* hours / days / weeks / months / years: set how long should be various date ranges kept in the database.  
* Hours/days/weeks/months/years: Retention periods.


=== exclude addresses ===
==== Exclude Addresses ====
* which IP addresses (src or dst) should be excluded from aggregation. This is usefull to not aggregate operator source IP or your SIP proxy source IP so the aggregation data will have only customers data.


=== exclude numbers ===
Exclude src/dst IPs (e.g., operators/SIP proxies) for customer-only data.
* which numbers (src or dst) should be excluded from aggregation. It is always good to set addresses first like your operator sip source ip addresses so your database will be not filled with data you do not want to use.  


== currency ==
==== Exclude Numbers ====


You do not need to create currency if you have only one. If you will have more currencies the GUI will recalculate it to the base currency which is set as "Main currency". It uses google services to get current exchange rate. The recalculation is not stored into the database. In database is always the original price thus recalculation is used only when viewing data.  
Exclude src/dst numbers. Prioritize addresses to avoid unnecessary data.


* Code: USD for example
=== Currency ===
* Custom code: symbol "$" for example 
* Name: name of the currency
* Country: Select the country
* Main currency: if selected all currencies in CDR view and charts etc. are recalculated to this currency
* Description


== settings ==
Optional for single currency. Multiple: Recalculates to main via Google rates (view-only, not stored).


* international prefixes: list of all prefixes used to distinguish between local and international numbers. Default is 00, +
* Code: e.g., USD.
* min. international length: if number does not match to international prefixes (for example lets say you are calling to Czech with normalized prefix 420123123123) and numbers of digits are greater then this value the number is treated as international. If you do not set this value it is not used at all.  
* Custom code: Symbol, e.g., "$".
* local number are in: if number is detected as local number (does not contains international prefix and is less then min. international length) it will be prefixed with international prefix according to what you choose. This is in case the a destination number is without + or 00 and without local international prefix
* Name: Currency name.
* Country: Select.
* Main currency: Recalculate all to this.
* Description.


=== Settings ===


= Watchdog =
* International prefixes: Distinguish local/international (default: 00, +).
* Min. international length: Treat longer numbers as international if no prefix.
* Local numbers are in: Prefix local numbers with international code for selected country.


In alerts / anti fraud there is two billing watchdog rules. You have to enable aggregation in billing settings.
== Watchdog ==


In Alerts/Anti Fraud: Two rules requiring aggregation enabled.


== Billing over quota ==  
=== Billing Over Quota ===


Billing over quota is checking total billed sum per source IP or souce Tel. number or grouped source IPs / numbers for hour / day / week and month aggregation periods. The purpose of this rule is possibility to be alerted globally or individually if there is any account which has billed sum higher then set threshold during the last hour day etc.
Checks billed sums per src IP/tel. number or groups for periods. Alerts on thresholds.
* Enabled: enable/disable rle* Every N minutes: how often to check the rule* Enable hyperlinks: create hyperlink in email alert to quickly go to the rule * hour / day / week / month: set maximum amount of calling costs to trigger the alert. * summary: if enabled all included caller numbers / ip addresses are summarized and then evaluated instead of taking each IP/tel.num separatly. This is for case where you want to group all customers numbers or ip addresses. * Include / Exclude IP addresses / numbers: allow to filter only calls you want to get the alert. If you do not specify any include/exclude rules the rule will trigger for every IP / tel. number individually.  
== Billing high rate ==


* Enabled: On/off.
* Every N minutes: Check frequency.
* Enable hyperlinks: Links in emails.
* Hour/day/week/month: Max costs.
* Summary: Aggregate included callers/IPs.
* Include/Exclude IP/numbers: Filter calls. None: Per individual IP/number.


The second watchdog rule is to trigger alert if calling to destination with higher cost per minute then set threshold. For example you want to know if someone is calling to destination 0.5USD / minute.
=== Billing High Rate ===
* Enabled: enable/disable rle* Every N minutes: how often to check the rule* Enable hyperlinks: create hyperlink in email alert to quickly go to the rule * Limit: set the cost / minute which will trigger this alert* Include / Exclude IP addresses / numbers: allow to filter only calls you want to get the alert. If you do not specify any include/exclude rules the rule will trigger for every IP / tel. number individually.


Alerts on destinations > cost/minute threshold.


* Enabled: On/off.
* Every N minutes: Check frequency.
* Enable hyperlinks: Links in emails.
* Limit: Cost/minute threshold.
* Include/Exclude IP/numbers: Filter calls. None: Per individual IP/number.


=== AI Summary for RAG ===


'''Summary:''' This article overviews VoIPmonitor's billing features: Price types, tables, watchdog rules for quotas/expensive destinations; configuration sections for types/rules, holidays, assignments, excludes, aggregation, currency, settings; and watchdog details.


'''Keywords:''' billing, customer price, operator price, billing tables, peak/offpeak, currency, watchdog, quota, high rate


 
'''Key Questions:'''
 
* What are the key billing features in VoIPmonitor?
 
* How to create and configure billing tables/rules?
 
* What is state holidays for in billing?
 
* How to exclude calls from billing?
 
* How to handle multiple currencies?
 
* What are international prefix settings?
 
* How do billing watchdog rules function?
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
.

Latest revision as of 14:38, 10 November 2025

Billing Feature Overview

  • Two price types in CDR: Customer and operator (for comparing operators).
  • Multiple billing tables: For each operator and customer.
  • Billing watchdog rules: Quotas per hour/day/week/month aggregated by src IP or tel. number.
  • Billing watchdog rules: For expensive destinations.

Settings > Billing Configuration

Sections: Billing type/rules, state holidays, operator assignment, customer assignment, exclude, aggregation, currency, settings.

Billing Type / Rules

Create at least one billing table for customer/operator prices. For operator-only, create per operator and assign in "operator assignment" without "Default customer billing".

  • Name: Billing table name.
  • State holidays: Assign holidays table for peak/offpeak.
  • Default price: Per-minute (offpeak if peak/offpeak enabled).
  • Enable peak/offpeak: For time-based billing.
  • Default price peak: Peak per-minute.
  • Default T1: First impulse seconds.
  • Default T2: Period length (e.g., 30s call, T1=10, T2=6: Bill 10 + 4*6 = 34s).
  • Default customer billing: Applies to unassigned customers.

Add billing rules (CSV export/import):

  • Name: Rule name.
  • Prefix number: Match prefix.
  • Fixed number: Match exact.
  • Price: Destination (offpeak if enabled).
  • Price peak: Peak destination.
  • Override default peak/offpeak: Custom times.
  • T1: Custom first impulse.
  • T2: Custom period.

State Holidays

Holidays table for offpeak treatment. Define only for peak/offpeak billing.

Operator Assignment

Rules per operator with billing table. Excludes customer price for operator calls (bills outgoing only). For both prices: One default customer table, assign operator tables here.

Override international prefixes per operator (see #settings).

Customer Assignment

Apply different tables to customers by src IP or tel. numbers/prefixes if default insufficient.

Override international prefixes per customer (see #settings).

Exclude

Rules to exclude billing by src/dst IP or tel. prefixes/numbers.

Aggregation

Summarizes costs by src IP/tel. number for hour/day/week/month/year. Used in fraud/alerts for quota rules.

Settings

  • Enable by addresses: Per src IP.
  • Enable by numbers: Per tel. number.
  • Week start.
  • Hours/days/weeks/months/years: Retention periods.

Exclude Addresses

Exclude src/dst IPs (e.g., operators/SIP proxies) for customer-only data.

Exclude Numbers

Exclude src/dst numbers. Prioritize addresses to avoid unnecessary data.

Currency

Optional for single currency. Multiple: Recalculates to main via Google rates (view-only, not stored).

  • Code: e.g., USD.
  • Custom code: Symbol, e.g., "$".
  • Name: Currency name.
  • Country: Select.
  • Main currency: Recalculate all to this.
  • Description.

Settings

  • International prefixes: Distinguish local/international (default: 00, +).
  • Min. international length: Treat longer numbers as international if no prefix.
  • Local numbers are in: Prefix local numbers with international code for selected country.

Watchdog

In Alerts/Anti Fraud: Two rules requiring aggregation enabled.

Billing Over Quota

Checks billed sums per src IP/tel. number or groups for periods. Alerts on thresholds.

  • Enabled: On/off.
  • Every N minutes: Check frequency.
  • Enable hyperlinks: Links in emails.
  • Hour/day/week/month: Max costs.
  • Summary: Aggregate included callers/IPs.
  • Include/Exclude IP/numbers: Filter calls. None: Per individual IP/number.

Billing High Rate

Alerts on destinations > cost/minute threshold.

  • Enabled: On/off.
  • Every N minutes: Check frequency.
  • Enable hyperlinks: Links in emails.
  • Limit: Cost/minute threshold.
  • Include/Exclude IP/numbers: Filter calls. None: Per individual IP/number.

AI Summary for RAG

Summary: This article overviews VoIPmonitor's billing features: Price types, tables, watchdog rules for quotas/expensive destinations; configuration sections for types/rules, holidays, assignments, excludes, aggregation, currency, settings; and watchdog details.

Keywords: billing, customer price, operator price, billing tables, peak/offpeak, currency, watchdog, quota, high rate

Key Questions:

  • What are the key billing features in VoIPmonitor?
  • How to create and configure billing tables/rules?
  • What is state holidays for in billing?
  • How to exclude calls from billing?
  • How to handle multiple currencies?
  • What are international prefix settings?
  • How do billing watchdog rules function?
Retrieved from "https://www.voipmonitor.org//doc/index.php?title=Billing&oldid=5740"