MACO APP | DOC
FUM 10 / 26
  • FUM 10 / 26
  • FUM 04 / 26
  • FUM 10 / 25
Schnittstellen
ProzessdokumentationenBO4E Geschäftsobjekte
Schnittstellen
ProzessdokumentationenBO4E Geschäftsobjekte
FUM 10 / 26
  • FUM 10 / 26
  • FUM 04 / 26
  • FUM 10 / 25
FUM 10 / 26
  • FUM 10 / 26
  • FUM 04 / 26
  • FUM 10 / 25
  1. BO4E Lesen (Backend)
  • Übersicht
  • Änderungsprotokoll Schnittstellen
  • Fehlercodes
  • Geschäftsobjekte
  • Trigger (MACO APP)
    • Einzelansicht LF
      • ECS Steuerprozess Lieferbeginn
      • Identifikation einer Marktlokation
      • Kündigungsprozess zwischen Lieferanten
      • Lieferbeginn
      • Lieferende von Lieferant an Netzbetreiber
      • Stammdatenänderung vom Lieferanten (verantwortlich)
      • Anfrage nach Stornierung
      • Übermittlung von Zählerständen vom LF
      • Bestellung zur Stammdatenänderung an NB / MSB (Lieferant)
      • Reklamation von Werten
      • Bestellung Abrechnungsdaten
      • Kommunikationsdatenblatt PARTIN
      • Geschäftsdatenanfrage
    • Einzelansicht NB
      • Anfrage zur Beendigung der Zuordnung des LFA zur Marktlokation bzw. Tranche
      • Aufhebung der Zuordnung des LFZ zur Marklokation bzw. Tranche versenden
      • Beendigung der Zuordnung des LFA zur Marklokation bzw. Tranche
      • Abrechnungsdaten Netznutzungsabrechnung versenden
      • Abrechnungsdaten Bilanzkreisabrechnung versenden
      • Stammdatenänderung vom Netzbetreiber (verantwortlich)
      • Einrichtung der Konfigurationen aufgrund einer Zuordnung eines LF zu einer MaLo oder Tranche
      • Übermittlung der Berechnungsformel
      • Wiederherstellung Anschlussnutzung nach LB
      • Lieferende von Netzbetreiber an Lieferant
      • Ersatz-/Grundversorgung
      • Anfrage nach Stornierung
      • Überprüfung einner EEG-Marklokation mit DV-Pflicht auf 100% LF-Zuordnung (Rolle NB)
      • Übermittlung des Lieferscheins zur Netznutzungsabrechnung
      • Übermittlung von Zählerständen vom NB
      • Widerspruch gegen Ablehnung
      • Stornierung Lieferschein
    • Einzelansicht MSB
      • Stammdatenänderung vom Messstellenbetreiber (verantwortlich)
    • Anfrage nach Stornierung
    • Trigger Events
    • Authentifizierung
  • BO4E Lesen (Backend)
    • Angebot lesen
      GET
    • Auftrag lesen
      GET
    • Avis lesen
      GET
    • Berechnungsformel lesen
      GET
    • Bilanzierung lesen
      GET
    • Energieliefervertrag lesen
      GET
    • Energiemengen aus Abrechnungskontext lesen
      GET
    • Lastgangs einer Lokation lesen
      GET
    • Zählerstand einer Lokation lesen
      GET
    • Kommunikationsdaten des Serviceanbieters lesen
      GET
    • Lokationsbündel lesen
      GET
    • Marktlokation lesen
      GET
    • Messlokation lesen
      GET
    • Messstellenbetriebsvertrag lesen
      GET
    • Netzlokation lesen
      GET
    • Netznutzungsvertrag lesen
      GET
    • Preisblatt lesen
      GET
    • Steuerbare Ressource lesen
      GET
    • Technische Ressource lesen
      GET
    • Tranche lesen
      GET
    • Zähler lesen Basis
      GET
    • Zähler lesen Konfig
      GET
    • KonfigurationsId lesen
      GET
    • Schaltzeitdefinition lesen
      GET
    • Leistungskurvendefinition lesen
      GET
    • Zaehlzeitdefinition lesen
      GET
    • Marktlokation identifizieren
      POST
  • Prozessdaten lesen (Backend)
    • Zuordnungsemächtigung lesen
  • Prozessdaten LF (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • Prozessdaten NB (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • Prozessdaten MSB (Backend)
    • Prozessdaten aktualiseren
    • Prozessdaten erstellen
  • MaloIdent LF (Backend)
    • Prozessdaten aktualisieren
    • Identifikation einer Marktlokation
  • MaloIdent NB (Backend)
    • Identifizierung der MaLo
    • Stammdaten der identifiz. MaLo
  • Obsolet
    • Verwendungszeitraum einer Marktlokation ermitteln
    • Absenderdaten lesen
    • Empfängerdaten lesen
  • MaLo-Ident
    • Übersicht
    • MaloIdent Anfrage auslösen
      POST
    • Identifizierung der MaLo
      POST
    • Stammdaten der identifiz. MaLo
      GET
    • Prozessdaten aktualisieren
      POST
  • LOKATIONIDENT
    • Übersicht
    • Identifizierung der Lokation
    • Stammdaten der identifiz. MaLo
    • Prozessdaten aktualisieren
  • MCS Eingang (MACO APP)
    • Empfang einer Marktnachricht
  1. BO4E Lesen (Backend)

Angebot lesen

Developing
GET
/getOfferBasic
OperationId:LESEN_ANGEBOT_BASIS
Lesen des Angebots mittels angebotsnummer (Parameter1)

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Responses

🟢200OK
application/json
Erfolgreiches Lesen des Avises
Bodyapplication/json

Example
[
    {
        "boTyp": "ANSPRECHPARTNER",
        "versionStruktur": "1",
        "angebotsnummer": "string",
        "anfragereferenz": "string",
        "angebotsdatum": "2019-08-24T14:15:22.123Z",
        "sparte": "STROM",
        "bindefrist": "2019-08-24T14:15:22.123Z",
        "angebotgeber": {
            "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"
        },
        "angebotnehmer": {
            "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"
        },
        "unterzeichnerAngebotsnehmer": {
            "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Ansprechpartner.json"
        },
        "unterzeichnerAngebotsgeber": {
            "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Ansprechpartner.json"
        },
        "zeitspanneEinrichtungUebermittlungWerte": {
            "zeiteinheit": "SEKUNDE",
            "dauer": 0,
            "startdatum": "2019-08-24T14:15:22.123Z",
            "enddatum": "2019-08-24T14:15:22.123Z",
            "einheit": "SEKUNDE",
            "ableseZeitraum": "string",
            "abrechnungsZeitraum": "string",
            "zeitraumText": "string",
            "zeitraumId": 0
        },
        "bindefristAngebot": {
            "zeiteinheit": "SEKUNDE",
            "dauer": 0,
            "startdatum": "2019-08-24T14:15:22.123Z",
            "enddatum": "2019-08-24T14:15:22.123Z",
            "einheit": "SEKUNDE",
            "ableseZeitraum": "string",
            "abrechnungsZeitraum": "string",
            "zeitraumText": "string",
            "zeitraumId": 0
        },
        "varianten": [
            {
                "angebotsstatus": "KONZEPTION",
                "beschreibung": "string",
                "erstelldatum": "2019-08-24T14:15:22.123Z",
                "bindefrist": "2019-08-24T14:15:22.123Z",
                "gesamtmenge": {
                    "wert": 0,
                    "einheit": "W"
                },
                "gesamtkosten": {
                    "wert": 0,
                    "waehrung": "string"
                },
                "teile": [
                    {
                        "anfrageSubreferenz": "string",
                        "gesamtmengeangebotsteil": {
                            "wert": 0,
                            "einheit": "W"
                        },
                        "gesamtkostenangebotsteil": {
                            "wert": 0,
                            "waehrung": "string"
                        },
                        "lieferzeitraum": {
                            "zeiteinheit": "SEKUNDE",
                            "dauer": 0,
                            "startdatum": "2019-08-24T14:15:22.123Z",
                            "enddatum": "2019-08-24T14:15:22.123Z",
                            "einheit": "SEKUNDE",
                            "ableseZeitraum": "string",
                            "abrechnungsZeitraum": "string",
                            "zeitraumText": "string",
                            "zeitraumId": 0
                        },
                        "verweisKatalognummer": {
                            "katalognummer": "string",
                            "zeilennummer": "string",
                            "versionsnummer": "string"
                        },
                        "lieferstellenangebotsteil": [
                            {
                                "boTyp": "ANSPRECHPARTNER",
                                "versionStruktur": "1",
                                "marktlokationsId": "string",
                                "sparte": "STROM",
                                "energierichtung": "AUSSP",
                                "bilanzierungsmethode": "RLM",
                                "verbrauchsart": [
                                    "KL"
                                ],
                                "unterbrechbar": true,
                                "netzebene": "NSP",
                                "umspannung": "NSP",
                                "netzbetreiberCodeNr": "string",
                                "gebietTyp": "REGELZONE",
                                "netzgebietNr": "string",
                                "bilanzierungsgebiet": "string",
                                "grundversorgerCodeNr": "string",
                                "gasqualitaet": "H_GAS",
                                "endkunde": {
                                    "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"
                                },
                                "lokationsadresse": {
                                    "postleitzahl": "string",
                                    "ort": "string",
                                    "strasse": "string",
                                    "hausnummer": "string",
                                    "postfach": "string",
                                    "adresszusatz": "string",
                                    "coErgaenzung": "string",
                                    "landescode": "AC",
                                    "ortsteil": "string",
                                    "zusatzInformation": {
                                        "zusatz1": "string",
                                        "zusatz2": "string",
                                        "zusatz3": "string",
                                        "zusatz4": "string",
                                        "zusatz5": "string"
                                    }
                                },
                                "katasterinformation": {
                                    "gemarkung_flur": "string",
                                    "flurstueck": "string",
                                    "flurstueckNummer": "string"
                                },
                                "regelzone": "string",
                                "marktgebiet": "string",
                                "zeitreihentyp": "EGS",
                                "messtechnischeEinordnung": "IMS",
                                "sperrstatus": "ENTSPERRT",
                                "referenzMarktlokationsId": "string",
                                "versorgungsart": "ERSATZVERSORGUNG",
                                "eigentuemer": {
                                    "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"
                                },
                                "hausverwalter": {
                                    "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Geschaeftspartner.json"
                                },
                                "verguetungEmpfaenger": "KUNDE",
                                "statusErzeugendeMalo": "EINSPEISEVERGUETUNG_PARAGRAPH_37",
                                "fernsteuerbarkeit": "TECHNISCH_NICHT_FERNSTEUERBAR",
                                "foerderungsLand": "string",
                                "redispatch": true,
                                "zukuenftigerMeldepunkt": true,
                                "lokationszuordnung": "UNVERAENDERT",
                                "konfigurationsprodukt": "string",
                                "leistungskurvendefinition": "string",
                                "produktdatenRelevanteRolle": "NB",
                                "beteiligterMarktpartner": {
                                    "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Marktteilnehmer.json"
                                },
                                "modulNetzentgelte": "PAUSCHALE_NETZGELDREDUZIERUNG_MODUL_1",
                                "datenqualitaet": "ERWARTETE_DATEN",
                                "gueltigkeitszeitraum": {
                                    "zeiteinheit": "SEKUNDE",
                                    "dauer": 0,
                                    "startdatum": "2019-08-24T14:15:22.123Z",
                                    "enddatum": "2019-08-24T14:15:22.123Z",
                                    "einheit": "SEKUNDE",
                                    "ableseZeitraum": "string",
                                    "abrechnungsZeitraum": "string",
                                    "zeitraumText": "string",
                                    "zeitraumId": 0
                                },
                                "marktrollen": [
                                    {
                                        "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Marktteilnehmer.json"
                                    }
                                ],
                                "zaehlwerke": [
                                    {
                                        "zaehlwerkId": "string",
                                        "bezeichnung": "string",
                                        "richtung": "AUSSP",
                                        "obisKennzahl": "string",
                                        "wandlerfaktor": 0,
                                        "einheit": "W",
                                        "schwachlastfaehig": "SCHWACHLASTFAEHIG",
                                        "verbrauchsart": [
                                            "KL"
                                        ],
                                        "unterbrechbarkeit": "UV",
                                        "waermenutzung": "SPEICHERHEIZUNG",
                                        "konzessionsabgabe": {
                                            "satz": "KAS",
                                            "kosten": 0,
                                            "kategorie": "string"
                                        },
                                        "steuerbefreit": true,
                                        "vorkommastelle": 0,
                                        "nachkommastelle": 0,
                                        "abrechnungsrelevant": true,
                                        "anzahlAblesungen": 0,
                                        "zaehlzeiten": {
                                            "register": "string",
                                            "zaehlzeitDefinition": "string",
                                            "schwachlastfaehig": "SCHWACHLASTFAEHIG"
                                        },
                                        "konfiguration": "string",
                                        "messprodukt": "string",
                                        "wertegranularitaet": "JAEHRLICH",
                                        "notwendigkeitZweiteMessung": "VORHANDEN",
                                        "werteuebermittlungVerwendungszweck": "VORHANDEN",
                                        "artEMobilitaet": "WB",
                                        "konfigurationsprodukt": "string",
                                        "keinKonfigurationsprodukt": true,
                                        "leistungskurvendefinition": "string",
                                        "verwendungszwecke": [
                                            {
                                                "marktrolle": "NB",
                                                "zweck": [
                                                    "NETZNUTZUNGSABRECHNUNG"
                                                ]
                                            }
                                        ],
                                        "verwendungszweckNB": "string",
                                        "verwendungszweckLF": "string",
                                        "verwendungszweckUENB": "string",
                                        "keinProdukt": true
                                    }
                                ],
                                "zaehlwerkeBeteiligteMarktrolle": [
                                    "NB"
                                ],
                                "verbrauchsmenge": [
                                    {
                                        "startdatum": "2019-08-24T14:15:22.123Z",
                                        "enddatum": "2019-08-24T14:15:22.123Z",
                                        "wertermittlungsverfahren": "PROGNOSE",
                                        "messwertstatus": "ABGELESEN",
                                        "obiskennzahl": "string",
                                        "wert": 0,
                                        "einheit": "W",
                                        "type": "ARBEITLEISTUNGTAGESPARAMETERABHMALO",
                                        "tarifstufe": "TARIFSTUFE_0",
                                        "nutzungszeitpunkt": "2019-08-24T14:15:22.123Z",
                                        "ausfuehrungszeitpunkt": "2019-08-24T14:15:22.123Z",
                                        "position": 0,
                                        "ablesedatum": "2019-08-24T14:15:22.123Z",
                                        "leistungsperiode": "string",
                                        "statuszusatzinformationen": [
                                            {
                                                "art": "PLAUSIBILISIERUNGSHINWEIS",
                                                "status": "KUNDENSELBSTABLESUNG"
                                            }
                                        ]
                                    }
                                ],
                                "zugehoerigeMesslokationen": [
                                    {
                                        "messlokationsId": "string",
                                        "arithmetik": "ADDITION",
                                        "gueltigSeit": "2019-08-24T14:15:22.123Z",
                                        "gueltigBis": "2019-08-24T14:15:22.123Z"
                                    }
                                ],
                                "netznutzungsabrechnungsdaten": [
                                    {
                                        "artikelId": "string",
                                        "artikelIdTyp": "ARTIKELID",
                                        "anzahl": 0,
                                        "gemeinderabatt": 0,
                                        "zuschlag": 0,
                                        "abschlag": 0,
                                        "singulaereBetriebsmittel": {
                                            "wert": 0,
                                            "einheit": "W"
                                        },
                                        "preisSingulaereBetriebsmittel": {
                                            "wert": 0,
                                            "einheit": "EUR",
                                            "bezugswert": "W",
                                            "status": "VORLAEUFIG",
                                            "menge": 0,
                                            "minimaleMenge": 0,
                                            "maximaleMenge": 0,
                                            "preisart": "EINRICHTUNGSPREIS"
                                        },
                                        "abrechnungBlindarbeit": true,
                                        "zahlerBlindarbeit": "ANSCHLUSSNUTZER",
                                        "zahlerBlindarbeitLf": true,
                                        "differenzDaten": true,
                                        "zaehlzeiten": {
                                            "register": "string",
                                            "zaehlzeitDefinition": "string",
                                            "schwachlastfaehig": "SCHWACHLASTFAEHIG"
                                        }
                                    }
                                ],
                                "messstellenbetriebsabrechnungsdaten": [
                                    {
                                        "messstellenbetriebsabrechnung": true,
                                        "artikelId": "string",
                                        "artikelIdTyp": "ARTIKELID",
                                        "anzahl": 0,
                                        "zuschlag": 0,
                                        "abschlag": 0
                                    }
                                ],
                                "energieherkunft": [
                                    {
                                        "erzeugungsart": "EEG",
                                        "anteilProzent": 0
                                    }
                                ],
                                "erforderlichesProduktpaket": [
                                    {
                                        "produktpaketId": 0,
                                        "produkt": [
                                            {
                                                "produktCode": "string",
                                                "codeProdukteigenschaft": "string",
                                                "wertedetails": "string"
                                            }
                                        ],
                                        "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR",
                                        "priorisierung": "PRIORITAET1"
                                    }
                                ],
                                "geokoordinaten": {
                                    "breitengrad": "string",
                                    "laengengrad": "string",
                                    "ostwert": "string",
                                    "nordwert": "string",
                                    "zone": "UTMZone31",
                                    "hochwert": "string",
                                    "rechtswert": "string"
                                },
                                "paketId": "P9705070235",
                                "marktlokationsTyp": [
                                    {
                                        "typ": "STANDARD_MARKTLOKATION",
                                        "gueltigAb": "2019-08-24T14:15:22.123Z",
                                        "gueltigBis": "2019-08-24T14:15:22.123Z"
                                    }
                                ],
                                "zugehoerigeMarktlokationen": [
                                    {
                                        "marktlokationsId": "string",
                                        "typ": "STANDARD_MARKTLOKATION"
                                    }
                                ],
                                "technischeEinrichtungen": [
                                    {
                                        "technischeEinrichtungenVorhanden": true,
                                        "verbrauchsart": "KL"
                                    }
                                ]
                            }
                        ],
                        "positionen": [
                            {
                                "positionsmenge": {
                                    "wert": 0,
                                    "einheit": "W"
                                },
                                "positionspreis": {
                                    "wert": 0,
                                    "einheit": "EUR",
                                    "bezugswert": "W",
                                    "status": "VORLAEUFIG",
                                    "menge": 0,
                                    "minimaleMenge": 0,
                                    "maximaleMenge": 0,
                                    "preisart": "EINRICHTUNGSPREIS"
                                },
                                "positionsbetrag": {
                                    "wert": 0,
                                    "waehrung": "string"
                                },
                                "preisschluesselstamm": "string",
                                "artikelnummer": "ARTIKELID",
                                "artikelId": [
                                    "string"
                                ],
                                "positionsbezeichnung": "string",
                                "anbietbar": true,
                                "freitext": "string",
                                "verweisKatalognummer": {
                                    "katalognummer": "string",
                                    "zeilennummer": "string",
                                    "versionsnummer": "string"
                                },
                                "beteiligterMarktpartner": {
                                    "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Marktteilnehmer.json"
                                },
                                "referenzMarktlokationsIds": [
                                    "string"
                                ],
                                "konfigurationsprodukt": "string"
                            }
                        ]
                    }
                ]
            }
        ],
        "positionsdaten": [
            {
                "positionsmenge": {
                    "wert": 0,
                    "einheit": "W"
                },
                "positionspreis": {
                    "wert": 0,
                    "einheit": "EUR",
                    "bezugswert": "W",
                    "status": "VORLAEUFIG",
                    "menge": 0,
                    "minimaleMenge": 0,
                    "maximaleMenge": 0,
                    "preisart": "EINRICHTUNGSPREIS"
                },
                "positionsbetrag": {
                    "wert": 0,
                    "waehrung": "string"
                },
                "preisschluesselstamm": "string",
                "artikelnummer": "ARTIKELID",
                "artikelId": [
                    "string"
                ],
                "positionsbezeichnung": "string",
                "anbietbar": true,
                "freitext": "string",
                "verweisKatalognummer": {
                    "katalognummer": "string",
                    "zeilennummer": "string",
                    "versionsnummer": "string"
                },
                "beteiligterMarktpartner": {
                    "$ref": "https://raw.githubusercontent.com/conuti-gmbh/bo4e-schema/master/docs/examples/bo/Marktteilnehmer.json"
                },
                "referenzMarktlokationsIds": [
                    "string"
                ],
                "konfigurationsprodukt": "string"
            }
        ]
    }
]
🟠400Bad Request
🟠422Parameter Error
Previous
BO4E Lesen (Backend)
Next
Auftrag lesen