FAQ

Wozu wird der initiale Marktpartner Import benötigt und wie kommen die Marktpartner in den PKS?

Die B2B routet (gemäß üblicher Installation/Konfiguration) eingehende und valide PARTIN Nachrichten von allen in der B2B hinterlegten Marktpartnern in den PKS. Kommt eine PARTIN eines neuen Marktpartners an, wird dieser im PKS neu angelegt und bei Versand der eigenen PARTIN “an alle” entsprechend berücksichtigt.

Damit initial zur Einführung der PARTIN Marktkommunikation am 01.10.2022 auch an alle bereits bestehenden Marktpartner (der ILN) eine PARTIN mit den eigenen Kontaktdaten versendet werden kann, wird ein initialen Import der Marktpartner in den PKS benötigt. Hierzu werden nur die ILNs (mit Codevergabestelle sofern abweichend vom BDEW) und deren Marktrollen zwingend benötigt, an die der PKS Mandant gemäß Marktkommunikation PARTIN versenden muss.

Durchführung

Automatischer Import aus B2B Marktpartnerverwaltung

Seit dem 4.1.2024 verfügt das PKS Backend über einen neuen REST Endpunkt zum Import der Marktpartnerdaten des PKS Mandanten aus der B2B Marktpartnerverwaltung. Hierbei muss darauf geachtet werden, dass insbesondere die Marktrollen der Partner richtig importiert werden, damit der PKS für den Versand an die Marktpartner diese korrekt berücksichtigen kann.

Die Marktrollen zu den Partnern können leider unterschiedlich in Ihrer B2B Marktpartnerverwaltung angelegt worden sein. Dies sollte daher beim Import der Marktpartner durch den Request-Body des Import-Aufrufs PUT /partner/b2b-import berücksichtigt werden.

Üblicherweise gibt es in der das Feld der “SA-ID”. Es kann dann ein Mapping der in der B2B hinterlegten Marktrolle auf die PKS-Marktrolle (mögliche Werte: MSB, NB, LF, BKV, BIKO, UENB, ESA, OTHER, UNDEFINED) hinterlegt werden.

Beispiel 1

Wenn Sie für Partner in der Marktrolle Netzbetreiber den Wert (oder auch nur Präfix) “NETZ” in der SA-ID gepflegt haben und für Messstellenbetreiber den Wert “MESS” oder auch “MSB”, so sollten Sie den folgenden Request-Body zum Marktrollen-Mapping mitgeben:

{
    "prefixToMarketRoleMap": {
        "NETZ": "NB",
        "MESS": "MSB",
        "MSB": "MSB"
    }
}

Beispiel 2

Wenn Sie die Rolle der Marktpartner durch einen Präfix in Marktpartner-Namen definiert haben, dann können Sie dies damit tun, dass sie zudem das “marketRoleField” mit dem Wert “PARTNER_NAME” (Default: “SERVICE_PROVIDER_ID”) hinzufügen:

{
    "prefixToMarketRoleMap": {
        "NETZ": "NB",
        "MESS": "MSB",
        "MSB": "MSB"
    },
	"marketRoleField": "PARTNER_NAME"
}

Manueller Import

Es müssen hierzu nur die Marktpartner, die mit dem Mandanten/ILN des PKS kommunizieren, in die Partner-Tabelle eingetragen werden. Dazu werden nur deren ILN (mit Codevergabestelle falls ungleich BDEW), Marktrolle und optional der Name des Partners benötigt.

Die aktuellen Marktpartner des Mandanten und deren Daten können, die zum initialen Import in den PKS benötigt werden, können beispielsweise aus der B2B-Marktpartnerverwaltung entnommen werden. Diese werden technisch oftmals in der Extension MPID_SYNC oder auf der entsprechenden Datenbanktabelle b2bbp_data_mp_contacts gespeichert.

Der initiale Marktpartner Import in den PKS findet dann per einfachem SQL Statement statt:

insert into pks_partner (iln, registrar, created, market_role, market_section, name, contact_sheet_state) values
('9900000000001', 'BDEW', '2022-05-31T11:00:00', 'LF', 'STROM', 'Lieferant Example AG', null),
('9900000000002', null, '2022-05-31T11:00:00', 'MSB', 'STROM', 'Messstellenbetreiber Test GmbH', null),
('4100000000003', 'GS1', '2022-05-31T11:00:00', 'NB', 'STROM', 'Netzbetreiber Beispiel GmbH', null);

Zur manuellen Erstellung des SQLs aus den Marktpartnerdaten der B2B (via Notepad/Excel) helfen wir auf Anfrage gerne.

Unterstützte Marktrollen (Abkürzungen gemäß BDEW Konvention): LF, MSB, NB, BKV, BIKO, UENB, ESA, (OTHER, UNDEFINED).

Hinweis: Wir empfehlen (aus Sicht der Datenhaltung) zunächst nur die Marktpartner zu importieren, welche gemäß ihrer Rolle an der PARTIN Kommunikation mit dem PKS Mandanten teilnehmen.