Web Service Documentation / Categories / Meter Services / Edit Meter Consumption Data

Edit Meter Consumption Data

Updated on August 14, 2017

Description

This web service updates a specific meter consumption data record based on the information provided in the XML request. The corresponding meter must already be shared with you and you must have write access to the meter.

Version

9.0

HTTP Method

PUT

Resource URL

/consumptionData/(consumptionDataId)

Header

Field Name Value Comments
Authorization Basic credentials
Content-Type application/xml

Authorization Required

Yes

Parameters

Parameter Name Description
consumptionDataId Id to the meter consumption data

XML Schemas

Request/Response Schema Name
Request meterConsumptionData.xsd
Response response.xsd

Example Requests

The following example updates an existing meter consumption data record that has an id of 711.

PUT  /consumptionData/711

<meterConsumption> <usage>12345</usage> <startDate>2011-01-01</startDate> <endDate>2011-01-31</endDate> </meterConsumption>

The following example updates an existing meter consumption with Green Power. To remove Green Power from an existing consumption record, just omit the Green Power data from the XML.

PUT  /consumptionData/712

<meterConsumption estimatedValue="false"> <usage>1000</usage> <startDate>2010-03-15</startDate> <endDate>2010-04-14</endDate> <greenPower> <generationLocation> <generationPlant>56859</generationPlant> </generationLocation> <sources> <solarPct>20.0</solarPct> <windPct>20.0</windPct> <geothermalPct>20.0</geothermalPct> <smallHydroPct>20.0</smallHydroPct> <biomassPct>0.0</biomassPct> <biogasPct>20.0</biogasPct> </sources> <value>99</value> </greenPower> </meterConsumption>

The following example updates an existing meter consumption with demand data. To remove demand data from an existing consumption record, just omit the demand data from the XML. Demand data only applies to electric grid-purchase meters.

PUT  /consumptionData/713

<meterConsumption estimatedValue="false"> <usage>1000</usage> <startDate>2010-03-15</startDate> <endDate>2010-04-14</endDate> <demandTracking> <demand>99</demand> <demandCost>5859</demandCost> </demandTracking> </meterConsumption>

Example Response

The following example indicates that the meter consumption data was updated successfully.

<response status="Ok">
    <id>711</id>
    <links>
        <link httpMethod="GET" link="/meter/1/consumptionData"
              linkDescription="This is the GET url for this Meter Consumption Data."/>
    </links>
</response>
LIVE