WorkflowBilling, Credit & Collections

Rate Code Validation

Rate code validation for every account, every night — each wrong tariff found with its clause, its proof and its refund or back-bill worked out

Every account checked every night, every wrong tariff fixed with its refund worked out.

See one case, screen by screen ↓
estimatedAED 3.4Ma year of wrong tariffs put right — refunds paid and under-billing recovered (1,312 accounts × AED 2,590 average yearly difference)
target100%of over-charged customers refunded before they have to complain
target12monthsthe most any back-bill reaches back for the utility's own error, with every month shown
demo1,312accountsof 1,184,400 broke a tariff rule in one nightly check, each with its refund or back-bill worked out
The problem

Why a wrong rate code runs for years

Every bill is priced by the rate code on the account. When a villa run as a nursery becomes a family home, a ground-floor unit opens as a grocery, a warehouse raises its connected load, a title deed changes hands or rooftop solar is connected, the tariff should change — and often nobody tells billing. The bill still computes, so no exception fires. Pre-invoice validation in the billing system checks that a bill adds up, not that the account belongs on its tariff.

So a wrong code surfaces as a complaint, an internal audit sample or a regulator's order, years later — when the refund is large and the back-bill is time-barred. Rate audits check the record, and the record says “villa”. At Lumina's scale of 1,184,400 accounts, checking 50 accounts a week by hand covers about 0.2 % of them in a year. Under-billing past the back-bill limit is revenue lost for good; over-charging is a customer harm and a regulatory exposure.

typical$63Mand more in refunds with interest for misclassified homes at one US utility, approved by the regulator in 2026
typical43,000homesor so in multifamily buildings, billed on the single-family rate class — about 10 % of that utility's multifamily customers
typical$1.78Mover-billed to its own city by a municipal utility, on mis-set accounts over eight years
Where a wrong tariff's correction days goestimated
By hand28 days
With the solution2.6 days
  • Getting the account onto a list to check — a monthly extract, or the nightly check15 → 0.1 d
  • Pulling the record, licences, tenancies, deeds and meter reads3 → 0.2 d
  • Rebilling every month on both tariffs, with VAT and the limits3 → 0.2 d
  • Manager review and signature3 → 1.1 d
  • Raising the rebill in billing2 → 0.9 d
  • Writing the customer letter in Arabic and English2 → 0.1 d

Estimated split for one mis-rated account, in working days, by hand and with the solution. The with-the-solution figures follow the medians on the Results screen — 2.4 days from a red cell to a corrected bill.

How it works

How an account is checked

Six agents read the tariff book, the account, its documents and how the meter is used, and work out every month; the rates analyst clears each red cell.

What comes in
Every account, every night5 sources · tariff book, billing, licences and tenancies, hourly reads, premise register
Agents at work
Tariff book readerrules + clauses
Then
Account profilerrecord · load
Document checkerlicence · tenancy · deed
Usage shape reader90 days hourly
Then
Rebill calculatorrefund · back-bill
Then
Customer letter writerArabic + English
A person decides
Rates analystclears each red cell
What comes out
Account on the right tariff
Refund or back-bill
Signed record
One case, step by step

One night's check, from a red cell to a refund the customer never asked for

