Muni-Link | Utility Cloud Help

Utility Cloud offers the ability to link directly with Muni-Link's Utility Billing software for anyone using Muni-Link for meter billing. Whenever you create a task for any supported task in Muni-Link, that task will be sent to Utility Cloud as a work order using the mapped workflow. From there, you can complete that work order the same as any other and on completion, the mapped data will be sent back to Muni-Link and complete the linked task.

For more information on Muni-Link Utility Billing, you can visit their website here. If you already use Muni-Link and are interested in setting up an integration with your billing account in Utility Cloud, you can reach out our Customer Success team using the contact information here to discuss the implementation process.

Setting up your integration

In order to begin sending work between Muni-Link and Utility Cloud, you will need to work with our Customer Success team to map a specific account in Utility Cloud for Muni-Link to send work orders. You will also need to map an asset class to map to your Muni-Link accounts and workflows to map to Muni-Link tasks. You will also need to create list definitions to support specific required fields in the asset class and workflows. Once configuration is completed, a Customer Success representative with Utility Cloud will work with our development team and representatives from Muni-Link to link those together.

Currently only the below Muni-Link tasks are supported for mapping to Utility Cloud:

Install Meter
Reread Meter
Exchange Meter
Exchange Meter ECR/MXU
Shutoff
Restore Service
Remove Meter

Account configuration

Only one account can be configured in Utility Cloud for receiving work orders from Muni-Link. That account needs to have the same business line as your account asset class and task workflows but otherwise doesn't need any special configuration. For more information on setting up a new account or editing an existing one, see Accounts.

Asset class configuration

The asset class configured for use with Muni-Link will represent your Muni-Link accounts as assets in Utility Cloud. The asset class should be the same business line as your account and workflows and requires the below fields:

Field Type	Required	Key	Title	List Definition
TEXT	No	no key required	Account Number
TEXT	No	no key required	Municipality
TEXT	No	sn	Serial Number
MULTIPLE CHOICE	No	mfg	Manufacturer	Meter Manufacturer
MULTIPLE CHOICE	No	um	Unit of Measure	Unit of Measure
MULTIPLE CHOICE	No	mp	Multiplier	Multiplier
MULTIPLE CHOICE	No	ms	Meter Size	Meter Sizes
MULTIPLE CHOICE	No	rt	Reader Type	Reader Type
TEXT	No	ecr	ECR Number
TEXT	No	mxu	MXU Number

For more information on creating or editing an asset class, see Asset Classes.

Workflow configuration

The workflows configured for use with Muni-Link will represent your tasks sent from Muni-Link to Utility Cloud. The workflows should be the same business line as your account and asset class, and requires the below fields for each workflow.

Install Meter

Field Type	Required	Key	Title	List Definition
DATE	Yes	no key required	Meter In Date
TIME	No	no key required	Meter In Time
NUMBER	Yes	no key required	Meter In Reading
TEXT	Yes	no key required	Serial Number
MULTIPLE CHOICE	Yes	no key required	Manufacturer	Meter Manufacturer
MULTIPLE CHOICE	Yes	no key required	Unit of Measure	Unit of Measure
MULTIPLE CHOICE	Yes	no key required	Multiplier	Multiplier
MULTIPLE CHOICE	Yes	no key required	Meter Size	Meter Sizes
MULTIPLE CHOICE	Yes	no key required	Reader Type	Reader Type
TEXT	No	no key required	ECR Number
TEXT	No	no key required	MXU Number

Reread Meter

Field Type	Required	Key	Title
DATE	Yes	no key required	Read Date
TIME	No	no key required	Read Time
NUMBER	Yes	no key required	Reading

Exchange Meter

Field Type	Required	Key	Title	List Definition
DATE	Yes	no key required	Meter Out Date
TIME	No	no key required	Meter Out Time
NUMBER	Yes	no key required	Meter Out Reading
DATE	Yes	no key required	Meter In Date
TIME	No	no key required	Meter In Time
NUMBER	Yes	no key required	Meter In Reading
TEXT	Yes	no key required	Serial Number
MULTIPLE CHOICE	Yes	no key required	Manufacturer	Meter Manufacturer
MULTIPLE CHOICE	Yes	no key required	Unit of Measure	Unit of Measure
MULTIPLE CHOICE	Yes	no key required	Multiplier	Multiplier
MULTIPLE CHOICE	Yes	no key required	Meter Size	Meter Sizes
MULTIPLE CHOICE	Yes	no key required	Reader Type	Reader Type
TEXT	No	no key required	ECR Number
TEXT	No	no key required	MXU Number

