bo4e.com package

Submodules

bo4e.com.adresse module

Contains Adresse class and corresponding marshmallow schema for de-/serialization

Bases: COM

Contains an address that can be used for most purposes.

Hint

Adresse JSON Schema

adresszusatz: str | None: Zusatzhinweis zum Auffinden der Adresse, z.B. “3. Stock linke Wohnung”

co_ergaenzung: str | None: Im Falle einer c/o-Adresse steht in diesem Attribut die Anrede. Z.B. “c/o Veronica Hauptmieterin”

hausnummer: str | None: Hausnummer inkl. Zusatz; z.B. “3”, “4a”

landescode: Landescode | None: Offizieller ISO-Landescode

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

ort: str | None: Bezeichnung der Stadt; z.B. “Hückelhoven”

ortsteil: str | None: Bezeichnung des Ortsteils; z.B. “Mitte”

postfach: str | None: Im Falle einer Postfachadresse das Postfach; Damit werden Straße und Hausnummer nicht berücksichtigt

postleitzahl: str | None

“41836”

Type:: Die Postleitzahl; z.B

strasse: str | None: Bezeichnung der Straße; z.B. “Weserstraße”

bo4e.com.angebotsposition module

Contains Angebotsposition class and corresponding marshmallow schema for de-/serialization

class bo4e.com.angebotsposition.Angebotsposition(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, positionsbezeichnung: str | None = None, positionspreis: Preis | None = None, positionsmenge: Menge | None = None, positionskosten: Betrag | None = None, **extra_data: Any)[source]

Bases: COM

Unterhalb von Angebotsteilen sind die Angebotspositionen eingebunden. Hier werden die angebotenen Bestandteile einzeln aufgeführt. Beispiel: Positionsmenge: 4000 kWh Positionspreis: 24,56 ct/kWh Positionskosten: 982,40 EUR

Hint

Angebotsposition JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

positionsbezeichnung: str | None: Bezeichnung der jeweiligen Position des Angebotsteils

positionskosten: Betrag | None: Kosten (positionspreis * positionsmenge) für diese Angebotsposition

positionsmenge: Menge | None: Menge des angebotenen Artikels (z.B. Wirkarbeit in kWh), in dieser Angebotsposition

positionspreis: Preis | None: Preis pro Einheit/Stückpreis des angebotenen Artikels.

bo4e.com.angebotsteil module

Contains Angebotsteil class and corresponding marshmallow schema for de-/serialization

