Skip to main content
The quickest way to get a new organisation running is guided onboarding. You bring your existing data in once, as documents for Joule to read or a single onboarding file. Then you review it and create everything together.
Prefer to build your portfolio by hand? See Your First Steps. This page covers the faster, assisted path.

You’re all set

After the plan step, UMS shows a You’re all set! page. Your organisation is ready, and the page offers quick links: Guided onboarding runs against an account, so create an account first.

Before you start

  • Suppliers and utilities must already exist. The onboarding upload looks up retailers and utility types by name and doesn’t create them. Ask your administrator if you’re unsure.
  • Gather your portfolio data: accounts, sites and their addresses, connection identifiers (electricity NMI, gas MIRN), retailer account references and agreement details.
  • Collect supporting documents if you want Joule to do the work: agreement PDFs, recent invoices or a site-list spreadsheet.

Open guided onboarding

Start it from any of these:
  • Accounts › Guided setup: creates an account, then opens guided onboarding for it.
  • An account’s page: click Launch Onboarding with Joule (the Joule icon in the header).
  • An account’s Settings tab: under Onboarding Tools, click Launch Onboarding with Joule.

The guided onboarding wizard

The wizard runs against the account you opened it from and has five steps. Every step except Review is optional.
1

Import data

Upload documents for Joule to analyse, or import a CSV. Joule reads your files and pre-fills the later steps. See AI document upload.
2

Infrastructure

Add or adjust associated accounts, sites and connections. If you imported data, these are already filled in for you to check.
3

Site links

Connect sites to connections, so each meter is tied to the right location.
4

Commercial

Add agreements and retail accounts.
5

Review

Check everything the wizard will create, then create the records in one go. The button names what it’s about to create.
When the records are created, you return to the account’s page.
The wizard saves your progress as you go, so your work survives a page refresh. The draft is kept in your browser tab, so closing the tab discards it.

AI document upload

On the Import data step, drop in the documents you already have. Joule extracts a portfolio from them and proposes associated accounts, sites, connections, site links, agreements and retail accounts. These flow into the later steps for you to review and edit before anything is created. Accepted files: PDF, CSV, Excel (.xlsx, .xls), TSV and images (.png, .jpg, .jpeg), up to 50 MB each. Agreement PDFs, recent invoices and site-list spreadsheets work well.
Extraction is a starting point. Check the extracted accounts, connections and agreements on the Infrastructure, Site links and Commercial steps before you create them.

All-in-one onboarding file

To drive onboarding from a spreadsheet, the onboarding upload creates your whole hierarchy (accounts, sites, connections, retail accounts and agreements) from a single CSV. It’s one row per connection. Repeated account, site and agreement values are de-duplicated. The upload is all-or-nothing. If any row fails validation, nothing is created. Fix the file and upload it again. For the columns and a template, see Onboarding upload (all-in-one).

Next

See What’s Next for the most valuable things to set up in your first week.