mako-gpke

GPKE — Geschäftsprozesse zur Kundenbelieferung mit Elektrizität

Process engine workflows for the German electricity market supplier-switch and grid access billing processes. Implements the BDEW GPKE specification and BNetzA rulings:

BK6-24-174 (Beschluss 24.10.2024, gültig seit 06.06.2025) — GPKE Teil 1–3 (Lieferantenwechsel, Zuordnungsprozesse)
BK6-22-024 (Beschluss 21.03.2024) — GPKE Teil 4 (Stammdatenprozesse) + ex-MPES absorption (LFW24, effective 2025-06-06)

APERAK Frist

GPKE processes use 24 wall-clock hours (fristen::add_hours(24)) for the APERAK response deadline — not Werktage. This is enforced by BK6-22-024.

PID Inventory

UTILMD supplier-switch and feed-in processes (S2.1/S2.2)

Legend: ✅ Implemented — full state machine, AHB-validated, production-safe. ↩ Derived — emitted by workflow as outbound ANTWORT, not routed as inbound. ❌ Removed — existed pre-LFW24; router rejects with CONTRL.

PID	Process name (AHB)	Direction	Status
55001	Anfrage Lieferbeginn Strom	LFN → NB	✅ Implemented
55002	Anfrage Lieferende Strom	LFN → NB	✅ Implemented
55003	Bestätigung Lieferbeginn	NB → LFN	↩ Derived from 55001 accept
55004	Ablehnung Lieferbeginn	NB → LFN	↩ Derived from 55001 reject
55005	Bestätigung Lieferende	NB → LFN	↩ Derived from 55002 accept
55006	Ablehnung Lieferende	NB → LFN	↩ Derived from 55002 reject
55007–55010	(removed in LFW24 — not in AHB S2.x)	—	❌ Removed
55017	Kündigung Lieferbeginn	LFN → LFA	✅ Implemented
55018	Bestätigung Kündigung Lieferbeginn	LFA → LFN	↩ Derived from 55017 always
55555	Anfrage Daten der individuellen Bestellung	LFN → NB	✅ Implemented (GPKE Teil 4, BK6-24-174)
56001	Einspeisung Anmeldung (ex-MPES, BK6-22-024)	LFE → NB	✅ AHB validated (fv20250606+)
56002	Einspeisung Abmeldung / Kündigung (ex-MPES, BK6-22-024)	LFE → NB	✅ AHB validated (fv20250606+)
56003	Einspeisung Bestätigung (ex-MPES, BK6-22-024)	NB → LFE	✅ AHB validated (fv20250606+)
56004	Einspeisung Ablehnung (ex-MPES, BK6-22-024)	NB → LFE	✅ AHB validated (fv20250606+)

LFW24 (BK6-22-024): PIDs 56001–56004 (Einspeisestelle) were transferred from MPES to GPKE effective 2025-06-06. Former PIDs 56005–56010 do not appear in any extracted INVOIC AHB and are not registered. PIDs 55007–55010 were removed in the LFW24 redesign to 24-hour processing.

ORDERS/ORDRSP Konfigurationseinrichtung (GPKE Teil 4)

PID	Process name	Direction	Status
17134	Einrichtung Konfiguration aufgrund Zuordnung LF (NB an MSB)	NB → MSB	✅ Implemented
17135	Einrichtung Konfiguration aufgrund Zuordnung LF (MSB an MSB)	MSB → MSB	✅ Implemented
19001	Bestellbestätigung (accept)	MSB → NB/MSB	↩ Derived from 17134/17135 accept
19002	Ablehnung der Bestellung (reject)	MSB → NB/MSB	↩ Derived from 17134/17135 reject

INVOIC billing processes (Netznutzungsabrechnung)

PID	Process name	Status
31001	Abschlagsrechnung (Netznutzung)	✅ Implemented
31002	NN-Rechnung (Netznutzungsabrechnung)	✅ Implemented
31004	Stornorechnung	✅ Implemented
31005	MMM-Rechnung (Mehr-/Mindermengensaldo)	✅ Implemented
31006	MMM-Rechnung (selbst ausgestellt)	✅ Implemented
31007	Aggregierte Mehr-/Mindermenge Rechnung	✅ Implemented
31008	Aggregierte Mehr-/Mindermenge Rechnung (SA)	✅ Implemented

PIDs 31003 (WiM-Rechnung) and 31009 (MSB-Rechnung) belong to the WiM domain.

EDIFACT Format Versions

Format version	Valid from	Valid until	Profile status
`FV2025-06-06`	2025-06-06	2025-09-30	✓ available (UTILMD S1.2 — LFW24 cutover; introduced PIDs 56001–56004)
`FV2025-10-01`	2025-10-01	2026-09-30	✓ available (UTILMD S2.1 — current)
`FV2026-10-01`	2026-10-01	—	✓ available (UTILMD S2.2 — upcoming)
`FV2026-04-01`	2026-04-01	2026-09-30	✓ available (INVOIC 2.8e, REMADV 2.9f, ORDERS 1.4b)

INVOIC (31001–31008) and ORDERS/ORDRSP Konfiguration (17134/17135, 19001/19002) use their own versioned profiles (fv20260401), independent of the UTILMD Strom release cycle.

Modules

Rust module	Contents
`wechselprozesse`	PIDs 55001–55002, 55017, 56001–56004 (UTILMD supplier-switch + feed-in)
`lf_anmeldung`	PIDs 55003–55006, 55018 (LF-role: receive NB ANTWORT)
`anfrage_bestellung`	PID 55555 (Anfrage Daten der individuellen Bestellung, LFN → NB, GPKE Teil 4)
`abrechnung`	PIDs 31001–31008 (INVOIC Netznutzungsabrechnung)
`konfiguration`	PIDs 17134/17135 (ORDERS outbound) + 19001/19002 (ORDRSP inbound) — GPKE Teil 4

Usage

use mako_gpke::{GpkeSupplierChangeWorkflow, SupplierChangeCommand};
use mako_engine::{builder::EngineBuilder, event_store::InMemoryEventStore};

// In tests (requires `testing` feature or `#[cfg(test)]`):
#[cfg(test)]
let ctx = EngineBuilder::new()
    .with_event_store(InMemoryEventStore::new())
    .build();

// In production, explicitly provide all stores:
// let ctx = EngineBuilder::with_stores(outbox, deadline, registry)
//     .with_event_store(my_slatedb_store)
//     .build();

let process = ctx.spawn::<GpkeSupplierChangeWorkflow>(tenant_id, workflow_id);
let events = process.execute(SupplierChangeCommand::ReceiveUtilmd {
    pid: 55001,
    // …
}).await?;

Regulatory references

BDEW GPKE Marktprozesse für die Belieferung mit Elektrizität
BNetzA BK6-24-174 (Beschluss 24.10.2024, gültig seit 06.06.2025) — GPKE Teil 1–3
BNetzA BK6-22-024 (Beschluss 21.03.2024) — GPKE Teil 4 + APERAK Frist 24 Stunden + ex-MPES PIDs 56001–56004
EDI@Energy UTILMD Strom AHB S2.2 (FV2026-10-01)
EDI@Energy INVOIC AHB 2.8e / AHB 1.0 (FV2025-10-01 onwards)
EDI@Energy APERAK AHB 2.2 (FV2026-10-01)

mako-gpke 0.3.0