Web Service Documentation / Categories / Meter Services / Add Waste Data

Add Waste Data

Updated on August 8, 2016

Description

This web service adds waste data to a specific meter based on the information provided in the XML request. It returns the unique identifier to each waste data entry. The meter must already be shared with you and you must have write access to the meter. A maximum of 120 waste data records is allowed.

Version

22.0

HTTP Method

POST

Resource URL

/meter/(meterId)/wasteData

Header

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

Authorization Required

Yes

Parameters

Parameter Name Description
meterId Id to the meter

XML Schemas

Request/Response Schema Name
Request wasteData.xsd
Response wasteData.xsd

Example Request

The following example adds waste data to a regularly collected waste (disposed) meter that has an id of 500.

POST  /meter/500/wasteData

<?xml version="1.0" encoding="UTF-8"?>
<wasteDataList>
    <wasteData estimatedValue="true">
        <startDate>2013-01-01</startDate>
        <endDate>2013-01-31</endDate>
        <quantity>50</quantity>
        <cost>100</cost>
        <disposalDestination>
            <incinerationPercentage>25</incinerationPercentage>
            <landfillPercentage>25</landfillPercentage>
            <unknownDestPercentage>25</unknownDestPercentage>
            <wasteToEnergyPercentage>25</wasteToEnergyPercentage>
        </disposalDestination>
    </wasteData>
</wasteDataList>

Example Response

The following example indicates that the consumption data was successfully added to the meter and this utility bill has an id of 745.

<?xml version="1.0" encoding="UTF-8"?>
<wasteDataList>
    <wasteData estimatedValue="true">
        <audit>
            <createdBy>ACME</createdBy>
            <createdDate>2016-06-02T15:08:52.663-04:00</createdDate>
            <lastUpdatedBy>ACME</lastUpdatedBy>
            <lastUpdatedDate>2016-06-02T15:08:52.663-04:00</lastUpdatedDate>
        </audit>
        <id>783569362</id>
        <startDate>2013-01-01</startDate>
        <endDate>2013-01-31</endDate>
        <quantity>50</quantity>
        <cost>100</cost>
        <disposalDestination>
            <incinerationPercentage>25</incinerationPercentage>
            <landfillPercentage>25</landfillPercentage>
            <unknownDestPercentage>25</unknownDestPercentage>
            <wasteToEnergyPercentage>25</wasteToEnergyPercentage>
        </disposalDestination>
    </wasteData>
</wasteDataList>
LIVE