class bo4e.com.angebotsteil.Angebotsteil(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, positionen: list[Angebotsposition] | None = None, anfrageSubreferenz: str | None = None, lieferstellenangebotsteil: list[Marktlokation] | None = None, gesamtmengeangebotsteil: Menge | None = None, gesamtkostenangebotsteil: Betrag | None = None, lieferzeitraum: Zeitraum | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente wird ein Teil einer Angebotsvariante abgebildet. Hier werden alle Angebotspositionen aggregiert. Angebotsteile werden im einfachsten Fall für eine Marktlokation oder Lieferstellenadresse erzeugt. Hier werden die Mengen und Gesamtkosten aller Angebotspositionen zusammengefasst. Eine Variante besteht mindestens aus einem Angebotsteil.

Hint

Angebotsteil JSON Schema

anfrage_subreferenz: str | None: Identifizierung eines Subkapitels einer Anfrage, beispielsweise das Los einer Ausschreibung

gesamtkostenangebotsteil: Betrag | None: Summe der Jahresenergiekosten aller in diesem Angebotsteil enthaltenen Lieferstellen

gesamtmengeangebotsteil: Menge | None: Summe der Verbräuche aller in diesem Angebotsteil eingeschlossenen Lieferstellen

lieferstellenangebotsteil: list[Marktlokation] | None: Marktlokationen, für die dieses Angebotsteil gilt, falls vorhanden. Durch die Marktlokation ist auch die Lieferadresse festgelegt

lieferzeitraum: Zeitraum | None: Hier kann der Belieferungszeitraum angegeben werden, für den dieser Angebotsteil gilt

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

positionen: list[Angebotsposition] | None: Einzelne Positionen, die zu diesem Angebotsteil gehören

bo4e.com.angebotsvariante module

Contains Angebotsvariante and corresponding marshmallow schema for de-/serialization

class bo4e.com.angebotsvariante.Angebotsvariante(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, angebotsstatus: Angebotsstatus | None = None, erstellungsdatum: AwareDatetime | None = None, bindefrist: AwareDatetime | None = None, teile: list[Angebotsteil] | None = None, gesamtmenge: Menge | None = None, gesamtkosten: Betrag | None = None, **extra_data: Any)[source]

Bases: COM

Führt die verschiedenen Ausprägungen der Angebotsberechnung auf

Hint

Angebotsvariante JSON Schema

angebotsstatus: Angebotsstatus | None: Gibt den Status eines Angebotes an.

bindefrist: AwareDatetime | None: Bis zu diesem Zeitpunkt gilt die Angebotsvariante

erstellungsdatum: AwareDatetime | None: Datum der Erstellung der Angebotsvariante

gesamtkosten: Betrag | None: Aufsummierte Kosten aller Angebotsteile

gesamtmenge: Menge | None: Aufsummierte Wirkarbeitsmenge aller Angebotsteile

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

teile: list[Angebotsteil] | None: Angebotsteile werden im einfachsten Fall für eine Marktlokation oder Lieferstellenadresse erzeugt. Hier werden die Mengen und Gesamtkosten aller Angebotspositionen zusammengefasst. Eine Variante besteht mindestens aus einem Angebotsteil.

bo4e.com.aufabschlag module

Contains AufAbschlag class and corresponding marshmallow schema for de-/serialization

class bo4e.com.aufabschlag.AufAbschlag(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, bezeichnung: str | None = None, staffeln: list[Preisstaffel] | None = None, beschreibung: str | None = None, aufAbschlagstyp: AufAbschlagstyp | None = None, aufAbschlagsziel: AufAbschlagsziel | None = None, einheit: Waehrungseinheit | None = None, website: str | None = None, gueltigkeitszeitraum: Zeitraum | None = None, **extra_data: Any)[source]

Bases: COM

Modell für die preiserhöhenden (Aufschlag) bzw. preisvermindernden (Abschlag) Zusatzvereinbarungen, die individuell zu einem neuen oder bestehenden Liefervertrag abgeschlossen wurden.

Hint

AufAbschlag JSON Schema

auf_abschlagstyp: AufAbschlagstyp | None: Typ des Aufabschlages (z.B. absolut oder prozentual).

auf_abschlagsziel: AufAbschlagsziel | None: Diesem Preis oder den Kosten ist der Auf/Abschlag zugeordnet. Z.B. Arbeitspreis, Gesamtpreis etc..

beschreibung: str | None: Beschreibung zum Auf-/Abschlag

bezeichnung: str | None: Bezeichnung des Auf-/Abschlags

einheit: Waehrungseinheit | None: Gibt an in welcher Währungseinheit der Auf/Abschlag berechnet wird. Euro oder Ct.. (Nur im Falle absoluter Aufschlagstypen).

gueltigkeitszeitraum: Zeitraum | None: Internetseite, auf der die Informationen zum Auf-/Abschlag veröffentlicht sind.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

staffeln: list[Preisstaffel] | None: Werte für die gestaffelten Auf/Abschläge.

website: str | None: Internetseite, auf der die Informationen zum Auf-/Abschlag veröffentlicht sind.

bo4e.com.aufabschlagproort module

Contains AufAbschlagProOrt class and corresponding marshmallow schema for de-/serialization

class bo4e.com.aufabschlagproort.AufAbschlagProOrt(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, postleitzahl: str | None = None, ort: str | None = None, netznr: str | None = None, staffeln: list[AufAbschlagstaffelProOrt] | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können Auf- und Abschläge verschiedener Typen im Zusammenhang mit örtlichen Gültigkeiten abgebildet werden.

Hint

AufAbschlagProOrt JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

netznr: str | None: Die ene’t-Netznummer des Netzes in dem der Aufschlag gilt.

ort: str | None: Der Ort für den der Aufschlag gilt.

postleitzahl: str | None: Die Postleitzahl des Ortes für den der Aufschlag gilt.

staffeln: list[AufAbschlagstaffelProOrt] | None: Werte für die gestaffelten Auf/Abschläge mit regionaler Eingrenzung.

bo4e.com.aufabschlagregional module

Contains AufAbschlagRegional and corresponding marshmallow schema for de-/serialization

class bo4e.com.aufabschlagregional.AufAbschlagRegional(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, bezeichnung: str | None = None, betraege: list[AufAbschlagProOrt] | None = None, beschreibung: str | None = None, aufAbschlagstyp: AufAbschlagstyp | None = None, aufAbschlagsziel: AufAbschlagsziel | None = None, einheit: Waehrungseinheit | None = None, website: str | None = None, zusatzprodukte: list[str] | None = None, voraussetzungen: list[str] | None = None, tarifnamensaenderungen: str | None = None, gueltigkeitszeitraum: Zeitraum | None = None, energiemixaenderung: Energiemix | None = None, vertagskonditionsaenderung: Vertragskonditionen | None = None, garantieaenderung: Preisgarantie | None = None, einschraenkungsaenderung: Tarifeinschraenkung | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können Auf- und Abschläge verschiedener Typen im Zusammenhang mit regionalen Gültigkeiten abgebildet werden. Hier sind auch die Auswirkungen auf verschiedene Tarifparameter modelliert, die sich durch die Auswahl eines Auf- oder Abschlags ergeben.

Hint

AufAbschlagRegional JSON Schema

auf_abschlagstyp: AufAbschlagstyp | None: Typ des Aufabschlages (z.B. absolut oder prozentual)

auf_abschlagsziel: AufAbschlagsziel | None: Diesem Preis oder den Kosten ist der Auf/Abschlag zugeordnet. Z.B. Arbeitspreis, Gesamtpreis etc.

beschreibung: str | None: Beschreibung zum Auf-/Abschlag

betraege: list[AufAbschlagProOrt] | None: Werte für die gestaffelten Auf/Abschläge mit regionaler Eingrenzung

bezeichnung: str | None: Bezeichnung des Auf-/Abschlags

einheit: Waehrungseinheit | None: Gibt an in welcher Währungseinheit der Auf/Abschlag berechnet wird. Euro oder Ct.

einschraenkungsaenderung: Tarifeinschraenkung | None: Änderungen in den Einschränkungen zum Tarif. Falls in dieser Komponenten angegeben, werden die Tarifparameter hiermit überschrieben.

energiemixaenderung: Energiemix | None: Der Energiemix kann sich durch einen AufAbschlag ändern (z.B. zwei Cent Aufschlag für Ökostrom: Sollte dies der Fall sein, wird hier die neue Zusammensetzung des Energiemix angegeben.

garantieaenderung: Preisgarantie | None: Änderungen in den Garantievereinbarungen. Falls in dieser Komponenten angegeben, werden die Tarifparameter hiermit überschrieben.

gueltigkeitszeitraum: Zeitraum | None: Zeitraum, in dem der Abschlag zur Anwendung kommen kann

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

tarifnamensaenderungen: str | None: Durch die Anwendung des Auf/Abschlags kann eine Änderung des Tarifnamens auftreten.

vertagskonditionsaenderung: Vertragskonditionen | None: Änderungen in den Vertragskonditionen. Falls in dieser Komponenten angegeben, werden die Tarifparameter hiermit überschrieben.

voraussetzungen: list[str] | None: Voraussetzungen, die erfüllt sein müssen, damit dieser AufAbschlag zur Anwendung kommen kann

website: str | None: Internetseite, auf der die Informationen zum Auf-/Abschlag veröffentlicht sind

zusatzprodukte: list[str] | None: Zusatzprodukte, die nur in Kombination mit diesem AufAbschlag erhältlich sind

bo4e.com.aufabschlagstaffelproort module

Contains AufAbschlagstaffelProOrt class and corresponding marshmallow schema for de-/serialization

class bo4e.com.aufabschlagstaffelproort.AufAbschlagstaffelProOrt(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, wert: Decimal | None = None, staffelgrenzeVon: Decimal | None = None, staffelgrenzeBis: Decimal | None = None, **extra_data: Any)[source]

Bases: COM

Gibt den Wert eines Auf- oder Abschlags und dessen Staffelgrenzen an

Hint

AufAbschlagstaffelProOrt JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

staffelgrenze_bis: Decimal | None: Oberer Wert, bis zu dem die Staffel gilt.

staffelgrenze_von: Decimal | None: Unterer Wert, ab dem die Staffel gilt.

wert: Decimal | None: Der Wert für den Auf- oder Abschlag.

bo4e.com.ausschreibungsdetail module

Contains class Ausschreibungsdetail and corresponding marshmallow schema for de-/serialization

class bo4e.com.ausschreibungsdetail.Ausschreibungsdetail(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, marktlokationsId: str | None = None, netzebeneLieferung: str | None = None, netzebeneMessung: str | None = None, marktlokationsadresse: Adresse | None = None, lieferzeitraum: Zeitraum | None = None, netzbetreiber: str | None = None, kunde: str | None = None, zaehlernummer: str | None = None, marktlokationsbezeichnung: str | None = None, zaehlertechnik: Zaehlertyp | None = None, istLastgangVorhanden: bool | None = None, prognoseJahresarbeit: Menge | None = None, prognoseArbeitLieferzeitraum: Menge | None = None, prognoseLeistung: Menge | None = None, rechnungsadresse: Adresse | None = None, **extra_data: Any)[source]

Bases: COM

Die Komponente Ausschreibungsdetail wird verwendet um die Informationen zu einer Abnahmestelle innerhalb eines Ausschreibungsloses abzubilden.

Hint

Ausschreibungsdetail JSON Schema

ist_lastgang_vorhanden: bool | None: Zeigt an, ob es zu der Marktlokation einen Lastgang gibt. Falls ja, kann dieser abgerufen werden und daraus die Verbrauchswerte ermittelt werden

kunde: str | None: Bezeichnung des Kunden, der die Marktlokation nutzt

lieferzeitraum: Zeitraum | None: Angefragter Zeitraum für die ausgeschriebene Belieferung

marktlokations_id: str | None: Identifikation einer ausgeschriebenen Marktlokation

marktlokationsadresse: Adresse | None: Die Adresse an der die Marktlokation sich befindet

marktlokationsbezeichnung: str | None: Bezeichnung für die Lokation, z.B. ‘Zentraler Einkauf, Hamburg’

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

netzbetreiber: str | None: Bezeichnung des zuständigen Netzbetreibers, z.B. ‘Stromnetz Hamburg GmbH’

netzebene_lieferung: str | None: In der angegebenen Netzebene wird die Marktlokation versorgt, z.B. MSP für Mittelspannung

netzebene_messung: str | None: In der angegebenen Netzebene wird die Lokation gemessen, z.B. NSP für Niederspannung

prognose_arbeit_lieferzeitraum: Menge | None: Ein Prognosewert für die Arbeit innerhalb des angefragten Lieferzeitraums der ausgeschriebenen Lokation

prognose_jahresarbeit: Menge | None: Prognosewert für die Jahresarbeit der ausgeschriebenen Lokation

prognose_leistung: Menge | None: Prognosewert für die abgenommene maximale Leistung der ausgeschriebenen Lokation

rechnungsadresse: Adresse | None: Die (evtl. abweichende) Rechnungsadresse

zaehlernummer: str | None: Die Bezeichnung des Zählers an der Marktlokation

zaehlertechnik: Zaehlertyp | None: Spezifikation, um welche Zählertechnik es sich im vorliegenden Fall handelt, z.B. Leistungsmessung

bo4e.com.ausschreibungslos module

Contains Ausschreibungslos class and corresponding marshmallow schema for de-/serialization

class bo4e.com.ausschreibungslos.Ausschreibungslos(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, losnummer: str | None = None, bezeichnung: str | None = None, preismodell: Preismodell | None = None, energieart: Sparte | None = None, wunschRechnungslegung: Rechnungslegung | None = None, wunschVertragsform: Vertragsform | None = None, betreutDurch: str | None = None, anzahlLieferstellen: int | None = None, lieferstellen: list[Ausschreibungsdetail] | None = None, lieferzeitraum: Zeitraum | None = None, bemerkung: str | None = None, gesamtMenge: Menge | None = None, wunschMindestmenge: Menge | None = None, wunschMaximalmenge: Menge | None = None, wiederholungsintervall: Zeitraum | None = None, wunschKuendingungsfrist: Zeitraum | None = None, wunschZahlungsziel: Zeitraum | None = None, **extra_data: Any)[source]

Bases: COM

Eine Komponente zur Abbildung einzelner Lose einer Ausschreibung

Hint

Ausschreibungslos JSON Schema

anzahl_lieferstellen: int | None: Anzahl der Lieferstellen in dieser Ausschreibung

bemerkung: str | None: Bemerkung des Kunden zum Los

betreut_durch: str | None: Name des Lizenzpartners

bezeichnung: str | None: Bezeichnung der Ausschreibung

energieart: Sparte | None: Unterscheidungsmöglichkeiten für die Sparte

gesamt_menge: Menge | None: Gibt den Gesamtjahresverbrauch (z.B. in kWh) aller in diesem Los enthaltenen Lieferstellen an

lieferstellen: list[Ausschreibungsdetail] | None: Die ausgeschriebenen Lieferstellen

lieferzeitraum: Zeitraum | None: Zeitraum, für den die in diesem Los enthaltenen Lieferstellen beliefert werden sollen

losnummer: str | None: Laufende Nummer des Loses

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

preismodell: Preismodell | None: Bezeichnung der Preismodelle in Ausschreibungen für die Energielieferung

wiederholungsintervall: Zeitraum | None: In welchem Intervall die Angebotsabgabe wiederholt werden darf. Angabe nur gesetzt für die 2. Phase bei öffentlich-rechtlichen Ausschreibungen

wunsch_kuendingungsfrist: Zeitraum | None: Kundenwunsch zur Kündigungsfrist in der Ausschreibung

wunsch_maximalmenge: Menge | None: Maximalmenge Toleranzband (kWh, %)

wunsch_mindestmenge: Menge | None: Mindesmenge Toleranzband (kWh, %)

wunsch_rechnungslegung: Rechnungslegung | None: Aufzählung der Möglichkeiten zur Rechnungslegung in Ausschreibungen

wunsch_vertragsform: Vertragsform | None: Aufzählung der Möglichkeiten zu Vertragsformen in Ausschreibungen

wunsch_zahlungsziel: Zeitraum | None: Kundenwunsch zum Zahlungsziel in der Ausschreibung

bo4e.com.betrag module

Contains Betrag class and corresponding marshmallow schema for de-/serialization

class bo4e.com.betrag.Betrag(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, wert: Decimal | None = None, waehrung: Waehrungscode | None = None, **extra_data: Any)[source]

Bases: COM

Die Komponente wird dazu verwendet, Summenbeträge (beispielsweise in Angeboten und Rechnungen) als Geldbeträge abzubilden. Die Einheit ist dabei immer die Hauptwährung also Euro, Dollar etc…

Hint

Betrag JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

waehrung: Waehrungscode | None: Die entsprechende Waehrung

wert: Decimal | None: Gibt den Betrag des Preises an.

bo4e.com.com module

Contains base class for all components

class bo4e.com.com.COM(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, **extra_data: Any)[source]

Bases: BaseModel

base class for all components

Hint

COM JSON Schema

id: Annotated[str | None, FieldInfo(annotation=NoneType, required=True, alias='_id', alias_priority=2)]: Eine generische ID, die für eigene Zwecke genutzt werden kann. Z.B. könnten hier UUIDs aus einer Datenbank stehen oder URLs zu einem Backend-System.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

version: Annotated[str | None, FieldInfo(annotation=NoneType, required=True, alias='_version', alias_priority=2)]: Version der COM-Struktur aka “fachliche Versionierung”

zusatz_attribute: list[ZusatzAttribut] | None

bo4e.com.dienstleistung module

Contains Dienstleistung class and corresponding marshmallow schema for de-/serialization

class bo4e.com.dienstleistung.Dienstleistung(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, dienstleistungstyp: Dienstleistungstyp | None = None, bezeichnung: str | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung einer abrechenbaren Dienstleistung.

Hint

Dienstleistung JSON Schema

bezeichnung: str | None: Bezeichnung der Dienstleistung

dienstleistungstyp: Dienstleistungstyp | None: Kennzeichnung der Dienstleistung

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.energieherkunft module

Contains Energieherkunft class and corresponding marshmallow schema for de-/serialization

class bo4e.com.energieherkunft.Energieherkunft(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, erzeugungsart: Erzeugungsart | None = None, anteilProzent: Decimal | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung einer Energieherkunft

Hint

Energieherkunft JSON Schema

anteil_prozent: Decimal | None: Prozentualer Anteil der jeweiligen Erzeugungsart.

erzeugungsart: Erzeugungsart | None: Art der Erzeugung der Energie.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.energiemix module

Contains Energiemix class and corresponding marshmallow schema for de-/serialization

Bases: COM

Zusammensetzung der gelieferten Energie aus den verschiedenen Primärenergieformen.

Hint

Energiemix JSON Schema

anteil: list[Energieherkunft] | None: Anteile der jeweiligen Erzeugungsart

atommuell: Decimal | None: Höhe des erzeugten Atommülls in g/kWh

bemerkung: str | None: Bemerkung zum Energiemix

bezeichnung: str | None: Bezeichnung des Energiemix

co2_emission: Decimal | None: Höhe des erzeugten CO2-Ausstosses in g/kWh

energieart: Sparte | None: Strom oder Gas etc.

energiemixnummer: int | None: Eindeutige Nummer zur Identifizierung des Energiemixes

gueltigkeitsjahr: int | None: Jahr, für das der Energiemix gilt

ist_in_oeko_top_ten: bool | None: Kennzeichen, ob der Versorger zu den Öko Top Ten gehört

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

oekolabel: list[Oekolabel] | None: Ökolabel für den Energiemix

oekozertifikate: list[Oekozertifikat] | None: Zertifikate für den Energiemix

website: str | None: Internetseite, auf der die Strommixdaten veröffentlicht sind

bo4e.com.fremdkostenblock module

Contains Fremdkostenblock class and corresponding marshmallow schema for de-/serialization

class bo4e.com.fremdkostenblock.Fremdkostenblock(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, kostenblockbezeichnung: str | None = None, kostenpositionen: list[Fremdkostenposition] | None = None, summeKostenblock: Betrag | None = None, **extra_data: Any)[source]

Bases: COM

Komponente zur Abbildung eines Kostenblocks in den Fremdkosten

Hint

Fremdkostenblock JSON Schema

kostenblockbezeichnung: str | None: Bezeichnung für einen Kostenblock. Z.B. Netzkosten, Messkosten, Umlagen, etc.

kostenpositionen: list[Fremdkostenposition] | None: Hier sind die Details zu einer Kostenposition aufgeführt. Z.B.: Alliander Netz Heinsberg GmbH, 2018-02-01, 2019-01-01, Arbeitspreis HT, 3.660 kWh, 5,8200 ct/kWh, 213,01 €

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

summe_kostenblock: Betrag | None: Die Summe aller Kostenpositionen dieses Blocks

bo4e.com.fremdkostenposition module

Contains Fremdkostenposition and corresponding marshmallow schema for de-/serialization

Bases: Kostenposition

Eine Kostenposition im Bereich der Fremdkosten

Hint

Fremdkostenposition JSON Schema

gebietcode_eic: str | None: EIC-Code des Regel- oder Marktgebietes eingetragen. Z.B. ‘10YDE-EON——1’ für die Regelzone TenneT

link_preisblatt: str | None: Link zum veröffentlichten Preisblatt

marktpartnercode: str | None: Die Codenummer (z.B. BDEW-Codenummer) des Marktpartners, der die Preise festlegt / die Kosten in Rechnung stellt

marktpartnername: str | None: Der Name des Marktpartners, der die Preise festlegt, bzw. die Kosten in Rechnung stellt

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.geokoordinaten module

Contains Geokoordinaten class and corresponding marshmallow schema for de-/serialization

class bo4e.com.geokoordinaten.Geokoordinaten(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, breitengrad: Decimal | None = None, laengengrad: Decimal | None = None, **extra_data: Any)[source]

Bases: COM

This component provides the geo-coordinates for a location.

Hint

Geokoordinaten JSON Schema

breitengrad: Decimal | None

laengengrad: Decimal | None

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.katasteradresse module

Contains Katasteradresse class and corresponding marshmallow schema for de-/serialization

class bo4e.com.katasteradresse.Katasteradresse(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, gemarkungFlur: str | None = None, flurstueck: str | None = None, **extra_data: Any)[source]

Bases: COM

Dient der Adressierung über die Liegenschafts-Information.

Hint

Katasteradresse JSON Schema

flurstueck: str | None

gemarkung_flur: str | None

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.konfigurationsprodukt module

Contains Konfigurationsprodukt class and corresponding marshmallow schema for de-/serialization

class bo4e.com.konfigurationsprodukt.Konfigurationsprodukt(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, produktcode: str | None = None, leistungskurvendefinition: str | None = None, schaltzeitdefinition: str | None = None, marktpartner: Marktteilnehmer | None = None, **extra_data: Any)[source]

Bases: COM

Object containing information about a Konfigurationsprodukt

Hint

Konfigurationsprodukt JSON Schema

leistungskurvendefinition: str | None

marktpartner: Marktteilnehmer | None

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

produktcode: str | None

schaltzeitdefinition: str | None

bo4e.com.kontaktweg module

Contains Kontaktweg class and corresponding marshmallow schema for de-/serialization

class bo4e.com.kontaktweg.Kontaktweg(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, kontaktart: Kontaktart | None = None, beschreibung: str | None = None, kontaktwert: str | None = None, istBevorzugterKontaktweg: bool | None = None, **extra_data: Any)[source]

Bases: COM

Die Komponente wird dazu verwendet, die Kontaktwege innerhalb des BOs Person darzustellen

Hint

Kontakt JSON Schema

beschreibung: str | None: Spezifikation, beispielsweise “Durchwahl”, “Sammelnummer” etc.

ist_bevorzugter_kontaktweg: bool | None: Gibt an, ob es sich um den bevorzugten Kontaktweg handelt.

kontaktart: Kontaktart | None: Gibt die Kontaktart des Kontaktes an.

kontaktwert: str | None: Die Nummer oder E-Mail-Adresse.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.konzessionsabgabe module

Contains Konzessionsabgabe and corresponding marshmallow schema for de-/serialization

class bo4e.com.konzessionsabgabe.Konzessionsabgabe(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, satz: AbgabeArt | None = None, kosten: Decimal | None = None, kategorie: str | None = None, **extra_data: Any)[source]

Bases: COM

Diese Komponente wird zur Übertagung der Details zu einer Konzessionsabgabe verwendet.

Hint

Konzessionsabgabe JSON Schema

kategorie: str | None: Gebührenkategorie der Konzessionsabgabe

kosten: Decimal | None: Konzessionsabgabe in E/kWh

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

satz: AbgabeArt | None: Art der Abgabe

bo4e.com.kostenblock module

Contains Kostenblock and corresponding marshmallow schema for de-/serialization

class bo4e.com.kostenblock.Kostenblock(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, kostenblockbezeichnung: str | None = None, summeKostenblock: Betrag | None = None, kostenpositionen: list[Kostenposition] | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente werden mehrere Kostenpositionen zusammengefasst.

Hint

Kostenblock JSON Schema

kostenblockbezeichnung: str | None: Bezeichnung für einen Kostenblock. Z.B. Netzkosten, Messkosten, Umlagen, etc.

kostenpositionen: list[Kostenposition] | None: Hier sind die Details zu einer Kostenposition aufgeführt. Z.B.: Alliander Netz Heinsberg GmbH, 01.02.2018, 31.12.2018, Arbeitspreis HT, 3.660 kWh, 5,8200 ct/kWh, 213,01 €

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

summe_kostenblock: Betrag | None: Die Summe aller Kostenpositionen dieses Blocks

bo4e.com.kostenposition module

Contains Kostenposition and corresponding marshmallow schema for de-/serialization

Bases: COM

Diese Komponente wird zur Übertagung der Details zu einer Kostenposition verwendet.

Hint

Kostenposition JSON Schema

artikelbezeichnung: str | None

Arbeitspreis HT

Type:: Bezeichnung für den Artikel für den die Kosten ermittelt wurden. Beispiel

artikeldetail: str | None

‘Drehstromzähler’

Type:: Detaillierung des Artikels (optional). Beispiel

betrag_kostenposition: Betrag | None: Der errechnete Gesamtbetrag der Position als Ergebnis der Berechnung <Menge * Einzelpreis> oder <Einzelpreis / (Anzahl Tage Jahr) * zeitmenge>

bis: AwareDatetime | None: exklusiver bis-Zeitpunkt der Kostenzeitscheibe

einzelpreis: Preis | None

5,8200 ct/kWh oder 55 €/Jahr.

Type:: Der Preis für eine Einheit. Beispiele

menge: Menge | None

3.660 kWh

Type:: Die Menge, die in die Kostenberechnung eingeflossen ist. Beispiel

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

positionstitel: str | None: Ein Titel für die Zeile. Hier kann z.B. der Netzbetreiber eingetragen werden, wenn es sich um Netzkosten handelt.

von: AwareDatetime | None: inklusiver von-Zeitpunkt der Kostenzeitscheibe

zeitmenge: Menge | None: Wenn es einen zeitbasierten Preis gibt (z.B. €/Jahr), dann ist hier die Menge angegeben mit der die Kosten berechnet wurden. Z.B. 138 Tage.

bo4e.com.kriteriumwert module

Contains KriteriumWert class and corresponding marshmallow schema for de-/serialization

class bo4e.com.kriteriumwert.KriteriumWert(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, kriterium: Tarifregionskriterium | None = None, wert: str | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können Kriterien und deren Werte definiert werden

Hint

KriteriumWert JSON Schema

kriterium: Tarifregionskriterium | None: Hier steht, für welches Kriterium der Wert gilt. Z.B. Postleitzahlen

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

wert: str | None: Ein Wert, passend zum Kriterium. Z.B. eine Postleitzahl.

bo4e.com.marktgebietinfo module

Contains Marktgebietinfo class and corresponding marshmallow schema for de-/serialization

class bo4e.com.marktgebietinfo.MarktgebietInfo(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, marktgebiet: str | None = None, marktgebietcode: str | None = None, **extra_data: Any)[source]

Bases: COM

Informationen zum Marktgebiet im Gas.

Hint

MarktgebietInfo JSON Schema

marktgebiet: str | None: Der Name des Marktgebietes

marktgebietcode: str | None: Die standardisierte Codenummer des Marktgebietes

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.menge module

Contains Menge class and corresponding marshmallow schema for de-/serialization

class bo4e.com.menge.Menge(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, wert: Decimal | None = None, einheit: Mengeneinheit | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung einer Menge mit Wert und Einheit.

Hint

Menge JSON Schema

einheit: Mengeneinheit | None: Gibt die Einheit zum jeweiligen Wert an

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

wert: Decimal | None: Gibt den absoluten Wert der Menge an

bo4e.com.positionsaufabschlag module

Contains PositionsAufAbschlag and corresponding marshmallow schema for de-/serialization

class bo4e.com.positionsaufabschlag.PositionsAufAbschlag(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, bezeichnung: str | None = None, beschreibung: str | None = None, aufAbschlagstyp: AufAbschlagstyp | None = None, aufAbschlagswert: Decimal | None = None, aufAbschlagswaehrung: Waehrungseinheit | None = None, **extra_data: Any)[source]

Bases: COM

Differenzierung der zu betrachtenden Produkte anhand der preiserhöhenden (Aufschlag) bzw. preisvermindernden (Abschlag) Zusatzvereinbarungen, die individuell zu einem neuen oder bestehenden Liefervertrag abgeschlossen werden können. Es können mehrere Auf-/Abschläge gleichzeitig ausgewählt werden.

Hint

PositionsAufAbschlag JSON Schema

auf_abschlagstyp: AufAbschlagstyp | None: Typ des AufAbschlages

auf_abschlagswaehrung: Waehrungseinheit | None: Einheit, in der der Auf-/Abschlag angegeben ist (z.B. ct/kWh).

auf_abschlagswert: Decimal | None: Höhe des Auf-/Abschlages

beschreibung: str | None: Beschreibung zum Auf-/Abschlag

bezeichnung: str | None: Bezeichnung des Auf-/Abschlags

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.preis module

Contains Preis class and corresponding marshmallow schema for de-/serialization

class bo4e.com.preis.Preis(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, wert: Decimal | None = None, einheit: Waehrungseinheit | None = None, bezugswert: Mengeneinheit | None = None, status: Preisstatus | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung eines Preises mit Wert, Einheit, Bezugswert und Status.

Hint

Preis JSON Schema

bezugswert: Mengeneinheit | None: Angabe, für welche Bezugsgröße der Preis gilt. Z.B. kWh.

einheit: Waehrungseinheit | None: Währungseinheit für den Preis, z.B. Euro oder Ct.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

status: Preisstatus | None: Gibt den Status des veröffentlichten Preises an

wert: Decimal | None: Gibt die nominale Höhe des Preises an.

bo4e.com.preisgarantie module

Contains Preisgarantie class and corresponding marshmallow schema for de-/serialization

class bo4e.com.preisgarantie.Preisgarantie(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, preisgarantietyp: Preisgarantietyp | None = None, zeitlicheGueltigkeit: Zeitraum | None = None, beschreibung: str | None = None, **extra_data: Any)[source]

Bases: COM

Definition für eine Preisgarantie mit der Möglichkeit verschiedener Ausprägungen.

Hint

Preisgarantie JSON Schema

beschreibung: str | None: Freitext zur Beschreibung der Preisgarantie.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

preisgarantietyp: Preisgarantietyp | None: Festlegung, auf welche Preisbestandteile die Garantie gewährt wird.

zeitliche_gueltigkeit: Zeitraum | None: Zeitraum, bis zu dem die Preisgarantie gilt, z.B. bis zu einem absolutem / fixem Datum oder als Laufzeit in Monaten.

bo4e.com.preisposition module

Contains Preisposition class and corresponding marshmallow schema for de-/serialization

class bo4e.com.preisposition.Preisposition(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, berechnungsmethode: Kalkulationsmethode | None = None, leistungstyp: Leistungstyp | None = None, leistungsbezeichnung: str | None = None, preiseinheit: Waehrungseinheit | None = None, bezugsgroesse: Mengeneinheit | None = None, preisstaffeln: list[Preisstaffel] | None = None, zeitbasis: Mengeneinheit | None = None, tarifzeit: Tarifzeit | None = None, bdewArtikelnummer: BDEWArtikelnummer | None = None, zonungsgroesse: Bemessungsgroesse | None = None, freimengeBlindarbeit: Decimal | None = None, freimengeLeistungsfaktor: Decimal | None = None, gruppenartikelId: str | None = None, **extra_data: Any)[source]

Bases: COM

Preis für eine definierte Lieferung oder Leistung innerhalb eines Preisblattes

Hint

Preisposition JSON Schema

bdew_artikelnummer: BDEWArtikelnummer | None: Eine vom BDEW standardisierte Bezeichnug für die abgerechnete Leistungserbringung; Diese Artikelnummer wird auch im Rechnungsteil der INVOIC verwendet.

berechnungsmethode: Kalkulationsmethode | None: Das Modell, das der Preisbildung zugrunde liegt

bezugsgroesse: Mengeneinheit | None: Hier wird festgelegt, auf welche Bezugsgrösse sich der Preis bezieht, z.B. kWh oder Stück

freimenge_blindarbeit: Decimal | None: Der Anteil der Menge der Blindarbeit in Prozent von der Wirkarbeit, für die keine Abrechnung erfolgt

freimenge_leistungsfaktor: Decimal | None: Der cos phi (Verhältnis Wirkleistung/Scheinleistung) aus dem die Freimenge für die Blindarbeit berechnet wird als tan phi (Verhältnis Blindleistung/Wirkleistung)

gruppenartikel_id: str | None: Übergeordnete Gruppen-ID, die sich ggf. auf die Artikel-ID in der Preisstaffel bezieht

leistungsbezeichnung: str | None: Bezeichnung für die in der Position abgebildete Leistungserbringung

leistungstyp: Leistungstyp | None: Standardisierte Bezeichnung für die abgerechnete Leistungserbringung

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

preiseinheit: Waehrungseinheit | None: Festlegung, mit welcher Preiseinheit abgerechnet wird, z.B. Ct. oder €

preisstaffeln: list[Preisstaffel] | None: Preisstaffeln, die zu dieser Preisposition gehören

tarifzeit: Tarifzeit | None: Festlegung, für welche Tarifzeit der Preis hier festgelegt ist

zeitbasis: Mengeneinheit | None: Die Zeit(dauer) auf die sich der Preis bezieht. Z.B. ein Jahr für einen Leistungspreis der in €/kW/Jahr ausgegeben wird

zonungsgroesse: Bemessungsgroesse | None: Mit der Menge der hier angegebenen Größe wird die Staffelung/Zonung durchgeführt. Z.B. Vollbenutzungsstunden

bo4e.com.preisstaffel module

Contains Preisstaffel and corresponding marshmallow schema for de-/serialization

class bo4e.com.preisstaffel.Preisstaffel(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, einheitspreis: Decimal | None = None, staffelgrenzeVon: Decimal | None = None, staffelgrenzeBis: Decimal | None = None, sigmoidparameter: Sigmoidparameter | None = None, artikelId: str | None = None, **extra_data: Any)[source]

Bases: COM

Gibt die Staffelgrenzen der jeweiligen Preise an

Hint

Preisstaffel JSON Schema

artikel_id: str | None: Standardisierte vom BDEW herausgegebene Liste, welche im Strommarkt die BDEW-Artikelnummer ablöst

einheitspreis: Decimal | None: Preis pro abgerechneter Mengeneinheit

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

sigmoidparameter: Sigmoidparameter | None: Parameter zur Berechnung des Preises anhand der Jahresmenge und weiterer netzbezogener Parameter

staffelgrenze_bis: Decimal | None: Exklusiver oberer Wert, bis zu dem die Staffel gilt

staffelgrenze_von: Decimal | None: Inklusiver unterer Wert, ab dem die Staffel gilt

bo4e.com.rechnungsposition module

Contains Rechnungsposition class and corresponding marshmallow schema for de-/serialization

Bases: COM

Über Rechnungspositionen werden Rechnungen strukturiert. In einem Rechnungsteil wird jeweils eine in sich geschlossene Leistung abgerechnet.

Hint

Rechnungsposition JSON Schema

artikel_id: str | None: Standardisierte vom BDEW herausgegebene Liste, welche im Strommarkt die BDEW-Artikelnummer ablöst

artikelnummer: BDEWArtikelnummer | None: Kennzeichnung der Rechnungsposition mit der Standard-Artikelnummer des BDEW

einzelpreis: Preis | None: Der Preis für eine Einheit der energetischen Menge

lieferung_bis: AwareDatetime | None: Ende der Lieferung für die abgerechnete Leistung (exklusiv)

lieferung_von: AwareDatetime | None: Start der Lieferung für die abgerechnete Leistung (inklusiv)

lokations_id: str | None: Marktlokation, die zu dieser Position gehört

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

positions_menge: Menge | None: Die abgerechnete Menge mit Einheit

positionsnummer: int | None: Fortlaufende Nummer für die Rechnungsposition

positionstext: str | None: Bezeichung für die abgerechnete Position

teilrabatt_netto: Betrag | None: Nettobetrag für den Rabatt dieser Position

teilsumme_netto: Betrag | None: Das Ergebnis der Multiplikation aus einzelpreis * positionsMenge * (Faktor aus zeitbezogeneMenge). Z.B. 12,60€ * 120 kW * 3/12 (für 3 Monate).

teilsumme_steuer: Steuerbetrag | None: Auf die Position entfallende Steuer, bestehend aus Steuersatz und Betrag

zeitbezogene_menge: Menge | None: Eine auf die Zeiteinheit bezogene Untermenge. Z.B. bei einem Jahrespreis, 3 Monate oder 146 Tage. Basierend darauf wird der Preis aufgeteilt.

zeiteinheit: Mengeneinheit | None: Falls sich der Preis auf eine Zeit bezieht, steht hier die Einheit

bo4e.com.regionalegueltigkeit module

Contains RegionaleGueltigkeit class and corresponding marshmallow schema for de-/serialization

class bo4e.com.regionalegueltigkeit.RegionaleGueltigkeit(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, gueltigkeitstyp: Gueltigkeitstyp | None = None, kriteriumsWerte: list[KriteriumWert] | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können regionale Gültigkeiten, z.B. für Tarife, Zu- und Abschläge und Preise definiert werden.

Hint

RegionaleGueltigkeit JSON Schema

gueltigkeitstyp: Gueltigkeitstyp | None: Unterscheidung ob Positivliste oder Negativliste übertragen wird

kriteriums_werte: list[KriteriumWert] | None: Hier stehen die Kriterien, die die regionale Gültigkeit festlegen

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.regionalepreisgarantie module

Contains RegionalePreisgarantie class and corresponding marshmallow schema for de-/serialization

class bo4e.com.regionalepreisgarantie.RegionalePreisgarantie(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, preisgarantietyp: Preisgarantietyp | None = None, zeitlicheGueltigkeit: Zeitraum | None = None, beschreibung: str | None = None, regionaleGueltigkeit: RegionaleGueltigkeit | None = None, **extra_data: Any)[source]

Bases: Preisgarantie

Abbildung einer Preisgarantie mit regionaler Abgrenzung

Hint

RegionalePreisgarantie JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

regionale_gueltigkeit: RegionaleGueltigkeit | None: Regionale Eingrenzung der Preisgarantie.

bo4e.com.regionalepreisstaffel module

Contains RegionalePreisstaffel class and corresponding marshmallow schema for de-/serialization

class bo4e.com.regionalepreisstaffel.RegionalePreisstaffel(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, einheitspreis: Decimal | None = None, staffelgrenzeVon: Decimal | None = None, staffelgrenzeBis: Decimal | None = None, sigmoidparameter: Sigmoidparameter | None = None, artikelId: str | None = None, regionaleGueltigkeit: RegionaleGueltigkeit | None = None, **extra_data: Any)[source]

Bases: Preisstaffel

Abbildung einer Preisstaffel mit regionaler Abgrenzung

Hint

RegionalePreisstaffel JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

regionale_gueltigkeit: RegionaleGueltigkeit | None: Regionale Eingrenzung der Preisstaffel

bo4e.com.regionaleraufabschlag module

Contains RegionalerAufAbschlag class and corresponding marshmallow schema for de-/serialization

class bo4e.com.regionaleraufabschlag.RegionalerAufAbschlag(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, bezeichnung: str | None = None, staffeln: list[RegionalePreisstaffel] | None = None, beschreibung: str | None = None, aufAbschlagstyp: AufAbschlagstyp | None = None, aufAbschlagsziel: AufAbschlagsziel | None = None, einheit: Waehrungseinheit | None = None, website: str | None = None, zusatzprodukte: list[str] | None = None, voraussetzungen: list[str] | None = None, tarifnamensaenderungen: str | None = None, gueltigkeitszeitraum: Zeitraum | None = None, energiemixaenderung: Energiemix | None = None, vertagskonditionsaenderung: Vertragskonditionen | None = None, garantieaenderung: Preisgarantie | None = None, einschraenkungsaenderung: Tarifeinschraenkung | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können Auf- und Abschläge verschiedener Typen im Zusammenhang mit regionalen Gültigkeiten abgebildet werden. Hier sind auch die Auswirkungen auf verschiedene Tarifparameter modelliert, die sich durch die Auswahl eines Auf- oder Abschlags ergeben.

Hint

RegionalerAufAbschlag JSON Schema

auf_abschlagstyp: AufAbschlagstyp | None: Typ des Aufabschlages (z.B. absolut oder prozentual)

auf_abschlagsziel: AufAbschlagsziel | None: Diesem Preis oder den Kosten ist der Auf/Abschlag zugeordnet. Z.B. Arbeitspreis, Gesamtpreis etc.

beschreibung: str | None: Beschreibung des Auf-/Abschlags

bezeichnung: str | None: Bezeichnung des Auf-/Abschlags

einheit: Waehrungseinheit | None: Gibt an in welcher Währungseinheit der Auf/Abschlag berechnet wird (nur im Falle absoluter Aufschlagstypen).

einschraenkungsaenderung: Tarifeinschraenkung | None: Änderungen in den Einschränkungen zum Tarif; Falls in dieser Komponenten angegeben, werden die Tarifparameter hiermit überschrieben.

energiemixaenderung: Energiemix | None: Der Energiemix kann sich durch einen AufAbschlag ändern (z.B. zwei Cent Aufschlag für Ökostrom). Sollte dies der Fall sein, wird hier die neue Zusammensetzung des Energiemix angegeben.

garantieaenderung: Preisgarantie | None: Änderungen in den Garantievereinbarungen; Falls in dieser Komponenten angegeben, werden die Tarifparameter hiermit überschrieben.

gueltigkeitszeitraum: Zeitraum | None: Zeitraum, in dem der Abschlag zur Anwendung kommen kann

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

staffeln: list[RegionalePreisstaffel] | None: Werte für die gestaffelten Auf/Abschläge mit regionaler Eingrenzung

tarifnamensaenderungen: str | None: Durch die Anwendung des Auf/Abschlags kann eine Änderung des Tarifnamens auftreten

vertagskonditionsaenderung: Vertragskonditionen | None: Änderungen in den Vertragskonditionen; Falls in dieser Komponenten angegeben, werden die Tarifparameter hiermit überschrieben.

voraussetzungen: list[str] | None: Voraussetzungen, die erfüllt sein müssen, damit dieser AufAbschlag zur Anwendung kommen kann

website: str | None: Internetseite, auf der die Informationen zum Auf-/Abschlag veröffentlicht sind

zusatzprodukte: list[str] | None: Zusatzprodukte, die nur in Kombination mit diesem AufAbschlag erhältlich sind

bo4e.com.regionaletarifpreisposition module

Contains RegionaleTarifpreisposition class and corresponding marshmallow schema for de-/serialization

class bo4e.com.regionaletarifpreisposition.RegionaleTarifpreisposition(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, preistyp: Preistyp | None = None, einheit: Waehrungseinheit | None = None, bezugseinheit: Mengeneinheit | None = None, preisstaffeln: list[RegionalePreisstaffel] | None = None, mengeneinheitstaffel: Mengeneinheit | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können Tarifpreise verschiedener Typen im Zusammenhang mit regionalen Gültigkeiten abgebildet werden.

Hint

RegionaleTarifpreisposition JSON Schema

bezugseinheit: Mengeneinheit | None: Größe, auf die sich die Einheit bezieht, beispielsweise kWh, Jahr

einheit: Waehrungseinheit | None: Einheit des Preises (z.B. EURO)

mengeneinheitstaffel: Mengeneinheit | None: Gibt an, nach welcher Menge die vorgenannte Einschränkung erfolgt (z.B. Jahresstromverbrauch in kWh)

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

preisstaffeln: list[RegionalePreisstaffel] | None: Hier sind die Staffeln mit ihren Preisangaben und regionalen Gültigkeiten definiert

preistyp: Preistyp | None: Angabe des Preistypes (z.B. Grundpreis)

bo4e.com.regionskriterium module

Contains Regionskriterium class and corresponding marshmallow schema for de-/serialization

class bo4e.com.regionskriterium.Regionskriterium(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, gueltigkeitstyp: Gueltigkeitstyp | None = None, regionskriteriumtyp: Regionskriteriumtyp | None = None, wert: str | None = None, **extra_data: Any)[source]

Bases: COM

Komponente zur Abbildung eines Regionskriteriums

Hint

Regionskriterium JSON Schema

gueltigkeitstyp: Gueltigkeitstyp | None: Hier wird festgelegt, ob es sich um ein einschließendes oder ausschließendes Kriterium handelt.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

regionskriteriumtyp: Regionskriteriumtyp | None: Hier wird das Kriterium selbst angegeben, z.B. Bundesland.

wert: str | None: Der Wert, den das Kriterium annehmen kann, z.B. NRW. Im Falle des Regionskriteriumstyp BUNDESWEIT spielt dieser Wert keine Rolle.

bo4e.com.sigmoidparameter module

Contains Sigmoidparameter class and corresponding marshmallow schema for de-/serialization

Bases: COM

Die Sigmoid-Funktion, beispielsweise zur Berechnung eines Leistungspreises hat die Form: LP=A/(1+(P/B)^C)+D

Hint

Sigmoidparameter JSON Schema

A: Decimal | None: Briefmarke Ortsverteilnetz (EUR/kWh)

B: Decimal | None: Wendepunkt für die bepreiste Menge (kW)

C: Decimal | None: Exponent (einheitenlos)

D: Decimal | None: Briefmarke Transportnetz (EUR/kWh)

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.standorteigenschaftengas module

Contains StandorteigenschaftenGas class and corresponding marshmallow schema for de-/serialization

class bo4e.com.standorteigenschaftengas.StandorteigenschaftenGas(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, netzkontonummern: list[str] | None = None, marktgebiete: list[MarktgebietInfo] | None = None, **extra_data: Any)[source]

Bases: COM

Standorteigenschaften der Sparte Gas

Hint

StandorteigenschaftenGas JSON Schema

marktgebiete: list[MarktgebietInfo] | None: Die Informationen zu Marktgebieten in dem Netz.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

netzkontonummern: list[str] | None: Netzkontonummern der Gasnetze

bo4e.com.standorteigenschaftenstrom module

Contains StandorteigenschaftenStrom class and corresponding marshmallow schema for de-/serialization

class bo4e.com.standorteigenschaftenstrom.StandorteigenschaftenStrom(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, bilanzierungsgebietEic: str | None = None, regelzone: str | None = None, regelzoneEic: str | None = None, **extra_data: Any)[source]

Bases: COM

Standorteigenschaften der Sparte Strom

Hint

StandorteigenschaftenStrom JSON Schema

bilanzierungsgebiet_eic: str | None: Die EIC-Nummer des Bilanzierungsgebietes

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

regelzone: str | None: Der Name der Regelzone

regelzone_eic: str | None: De EIC-Nummer der Regelzone

bo4e.com.steuerbetrag module

Contains Steuerbetrag class and corresponding marshmallow schema for de-/serialization

class bo4e.com.steuerbetrag.Steuerbetrag(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, steuerkennzeichen: Steuerkennzeichen | None = None, basiswert: Decimal | None = None, steuerwert: Decimal | None = None, waehrung: Waehrungscode | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung eines Steuerbetrages.

Hint

Steuerbetrag JSON Schema

basiswert: Decimal | None: Nettobetrag für den die Steuer berechnet wurde. Z.B. 100

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

steuerkennzeichen: Steuerkennzeichen | None: Kennzeichnung des Steuersatzes, bzw. Verfahrens.

steuerwert: Decimal | None: Aus dem Basiswert berechnete Steuer. Z.B. 19 (bei UST_19)

waehrung: Waehrungscode | None: Währung. Z.B. Euro.

bo4e.com.tarifberechnungsparameter module

Contains Tarifberechnungsparameter class and corresponding marshmallow schema for de-/serialization

class bo4e.com.tarifberechnungsparameter.Tarifberechnungsparameter(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, berechnungsmethode: Tarifkalkulationsmethode | None = None, istMesspreisInGrundpreisEnthalten: bool | None = None, istMesspreisZuBeruecksichtigen: bool | None = None, messpreistyp: Messpreistyp | None = None, kwInklusive: Decimal | None = None, kwWeitereMengen: Decimal | None = None, hoechstpreisNT: Preis | None = None, hoechstpreisHT: Preis | None = None, mindestpreis: Preis | None = None, zusatzpreise: list[Tarifpreis] | None = None, **extra_data: Any)[source]

Bases: COM

In dieser Komponente sind die Berechnungsparameter für die Ermittlung der Tarifkosten zusammengefasst.

Hint

Tarifberechnungsparameter JSON Schema

berechnungsmethode: Tarifkalkulationsmethode | None: Gibt an, wie die Einzelpreise des Tarifes zu verarbeiten sind

hoechstpreis_h_t: Preis | None: Höchstpreis für den Durchschnitts-Arbeitspreis HT

hoechstpreis_n_t: Preis | None: Höchstpreis für den Durchschnitts-Arbeitspreis NT

ist_messpreis_in_grundpreis_enthalten: bool | None: True, falls der Messpreis im Grundpreis (GP) enthalten ist

ist_messpreis_zu_beruecksichtigen: bool | None: True, falls bei der Bildung des Durchschnittspreises für die Höchst- und Mindestpreisbetrachtung der Messpreis mit berücksichtigt wird

kw_inklusive: Decimal | None: Im Preis bereits eingeschlossene Leistung (für Gas)

kw_weitere_mengen: Decimal | None: Intervall, indem die über “kwInklusive” hinaus abgenommene Leistung kostenpflichtig wird (z.B. je 5 kW 20 EURO)

messpreistyp: Messpreistyp | None: Typ des Messpreises

mindestpreis: Preis | None: Mindestpreis für den Durchschnitts-Arbeitspreis

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

zusatzpreise: list[Tarifpreis] | None: Liste mit zusätzlichen Preisen, beispielsweise Messpreise und/oder Leistungspreise

bo4e.com.tarifeinschraenkung module

Contains Tarifeinschraenkung and corresponding marshmallow schema for de-/serialization

class bo4e.com.tarifeinschraenkung.Tarifeinschraenkung(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, zusatzprodukte: list[str] | None = None, voraussetzungen: list[Voraussetzungen] | None = None, einschraenkungzaehler: list[Geraet] | None = None, einschraenkungleistung: list[Menge] | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente werden Einschränkungen für die Anwendung von Tarifen modelliert.

Hint

Tarifeinschraenkung JSON Schema

einschraenkungleistung: list[Menge] | None: Die vereinbarte Leistung, die (näherungsweise) abgenommen wird. Insbesondere Gastarife können daran gebunden sein, dass die Leistung einer vereinbarten Höhe entspricht.

einschraenkungzaehler: list[Geraet] | None: Liste der Zähler/Geräte, die erforderlich sind, damit dieser Tarif zur Anwendung gelangen kann. (Falls keine Zähler angegeben sind, ist der Tarif nicht an das Vorhandensein bestimmter Zähler gebunden.)

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

voraussetzungen: list[Voraussetzungen] | None: Voraussetzungen, die erfüllt sein müssen, damit dieser Tarif zur Anwendung kommen kann

zusatzprodukte: list[str] | None: Weitere Produkte, die gemeinsam mit diesem Tarif bestellt werden können

bo4e.com.tarifpreis module

Contains Tarifpreis class and corresponding marshmallow schema for de-/serialization

Bases: Preis

Abbildung eines Tarifpreises mit Preistyp und Beschreibung abgeleitet von COM Preis.

Hint

Tarifpreis JSON Schema

beschreibung: str | None: Beschreibung des Preises. Hier können z.B. Preisdetails angegeben sein, beispielsweise “Drehstromzähler”.

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

preistyp: Preistyp | None: Angabe des Preistypes (z.B. Grundpreis)

bo4e.com.tarifpreisposition module

Contains Tarifpreisposition class and corresponding marshmallow schema for de-/serialization

class bo4e.com.tarifpreisposition.Tarifpreisposition(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, preistyp: Preistyp | None = None, einheit: Waehrungseinheit | None = None, bezugseinheit: Mengeneinheit | None = None, preisstaffeln: list[Preisstaffel] | None = None, mengeneinheitstaffel: Mengeneinheit | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können Tarifpreise verschiedener Typen abgebildet werden.

Hint

Tarifpreisposition JSON Schema

bezugseinheit: Mengeneinheit | None: Größe, auf die sich die Einheit bezieht, beispielsweise kWh, Jahr

einheit: Waehrungseinheit | None: Einheit des Preises (z.B. EURO)

mengeneinheitstaffel: Mengeneinheit | None: Gibt an, nach welcher Menge die vorgenannte Einschränkung erfolgt (z.B. Jahresstromverbrauch in kWh)

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

preisstaffeln: list[Preisstaffel] | None: Hier sind die Staffeln mit ihren Preisenangaben definiert

preistyp: Preistyp | None: Angabe des Preistypes (z.B. Grundpreis)

bo4e.com.tarifpreispositionproort module

Contains TarifpreispositionProOrt class and corresponding marshmallow schema for de-/serialization

class bo4e.com.tarifpreispositionproort.TarifpreispositionProOrt(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, postleitzahl: str | None = None, ort: str | None = None, netznr: str | None = None, preisstaffeln: list[TarifpreisstaffelProOrt] | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente können Tarifpreise verschiedener Typen abgebildet werden

Hint

TarifpreispositionProOrt JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

netznr: str | None: ene’t-Netznummer des Netzes in dem der Preis gilt

ort: str | None: Ort für den der Preis gilt

postleitzahl: str | None: Postleitzahl des Ortes für den der Preis gilt

preisstaffeln: list[TarifpreisstaffelProOrt] | None

bo4e.com.tarifpreisstaffelproort module

Contains TarifpreisstaffelProOrt class and corresponding marshmallow schema for de-/serialization

class bo4e.com.tarifpreisstaffelproort.TarifpreisstaffelProOrt(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, arbeitspreis: Decimal | None = None, arbeitspreisNT: Decimal | None = None, grundpreis: Decimal | None = None, staffelgrenzeVon: Decimal | None = None, staffelgrenzeBis: Decimal | None = None, **extra_data: Any)[source]

Bases: COM

Gibt die Staffelgrenzen der jeweiligen Preise an

Hint

TarifpreisstaffelProOrt JSON Schema

arbeitspreis: Decimal | None: Der Arbeitspreis in ct/kWh

arbeitspreis_n_t: Decimal | None: Der Arbeitspreis für Verbräuche in der Niedertarifzeit in ct/kWh

grundpreis: Decimal | None: Der Grundpreis in Euro/Jahr

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

staffelgrenze_bis: Decimal | None: Oberer Wert, bis zu dem die Staffel gilt (exklusive)

staffelgrenze_von: Decimal | None: Unterer Wert, ab dem die Staffel gilt (inklusive)

bo4e.com.unterschrift module

Contains Unterschrift class and corresponding marshmallow schema for de-/serialization

Bases: COM

Modellierung einer Unterschrift, z.B. für Verträge, Angebote etc.

Hint

Unterschrift JSON Schema

datum: AwareDatetime | None: Datum der Unterschrift

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

name: str | None: Name des Unterschreibers

ort: str | None: Ort, an dem die Unterschrift geleistet wird

bo4e.com.verbrauch module

Contains Verbrauch and corresponding marshmallow schema for de-/serialization

class bo4e.com.verbrauch.Verbrauch(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, wertermittlungsverfahren: Wertermittlungsverfahren | None = None, obisKennzahl: str | None = None, wert: Decimal | None = None, einheit: Mengeneinheit | None = None, startdatum: AwareDatetime | None = None, enddatum: AwareDatetime | None = None, messwertstatus: Messwertstatus | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung eines zeitlich abgegrenzten Verbrauchs

Hint

Verbrauch JSON Schema

einheit: Mengeneinheit | None: Gibt die Einheit zum jeweiligen Wert an

enddatum: AwareDatetime | None: Exklusives Ende des Zeitraumes, für den der Verbrauch angegeben wird

messwertstatus: Messwertstatus | None: Messwertstatus includes the plausibility of the value

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

obis_kennzahl: str | None: Die OBIS-Kennzahl für den Wert, die festlegt, welche Größe mit dem Stand gemeldet wird, z.B. ‘1-0:

startdatum: AwareDatetime | None: Inklusiver Beginn des Zeitraumes, für den der Verbrauch angegeben wird

wert: Decimal | None: Gibt den absoluten Wert der Menge an

wertermittlungsverfahren: Wertermittlungsverfahren | None: Gibt an, ob es sich um eine PROGNOSE oder eine MESSUNG handelt

bo4e.com.vertragskonditionen module

Contains Vertragskonditionen class and corresponding marshmallow schema for de-/serialization

class bo4e.com.vertragskonditionen.Vertragskonditionen(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, beschreibung: str | None = None, anzahlAbschlaege: Decimal | None = None, vertragslaufzeit: Zeitraum | None = None, kuendigungsfrist: Zeitraum | None = None, vertragsverlaengerung: Zeitraum | None = None, abschlagszyklus: Zeitraum | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung für Vertragskonditionen. Die Komponente wird sowohl im Vertrag als auch im Tarif verwendet.

Hint

Vertragskonditionen JSON Schema

abschlagszyklus: Zeitraum | None: In diesen Zyklen werden Abschläge gestellt. Alternativ kann auch die Anzahl in den Konditionen angeben werden.

anzahl_abschlaege: Decimal | None: Anzahl der vereinbarten Abschläge pro Jahr, z.B. 12

beschreibung: str | None: Freitext zur Beschreibung der Konditionen, z.B. “Standardkonditionen Gas”

kuendigungsfrist: Zeitraum | None: Innerhalb dieser Frist kann der Vertrag gekündigt werden

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

vertragslaufzeit: Zeitraum | None: Über diesen Zeitraum läuft der Vertrag

vertragsverlaengerung: Zeitraum | None: Falls der Vertrag nicht gekündigt wird, verlängert er sich automatisch um die hier angegebene Zeit

bo4e.com.vertragsteil module

Contains Vertragsteil class and corresponding marshmallow schema for de-/serialization

class bo4e.com.vertragsteil.Vertragsteil(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, vertragsteilbeginn: AwareDatetime | None = None, vertragsteilende: AwareDatetime | None = None, lokation: str | None = None, vertraglichFixierteMenge: Menge | None = None, minimaleAbnahmemenge: Menge | None = None, maximaleAbnahmemenge: Menge | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung für einen Vertragsteil. Der Vertragsteil wird dazu verwendet, eine vertragliche Leistung in Bezug zu einer Lokation (Markt- oder Messlokation) festzulegen.

Hint

Vertragsteil JSON Schema

lokation: str | None: Der Identifier für diejenigen Markt- oder Messlokation, die zu diesem Vertragsteil gehören. Verträge für mehrere Lokationen werden mit mehreren Vertragsteilen abgebildet

maximale_abnahmemenge: Menge | None: Für die Lokation festgelegte maximale Abnahmemenge (exklusiv)

minimale_abnahmemenge: Menge | None: Für die Lokation festgelegte Mindestabnahmemenge (inklusiv)

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

vertraglich_fixierte_menge: Menge | None: Für die Lokation festgeschriebene Abnahmemenge

vertragsteilbeginn: AwareDatetime | None: Start der Gültigkeit des Vertragsteils (inklusiv)

vertragsteilende: AwareDatetime | None: Ende der Gültigkeit des Vertragsteils (exklusiv)

bo4e.com.verwendungszweckpromarktrolle module

Contains Verwendungszweck class and corresponding marshmallow schema for de-/serialization

class bo4e.com.verwendungszweckpromarktrolle.VerwendungszweckProMarktrolle(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, marktrolle: Marktrolle | None = None, zwecke: list[Verwendungszweck] | None = None, **extra_data: Any)[source]

Bases: COM

Dient zur Identifizierung des Verwendungszwecks der Marktrolle an der Marktlokation, der die Werte zu übermitteln sind.

Hint

Verwendungszweck JSON Schema

Zwecke: list[Verwendungszweck] | None: Verwendungszwecke

marktrolle: Marktrolle | None: Marktrolle, für die die Daten relevant sind

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

bo4e.com.zaehlwerk module

Contains Zaehlwerk class and corresponding marshmallow schema for de-/serialization

class bo4e.com.zaehlwerk.Zaehlwerk(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, zaehlwerkId: str | None = None, bezeichnung: str | None = None, richtung: Energierichtung | None = None, obisKennzahl: str | None = None, wandlerfaktor: Decimal | None = None, einheit: Mengeneinheit | None = None, istSchwachlastfaehig: bool | None = None, verwendungszwecke: list[VerwendungszweckProMarktrolle] | None = None, verbrauchsart: Verbrauchsart | None = None, istUnterbrechbar: bool | None = None, waermenutzung: Waermenutzung | None = None, konzessionsabgabe: Konzessionsabgabe | None = None, istSteuerbefreit: bool | None = None, vorkommastelle: int | None = None, nachkommastelle: int | None = None, istAbrechnungsrelevant: bool | None = None, anzahlAblesungen: int | None = None, zaehlzeitregister: Zaehlzeitregister | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente werden Zählwerke modelliert.

Hint

Zaehlwerk JSON Schema

anzahlAblesungen: int | None: Anzahl Ablesungen pro Jahr

bezeichnung: str | None: Zusätzliche Bezeichnung, z.B. Zählwerk_Wirkarbeit.

einheit: Mengeneinheit | None: Die Einheit der gemessenen Größe, z.B. kWh

ist_abrechnungsrelevant: bool | None: Abrechnungsrelevant

ist_schwachlastfaehig: bool | None: Schwachlastfaehigkeit

ist_steuerbefreit: bool | None: Steuerbefreiung

ist_unterbrechbar: bool | None: Unterbrechbarkeit Marktlokation

konzessionsabgabe: Konzessionsabgabe | None: Konzessionsabgabe

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

nachkommastelle: int | None: Anzahl der Nachkommastellen

obis_kennzahl: str | None: Die OBIS-Kennzahl für das Zählwerk, die festlegt, welche auf die gemessene Größe mit dem Stand gemeldet wird. Nur Zählwerkstände mit dieser OBIS-Kennzahl werden an diesem Zählwerk registriert.

richtung: Energierichtung | None: Die Energierichtung, Einspeisung oder Ausspeisung.

verbrauchsart: Verbrauchsart | None: Stromverbrauchsart/Verbrauchsart Marktlokation

verwendungszwecke: list[VerwendungszweckProMarktrolle] | None: Verwendungungszweck der Werte Marktlokation

vorkommastelle: int | None: Anzahl der Vorkommastellen

waermenutzung: Waermenutzung | None: Wärmenutzung Marktlokation

wandlerfaktor: Decimal | None: Mit diesem Faktor wird eine Zählerstandsdifferenz multipliziert, um zum eigentlichen Verbrauch im Zeitraum zu kommen.

zaehlwerk_id: str | None: Identifikation des Zählwerks (Registers) innerhalb des Zählers. Oftmals eine laufende Nummer hinter der Zählernummer. Z.B. 47110815_1

zaehlzeitregister: Zaehlzeitregister | None: Erweiterte Definition der Zählzeit in Bezug auf ein Register

bo4e.com.zaehlzeitregister module

Contains Zaehlzeitregister class and corresponding marshmallow schema for de-/serialization

class bo4e.com.zaehlzeitregister.Zaehlzeitregister(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, zaehlzeitDefinition: str | None = None, zaehlzeitRegister: str | None = None, istSchwachlastfaehig: bool | None = None, **extra_data: Any)[source]

Bases: COM

Mit dieser Komponente werden Zählzeitregister modelliert. Ein Zählzeitregister beschreibt eine erweiterte Definition der Zählzeit in Bezug auf ein Register. Dabei werden alle Codes dazu vom Netzbetreiber vergeben.

Hint

Zaehlzeitregister JSON Schema

ist_schwachlastfaehig: bool | None: Schwachlastfaehigkeit

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

zaehlzeit_definition: str | None: Zählzeitdefinition

zaehlzeit_register: str | None: Zählzeitregister

bo4e.com.zeitraum module

Contains Zeitraum class and corresponding marshmallow schema for de-/serialization

class bo4e.com.zeitraum.Zeitraum(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, einheit: Mengeneinheit | None = None, dauer: Decimal | None = None, startdatum: AwareDatetime | None = None, enddatum: AwareDatetime | None = None, startzeitpunkt: AwareDatetime | None = None, endzeitpunkt: AwareDatetime | None = None, **extra_data: Any)[source]

Bases: COM

Diese Komponente wird zur Abbildung von Zeiträumen in Form von Dauern oder der Angabe von Start und Ende verwendet. Es muss daher eine der drei Möglichkeiten angegeben sein: - Einheit und Dauer oder - Zeitraum: Startdatum bis Enddatum oder - Zeitraum: Startzeitpunkt (Datum und Uhrzeit) bis Endzeitpunkt (Datum und Uhrzeit)

Hint

Zeitraum JSON Schema

dauer: Decimal | None

einheit: Mengeneinheit | None

enddatum: AwareDatetime | None

endzeitpunkt: AwareDatetime | None

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

startdatum: AwareDatetime | None

startzeitpunkt: AwareDatetime | None

bo4e.com.zeitreihenwert module

Contains Zeitreihenwert class and corresponding marshmallow schema for de-/serialization

class bo4e.com.zeitreihenwert.Zeitreihenwert(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, zeitspanne: Zeitspanne | None = None, wert: Decimal | None = None, status: Messwertstatus | None = None, statuszusatz: Messwertstatuszusatz | None = None, **extra_data: Any)[source]

Bases: COM

Abbildung eines Zeitreihenwertes bestehend aus Zeitraum, Wert und Statusinformationen.

Hint

Zeitreihenwert JSON Schema

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

status: Messwertstatus | None: Der Status gibt an, wie der Wert zu interpretieren ist, z.B. in Berechnungen.

statuszusatz: Messwertstatuszusatz | None: Eine Zusatzinformation zum Status, beispielsweise ein Grund für einen fehlenden Wert.

wert: Decimal | None: Der in der Zeitspanne gültige Wert.

zeitspanne: Zeitspanne | None: Zeitespanne für das Messintervall

bo4e.com.zeitspanne module

contains the COM Zeitspanne

class bo4e.com.zeitspanne.Zeitspanne(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, start: AwareDatetime | None = None, ende: AwareDatetime | None = None, **extra_data: Any)[source]

Bases: COM

Eine Zeitspanne ist definiert aus Start und/oder Ende. Der Unterschied zur Menge (die auch zur Abbildung von Zeitmengen genutzt wird) ist, dass konkrete Start- und Endzeitpunkte angegeben werden. Die Zeitspanne ist aus dem COM Zeitraum hervorgegangen, das in Zeitspanne und Menge aufgeteilt wurde.

Hint

Zeitspanne JSON Schema

ende: AwareDatetime | None: exklusives Ende

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

start: AwareDatetime | None: inklusiver Beginn

bo4e.com.zustaendigkeit module

Contains Zustaendigkeit class and corresponding marshmallow schema for de-/serialization

class bo4e.com.zustaendigkeit.Zustaendigkeit(*, _version: str | None = '202401.4.1.dev50+g7314aa9f', _id: str | None = None, zusatzAttribute: list[ZusatzAttribut] | None = None, themengebiet: Themengebiet | None = None, position: str | None = None, abteilung: str | None = None, **extra_data: Any)[source]

Bases: COM

Enthält die zeitliche Zuordnung eines Ansprechpartners zu Abteilungen und Zuständigkeiten.

Hint

Zustaendigkeit JSON Schema

abteilung: str | None: Abteilung, in der der Ansprechpartner/ die Person tätig ist

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}: A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

position: str | None: Berufliche Rolle des Ansprechpartners/ der Person

themengebiet: Themengebiet | None: Hier kann eine thematische Zuordnung des Ansprechpartners bzw. der Person angegeben werden

bo4e.com package

Submodules

bo4e.com.adresse module

bo4e.com.angebotsposition module

bo4e.com.angebotsteil module

bo4e.com.angebotsvariante module

bo4e.com.aufabschlag module

bo4e.com.aufabschlagproort module

bo4e.com.aufabschlagregional module

bo4e.com.aufabschlagstaffelproort module

bo4e.com.ausschreibungsdetail module

bo4e.com.ausschreibungslos module

bo4e.com.betrag module

bo4e.com.com module

bo4e.com.dienstleistung module

bo4e.com.energieherkunft module

bo4e.com.energiemix module

bo4e.com.fremdkostenblock module

bo4e.com.fremdkostenposition module

bo4e.com.geokoordinaten module

bo4e.com.katasteradresse module

bo4e.com.konfigurationsprodukt module

bo4e.com.kontaktweg module

bo4e.com.konzessionsabgabe module

bo4e.com.kostenblock module

bo4e.com.kostenposition module

bo4e.com.kriteriumwert module

bo4e.com.marktgebietinfo module

bo4e.com.menge module

bo4e.com.positionsaufabschlag module

bo4e.com.preis module

bo4e.com.preisgarantie module

bo4e.com.preisposition module

bo4e.com.preisstaffel module

bo4e.com.rechnungsposition module

bo4e.com.regionalegueltigkeit module

bo4e.com.regionalepreisgarantie module

bo4e.com.regionalepreisstaffel module

bo4e.com.regionaleraufabschlag module

bo4e.com.regionaletarifpreisposition module

bo4e.com.regionskriterium module

bo4e.com.sigmoidparameter module

bo4e.com.standorteigenschaftengas module

bo4e.com.standorteigenschaftenstrom module

bo4e.com.steuerbetrag module

bo4e.com.tarifberechnungsparameter module

bo4e.com.tarifeinschraenkung module

bo4e.com.tarifpreis module

bo4e.com.tarifpreisposition module

bo4e.com.tarifpreispositionproort module

bo4e.com.tarifpreisstaffelproort module

bo4e.com.unterschrift module

bo4e.com.verbrauch module

bo4e.com.vertragskonditionen module

bo4e.com.vertragsteil module

bo4e.com.verwendungszweckpromarktrolle module

bo4e.com.zaehlwerk module

bo4e.com.zaehlzeitregister module

bo4e.com.zeitraum module

bo4e.com.zeitreihenwert module

bo4e.com.zeitspanne module

bo4e.com.zustaendigkeit module

Module contents