Short description of Data Post Office

Data Post Office serves as a general data receiver, which means that anyone providing data to Min Bolig (My Home), Se Elforbrug (View Electricity Consumption) or other equivalent systems, via the Web service of the Danish Electricity Saving Trust to data recipients, will supply data to this location.

In order to be able send data to the Data Post Office, senders must use a Web service in which the data string itself, some provider information and a reference number must be stated (see Description of data format).

The reference number should be unique, which means that companies generating such a number should compile it from the following constituent parts: a country code, CVR (VAT) registration number and HouseControl ID, e.g. DNK-21318671-1234567890.

The HouseControl ID should preferably not be a GUID, such as e.g. e99e6e2a-0a10-4797-83d4-ad3cdcc26d53, because this can be very difficult to key in. A HouseControl ID in this format should therefore be replaced by a code consisting entirely of numbers, while still being unique.
In respect of, for example, a reference number from viaSENS, the HouseControl ID and data logger ID will typically be identical inasmuch as these do not operate with a HouseControlID.

A reference number is one which must be displayed and provided directly to the user via a label on, for example, the viaSens box from Seluxit, or on the homepage on which the user requests to have data sent to the Data Post Office. In respect of the latter, this will mean that the data provider must present the reference number directly and clearly on the screen, along with information that this is the number to be utilised by users on the homepage where the data will ultimately reside.

On the homepage where the data will be used there must be a heading explaining to the user that, if they have ordered data from a data provider, they must supply a reference number here and click on ‘download’. Thereafter, all the meter sessions with this reference number will be associated with this particular user and homepage. Each night, all data with this reference number will be automatically downloaded from the Data Post Office.

Special IMPORTANT information regarding integration with My Home (Min Bolig):
As described above the data is submitted by the webservice with the following parameters:

data_str, ThreeDigitProducerCountryCode, ProducerRegistrationNumber_CVR, HouseControlID, UniqueReferenceNumber, ThreeDigitDataSenderCountryCode

It's IMPORTANT that the HouseControlID is the ID of the master delivering the data. This master ID is a unique ID and is the same Master ID users use to identify their master in My Home at the Automation setup page.

The data_str XML document contains a number of child nodes to the node <NewDataset>, for My Home it's important that the following two nodes are filled out.

• The node <LoggerDevice_ID> should be set to the specific physical device ID as in the device list sent from the master to My Home. Like <LoggerDevice _ID>2</LoggerDevice_ID>
• The node <LoggerUnit_ID> should be set to the specific log ID in the physical device as in the device list sent from the master to My Home. A physical device can contain more than one logger, like a switch that logs Temperature and power consumption, or a power unit that logs multiple power outlets. Like <LoggerUnit_ID>zwave_11</LoggerUnit_ID>.

Description of Web service
The Web services that should be used to send data to the Data Post Office are shown here:

The first returns the address to the location to which the data must be sent (making the system scalable)
http://www.webservice.sparel.dk/getdatapostofficeip_webservice_V1
/getdatapostofficeip_webservice.asmx

This contains the following functions:
ReturnString = getuploadip(“”) (parameter in the function which are of type string should only be ””)

ReturnString from function is therefore the address which links to the Web service which saves the data.

ReturnString =
http://www.webservice.sparel.dk/datapostoffice_webservice_V1/datapostoffice_
webservice.asmx

with the following function:

ReturnString =
senddata(ByVal data_str As String,
ByVal ThreeDigitProducerCountryCode As String,
ByVal ProducerRegistrationNumber_CVR As String,
ByVal HouseControlID As String,
ByVal UniqueReferenceNumber As String,
ByVal ThreeDigitDataSenderCountryCode As String) As String

Return string from the function senddata can contain the following:

For more information about the data format read the Data Post Office Documentation

Data format example for version 3

<Format_version>3</Format_version>
<NewDataset>
<Logger_ID>600000034</Logger_ID><IsHeadmeter>?</IsHeadmeter>
<LoggerDevice_ID>2</LoggerDevice_ID><LoggerUnit_ID> zwave_11</LoggerUnit_ID>
<Logger_Producer>Producer Name</Logger_Producer><Logger_Model>Model xyz 10</Logger_Model>
<Logger_Version>ver 1.2</Logger_Version>
<DataDeliveredVia>-1</DataDeliveredVia>
<C-factor>1.0</C-factor>
<Room_ID>4</Room_ID><Device_ID>2</Device_ID>
<Date_time_format_string>dd-MM-yyyy HH:mm:ss</Date_time_format_string>
<DateAndTimeStamp_Indicator>0</DateAndTimeStamp_Indicator>
<RegistrationType>1</RegistrationType>
<MeteringType>1</MeteringType><Decade_prefix>1</Decade_prefix><Unit>1</Unit>
<Free_text_string>This is the first test</Free_text_string>
<IsInstantaneousValues>No</IsInstantaneousValues>
<Integration_period_in_minutes>15</Integration_period_in_minutes>
<MeterValues>
<DateAndTime>01-05-2007 09:00:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 09:15:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 09:30:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 09:45:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 10:00:00</DateAndTime><Value>28.3</Value>
<DateAndTime>01-05-2007 10:15:00</DateAndTime><Value>29.4</Value>
<DateAndTime>01-05-2007 10:30:00</DateAndTime><Value>28.2</Value>
</MeterValues>
</NewDataset>
<NewDataset>
<Logger ID>600000035</Logger_ID><IsHeadmeter>?</IsHeadmeter>
<DataDeliveredVia>-1</DataDeliveredVia>
<C-factor>1.0</C-factor>
<Room_ID>4</Room_ID><Device_ID>3</Device_ID>
<Date_time_format_string>dd-MM-yyyy HH:mm:ss</Date_time_format_string>
<RegistrationType>1</RegistrationType>
<MeteringType>1</MeteringType><Decade_prefix>1</Decade_prefix><Unit>1</Unit>
<Free_text_string>This is the second test</Free_text_string>
<Integration_period_in_minutes>15</Integration_period_in_minutes>
<MeterValues>
<DateAndTime>01-05-2007 10:00:00</DateAndTime><Value>26.2</Value>
<DateAndTime>01-05-2007 10:15:00</DateAndTime><Value>26.3</Value>
<DateAndTime>01-05-2007 10:30:00</DateAndTime><Value>27.1</Value>
<DateAndTime>01-05-2007 10:45:00</DateAndTime><Value>28.2</Value>
</MeterValues>
</NewDataset>