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 | |
|---|---|
| Request | InsertMeterReadingRequestType.java |
| Return | InsertMeterReadingResponseType.java |
Request:
| ID # | Required | Description |
|---|---|---|
| idobject | X | Asset ID #. |
| fgaction | X | Action. List of options: 1 - New meter reading 2 - New meter restart |
| vlreadvalue | X¹ | Reading value. Use point as decimal separator and do not used thousands separator, for example “16000.000”. |
| dtreaddate | Meter reading date, in the format mm/dd/YYYY. If empty, it will consider the date and time of the import service. | |
| qthrread | X² | Meter 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 |
|---|---|
| return | SUCCESS: 1. FAILURE: Message detailing the error. |