Buildings - add

Buildings (also known as sites or network nodes) are an important part of Utilmate and impact most reporting and default pricing for customers.

To add a building, go to the Maintenance menu, Utility Services and select Buildings. Select Add Building from the Building Actions dropdown list.

The "Add Building" wizard is opened. Enter building details and click on the next button.

Enter the building attributes (see below for building attribute XML tags) and click on the next button.

Enter building billing requirements and click on the next button.

Important:  Billing day - this is used if you are using the billing calendar to control when each building is being billed.  If you are, and you would like to bill this building to the current day, set the billing day to the current day's date eg if today is 20 January, set the billing day to 20.

Enter the building price plans and click on the save button.

Building Attributes

The building attributes are in XML field that looks like this:

<data>
<site_address>9 Smith Street</site_address>
<site_suburb>Springfield</site_suburb>
<site_state_code>NSW</site_state_code>
<site_postcode>2000</site_postcode>
<bodycorpname/>
</data>

XML syntax rules are:

• XML documents must have a root element (<data></data>)
• XML elements must have a closing tag (<site_address></site_address>)
• XML tags are case sensitive (<site_address> works whereas <Site_Address> will not be valid)
• XML elements must be properly nested (<data><site_address></site_address></data>)
• XML attribute values must be quoted

Using an online XML validator would be useful to ensure the correct syntax is used. (https://webformatter.com/xml or https://www.xmlvalidation.com/) 

Below is the full range of XML tags that are available.  There is validation to ensure only these tags can be used.  Please take note of the case sensitivity.

<site_address> - address line 1 (number and street)
<site_suburb> - address line 2 (suburb)
<site_state_code> - address line 3 (state code)
<site_postcode> - post code
<bodycorpname> - if billing on behalf, enter the body corp name associated with the building
<basic_plan_url> - URL address to basic plan associated with building and shown on Buildings Report
<terms_url> - URL address to show specific terms relating to building and shown on Buildings Report
<logo_image> - URL address to building logo and shown on Buildings Report
<BSB> - your (Bank-State-Branch) number, a six-digit number that identifies banks and branches across Australia
<ACCNO>
<ABN> - your Australian Business Number
<ACN> - your Australian Company Number
<welcome_letter>
<auto_occ_consumption>
<auto_occ_threshold>
<res_low_consumption>
<res_high_consumption>
<bus_low_consumption>
<bus_high_consumption>
<stratapay>
<GSTNO> - your New Zealand Goods and Services Tax Number
<Phone> - your phone number
<website> - your website url
<email> - your email address
<building_manager>
<building_phone>
<UDS>
<AllowSMS>
<apply_movein_charge>
<apply_moveout_charge>

Warning: This is a maintenance menu item. Please ensure you are familiar with Utilmate and understand the impacts of making changes to Maintenance menu items.