# 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.
| 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 | Anweisung Sperrung | NB → LFN | ✅ Implemented |
| 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)
| 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)
| 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
| `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
| `wechselprozesse` | PIDs 55001–55002, 55017, 56001–56004 (UTILMD supplier-switch + feed-in) |
| `sperrung` | PID 55555 (Anweisung Sperrung, NB → LFN) |
| `lf_anmeldung` | PIDs 55003–55006, 55018 (LF-role: receive NB ANTWORT) |
| `abrechnung` | PIDs 31001–31008 (INVOIC Netznutzungsabrechnung) |
| `konfiguration` | PIDs 17134/17135 (ORDERS outbound) + 19001/19002 (ORDRSP inbound) — GPKE Teil 4 |
## Usage
```rust
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`)