MACO APP DOCS
  1. API Docs
MACO APP DOCS
  • Kundendokumentation
    • Oracle
      • API Docs
        • Overview
        • Error codes
        • Changelog Interfaces
        • Business Objects
        • Integration Layer
        • Trigger Events (MACO APP)
          • Role Supplier (LF)
            • Start of delivery
        • Read BO4E (Backend)
          • Get Communication Data
          • Get Meter
          • Get Tranche
          • Get Technical Resource
          • Get Controllable Resource
          • Get Grid Usage Contract
          • Get Grid Location
          • Get Metering Point Operation Contract
          • Get Meter Location
          • Get Market Location
          • Get Location Bundle
          • Get Meter Readings
          • Get The Load Profile
          • Get Energy Amount
          • Get Energy Supply Contract
          • Get Balance Sheet
          • Get CalculationFormula
          • Get Avis
        • Read Process Data (Backend)
          • Get Allocation Authorization
        • Write Process Data LF (Backend)
          • Create Process Data
          • Update Process Data
      • Process Docs
        • Supplier
          • Start of delivery (Role supplier new)
            • Process overview
  1. API Docs

Business Objects

Overview of Business Objects#

Business Objects 4 Energy
Business Objects 4 Energy is an initiative aiming at more flexible and tailored business process design, while promoting the standardization of information flow between individual process steps.
The goal is to establish a new communication standard called “Business Objects for Energy (BO4E)”.
CONUTI is a member of this initiative and uses BO4E as the data model within the MACO APP.

Important BO4E Business Objects#

Market Location (Marktlokation)#

A Market Location (Marktlokation, MaLo) represents the commercial point of delivery or injection, identified by an 11-digit MaLo ID.
It is the anchor for contracts and billing. Each MaLo typically links to one or more Metering Locations (MeLo).
Attributes include division (electricity/gas), energy direction (consumption/injection), balancing method (RLM/SLP), consumption type, and responsible DSO codes.
In market communication, the MaLo ID is central to switching, billing, and master data exchanges.

Metering Location (Messlokation)#

A Metering Location (Messlokation, MeLo) is the technical point where energy is measured, identified by an 11-digit MeLo ID.
It contains technical details such as grid level, responsible metering service providers (MSB, MDL), and the installed meters.
Each MeLo belongs to exactly one MaLo, and it may host one or multiple Meters (Zähler).
In communication, the MeLo ID is used in meter reading messages, switching confirmations, and metering responsibility processes.

Network Location (Netzlokation)#

A Network Location represents a grid connection point (e.g. transformer station, grid node).
It is identified by a Netzlokations-ID and connects one or more market locations to the higher-level grid.
Network locations are relevant for DSOs to manage infrastructure and are referenced in market processes for grid connection and grid usage agreements.

Meter (Zähler)#

The Meter object represents the physical device used to record energy consumption or production.
It has a unique meter number, type (e.g. smart meter, dual-tariff meter), calibration data, and may support multiple registers.
Meters are linked via the Messlokation’s list of installed devices.
In market processes, meter data is exchanged during meter installation/removal, switching, or when reporting readings.

Balancing (Bilanzierung)#

Balancing describes how energy volumes at a location are accounted for in the market.
The main distinction is between SLP (Standard Load Profile) customers and RLM (interval metered) customers.
Balancing methods determine how consumption data is aggregated and settled in the balancing group.
In communication, the balancing method is always indicated for each MaLo and drives settlement processes.

Location Bundle (Lokationsbündel)#

A Location Bundle groups multiple market or metering locations under a single framework, often for industrial or corporate customers.
It allows multiple delivery points to be managed in one contractual context.
In communication, bundles are used for reporting aggregated data, consolidated billing, or special framework agreements.

Contract (Vertrag) – Energy Supply Contract#

An Energy Supply Contract (Energieliefervertrag) links a supplier with a customer for the delivery of energy to one or more market locations.
Key fields include contract number, type, validity period (valid from/to), partners (supplier and customer), and the contract parts referencing MaLo or MeLo.
In market processes, supply contracts are implicitly created and ended during supplier switching, and their validity defines delivery responsibilities.

