Skip to main content
Agreements link accounts, suppliers, connections and tariffs together. For a reference of the Agreements page, its views and statuses, see Agreements.

Creating a new agreement

1

Open the Agreements page

Open Agreements in the Commercial group of the sidebar.
2

Open the create drawer

Click Add agreement.
3

Fill in the agreement details

The drawer groups the fields under Agreement Information (name, type and reference), Dates (start, end and executed), Status (an optional override and its reason), Relationships (account and supplier) and Documents. Name and type are required.
4

Save

Save the drawer. The new agreement appears in the list.
5

Complete the setup

Open the agreement and add its connections and tariffs.

Viewing agreement details

Click an agreement’s name in the Agreement column to open its detail page.
Agreement detail page in UMS
The detail page has these tabs:
  • Overview: agreement summary, dates, supplier and key details
  • Connections: connections covered by this agreement
  • Tariffs: tariff structures and rates for this agreement
  • Brokerage: brokerage records linked to this agreement
  • Settings: agreement-specific settings
Header actions cover the rest: Extract from contract, New tariff (on the Tariffs tab), New Retail Account, Add Document, Add a Connection, Bulk Add Connections, Merge Into This Agreement and Add a Brokerage Record.

Managing connections

The Connections tab lists the Agreement Connections: the meter connections this agreement covers. Click a row to open it.
Agreement connections tab in UMS

Adding connections

  • One connection: click Add a Connection. The drawer starts with the agreement’s dates; pick the connection and, optionally, its retail account.
  • Many connections: click Bulk Add Connections to open Link connections to agreement.
1

Connections

Choose the Namespace, then paste the connection identifiers (NMIs or MIRNs). UMS looks each one up in that namespace. Start Date and End Date default from the agreement and apply to every connection created.
2

Review

Check how many are Ready to create and how many are Invalid or pending, then create the links.

Managing tariffs

The Tariffs tab shows the tariff structures linked to this agreement.
Agreement tariffs tab in UMS
  • New tariff opens the tariff builder with the agreement and supplier filled in. The button shows only while the Tariffs tab is open.
  • Extract from contract reads a contract for you. See below.
See the Managing Tariffs guide for creating and editing tariffs.

Extracting a tariff from a contract

1

Upload the contract

Click Extract from contract and drop a signed contract or offer document into Extract Tariff from Contract.
2

Review the proposal

Joule reads the document, usually in under a minute, and proposes a tariff. Nothing is created yet.
3

Confirm or reject

Click Confirm & Create Tariff to create it, or Reject to discard the proposal.

Other actions

  • New Retail Account creates a retail account with the agreement’s account, supplier and dates filled in.
  • Add Document attaches a contract or other file to the agreement.
  • Add a Brokerage Record creates a brokerage record for this agreement, starting as pending, with its dates filled in from the agreement.
  • Merge Into This Agreement opens the merge flow with this agreement as the root. Pick the duplicate agreements to fold into it, review, then merge. The merge cannot be undone. You can also start a merge from Merge Agreements on the Agreements list.