Funk­ti­ons­um­fang

Die Funk­ti­on der Markt­part­ner­er­mitt­lung dient dazu, für jeden belie­bi­gen Stand­ort den zustän­di­gen Markt­part­ner einer bestimm­ten Rol­le zu ermit­teln. Dazu zäh­len Netz­be­trei­ber, Grund­ver­sor­ger, Mess­stel­len­be­trei­ber und für his­to­ri­sche Zeit­räu­me auch Messdienstleister.

Ein­ga­be

Zum Abruf der Kon­takt­da­ten eines Markt­part­ners müs­sen ​„Post­leit­zahl“, ​„Ort“, ​„Stra­ße“ und ​„Haus­num­mer“ der betrof­fe­nen Lie­fer­stel­le an die Schnitt­stel­le des Web­ser­vice über­tra­gen wer­den. Über die optio­na­le Anga­be des Para­me­ters ​„Orts­teil“ kann die Adres­se genau­er bestimmt wer­den. Wei­ter­hin müs­sen die gewünsch­te ​„Mark­trol­le (Netz­be­trei­ber, Lie­fe­rant, Mess­stel­len­be­trei­ber oder Mess­dienst­leis­ter)“, die jewei­li­ge ​„Span­nungs­ebe­ne“ sowie der betrach­te­te ​„Stich­tag“ über­ge­ben werden.

Ver­ar­bei­tung

Es wird der an der über­ge­be­nen Adres­se am gewähl­ten Stich­tag akti­ve Markt­teil­neh­mer ermit­telt. Für die­sen wer­den die aktu­ells­ten Markt­part­ner­in­for­ma­tio­nen zurück­ge­lie­fert. Unab­hän­gig vom Stich­tag wer­den immer die aktu­ell gül­ti­gen Infor­ma­tio­nen ausgegeben.

Aus­ga­be

Der Web­ser­vice lie­fert als Ergeb­nis einen Daten­satz zurück, der den Unter­neh­mens­na­men des ermit­tel­ten Markt­part­ners, die Anschrift sei­nes Haupt­stand­orts, die Ver­band­s­code­num­mer sowie die 1:1‑Kommunikationsadresse ent­hält. Die Struk­tur des Daten­sat­zes ent­spricht den stan­dar­di­sier­ten Spe­zi­fi­ka­tio­nen des Geschäfts­ob­jekts ​„BO Marktteilnehmer“.

Das Web­ser­vice­pa­ket wur­de nach dem RESTful-Para­dig­ma ent­wi­ckelt. Der Archi­tek­tur­stil REST (Repre­sen­ta­tio­nal Sta­te Trans­fer) ermög­licht eine platt­form­un­ab­hän­gi­ge Maschi­ne-zu-Maschi­ne-Kom­mu­ni­ka­ti­on. Es kom­men aus­schließ­lich stan­dar­di­sier­te HTTP-Metho­den zum Ein­satz, inner­halb derer Daten in unter­schied­li­chen For­ma­ten und Struk­tu­ren aus­ge­lie­fert wer­den können.

Zugangs­vor­aus­set­zun­gen