Destination catalogue

The destination catalogue is the switch's numbering reference: which countries exist, how each one is subdivided, and which prefixes belong to each subdivision. It is what dial peers point at, and what organises the prefixes your tariffs carry. You will find it under Routing › Destinations.

It has three levels, from general to specific: Country → Destination → Prefix.

The three levels

Country

A real country with its calling code. NEXIA ships the full world list: over 230 countries, each with its ISO code, calling code and flag. A calling code never changes.

The master holds countries only. No pseudo-countries: no premium, satellite, Inmarsat or freephone ranges. That keeps the catalogue clean and means any number's prefix resolves to a real country.

Destination

This is the standard set per country, taken from the published national numbering plans (E.164). NEXIA ships ~458 standard destinations preloaded, and every one of them is editable.

A destination is defined by range, not by uploading thousands of codes:

• Name — Colombia Mobile.
• Type — Mobile, Fixed or Area.
• Defining prefixes — the prefix (or prefixes) that define it. Colombia Mobile is defined by 573; California by the set 1213, 1310, 1415, 1650, 1818….
• Number length — how many digits the full number has, calling code included. A Colombian mobile is 12: 57 plus ten.

Prefix

These are the leaves: the thousands of granular codes filed under a destination. They can carry a name of their own (57604 Medellín) or be bare codes (57310). A single destination can hold tens of thousands of prefixes, and that is perfectly normal.

The +1 case (NANP)

The United States, Canada, Puerto Rico, the Dominican Republic and the rest of the 1 zone do not separate mobile from fixed by prefix — that distinction does not exist in the numbering plan. So the catalogue models them differently:

• Destinations go by state or province: USA California, USA Texas, USA New York.
• Area codes (NPA) are the Prefixes under each state: California covers 1213, 1310, 1415, 1510, 1619, 1650, 1818 and more.
• The length is 11 digits: 1 + area (3) + number (7).

Browsing the catalogue

Navigation goes down one level at a time.

1. Routing › Destinations opens the list of countries, showing Name, Code, Calling Code and how many destinations each one has. The search box filters by country or prefix.
2. Click a country to see its destinations: Destination, Type, Defining Prefixes, Number Length and the number of Prefixes already filed under it.
3. Click a destination to see its prefixes, paginated and with their own search box (Search prefix or name…). ← Back takes you up a level.

In the prefix view you can select rows (or everything matching the current filter) and use the action bar to Assign them to another destination in the same country, or Unassign them, which leaves them without a destination but keeps them in the catalogue. A prefix you filed by hand is marked as such: later imports will not move it on their own.

Creating or editing a destination

Inside a country, + New Destination creates one; the EDIT button on a row opens the same form for an existing one.

1. Name: the destination name, for example Colombia Mobile.
2. Type: Mobile, Fixed or Area.
3. Defining prefixes: comma-separated and always including the calling code — 573, 5760. A prefix that does not start with the country's calling code is rejected.
4. Number length: minimum and maximum digits of the full number.

Save stores the change and, if you touched the defining prefixes, the catalogue re-files that country's prefixes immediately: anything now covered by the new range moves on its own. DELETE removes the destination but not its prefixes — they stay in the catalogue, unassigned and ready to be re-filed.

Number length

Number length is the total digit count of the number, calling code included. Colombia Mobile: 12. USA California: 11. Spain Mobile: 11.

Why it matters: a number can match the prefix and still be invalid. 5731234 starts with 573 but is far too short for a Colombian mobile; 5730012345678901 is far too long. With the length declared, the switch rejects them at the door instead of handing them to a carrier that will reject them anyway, later and at a cost.

Leaving both fields empty means do not enforce length for that destination: the system falls back to the country default and the listing shows auto.

Where prefixes come from: tariff imports

Destinations are master data; prefixes arrive through tariffs. You mark one tariff as the catalogue source (in Users › Tariffs, the SET AS SOURCE button), and from then on every import into that tariff feeds the catalogue.

On import, each prefix in the file is resolved by longest match against the defining prefixes of the destinations that already exist:

An import never creates countries or destinations. Anything that does not resolve does not go in: it is listed under Discrepancies with the reason. The correct flow is to create the missing country or destination by hand, then compare again.

The summary shown when the import finishes tells you how many prefixes were filed, how many were updated, and how many were left out.

Discrepancies

From Routing › Destinations, the Discrepancies button (with its pending counter) opens the tray of differences between the source tariff and the catalogue. Compare now re-runs the comparison without re-importing the file.

The In use by column shows which dial peers depend on the affected destination, so you see the blast radius before applying anything. The Open / Applied / Dismissed tabs separate pending work from settled work, and anything dismissed stays dismissed on later comparisons — it will not come back to nag you. Apply all and Dismiss all resolve in bulk whatever you are currently looking at.

Why keeping it tidy pays off

• Dial peers are built by picking a country and destination from the catalogue: one peer covers every prefix of that destination, and if you fix a prefix tomorrow, every peer referencing it is fixed too.
• A destination with its length declared filters impossible numbers before you spend an outbound attempt on them.
• The catalogue is what makes a report readable: USA Texas and Colombia Mobile instead of 1512 and 573.