Exchange Meter ECR/MXU

Field Type	Required	Key	Title
DATE	Yes	no key required	Meter Out Date
TIME	No	no key required	Meter Out Time
NUMBER	Yes	no key required	Meter Out Reading
DATE	Yes	no key required	Meter In Date
TIME	No	no key required	Meter In Time
NUMBER	Yes	no key required	Meter In Reading
TEXT	Yes	no key required	ECR Number
TEXT	Yes	no key required	MXU Number

Shutoff

Field Type	Required	Key	Title
DATE	Yes	no key required	Read Date
TIME	No	no key required	Read Time
NUMBER	Yes	no key required	Reading

Restore Service

Field Type	Required	Key	Title
DATE	Yes	no key required	Read Date
TIME	No	no key required	Read Time
NUMBER	Yes	no key required	Reading

Remove Meter

Field Type	Required	Key	Title
DATE	Yes	no key required	Meter Out Date
TIME	No	no key required	Meter Out Time
NUMBER	Yes	no key required	Meter Out Reading

For more information on creating or editing a workflow, see Workflow Classes.

List definition configuration

The list definitions configured for use in your asset class and workflows mapped to Muni-Linked are used to validate specific fields Muni-Link will be looking for when your work order is sent back to Muni-Link.

Meter Manufacturer

Field Name
Sensus
Neptune

Unit of Measure

Field Name
Gallons
Cubic Feet

Multiplier

Field Name
1 (0 Fixed Zeros)
10 (1 Fixed Zero)

Meter Sizes

Field Name
3/4
5/8

Reader Type

Field Name
Unknown
Radio
Touch

For more information on creating or editing list definitions, see List definitions.

Linking your configuration

Once your account, asset class, and workflow are created and configured in your billing account, a Utility Cloud Customer Success representative will need to coordinate with one of our developers and a representative from Muni-Link in order to finish enabling your billing account to send and receive data to and from Muni-Link. You can find contact information for our Customer Success team on the Contact Us page.

Creating and completing Muni-Link work orders

Once your integration is configured between Muni-Link and Utility Cloud, sending a Muni-Link task to Utility Cloud as a work order only requires you to create a supported task in Muni-Link.

Creating from Work Orders

To create a work order from Muni-Link's Work Orders system:

From Muni-Link, select Work Orders.
From Work Orders, select NEW WORK ORDER.
Enter all the required information, select your task, and select Create.

Once your work order is created in Muni-Link, that work order is automatically created in Utility Cloud with the corresponding workflow. If no asset exists yet to represent your Muni-Link account, then an asset will be created in the linked Utility Cloud account for that work order to be created against. The Work Order page for that work order will show the Utility Cloud Work Order ID under External ID and you can use that ID to find the correct work order in Utility Cloud.

That work order can then be completed the same as any other work order in Utility Cloud, and on completion the associated workflow report data will be sent to Muni-Link and the Muni-Link work order updated and completed. If that work order is canceled in Utility Cloud instead, then it will be canceled in Muni-Link.

Creating from Service Orders

To create a work order from Muni-Link's Service Orders system:

From Muni-Link, select Service Orders.
From Service Orders, select New Service Order in the lower-right of the page.
Select Account or Location to create an individual service order/work order or select Mass Creation to create multiple, and once you've entered the required fields, select Next.
Select your task and enter all required fields, then select Save.

Once your service order is created in Muni-Link, the corresponding work order is automatically created in Utility Cloud with the corresponding workflow. If no asset exists yet to represent your Muni-Link account, then an asset will be created in the linked Utility Cloud account for that work order to be created against. The Service Order page for that work order will show the Utility Cloud Work Order ID and Asset ID under the Integration Points panel and you can use that ID to find the correct work order in Utility Cloud.