Lumina Utilities bills 1,184,400 accounts from its 2026 tariff book, edition 3. On 13 Oct 2026 the nightly check runs from 01:00 to 02:47. Here is what happens next, screen by screen, in the working solution.

  1. 0101:00–02:47

    Every account against every rule, overnight

    Six agents · the nightly check

    The tariff book reader reads edition 3 into six eligibility rules tied to 41 clauses. The account profiler reads 1,184,400 accounts with their tariff history and load; the document checker matches 642,180 licences, tenancies, deeds and certificates; the usage shape reader scores 1,092,600 meters on 90 days of hourly reads. By 02:31 the rebill calculator has rebilled every account that breaks a rule, month by month, and by 02:44 the letter writer has drafted 1,100 notices in Arabic and English.

    “1,312 break a rule · 214 worth over AED 1,000 come first”

  2. 02Morning

    A grocery on a home tariff, seen in its load shape

    Aisha Karimi · Rates analyst

    Aisha's tariff check puts accounts down the side and the six rules across the top — premise use, connected load, usage shape, household status, riders, tariff code. Each usage-shape cell draws the meter's 24 hours against what its tariff expects. Unit G-03 at Saffron Creek Residences is billed R1 Residential, but its load is flat from 07:00 to 23:00 every day: shop, 0.88. Trade licence TL-771904 for Saffron Fresh Grocery has been active at the premise since 4 Mar 2025.

    The fix: R1 → C1 from 4 Mar 2025 · 19 months wrong, back-bill held to the 12-month limit · AED 5,502.45 incl. VAT

  3. 03One click

    Villa 31: a family home on the commercial tariff for 26 months

    Aisha Karimi · Rates analyst

    The first red cell on the list is Villa 31, Zahra Gardens, account 2041 778 330, billed C1 Commercial. The premise-use cell reads “Licence cancelled 18 Jul 2024 · tenancy residential”. The rail beside it quotes the clause, draws the villa's shape against the daytime office shape C1 expects, and shows the fix already worked out: R1 Residential from 1 Aug 2024, 26 months rebilled.

    Clause 4.2: “C1 applies to premises used for trade, with an active trade licence or a commercial tenancy registered at the premise.”

  4. 04The account

    The nursery closed; billing was never told

    Document checker and Account profiler

    The account shows the tariff history: C1 for Little Steps Home Nursery under trade licence TL-604218 from March 2021, then C1 for a family home that should be R1. The licence was cancelled on 18 Jul 2024; tenancy registration EJ-2024-0815532 for Samir Haddad and his family is residential from 1 Aug 2024. Each record opens from the evidence list — licence register, tenancy registry, premise register 410 778 031 and the hourly reads from meter EM-4417031.

    Premise register: “C1 Commercial since 9 Mar 2021 · not changed at the move-in”

  5. 05The proof and the money

    A home's evenings, and every month rebilled

    Usage shape reader and Rebill calculator

    Ninety days of hourly reads show a home: lowest 08:00–15:00, peak 19:00–23:00, weekend daytime use 24 % above weekdays. Home · villa scores 0.91; office · daytime, what C1 expects, 0.22. The rebill calculator prices the same kWh on R1 for each of the 26 months, Aug 2024 to Sep 2026: 70,035 kWh, AED 25,032.25 billed on C1 against AED 17,470.38 on R1, before VAT.

    Refund to the customer: AED 7,940.00 incl. 5 % VAT · 26 months, every month shown

  6. 06The letter

    The notice, drafted in Arabic and English

    Customer letter writer

    The letter to Samir Haddad says what was wrong, the new tariff, the months and the amount: Lumina has corrected the tariff and will refund AED 7,940.00, including VAT, as a credit on the next bill, with a table of every month. It apologises for Lumina's error and tells him he does not need to do anything. Aisha approves the wording; the letter waits for the signature.

    “Drafted by the Customer letter writer · sent after Omar Siddiqui signs”

  7. 07Cleared and signed

    Aisha clears the cell; Omar signs the refund

    Omar Siddiqui · Rates and tariffs manager

    Aisha clears the cell. A refund over AED 5,000 goes to Omar Siddiqui, who signs every back-bill and every refund above that line. The sign-off shows each step in order — agents proposed with the evidence, Aisha cleared, Omar signed, Priya Nair raises the rebill in billing, and the letter goes out in Arabic and English.

    “Omar Siddiqui signed the AED 7,940.00 refund · Villa 31”

  8. 08A key account

    A cold store owed a refund, and a call before the letter

    Daniel Brooks · Key account manager

    Warehouse 12 in Lumina Industrial Area is billed C1 Commercial. Load upgrade LU-25-0412 raised its connected load from 380 to 1,250 kVA on 3 Jun 2025, with a demand meter fitted — and no tariff change was raised. Clause 3.1 puts 400 kVA and above on I1 Industrial. Rebilled over 16 months with the demand charge, Northgate Cold Stores LLC is owed AED 105,352.80. Accounts of 400 kVA or more go to Daniel Brooks as well as Omar.

    Run log: “Key account · Daniel Brooks to call before the letter”

  9. 09Not moved

    One signal is not enough

    Usage shape reader

    Townhouse 7 at Rimal Heights shows more daytime use since July 2026, scoring 0.71 against the office template — below the 0.80 the settings require. The document checker finds no trade licence and no commercial tenancy at the premise. The cell stays amber, the account stays on R1, and it is looked at again on 11 Jan 2027.

    “The usage shape alone never changes a tariff; a licence, tenancy or record must agree.”

  10. 1014 weeks live

    Money put right both ways, inside the limit

    Omar Siddiqui · Rates and tariffs manager

    Since go-live on 6 Jul 2026 the Results screen shows AED 3.92M refunded to 1,507 over-charged customers before they had to complain, AED 1.77M back-billed to 979 accounts inside the 12-month limit with instalments, 2,486 accounts corrected and signed, and no back-bill over the limit. The biggest cause: occupancy changed and the tariff did not, on 945 accounts.

    “Median 2.4 days from a red cell to a corrected bill. Before, a wrong tariff was found when the customer complained or an audit sample reached it.”

