MACO APP | DOC
FUM 10 / 25
  • FUM 10 / 25
  • FUM 04 / 25
SchnittstellenProzessdokumentationenBO4E Geschäftsobjekte
SchnittstellenProzessdokumentationenBO4E Geschäftsobjekte
FUM 10 / 25
  • FUM 10 / 25
  • FUM 04 / 25
  1. Schnittstellen
  • Ü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)
    • 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
    • Einzelansicht MSB
      • Stammdatenänderung vom Messstellenbetreiber (verantwortlich)
    • Trigger Events
    • Authentifizierung
  • BO4E Lesen (Backend)
    • Avis lesen
    • Berechnungsformel lesen
    • Bilanzierung lesen
    • Energieliefervertrag lesen
    • Energiemengen aus Abrechnungskontext lesen
    • Lastgangs einer Lokation lesen
    • Zählerstand einer Lokation lesen
    • Kommunikationsdaten des Serviceanbieters lesen
    • Lokationsbündel lesen
    • Marktlokation lesen
    • Messlokation lesen
    • Messstellenbetriebsvertrag lesen
    • Netzlokation lesen
    • Netznutzungsvertrag lesen
    • Steuerbare Ressource lesen
    • Technische Ressource lesen
    • Tranche lesen
    • Zähler lesen
  • 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
  • MCS Eingang (MACO APP)
    • Empfang einer Marktnachricht
  1. Schnittstellen

Fehlercodes

Übersicht der Schnittstellen Fehlercodes.

Antwortcodes#

Die MACO APP verwendet standardmäßige HTTP-Codes, um den Erfolg oder Misserfolg Ihrer Anfragen anzuzeigen.
2xx HTTP-Codes stehen für erfolgreiche Anfragen.
4xx HTTP-Codes stehen für fehlerhafte Anfragen seitens des Nutzers.
5xx HTTP-Codes deuten auf ein Problem mit den MACO APP-Servern hin.

Statuscodes#

StatuscodeBeschreibung
200Erfolgreiche Anfrage.
4xxClient-Fehler, siehe Fehlercodes.
5xxFehler auf den MACO APP-Servern.

Fehler-Schema#

MACO APP verwendet HTTP-Standardcodes zur Anzeige von Erfolgen oder Fehlern. Die folgenden Fehlercodes können auftreten:
StatuscodeTypBeschreibung
400malformedDie Anfrage enthält Syntaxfehler, z. B. ein nicht lesbares JSON-Format.
401unauthenticatedDie Anfrage enthält keine gültigen Zugangsdaten.
403permissionDeniedDer authentifizierte Benutzer hat keine Berechtigung für diese Anfrage.
404notFoundDie angeforderte Ressource existiert nicht.
409conflictDie Anfrage steht in Konflikt mit einer anderen Anfrage.
422invalidDie Anfrage enthält ungültige Parameter.
429rateLimitedZu viele Anfragen in kurzer Zeit – der Client wurde vorübergehend geblockt.
500internalEin unerwarteter Fehler ist aufgetreten, das Ergebnis ist unbekannt.
501notImplementedDie angeforderte Operation wird nicht unterstützt oder ist nicht implementiert.
502badGatewayDer Server hat eine ungültige Antwort vom Upstream-Server erhalten.
503unavailableDer Service ist momentan nicht verfügbar (z. B. Wartung oder Überlastung).
504timeoutDer Server hat vom Upstream-Server keine rechtzeitige Antwort erhalten.
505httpVersionNotSupportedDie HTTP-Version der Anfrage wird vom Server nicht unterstützt.

Fehlerbehandlung#

Wenn ein Fehler auftritt, enthält die Antwort zusätzliche Informationen über das Problem.
Previous
Änderungsprotokoll Schnittstellen
Next
Geschäftsobjekte