Billing

Billing

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: When enabled, applies the customer price (C:) from this table to all source IPs, even if not assigned to a specific customer. This is useful for reporting purposes when you want to ensure all calls show customer pricing, while operator prices (O:) are still determined by operator assignment rules based on destination IP.

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.

Number Matching Type

When creating prefix rules, choose how VoIPmonitor matches international prefixes:

• Original: Requires separate rules for each prefix format. For example, if users dial both 00420 and +420, you need two rules: one for 00420 and another for +420.

• Normalized: International prefixes are stripped before matching. A single rule for 420 will match calls to 00420, +420, and just 420. This is recommended for simpler configuration when international prefixes vary.

The matching behavior is controlled by the "International prefixes" setting in the global Settings section (default: 00 and +).

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.

Viewing Costs in Reports and CDR View

After configuring billing, you may want to verify that costs are being calculated and then include them in reports.

Verifying Costs in CDR View

To verify that billing is working correctly, check if costs appear in your CDR records:

1. Navigate to the CDR view in the GUI
2. Click the dropdown menu on the first column (column selection icon)
3. Select PRICE from the list of available columns
4. The PRICE column will now show Customer (C:) and Operator (O:) prices for each call

If prices show as zero or empty, check:

• The billing system is enabled (Settings > Billing Configuration > Settings > "Enable by addresses" or "Enable by numbers")
• The source or destination IP is assigned to a billing table
• The called number matches a prefix or rule in the billing table
• The "Default customer billing" checkbox is enabled if you want customer prices applied to all calls

Including Costs in Daily Reports

To generate reports with call costs:

1. Navigate to GUI > Reports > Configure Daily Reports
2. Select CDR summary as the report type
3. Enable the Price columns option
4. Configure the date range and any filters (e.g., specific trunks, IP addresses)
5. Save the report configuration

The report will include cost information based on your billing configuration. See Reports for more details on report types.

AI Summary for RAG

Summary: This article documents VoIPmonitor's billing features for tracking call costs. Features include: two price types (Customer and Operator), multiple billing tables per operator/customer, watchdog rules for quotas and expensive destinations. Configuration covers billing rules with peak/offpeak rates, state holidays, operator/customer assignment, exclusions, cost aggregation, and multi-currency support. Number matching can be "original" (exact prefix match) or "normalized" (strips international prefixes). Costs are viewable in CDR PRICE column and can be included in daily reports.

Keywords: billing, customer price, operator price, billing tables, peak, offpeak, currency, watchdog, quota, high rate, PRICE column, daily reports, CDR summary, default customer billing, prefix number, normalized, original, international prefixes, number matching, T1, T2, impulse, aggregation

Key Questions:

• What are the key billing features in VoIPmonitor?
• How to create and configure billing tables and rules?
• What is the state holidays table used for in billing?
• How to exclude calls from billing?
• How to handle multiple currencies in VoIPmonitor?
• What are international prefix settings?
• How do billing watchdog rules function?
• How to view costs in the CDR view?
• How to include costs in daily reports?
• What does Default customer billing do?
• What is the difference between normalized and original number matching for billing prefixes?
• How do I configure billing rates based on specific call number prefixes?
• What are T1 and T2 billing parameters?