Who it’s for

Built for everyone who puts a tariff right.

The same wrong tariff, seen by the four people who fix it — what their week looked like, and what it looks like now.

AK
Aisha KarimiRates analyst, revenue assurance · clears cells, releases refunds up to AED 5,000
Rates analyst
Before
Works a list of suspect accounts from a monthly extract, 40–60 checks a week by hand. “I can check the record. I can't see how the place is really used.”
Now
Opens a matrix of every account that broke a rule last night, red first, each cell with its clause, its documents, the meter's shape and the money already worked out.
OS
Omar SiddiquiRates and tariffs manager · owns the tariff book, signs every back-bill and refunds over AED 5,000
Rates and tariffs manager
Before
Owns the tariff book; signs every back-bill and every refund over AED 5,000. “Show me the clause, the proof and the months. Then I sign.”
Now
Signs from one list of refunds and back-bills, each with both tariffs for every month and the limit already applied; publishes rule changes as a new version.
DB
Daniel BrooksKey account manager, industrial · 38 large accounts, reviews 400 kVA and above
Key account manager
Before
Hears about tariff errors from the customer's auditor. “I want to call my customer before their auditor calls me.”
Now
Sees every correction on an account of 400 kVA or more before the letter goes, with the load change, the clause and the refund.
PN
Priya NairBilling analyst · raises rebills in billing, sends the letters
Billing analyst
Before
Raises each rebill in billing and sends the letters. “Give me the corrected months, not a spreadsheet.”
Now
Gets the signed rebill month by month — kWh, both prices and the difference with VAT — and a letter already drafted in Arabic and English.
Built on the engine

6 agents. Each with one job, and hard limits.

Six agents read the tariff book, the account, its documents and how the meter is used, and work out every month; the rates analyst clears each red cell.

Tariff book reader

Reads the tariff book and its amendments into eligibility rules — premise use, connected load band, household status, riders and whether a code is in force — each tied to its clause, and names the successor of every retired code.

  • Never changes a tariff or a price
  • Every rule cites its clause
  • Shows what an amendment changes before anything is published
Account profiler

Pulls premise type, connected load, household status, riders and tariff history with dates for every account, from billing, the premise register and the connections system.

  • Read only
  • Never merges or edits an account
Document checker

Looks up every trade licence, tenancy registration, title deed and solar connection certificate registered at the premise number, and gives its status, its dates and the field that matters.

  • The premise number must match
  • Never accepts an expired document as current
Usage shape reader

Averages 90 days of hourly reads by day of week and hour and scores the shape against templates — home villa, home apartment, shop, office, cold store, school, farm — giving the best match and the match for the tariff billed.

  • Never moves an account on its shape alone — a document or record must agree
  • A match counts as a signal only at 0.80 or above
Rebill calculator

Prices the same kWh and demand on the right tariff for every month on the wrong one, with VAT. Refunds over-charges for the whole period on record, up to 84 months; back-bills under-charges for no more than 12.

  • Never sends a rebill before sign-off
  • Back-bills held to the limit
  • Shows both prices for every month
Customer letter writer

Drafts a short, plain notice in Arabic and English: what was wrong, the new tariff, the months and the amount. Offers instalments on a back-bill and apologises when the error was Lumina's.

  • No back-bill letter before the manager signs
  • Never names another customer
Rates analyst

Clears the cell; the manager signs. The agents propose; a named person decides.

Ask in plain words

Ask about any account, in plain words

Ask about any account, rule, refund or back-bill — or say what to change. Every answer points to its records.

Why is Villa 31 on the commercial tariff?

Because nobody changed it when the nursery closed. Villa 31 was licensed as Little Steps Home Nursery until 18 Jul 2024. The Haddad family has lived there since 1 Aug 2024 on a residential tenancy, and the meter shows a home: evening peak, busier weekends. Clause 4.2 puts it on R1. Rebilled over 26 months, Lumina owes AED 7,940.00.

