Rate plans

Define prefix rates, assign plans to trunks, VMGateClients, or resellers, and keep billing aligned with routing.

Rate plans overview

Open Configuration → Rates. A rate plan is a named price list: destination prefixes with per-minute rates and billing parameters. Plans are created with a fixed Scope that cannot be changed later:

• Customer (retail, via trunks) — what you charge for SIP ingress on Customer trunks.
• Reseller — payout rates for a middleman (chapter 07).
• VMGateClient — operator payout rates for a client on a network.

Attach a Customer-scoped plan to each trunk that should bill retail traffic. Dialpeers route calls; the trunk’s rate plan still drives Customer billing (chapter 09).

Create and manage plans

Click Add Plan. Enter name, currency (default USD), and scope, then Add Plan. After creation, use the ⋮ menu → Associate… to link the plan to trunks, resellers, or VMGateClients depending on scope.

The plan list shows name, scope, currency, destination count, assignment count, and status. View destinations → opens the prefix table for that plan.

Edit plan and Delete plan are disabled once the plan has call history. Associate… remains available to add or remove links where allowed.

Destinations and rates

From View destinations →, click + Add Destination. For each row enter:

• Code — numeric destination prefix (empty allowed; description fills from the dialplan on blur).
• Valid since (UTC) — when the rate becomes effective (all rate times are UTC).
• Rate per minute, optional Connection fee, Connection sec, and Billing block sec.

The destinations table shows prefix, description, rate/min, valid-from, valid-to, and status. More specific prefixes override broader ones within the same plan at billing time. New calls use rates effective for their start time; historical CDRs keep the rate applied on the call.

Use ← Back to Plans to return to the plan list.

Customer plans and trunks

Customer-scoped plans attach to SIP trunks in either place:

• When creating or editing a trunk under Trunks — Rate plan dropdown (Customer scope only).
• On the rate plan — ⋮ menu → Associate… → pick a trunk (shown with its Customer name).

Remove an association from the Associate dialog when the trunk has no calls on that plan; locked rows show a lock icon if call history exists.

Reseller and VMGateClient plans

Reseller scope: after creating the plan, ⋮ → Associate… and add resellers. One active rate deck per reseller is the intended model — use destinations to define prefix payouts.

VMGateClient scope: associate from the plan (⋮ → Associate…, choose a client that has a network) or from the client side — open VMGateClients, ⋮ menu → Associated rates to view or de-associate payout plans for that device.

Align Customer trunk rates with VMGateClient and reseller payout plans so margin and CDR reports reconcile.