Watermeter process
Die Aargauer Verwaltungsreformatoren
Watermeter process – getting started
Introducation
Water meter process allows real estate owner or tenant to update the water meter reading into the system which reports the new water meter counter back to the municipality.
Prerequisites
- Sign up for a developer account (If you already signed up, sign in here)
- Get subscription key from sign up account
- Register Application
- 3rd party software or webservice available to receive API calls
Business case description
The municipality starts the process by give a notice to the affected Subscriber of this process. Then, either the real estate owner or tenant, report the current value of the watermeter counter via the Smart Service Portal. The subscriber first enters:
- the water meter number
- location of the building (address)
- if they are reporting as therole of an owner or of a tenant
As they confirm the named entries, they can report the current water meter readings into the system. After submitting, the system connects the account of the subscriber (who registered before) with the new values of the watermeter reading. Then the system checks the values for rules predefined by the municipality (e.g.deviation from the last year of +/- 10%). If the rules match, the values will be directed to the 3rd party software.
If there is a deviation, the municipality checks the entry an either start further clarification or submits the checked values to the 3rd party software where the values will be used for billing.
Sequence Diagram
.jpg)
Start / Passing water meter tasks to Fit4Digital
In this step, the Fit4Digital platformscreates an event wm.initiated.
The event will be created when the municipality kicks off the process in the Fit4Digital cockpit to start collecting water meter readings.
How to integrate an wm.initiated event
- Configure a webhook for the wm.initiated event.
- Find the API to create,retrieve and update webhooks here.
- Available variable:
- mandat
- fakturaprofil
- periodebisdatum
- When the system creates the event wm.initiated, the above webhook will be executed
- In the response to the webhook API call, the requested water meter data can be passed back.
- Find more information about the call back here.
- The response should be in thefollowing JSON format:
[
{
"ablesedatum":"31.10.2017",
"aboNummer":188,
"anzahlStellen":5,
"apparateNr":203,
"fabrikationsNummer":"925088",
"mandant":1,
"nameKunde":"Muster Josef",
"objektBezeichnung":"Einfamilienhaus:Rankgasse 15,ZufikonAG",
"ortschaftKunde":"5621 Zufikon",
"standAlt":2277.0,
"standNeu":0.0,
"strasseKunde":"Rankgasse 16",
"vorjahresVerbrauch":150.0,
"werkNummer":"201"
},
{
"ablesedatum":"31.10.2017",
"aboNummer":189,
"anzahlStellen":5,
"apparateNr":204,
"fabrikationsNummer":"925089",
"mandant":1,
"nameKunde":"Muster Peter",
"objektBezeichnung":"Einfamilienhaus:Rankgasse 15,Zufikon AG",
"ortschaftKunde":"5621 Zufikon",
"standAlt":2262.0,
"standNeu":0.0,
"strasseKunde":"Rankgasse 15",
"vorjahresVerbrauch":129.0,
"werkNummer":"202"
}
]
The submissions are successful when the clientis displayed with the water meter task. The client will be required to enter the new water clock counter value and submit the input.
Receiving new water meter values
After the client has entered the new watermeter reading values and submitted it from the portal to the Fit4Digital platform, the Fit4Digital will perform some rules checking defined by the municipality and, if necessary, invoke a workflow to get approval.
Once the process is completed, theFit4Digital platform creates an event wm.readresult.
How to integrate for a wm.readresult event:
- Configure a webhook for the mo.ordernew event.
- Find the API to create,retrieve and update webhooks here.
- Available variables:
- ablesedatum
- mandat
- abonummer
- apparatenr
- standneu
- When the system creates the event wm.readresult, the above webhook will be executed
- Find more information about thecall back here
- The response expected:
- None