Which shops are billed as homes?

183 accounts on R1 or R2 have a shop or office shape above 0.80 and a trade licence at the premise. The largest is Unit G-03, Saffron Creek: flat 07:00–23:00 every day, grocery licence since 4 Mar 2025. Back-bill AED 5,502.45, held to 12 months.

How much do we owe in refunds from last night?

Last night's check found 788 accounts owed a refund, AED 2.31M, and 524 under-billed, AED 1.07M within the limit. On today's list the largest refund is Warehouse 12, AED 105,352.80, a key account for Daniel Brooks.

Show the accounts still on retired codes

212 accounts still carry a code retired on 1 Jan 2026. They are price-neutral, so they recode without a rebill. Lumina Primary School is on today's list: clear its cell to recode it to G1; the other 211 can be recoded together from the Tariff book.

Every screen

The working solution, as it ships.

13 screens from the working solution, on its sample data. Pick one to see it large.

The tariff checkEvery account that broke a rule last night against the six eligibility rules, red first, each red cell with its refund or back-bill, today's tally and last night's run.
A shop on a home tariffUnit G-03's flat 07:00–23:00 load against what R1 expects, its grocery licence, and the back-bill held to the 12-month limit.
A red cell, openedVilla 31's premise-use cell beside its evidence: the clause, the villa's shape against what C1 expects, and the refund already worked out.
The accountVilla 31's change from C1 to R1, its tariff history, the meter's 90 days against the templates, the rules it breaks and the evidence.
Rebilled month by monthThe same kWh priced on both tariffs for each of the 26 months, with the refund including VAT, beside the sign-off steps.
The customer letterThe refund notice to the customer in Arabic and English, sent only after the manager signs.
Cleared and signedAgents proposed, the analyst cleared, the manager signed, billing raises the rebill and the letter goes out.
A key accountA cold store's connected load raised to 1,250 kVA: the move to the industrial tariff and its refund, reviewed by the key account manager.
One signal onlyA daytime shape below the confidence line and no licence at the premise: the account is not moved and is looked at again.
Usage shapesEvery account placed by its daytime and evening share and coloured by its tariff — homes billed as shops sit in the wrong cloud.
Refunds and back-billsCorrections waiting for the manager or ready to release, with the change, the months and who cleared each one.
ResultsMoney refunded and back-billed by week, why accounts were on the wrong tariff, and the time from a red cell to a corrected bill.
Your rulesThe back-bill limit, refund lookback, sign-off line, nightly schedule and how strict the checks are.
Governance

Built for regulated billing: cited, signed, inside the limits.

Every red cell cites its clause and its proofEach broken rule shows the tariff book clause, the record and the document behind it — the licence, the tenancy, the deed, the load upgrade or the meter reads — and each one opens to the field that matters.
Two signals before an account movesThe usage shape alone never changes a tariff; a licence, tenancy or record must agree. The rule is locked on. One signal leaves the cell amber, and the account is looked at again after 90 days.
The analyst clears; the manager signsAgents read, check, score and calculate — they never move an account or send a bill. A rates analyst clears each cell, and the rates and tariffs manager signs every back-bill and every refund over AED 5,000.
The limits are held, both waysA back-bill for Lumina's own error reaches back 12 months at most, with instalments over as many months as were billed back. Over-charges are refunded for the whole period on record, up to 84 months.
Key accounts see it firstAny account with a connected load of 400 kVA or more goes to the key account manager too, so the customer hears about the correction before the letter arrives.
Every change on the recordEach agent step and each decision — who cleared, who signed, what was sent — is recorded with its time. Every settings change is saved as a new rules version, and the rebill keeps both tariffs for every month.
Configuration

Your tariff book and your limits, not ours

The back-bill limit, the refund lookback, who signs and how strict the checks are are settings, chosen by the rates team — and every change is saved as a new rules version.