Contract (Vertrag) – Network Usage Contract#

A Network Usage Contract (Netznutzungsvertrag) is the agreement between a DSO and a supplier for using the distribution network to deliver energy to MaLos.
It includes contract identifiers, partners (DSO and supplier), validity periods, and the covered MaLos.
These contracts underpin the billing of network charges and are reflected in Netznutzungsrechnungen exchanged between DSOs and suppliers.

Contract (Vertrag) – Metering Service Contract#

A Metering Service Contract (Messstellenbetriebvertrag) defines the relationship between the customer (or sometimes supplier) and the Metering Point Operator (MSB).
It covers installation, operation, and maintenance of meters at MeLos.
Validity periods indicate when the MSB responsibility starts and ends.
In communication, these contracts are referenced when switching MSB responsibility or when confirming metering service details.
Netzlokation → Marktlokation (“connects”)
A network location connects multiple market locations to the physical distribution grid.
Lokationsbündel → Marktlokation (“groups”)
A location bundle groups several market locations into one framework, often for corporate customers.
Marktlokation → Messlokation (“references”)
A market location references its associated metering locations, linking commercial and technical perspectives.
Messlokation → Zähler (“contains”)
A metering location contains the installed meters that physically record consumption or generation.
Marktlokation → Bilanzierung (“balances”)
A market location defines its balancing method (e.g., SLP or RLM) for settlement in the balancing group.
Marktlokation → Energieliefervertrag (“coveredBy”)
A market location is covered by an energy supply contract between supplier and customer.
Marktlokation → Netznutzungsvertrag (“coveredBy”)
A market location is subject to a network usage contract between supplier and DSO.
Messlokation → Messstellenbetriebsvertrag (“coveredBy”)
A metering location is operated under a metering service contract with the MSB.
Marktlokation → Marktteilnehmer (“assignedTo”)
A market location is assigned to one or more market participants (e.g. supplier, DSO, BKV). Each assignment carries a role type (marktrolle), an official identifier (rollencodenummer), and a validity period (gueltigkeitszeitraum).
Messlokation → Marktteilnehmer (“assignedTo”)
A metering location is assigned to one or more market participants (e.g. MSB, MDL). Each assignment carries a role type (marktrolle), an official identifier (rollencodenummer), and a validity period (gueltigkeitszeitraum).

All available business objects:#

AdHocSteuerkanal (Ad-hoc Control Channel)
Anfrage (Request)
Angebot (Offer)
Ansprechpartner (Contact Person)
Auftrag (Order)
Avis (Advice/Notification)
Berechnungsformel (Calculation Formula)
Bilanzierung (Balancing)
Bilanzkreis (Balancing Group)
Energiemenge (Energy Quantity / Meter Reading)
Geschaeftspartner (Business Partner)
Handelsunstimmigkeit (Commercial Dispute)
Kommunikationsdaten (Communication Data)
Leistungskurvendefinition (Load Curve Definition)
Lokationsbuendel (Location Bundle)
Marktlokation (Market Location)
Marktteilnehmer (Market Participant)
Messlokation (Metering Location)
Netzlokation (Grid Location)
Preisblatt (Price Sheet)
Rechnung (Invoice)
Reklamation (Complaint)
Schaltzeitdefinition (Switching Time Definition)
Sperrauftrag (Blocking Order)
Statusbericht (Status Report)
Statusmitteilung (Status Notification)
SteuerbareRessource (Controllable Resource)
Tarifinfo (Tariff Information)
TechnischeRessource (Technical Resource)
Tranche (Tranche/Batch)
Vertrag (Contract)
Verwendungszeitraum (Usage Period)
WerteNachTyp2 (Values by Type 2)
Zaehler (Meter)
Zaehlzeitdefinition (Metering Time Definition)
Modified at 2025-09-22 12:25:12
Previous
Changelog Interfaces
Next
Integration Layer
Built with