CLI Groups - CLI Prefixes

From Kolmisoft Wiki
Jump to navigationJump to search

A CLI Group is a list of CLI prefixes (numeric caller-ID prefixes) attached to a wholesale tariff rate.

Together with the destination prefix, it allows the switch to apply different prices to the same called destination depending on who is calling. In the MOR GUI, the same data appears as CLI Group on rate lists and import analysis, and as CLI Prefixes when you edit a single rate.



Description

What is a CLI Group?
A CLI Group holds one or more CLI prefixes — the leading digits of the caller's number (Calling Line Identification, also called Caller ID or A-number). Each wholesale rate row combines:

  • a destination prefix (the called number / B-number / CLD), and
  • an optional CLI Group (the allowed caller-ID prefixes for that rate).

If no CLI Group is configured on a rate, matching uses only the destination prefix (standard destination-based rating).

CLI Group and CLI prefixes
In documentation and supplier rate files, "CLI Group" usually refers to the named bucket; "CLI prefixes" are the individual numeric values within it (for example, 30767 and 3706). MOR stores them as a comma-separated list of prefixes on the rate.



Why operators use CLI Groups (EU / origin-based rating)

Many European carriers use origin-based rating (OBR): the price depends on where the call originated (CLI / A-number) and where it terminates (destination). This is common on termination to EU destinations:

  • Lower rate when the caller's number is in the European Economic Area (EEA) — "in-zone" CLI.
  • Higher rate when the caller is outside the EEA, when the CLI is missing, invalid, or treated as non-EEA — "out-of-zone" or surcharge pricing.

Operators often publish the same destination prefix twice (or more) in a tariff with different CLI Groups — one group listing EEA CLI prefixes, another for non-EEA — instead of maintaining separate destination trees.

Glossary (short):

  • CLI — Calling Line Identification / Caller ID / A-number (the calling party's number).
  • CLD — called number / destination dialed.
  • OBR — Origin-Based Rating (origin + destination determine the rate).
  • EEA — European Economic Area (not identical to the EU; include only prefixes your supplier defines as in-zone).

Industry references (external):

On live calls, the rating engine uses the CLI presented on the SIP leg (often the From header; if the caller hides CLI, many platforms use P-Asserted-Identity when present). Your tariff design should match what your network actually receives from upstream carriers.



How call rating uses CLI Groups

When a CLI Group is set on a rate:

  1. The called number must match the rate's destination prefix (longest match as usual).
  2. The caller's number must start with at least one CLI prefix listed in that rate's CLI Group.

If both match, that rate row applies. If the destination matches but the CLI does not match any prefix in the group, that rate row does not apply — another rate for the same destination (different CLI Group or no CLI Group) may apply instead.

Multiple rates for one destination
You can have several active rates with the same destination prefix and different CLI Groups (for example, EEA vs non-EEA). The switch distinguishes them by the combination of prefix + CLI Group.

Empty CLI Group
If the rate has no CLI prefixes (no CLI Group on the rate), billing falls back to destination-only matching for that row — the same idea as documented for M4 in the CLI Groups section.

Longest prefix
For CLI matching, the system uses the longest suitable CLI prefix match among the group's prefixes (same principle as destination prefix matching).



Configure CLI Groups in MOR

Manual editing (single rate)

  1. Go to SETTINGS → Billing → Tariffs.
  2. Open Rates for the wholesale tariff you want to change (see Entering Rates for Wholesale Tariff).
  3. Open Details for the rate row.
  4. In the CLI Prefixes section, add or remove numeric prefixes, or use Delete All to clear the group.

Changes apply to that rate. Adding or removing prefixes may reassign the rate to an existing CLI Group with the same prefix set, or create a new group, so identical prefix lists on different rates can share one group.



Rates list and import review

On the wholesale Rates list, the CLI Group column shows a short view of the prefixes (hover for the full list). During the Automatic Tariff Import job analysis, the same column helps you review what will be imported before you accept the job.



Automatic Tariff Import (add-on)

Bulk CLI Groups from supplier spreadsheets are normally loaded through the Automatic Tariff Import add-on (when enabled on your system). Functionality matches M4; supplier templates often use M4 screenshots, but the MOR menus and labels are the same idea.

Where to configure templates: SETTINGS → Billing → Tariffs → Import → Import Rules → Templates (accountant permission path: Manage Tariffs > Tariff Import > Templates).

On each Tariff Template, the CLI Group block (administrators) supports two modes:

  1. CLI Group column — one column on the main rate sheet contains the CLI Group data (often comma-separated prefixes per row).
  2. CLI Group with mapping — five settings are all required:
    • CLI Group column on the main sheet (group name or key to look up),
    • CLI Group mapping sheet (workbook sheet number),
    • header rows to skip on the mapping sheet,
    • mapping name column (group name in the mapping sheet),
    • mapping prefix column (prefix values that belong to each group).

See Automatic Tariff Import for the full template workflow and examples (ATI provider templates).



Import from CSV (manual wizard)

The standard Rate import from CSV wizard maps only Prefix, Rate, and related columns; it does not expose a CLI Group column assignment. For large tariffs with OBR/EEA splits, use Automatic Tariff Import or configure CLI Prefixes manually on each rate after a basic CSV import.



CLI prefix rules

CLI prefixes on a rate must follow these rules (including rows imported through Automatic Tariff Import):

  • Numeric only — each prefix contains digits only (no spaces or letters).
  • Maximum length — each prefix can be at most 30 digits.
  • Total size — the combined prefix list for one group cannot exceed the system limit (import may reject rows that exceed it).
  • No duplicates — the same prefix cannot appear twice in one group.

Typical import or analysis messages include: CLI Group has non numeric Prefix, CLI Group Prefixes total length exceeded, CLI Group has duplicate Prefixes, and CLI Group has Prefix exceeding max length.



Operational notes

Missing or invalid CLI
If OBR applies to your traffic, calls with no CLI, an anonymous CLI, or a CLI that does not match your in-zone group may be rated on a higher "out-of-zone" row or a default row — depending on how you built the tariff. Design explicit rows for "unknown / non-EEA" rather than assuming a single destination rate covers all origins.

CLI manipulation
Upstream or fraudulent CLI manipulation (presenting an in-zone A-number to avoid surcharges) is a known OBR risk. Use supplier agreements, CLI validation, and monitoring; see the external OBR articles linked above.

Not the same as device CLIs
CLIs (Incoming CallerIDs) under SETTINGS → Users → Devices → CLIs are caller-ID numbers assigned to devices for origination — a different feature. CLI Groups on tariffs are only for rating wholesale calls by CLI + destination.

Tariff selection by CLI
Separate settings (for example, matching a user's tariff from the caller's CLI on inbound traffic) are not the same as CLI Groups on individual rate rows. Configure OBR-style wholesale rates directly on the tariff using CLI Groups, as described here.



See also

Retrieved from "https://wiki.kolmisoft.com/index.php?title=CLI_Groups_-_CLI_Prefixes&oldid=31608"