SettingDefaultChoose from
Back-bill limit when the error is Lumina's12 months1 to 24 months — how far back a corrected account may be billed
Refund lookbackWhole period, up to 84 monthsWhole period, up to 60 months · up to 84 months · up to 120 months
Manager sign-offAED 5,000AED 2,000 · AED 5,000 · AED 10,000 — refunds above it, and every back-bill, need the rates and tariffs manager
Nightly checkEvery night at 01:00Every night at 01:00 · Every night at 03:00 · Every Sunday at 01:00
Usage shape confidence0.800.60 to 0.95 — the lowest template match that counts as a signal
Two signals before an account movesOnAlways on — the usage shape alone never changes a tariff
Look again at amber cells90 days30 days · 60 days · 90 days
Key accountsOnOn · Off — connected load of 400 kVA or more goes to the key account manager too
Connections

Works with the records a rates team already checks

Tariff book and rate schedulestariff codes, eligibility clauses, riders, retired codes and amendments
Billing and customer accountsrate code, tariff history, premise type and connected load
Premise registerpremise number, type and the account at the premise
Licence, tenancy and land registerstrade licences, tenancy (Ejari) registrations and title deeds
Meter data90 days of hourly reads, export reads and peak demand
Connectionsload upgrades, demand meters and solar connection certificates
What it changes

The difference, in numbers.

Every figure is labelled: a target the solution is built to, an estimate, a typical published result, or a proven one.

target
100%
of over-charged customers refunded before they have to complain
estimated
AED 3.4M
a year of wrong tariffs put right: refunds paid, under-billing recovered
target
12months
the most any back-bill reaches back, with every month shown
12-month limit
refunds go back further

“demo” = seen in the working solution, on its sample accounts · “target” = the design goal, measured in the pilot · “estimated” = our arithmetic, inputs shown (AED 3.4M = 1,312 accounts found in one nightly check × AED 2,590 average yearly difference, Lumina sample figures; the working-days split is our estimate) · “typical” = published figures (Nevada Independent and KOLO, 2026: NV Energy refunding more than $63M with interest for about 43,000 homes billed on the wrong rate class; Vermont Business Magazine, 2014: Burlington Electric over-billed the city by $1.78M). Back-billing limits named as context: Fla. Admin. Code 25-6.106 and 25-30.350 (12 months for gas and water), Utility Regulator NI (13 months); New York bill S8530 (2025) would require a misclassified account to be moved to the right rate code. Lumina Utilities and the people, premises, companies, licences, tenancies and records named on this page are fictional — characters and sample data in the working solution.

Questions

What rates and billing teams ask us.

What is rate code validation software?

Software that checks every utility account is on the tariff, or rate code, it qualifies for — and works out the refund or back-bill when it is not. Rate Code Validation checks every account every night against the tariff book's eligibility rules, and a rates analyst clears each account it flags.

How does rate code validation work?

Six agents read the tariff book into rules tied to their clauses, profile each account, check the licences, tenancies, deeds and certificates at the premise, score 90 days of hourly reads, and rebill every month on the right tariff. Each broken rule becomes a red cell with its clause, its proof and its money.

How does it find a business billed on a residential tariff?

It reads how the meter is used, not only the record. A shop's flat trading-hours load or a home's evening peak is scored against shape templates, and a matching trade licence or tenancy confirms it. In the sample, a grocery billed as a home scored 0.88 on the shop template and held an active trade licence.

Can the usage shape alone change a customer's tariff?

No. The shape is one signal; a licence, tenancy or record must agree before an account moves, and that rule cannot be switched off. With one signal the cell stays amber and the account is looked at again after 90 days.

How are refunds and back-bills for misclassified accounts worked out?

The rebill calculator prices the same kWh and demand on the right tariff for every month, with VAT, and shows both prices. Over-charges are refunded for the whole period on record, up to 84 months; back-bills for the utility's own error stop at the back-bill limit, 12 months in the sample, with instalments.

Do people stay in control of tariff changes?

Yes. The agents read, check, score and calculate, and never move an account or send a bill. A rates analyst clears each cell, the rates and tariffs manager signs every back-bill and every refund over AED 5,000, and accounts of 400 kVA or more go to the key account manager too.

What happens when the tariff book changes?

An amendment is added on the Tariff book screen. The tariff book reader reads it into rules and shows what would change before anything is published, and the rates and tariffs manager publishes it. Retired codes go to their successor; price-neutral recodes need no rebill.

How long does it take to go live?

The Agentic Solution Engine builds and deploys it from your requirements and documents — your tariff book, billing rules, letter templates and a sample of accounts — and it goes live once every quality gate has passed. We will walk you through it on your own accounts first.

See it on
your tariff book.

We'll run Rate Code Validation on your own tariff book and a sample of your accounts.