Skip to main content
Retail accounts are the account references that energy retailers assign to your connections. They link your internal account structure to the retailer’s billing system, and they are how incoming invoices get matched to the correct account and connection.

Where to find it

Open Accounts in the Portfolio group of the sidebar, then select the Retail accounts tab.
The Retail accounts tab only appears for users with access to the Validation module.
UMS Retail Accounts list showing retailer account references

Retail accounts list

The view switch above the grid filters the list: The grid also shows whether invoice validation and gap checks are switched on for each account.

Header actions

Creating a retail account

Click New Retail Account to open the drawer. Enter the retailer’s account reference and link the supplier, account and connection. You can also set the open and close dates, status, validation and gap-check settings, match tolerance, expected billing frequency and payment terms.
A retail account links one connection to one retailer reference. When a connection transfers between retailers, a new retail account is created and the old one is closed, which keeps a full billing history per retailer.

Statuses

The list and the detail page header label the same statuses slightly differently:

Retail account detail page

A retail account detail page with its tabbed interface and details panel
The header shows the retailer’s account reference, a status chip and a link to the parent account. The Scenarios card lists tariff-review scenarios for the account. Use Model opportunities to start a new one, or Bulk tariff review for a multi-period review.

Header actions

Activating an account also closes any other active or pending accounts on the connection. Tick Mark as Pending to close those as Deactivation pending instead of Inactive. When closing, tick Mark as Pending to close this account as Deactivation pending.

Merging retail accounts

When duplicate retail accounts exist for the same connection, merge them into a single root. The merge is irreversible: agreements, connections, invoices and related data move into the root account.
1

Select

Click Merge Retail Accounts. Choose the root account to keep, then add the accounts to merge into it.
2

Review

Click Review. Check the root and the accounts being merged, each with its supplier reference and open and close dates.
3

Merge

Click Merge. UMS reassigns the data to the root while the Load step runs.
4

Results

Review the Success and Failed counts. Click Download Results to save them as JSON, then resolve any failures.
Use Merge Recommendations to let UMS surface likely duplicates instead of finding them by hand.
  • Agreements: the contracts retail accounts are linked to
  • Validation: checks invoices against each retail account’s tariffs
  • Payments: pays validated invoices by retail account