Skip to main content

UDE v1 Energy extension

Version: Process description SALES005 v1.0

1 The process.​

The energy extension provides the ability to send and receive additional information regarding energy in the DICO invoice message. The extension is functionally an exact copy of the UBL energy invoice. This way, a mapping can easily be made.

In most cases, the energy supplier sends the invoice to parties in the construction and engineering sector. via the extension, energy data can be delivered and processed in a structured way.

Published extensions within EnergyUDE:

  • XML structure EnergyUDE in the Invoice message

2 UDE Structure​

2.1 EnergyUDE in the Invoice Message​

The location of the extension within the invoice message is at the InvoiceLine level, xpath is: Invoice/InvoiceLine/UserDefinedExtension

<UserDefinedExtension xmlns:energy="https://ontology.ketenstandaard.nl/DICO/UDE/Energy/v1"
  xsi:schemaLocation="https://ontology.ketenstandaard.nl/DICO/UDE/Energy/v1 EnergyUDEv1.xsd">
  <energy:EnergyUDE>
    <energy:UtilityConsumptionPoint>
      <energy:UtilityConsumptionPointID> </energy:UtilityConsumptionPointID>
      <energy:EBCluster>
        <energy:Cluster>
          <energy:ClusterID> </energy:ClusterID>
          <energy:StartDate> </energy:StartDate>
          <energy:EndDate> </energy:EndDate>
        </energy:Cluster>
      </energy:EBCluster>
      <energy:UtilityConsumptionpointAddress>
        <energy:GLN> </energy:GLN>
        <energy:Name> </energy:Name>
        <energy:Name2> </energy:Name2>
        <energy:Street> </energy:Street>
        <energy:HouseNumber> </energy:HouseNumber>
        <energy:HouseLetter> </energy:HouseLetter>
        <energy:HouseNumberSuffix> </energy:HouseNumberSuffix>
        <energy:City> </energy:City>
        <energy:PostalCode> </energy:PostalCode>
        <energy:Country> </energy:Country>
      </energy:UtilityConsumptionpointAddress>
      <energy:UtilityMeter>
        <energy:MeterNumber> </energy:MeterNumber>
        <energy:MeterConstant> </energy:MeterConstant>
        <energy:MeterReading>
          <energy:MeterReadingTypeCode> </energy:MeterReadingTypeCode>
          <energy:PreviousMeterReadingDate> </energy:PreviousMeterReadingDate>
          <energy:PreviousMeterQuantity> </energy:PreviousMeterQuantity>
          <energy:PreviousMeterQuantityUoM> </energy:PreviousMeterQuantityUoM>
          <energy:LatestMeterReadingDate> </energy:LatestMeterReadingDate>
          <energy:LatestMeterQuantity> </energy:LatestMeterQuantity>
          <energy:LatestMeterQuantityUoM> </energy:LatestMeterQuantityUoM>
          <energy:PreviousMeterReadingMethodCode> </energy:PreviousMeterReadingMethodCode>
          <energy:LatestMeterReadingMethodCode> </energy:LatestMeterReadingMethodCode>
          <energy:ConsumptionQuantity> </energy:ConsumptionQuantity>
          <energy:ConsumptionQuantityUoM> </energy:ConsumptionQuantityUoM>
          <energy:CorrectedConsumptionQuantity> </energy:CorrectedConsumptionQuantity>
          <energy:CorrectedConsumptionQuantityUoM> </energy:CorrectedConsumptionQuantityUoM>
          <energy:MeterReadingComments> </energy:MeterReadingComments>
          <energy:FuelMix>
            <energy:FuelType>
              <energy:FuelTypeCode> </energy:FuelTypeCode>
              <energy:FuelTypeName> </energy:FuelTypeName>
              <energy:FuelTypePercentage> </energy:FuelTypePercentage>
            </energy:FuelType>
          </energy:FuelMix>
        </energy:MeterReading>
      </energy:UtilityMeter>
    </energy:UtilityConsumptionPoint>
  </energy:EnergyUDE>
</UserDefinedExtension>