Skip to main content
Version: 2.2.1

insertMeterReading

This method allows adding:

  • Asset meter readings.

To insert each of these items, it is necessary to follow the standard documented below.

Java class
RequestInsertMeterReadingRequestType.java
ReturnInsertMeterReadingResponseType.java

Request:

ID #RequiredDescription
idobjectXAsset ID #.
fgactionXAction. List of options:
1 - New meter reading
2 - New meter restart
vlreadvalueReading value.
Use point as decimal separator and do not used thousands separator, for example “16000.000”.
dtreaddateMeter reading date, in the format mm/dd/YYYY.
If empty, it will consider the date and time of the import service.
qthrreadMeter reading time, in the format hh:mm (00:00 - 23:59). If empty, it will consider the date and time of the import service.
info
  • X¹ - Required if the action is New meter reading. Not required if the action is New meter restart.
  • X² - Required if the reading date is filled out.

Request structure:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:maintenance">
<soapenv:Header/>
<soapenv:Body>
<urn:insertMeterReading>
<!--You may enter the following 5 items in any order-->
<urn:idobject>?</urn:idobject>
<urn:fgaction>?</urn:fgaction>
<urn:vlreadvalue>?</urn:vlreadvalue>
<urn:dtreaddate>?</urn:dtreaddate>
<urn:qthrread>?</urn:qthrread>
</urn:insertMeterReading>
</soapenv:Body>
</soapenv:Envelope>

Return:

ID #Description
returnSUCCESS: 1.
FAILURE: Message detailing the error.